Page Assist 浏览器侧边栏本地 AI 助手:隐私优先,5 分钟跑起来
【免费下载链接】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、LM Studio 等),在侧边栏里直接和你聊天、总结当前页面。适合想本地跑模型、又希望对话记录不出自己电脑的人。
它到底帮你解决什么问题
先说三个很常见的卡点:
- 切窗口问 AI 很打断思路:在网页和云端聊天工具之间来回切换,还要复制粘贴内容,一次就耽误半分钟
- 云端模型不放心:把工作文档、内部链接发给公共 API,隐私始终是个隐患
- 网页助手"看不见"页面:不少助手只会聊天,无法结合你当前打开的内容回答
Page Assist 的解法是把模型搬到本地:对话记录、知识库、配置都存在浏览器里,推理跑在你自己机器上;同时它能读取当前标签页的内容,直接基于你正看的页面作答。
5 分钟跑起来:最省心的安装路径
依赖一张表说清:
| 组件 | 用途 |
|---|---|
| Bun | 运行环境,负责装依赖和构建 |
| Ollama | 在本机运行模型,装好后先拉取一个模型即可 |
| Chrome / Edge / Firefox | 用来加载扩展 |
步骤:
- 克隆仓库:
git clone https://gitcode.com/GitHub_Trending/pa/page-assist - 进入目录执行
bun install(装不上依赖可改用npm install) - 执行
bun run build构建扩展 - 打开
chrome://extensions/,开启右上角"开发者模式" - 点"加载已解压的扩展程序",选择构建产物目录
💡 最容易卡住的不是安装,而是装完后的模型连接:Ollama 若运行在localhost:11434会被自动识别;连不上多半是浏览器 CORS 限制,排查方法见下文故障定位。
功能实战:按使用深度分层
开箱即用:侧边栏问当前页面
装完就能用。在任意网页按Ctrl+Shift+Y打开侧边栏,再用Ctrl+E切到"结合当前页面"模式,让它总结、翻译、提问,全程不用切标签页。用法细节见 docs/sidebar/。
进阶:和私有文档对话
把 PDF、Word、TXT、CSV、Markdown 放进知识库(docs/features/),先在设置里配好嵌入模型(推荐nomic-embed-text),之后在输入框选中对应知识库,就能就着自己上传的文档问答。注意数据只存在浏览器本地,文件太大太多会占用不少空间。
高阶:让模型替你操作页面
装上同仓库提供的 Page Action 配套扩展(仅 Chromium 系浏览器),模型可以读取当前标签页并执行点击、输入、滚动、填表等动作,且每一步默认需要你确认。适合"帮我填完这个表单"这类自动化场景。
配置指南:让体验翻倍的关键设置
快捷键(可在浏览器的扩展快捷键页面修改):
| 动作 | 默认快捷键 |
|---|---|
| 打开侧边栏 | Ctrl+Shift+Y |
| 打开独立 Web 界面 | Ctrl+Shift+L |
| 新建对话 | Ctrl+Shift+O |
| 切换侧边栏 | Ctrl+B |
| 聚焦输入框 | Shift+Esc |
| 切换页面对话模式 | Ctrl+E |
模型怎么选:
| 你的诉求 | 推荐方案 | 说明 |
|---|---|---|
| 完全离线、隐私优先 | Ollama 本地模型 | 默认自动识别本机服务,参数大小按内存挑 |
| 轻量、零配置 | Chrome AI | 浏览器内置,响应快 |
| 需要更强能力 | OpenAI 兼容端点 | 如 LM Studio,配置见 docs/providers/ |
浏览器兼容方面:Chrome、Edge、Brave、Firefox、Vivaldi、LibreWolf、Zen 功能全开;Opera、Arc 只能用独立 Web 界面,没有侧边栏。
遇到问题:高频故障快速定位
安装类
- 依赖装不上:检查网络,或换
npm install重试 - 扩展加载失败:确认已开开发者模式、构建产物目录存在,重启浏览器再试
连接类
- 提示直连错误:先确认 Ollama 服务在运行、模型已下载
- 发消息报 403:属于 CORS 问题,到设置的 Ollama 选项里开启自定义 Origin URL,或给 Ollama 设环境变量
OLLAMA_ORIGINS=*后重启服务
性能类
- 回复慢:把模型参数调小,7B 级别更稳;内存 8GB 以下不建议上 13B
- 知识库处理慢:大文档分批上传,避免一次塞满浏览器存储
你的数据去哪儿了
- 对话、知识库、模型配置全部存在浏览器本地,没有服务端存储
- 只有你主动启用分享功能时才会与外部通信
- 代码完全开源,每一条数据流向都可以自行审计
上手建议
去仓库把扩展跑起来,先花 10 分钟做一件事:Ctrl+Shift+Y打开侧边栏,对当前页面说一句"总结这页的重点"。跑通这一步,知识库、MCP 工具、页面操作这些进阶玩法再慢慢解锁也不迟。
【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assist
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考