Page Assist 安装和配置指南

Page Assist 安装和配置指南

page-assist Use your locally running AI models to assist you in your web browsing 项目地址: https://gitcode.com/gh_mirrors/pa/page-assist

1. 项目基础介绍和主要编程语言

Page Assist 是一个开源的 Chrome 扩展程序，旨在通过本地运行的 AI 模型来辅助你的网页浏览。该项目的主要编程语言是 TypeScript，它结合了 JavaScript 的灵活性和静态类型检查的优势，使得代码更加健壮和易于维护。

2. 项目使用的关键技术和框架

Page Assist 项目使用了以下关键技术和框架：

• Bun: 一个快速、现代的 JavaScript 运行时，用于安装依赖和构建项目。
• Ollama: 一个本地 AI 提供者，用于与 AI 模型进行交互。
• OpenAI API: 兼容的端点（如 LM Studio、llamafile 等），用于与 AI 模型进行通信。
• Tailwind CSS: 一个用于快速构建用户界面的 CSS 框架。
• PostCSS: 一个用于处理 CSS 的工具，通常与 Tailwind CSS 一起使用。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

在开始安装 Page Assist 之前，请确保你已经安装了以下工具和软件：

• Node.js: 用于运行 JavaScript 代码。
• Bun: 用于安装项目依赖和构建项目。
• Ollama: 用于本地 AI 模型的运行。
• Chrome 或 Firefox 浏览器: 用于加载和测试扩展程序。

详细安装步骤

步骤 1: 克隆项目仓库

首先，你需要从 GitHub 上克隆 Page Assist 项目到本地：

git clone https://github.com/n4ze3m/page-assist.git
cd page-assist

步骤 2: 安装项目依赖

使用 Bun 安装项目所需的依赖：

bun install

步骤 3: 构建扩展程序

构建扩展程序，默认情况下会为 Chrome 构建：

bun run build

如果你想为 Firefox 构建，可以使用以下命令：

bun run build:firefox

步骤 4: 加载扩展程序

对于 Chrome 浏览器：

1. 打开 Chrome 浏览器的扩展程序管理页面：chrome://extensions/。
2. 启用开发者模式，方法是点击右上角的开关。
3. 点击“加载已解压的扩展程序”按钮，然后选择 build 目录。

对于 Firefox 浏览器：

1. 打开 Firefox 浏览器的附加组件管理页面：about:addons。
2. 点击“扩展”选项卡。
3. 点击“管理您的扩展”按钮。
4. 点击“加载临时附加组件”按钮，然后选择 build 目录中的 manifest.json 文件。

步骤 5: 使用扩展程序

安装完成后，你可以通过以下方式使用 Page Assist：

• 侧边栏: 通过右键菜单或快捷键 Ctrl+Shift+P 打开侧边栏，与本地 AI 模型进行交互。
• Web UI: 点击扩展程序图标，打开一个新的标签页，进入 Web UI 界面。

开发模式

如果你想在开发模式下运行扩展程序，可以使用以下命令：

bun dev

这将启动一个开发服务器，并监视源文件的变化。你可以在浏览器中加载扩展程序并测试你的更改。

总结

通过以上步骤，你已经成功安装并配置了 Page Assist 扩展程序。现在你可以开始使用本地运行的 AI 模型来辅助你的网页浏览了。如果你有任何问题或建议，欢迎在项目的 GitHub 仓库中提出。

page-assist Use your locally running AI models to assist you in your web browsing 项目地址: https://gitcode.com/gh_mirrors/pa/page-assist