把本地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 可以省掉。
- 克隆项目
git clone https://gitcode.com/GitHub_Trending/pa/page-assist cd page-assist- 安装依赖
bun installBun 遇到问题时,换 npm install 也能跑通。
- 构建扩展
bun run build默认同时构建 Chrome、Edge 和 Firefox 三个版本。
- 加载扩展
打开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),仅供参考