如何快速上手 Page Assist：在任何网页与本地 AI 模型交互的完整指南
【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assist
Page Assist 是一款开源 Chrome 扩展，让你在任何网页的侧边栏里与本地运行的 AI 模型对话——想让浏览网页时随手用上 AI、又不想把数据交给云端的人，它就是为此准备的。
先了解它能做什么
装之前，先感受两个最典型的使用场景：
- 在任何网页上与本地模型讨论当前内容：阅读技术文章或外文资料时，打开侧边栏就能问“这段讲了什么”“帮我总结”“这段代码怎么理解”，不用复制文本、切换窗口。
- 随手打开的 Web UI 控制台：按一下快捷键就能进入完整的 Web UI，管理聊天、配置模型，扩展的侧边栏与 Web UI 双入口让 AI 助手始终在浏览动线之内。
整个过程中，模型跑在你自己的电脑上，网页内容无需上传到任何第三方服务，这是本地 AI 模型交互方案最大的吸引力。
开始前的准备清单：两项安装与验证
从源码运行扩展，只需提前备好一个构建运行时和一个模型运行时，外加一份项目源码：
- 获取项目源码：在终端执行
git clone https://gitcode.com/GitHub_Trending/pa/page-assist，后文所有操作都基于这个项目目录。 - 安装 Bun：项目用它安装依赖并构建扩展。用
bun --version验证，能打印版本号即安装成功。缺了它，扩展包根本构建不出来，加载扩展无从谈起。 - 安装 Ollama：本地模型运行环境。用
ollama --version验证，并确认 Ollama 服务已启动。缺了它，扩展装好后没有模型可对话，第一次聊天就会失败。
3 步加载扩展并完成第一次运行
- 开启开发者模式：打开 Chrome 扩展管理页 chrome://extensions/，把右上角“开发者模式”开关打开。
- 先构建，再加载：先在项目目录用 Bun 运行构建脚本（即 package.json 脚本里的 build:chrome 一项），生成项目根目录下的 build 目录；然后回到扩展管理页，点“加载已解压的扩展程序”，选择build 目录本身。
- 最容易卡住的地方在这一步：很多人会默认选中整个项目根目录，而 manifest.json 在 build 目录里，选错就会看到“清单文件缺失或不可读取”一类的报错。
- 若提示 manifest 存在 JSON 语法错误，通常说明构建没跑完整，重跑一次构建脚本即可。
- 确认生效：工具栏出现 Page Assist 图标，按下默认快捷键 Ctrl+Shift+Y 能在网页右侧打开侧边栏——看到这一现象，就说明前面每一步都对了。
常见问题速查
| 现象 | 可能原因 | 解法 |
|---|---|---|
| 安装依赖或构建卡住 | Bun 版本过旧、网络受限 | 升级最新 Bun 后重新安装依赖 |
| 加载时提示 manifest 缺失或不可读取 | 选了项目根目录而非 build 目录 | 重新点“加载已解压的扩展程序”，选择 build 子目录 |
| 按快捷键没反应 | 与系统或其他扩展的快捷键冲突 | 进入扩展快捷键设置更换组合键（下一节详述） |
| 打开扩展后模型无响应 | Ollama 服务未启动或没有可用模型 | 启动 Ollama 服务、拉取一个模型后再试 |
快捷键配置与冲突规避
扩展提供两组默认组合键：Ctrl+Shift+Y 打开侧边栏，Ctrl+Shift+L 打开 Web UI。如果被其他应用占用，进入 Chrome 的快捷键设置页 chrome://extensions/shortcuts，找到 Page Assist 条目换成不常用的组合即可。
改完后的自测方法：打开任意网页，按新组合键——侧边栏（或 Web UI）弹出来即设置生效；仍无反应时，检查是否被另一个扩展占用了同一组合键。
至此，你的本地 AI 网页助手已经就绪。更多功能细节见官方文档，想深入实现原理可以直接阅读源码 src/。🙂
【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assist
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
