把本地AI助手装进浏览器侧边栏,从安装到离线对话的实战记录
2026/9/20 2:44:36 网站建设 项目流程

把本地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 带进侧边栏的扩展:模型跑在你自己的机器上,你在侧边栏里离线对话、直接追问当前页面,不用切换应用。

五步跑起来

装之前需要三样东西:Bun(运行环境)、Ollama(本地模型运行平台)、一个 Chromium 系或 Firefox 浏览器。如果你打算用 LM Studio 这类 OpenAI 兼容端点,Ollama 可以省掉。

  1. 克隆项目
git clone https://gitcode.com/GitHub_Trending/pa/page-assist cd page-assist
  1. 安装依赖
bun install

Bun 遇到问题时,换 npm install 也能跑通。

  1. 构建扩展
bun run build

默认同时构建 Chrome、Edge 和 Firefox 三个版本。

  1. 加载扩展

打开chrome://extensions/,开启右上角"开发者模式",点"加载已解压的扩展程序",选中项目里的 build 目录。Firefox 则在 about:addons 里加载 build 目录中的 manifest.json。

看到浏览器工具栏出现 Page Assist 图标,就算装好了。

浏览器本地AI助手能替你干什么

简单讲,它提供三样东西:任意网页上能开的侧边栏 AI 助手、一个独立标签页的 Web 对话界面、一个能和自己文档聊天的知识库。

边看边问

在任何页面按 Ctrl+Shift+Y 打开侧边栏,用 Ctrl+E 切到"与当前页对话"模式。模型能看到你正在看的页面内容,你可以让它总结整篇文章、翻译某一段、解释看不懂的概念,全程不用切换标签页。阅读位置和上下文都在,页面上读内容,侧边栏里问问题。比如在 GitHub 的文档页上直接问"这个参数是干什么的",它会结合页面内容回答。

查自己的资料

知识库支持上传 PDF、Docx、Txt、CSV、MD 五类文件,然后针对它们提问。启用前要在 RAG 设置里选一个嵌入模型(官方推荐 nomic-embed-text),不要用普通对话模型代替。上传后文件处理需要一点时间,完成后点输入框里的知识库图标,勾选想引用的文档即可。比如把产品手册 PDF 传进去,问"第 3 章的兼容性限制是什么"。

换引擎

底层模型可以随意换。跑在默认 localhost:11434 的 Ollama 会被自动识别,不用配置;你也可以添加任意 OpenAI 兼容端点,比如 LM Studio、llamafile,或者用 Chrome AI 里芯片内置的 Gemini Nano 处理轻量任务。切换时进设置选提供商和模型就行,已有的对话记录不受影响。

侧边栏AI助手卡壳的地方都在这

模型选多大合适

7B 到 13B 是效果和速度的平衡点,多数机器跑起来不费劲。显存充裕可以试 13B 以上,明显卡顿就降到 7B。

快捷键总和应用冲突

扩展级快捷键(Ctrl+Shift+Y、Ctrl+Shift+L 这类)可以在浏览器的扩展快捷键设置页改成不冲突的组合。应用内的快捷键如新建对话则是固定值。

文档太大处理慢

知识库的文件解析和向量存储都在浏览器本地完成,没有服务器帮忙。大文档建议拆开分批上传,同时定期清理用不上的旧对话和旧知识库,给本地存储腾空间。

连不上 Ollama

先确认 Ollama 服务正在运行、目标模型已经下载。默认地址 localhost:11434 会自动识别,如果你用的是非默认地址,在设置里"OpenAI 兼容 API"一栏手动加端点。

浏览器选哪个

Chrome、Edge、Firefox、Brave、Vivaldi 都完整支持侧边栏、网页对话和 Web UI。Opera 和 Arc 只支持独立 Web 界面。

谁适合用

如果你平时读论文:英文文献的摘要和方法章节可以先让它用大白话过一遍,不用逐字查词典。阅读时按 Ctrl+Shift+Y 把侧边栏拉出来,切到与当前页对话模式,问一句"这篇论文的核心贡献是什么",再回到页面上继续读下一段。

如果你写代码:新框架的文档、第三方库的行为细节是每天要翻的东西。打开官方文档页面,在侧边栏里直接问某个参数的版本差异;也可以把文档 PDF 放进知识库,长期留着随时查。

如果你做内容:参考文章收集完就能丢给它。在侧边栏里总结一篇行业文章的要点,或者把外文资料翻译成中文,结果复制进你的素材库就能用。

你的数据去了哪

对话历史、知识库和设置全部存在浏览器的本地存储里。只有你主动使用"分享"功能把对话发出去时,数据才会离开这台机器,而这个功能可以在设置里关掉;不启用分享时,数据不出浏览器。代码完全开源,以上行为可以自己去源码里验证。

延伸阅读

  • 侧边栏打开方式
  • 知识库配置说明
  • Ollama 连接指南
  • 快捷键完整列表
  • 隐私政策
  • 贡献指南

Page Assist 把本地模型放到你浏览页面的手边,对话留在自己的机器上。打开 Chrome 扩展页把 build 目录加载进去,从一句"总结这个页面"开始。

提示:第一次装,先让 Ollama 拉好模型再加载扩展,绝大多数起步问题都是顺序反了。

【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assist

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

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

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

立即咨询