Page Assist 项目常见问题解决方案
项目基础介绍
Page Assist 是一个开源的 Chrome 扩展程序,旨在为用户提供一个侧边栏和 Web UI,以便与本地运行的 AI 模型进行交互。该项目的主要编程语言是 JavaScript 和 TypeScript。通过 Page Assist,用户可以在任何网页上与 AI 模型进行交互,实现诸如与网页内容对话等功能。
新手使用注意事项及解决方案
1. 依赖安装问题
问题描述:新手在安装项目依赖时可能会遇到问题,尤其是在安装 Bun 和 Ollama 等依赖时。
解决步骤:
- 安装 Bun:按照官方指南安装 Bun。确保系统环境变量中包含 Bun 的路径。
- 安装 Ollama:按照 Ollama 的官方安装指南进行安装。确保 Ollama 服务正常运行。
- 验证安装:在终端中运行
bun --version
和ollama --version
命令,确认安装成功。
2. 扩展加载问题
问题描述:在加载 Chrome 扩展时,可能会遇到“无法加载扩展”的错误。
解决步骤:
- 启用开发者模式:打开 Chrome 的扩展管理页面(
chrome://extensions/
),确保开发者模式已启用。 - 加载扩展:点击“加载已解压的扩展程序”按钮,选择项目的
build
目录。 - 检查 manifest 文件:确保
manifest.json
文件格式正确,没有语法错误。
3. 键盘快捷键冲突
问题描述:默认的键盘快捷键可能与其他应用程序或扩展程序的快捷键冲突,导致无法正常使用。
解决步骤:
- 修改快捷键:打开 Chrome 的扩展管理页面,找到 Page Assist 扩展,点击“键盘快捷键”选项。
- 自定义快捷键:为 Page Assist 设置新的快捷键,避免与其他应用程序或扩展程序冲突。
- 测试快捷键:使用新的快捷键打开侧边栏或 Web UI,确保功能正常。
通过以上步骤,新手用户可以顺利解决在使用 Page Assist 项目时可能遇到的常见问题,确保项目的正常运行。