如何快速装好 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 是一个开源浏览器扩展,装上它之后,你可以用自己电脑上跑的 AI 模型(比如 Ollama 里的模型)随手回答网页内容的问题,不用把内容复制粘贴到别的聊天工具里。本文带你完成 Page Assist 安装、构建和首次配置,全程大约 10 分钟。
一分钟看懂 Page Assist
Page Assist 的目标很单纯:让你在任何网页旁边都能对话,而对话由你本地运行的模型完成。它提供两个入口——跟随网页的侧边栏,以及一个类似 ChatGPT 网站的全功能 Web UI,两者共享同一套模型配置。
核心技术速览:
| 项目 | 说明 |
|---|---|
| 主要语言 | TypeScript(JavaScript + 类型检查,代码更不容易出错) |
| 构建工具 | Bun(现代 JS 运行时,装依赖和构建都比传统工具更快) |
| 扩展框架 | WXT(基于 Vite 的浏览器扩展开发框架,Chrome/Firefox 一套代码) |
| AI 接入 | Ollama(本地模型运行器)、OpenAI 兼容端点(LM Studio、llamafile 等)、Chrome AI |
| 界面样式 | Tailwind CSS + PostCSS(原子化 CSS 框架和 CSS 处理工具) |
简单说:你负责让模型跑起来(Ollama 或 LM Studio),Page Assist 负责把它嵌进浏览器里。
环境自检清单:动手前先备齐 4 样东西
📋 开始 Page Assist 安装前,花一分钟确认下面这几项,能避免大部分"装一半报错"的情况:
- 一个浏览器——Chrome、Edge、Brave 等 Chromium 系,或 Firefox,二选一即可(都想要也没问题)。
- Bun——负责装依赖和构建。如果装 Bun 遇到麻烦,用 npm 替代也可以,只是命令要相应替换。
- 本地 AI 运行环境——推荐 Ollama(开源的本地模型运行器,一条命令即可拉模型);或者 LM Studio / llamafile 这类提供 OpenAI 兼容接口的工具。注意一下:这一步只是"备齐",扩展加载后还需要在设置里填写连接信息。
- Git——用于拉取代码仓库。
验证方法很简单:在终端分别执行bun --version和ollama --version,能输出版本号就说明就绪了。
三步完成构建:克隆、装依赖、打包
接下来进入核心操作。三步全部在终端里完成,工作目录切进项目根目录即可。
第 1 步:拉取代码
执行下面的命令,把仓库克隆到本地:
git clone https://gitcode.com/GitHub_Trending/pa/page-assist && cd page-assist第 2 步:安装依赖
在page-assist目录内执行,Bun 会按 lock 文件装好所有前端依赖:
bun install第 3 步:构建扩展
一条命令会为 Chrome、Edge 和 Firefox 同时产出构建结果,文件放在根目录的build文件夹里:
bun run build注意一下:如果你只给 Firefox 用,可以单独跑bun run build:firefox省时间。构建成功的标志是build目录里出现了各浏览器的扩展产物(包含manifest.json的目录),下一步就要用到它。
加载到浏览器:Chrome 与 Firefox 两种打开方式
🌐 构建只是"造好零件",还要把扩展"装进"浏览器才生效。两种方式差别不大,但细节不同,按你用的浏览器对照操作。
Chrome(及 Edge、Brave 等 Chromium 系)
- 地址栏输入
chrome://extensions回车,进入扩展管理页; - 打开页面右上角的"开发者模式"开关;
- 点击"加载已解压的扩展程序",选择项目里的
build目录(对应你浏览器的那个产物目录)。
Firefox
- 地址栏输入
about:addons,进入附加组件管理页; - 在"扩展"选项卡中找到"管理您的扩展";
- 选择"加载临时附加组件",指向
build目录中的manifest.json文件。
验证:浏览器工具栏出现 Page Assist 图标即加载成功。再提醒一句,Firefox 的临时附加组件在重启后可能需要重新加载,长期使用的读者可以留意官方渠道的正式签名版本。
上手使用:侧边栏、Web UI 与开发模式
扩展装好后,Page Assist 给你两个主要入口,按需切换即可。
侧边栏:网页边的随身助手
在任意网页上右键选择"Open Page Assist Sidebar",或直接按默认快捷键Ctrl+Shift+Y,侧边栏就会贴着当前页面打开。它最实用的场景是"聊网页":不用复制正文,直接问"这篇文章讲了什么",模型会基于当前页面内容回答。
Web UI:完整聊天界面
点击工具栏上的 Page Assist 图标,或按Ctrl+Shift+L,会在新标签页打开类似 ChatGPT 的完整界面,可以管理模型、知识库和各类设置。首次使用建议从这里进:在设置页填写 Ollama 的地址或 OpenAI 兼容端点的 URL,选一个模型,发一条测试消息,能收到回复就说明本地 AI 浏览器扩展配置打通了。两个快捷键都可以在浏览器扩展管理页的"快捷键"设置里改成你顺手的组合,更多细节见 快捷键说明。
开发模式:改完即见效果
如果你打算改代码,用热更新的开发服务器比反复构建省心得多:
bun dev它会启动监视进程,保存文件后自动重建,浏览器里加载同一份构建产物即可看到变化。Firefox 对应命令是bun dev:firefox。
装完之后:三个值得立刻做的事
- 接上你的模型——打开 Web UI 设置,配置 Ollama 或 LM Studio 端点,跑通第一条消息。接入细节参考 Ollama 接入文档。
- 试一次"聊网页"——找一篇长文,用侧边栏的 Chat with Website 模式让它总结,感受本地模型和网页联动的实际体验。
- 按口味调设置——界面语言、侧边栏左右位置、主题深浅都在 官方文档 有逐项说明,建议先花两分钟把语言切到中文,后面会舒服很多。
Page Assist 的所有对话数据默认只存在你自己的浏览器本地存储里,不担心网页内容被上传到某个云端服务——这一点可以放心在敏感页面上使用它。
【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assist
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考