如何快速装好 Page Assist:本地 AI 浏览助手完整指南
2026/9/20 13:33:05 网站建设 项目流程

如何快速装好 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 安装前,花一分钟确认下面这几项,能避免大部分"装一半报错"的情况:

  1. 一个浏览器——Chrome、Edge、Brave 等 Chromium 系,或 Firefox,二选一即可(都想要也没问题)。
  2. Bun——负责装依赖和构建。如果装 Bun 遇到麻烦,用 npm 替代也可以,只是命令要相应替换。
  3. 本地 AI 运行环境——推荐 Ollama(开源的本地模型运行器,一条命令即可拉模型);或者 LM Studio / llamafile 这类提供 OpenAI 兼容接口的工具。注意一下:这一步只是"备齐",扩展加载后还需要在设置里填写连接信息。
  4. Git——用于拉取代码仓库。

验证方法很简单:在终端分别执行bun --versionollama --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 系)

  1. 地址栏输入chrome://extensions回车,进入扩展管理页;
  2. 打开页面右上角的"开发者模式"开关;
  3. 点击"加载已解压的扩展程序",选择项目里的build目录(对应你浏览器的那个产物目录)。

Firefox

  1. 地址栏输入about:addons,进入附加组件管理页;
  2. 在"扩展"选项卡中找到"管理您的扩展";
  3. 选择"加载临时附加组件",指向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

装完之后:三个值得立刻做的事

  1. 接上你的模型——打开 Web UI 设置,配置 Ollama 或 LM Studio 端点,跑通第一条消息。接入细节参考 Ollama 接入文档。
  2. 试一次"聊网页"——找一篇长文,用侧边栏的 Chat with Website 模式让它总结,感受本地模型和网页联动的实际体验。
  3. 按口味调设置——界面语言、侧边栏左右位置、主题深浅都在 官方文档 有逐项说明,建议先花两分钟把语言切到中文,后面会舒服很多。

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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询