Page Assist:离线可用、3步接好Ollama的本地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 后,在浏览器侧边栏里就能总结当前页面、解析划选文字、就页面内容提问。对话与知识数据全部存在本地,适合不想把内容上传云端、又想随手用 AI 的读者。
痛点:复制、等待和不安的代价
读一篇长论文或产品文档,想问 AI 一个段落:复制到云端 AI 站点、粘贴、等结果、再切回页面,一个问题三次切换屏幕。若页面是内部文档,粘贴到第三方网站时还会多一份不安。
在飞机或地铁上想继续读网页并用 AI,云端服务直接断网;即便在家有网,模型响应有时比阅读速度慢。你需要的是随页面一起工作的本地 AI 助手,而不是另一个要登录的网页。
功能一览:页面问答、划词解析与文档处理三组能力
随页问答
- 侧边栏对话:在任意页面右键选择 Open Page Assist Sidebar,或按 Ctrl+Shift+Y,模型对话出现在页面旁边,无需切标签页
- Chat with Website:把当前页面内容作为上下文发给模型,问"这篇页面讲了什么"得到基于页面内容的回答
- 页面视觉(Vision):视觉模型可直接"看到"页面截图;无视觉能力的模型可用内置 Tesseract OCR 提取文字再读页
划词AI解析与文档知识
- 划词 Copilot:选中文字后右键,直接执行总结、改写、翻译、解释等内置动作
- 自定义 Copilot 提示词:自己写动作模板,选中文字经 {text} 占位符注入,保存后出现在右键菜单
- 知识库(RAG):上传 PDF、Docx、Txt、CSV、MD 文件,用本地向量检索让模型基于你自己的文档回答
扩展能力
- Web UI:点击扩展图标在新标签页打开完整聊天界面,带历史对话,接近 ChatGPT 式网站的使用体验
- 联网搜索:一个开关让模型结合实时搜索结果作答,支持 Google、DuckDuckGo、Bing、百度等多个引擎
- 快捷键体系:Ctrl+Shift+Y 开侧边栏、Ctrl+Shift+L 开 Web UI、Ctrl+E 在普通对话与页面对话间切换
- 其他:文本朗读、语音输入、YouTube 字幕摘要,以及中日韩英等多语言界面
快速上手:接好Ollama并构建扩展只需3步
先对照环境要求:
| 要求 | 说明 | 检查方式 |
|---|---|---|
| 浏览器 | Chrome、Edge、Brave、Firefox 等;Opera、Arc 仅支持 Web UI | 以浏览器扩展页支持为准 |
| Ollama | 本地模型服务,需保持运行 | 终端执行ollama list能看到模型 |
| Bun(或 npm) | 构建工具,官方推荐 Bun | bun -v输出版本号 |
手动安装主路径(唯一一套完整步骤):
- 先给 Ollama 拉一个模型:
ollama pull llama3- 克隆仓库并进入目录:
git clone https://gitcode.com/GitHub_Trending/pa/page-assist cd page-assist- 安装依赖并构建,一次产出 Chrome、Edge、Firefox 三个版本;Bun 遇到问题可改用 npm 执行同样命令:
bun install bun run build- 加载扩展:Chrome 打开
chrome://extensions,开启"开发者模式",点"加载已解压的扩展程序"并选中build目录;Firefox 打开about:addons,选"加载临时扩展"指向build目录里的manifest.json。 - 打开任意网页按 Ctrl+Shift+Y,侧边栏出现;Ollama 跑在默认
localhost:11434时扩展自动识别,无需再配置。
如果不想自己构建,可直接从 Chrome 应用商店、Firefox 附加组件商店或 Edge 加载项安装。
设计思路:数据留在本地、连接零配置
聊天记录、知识库向量与设置全部存放在浏览器本地存储(Dexie),没有服务器端存储;扩展唯一会向外通信的是分享功能,且可在设置中关闭。另一项决策是 Ollama 自动检测:只要 Ollama 在localhost:11434运行即可直接连上;LM Studio 等 OpenAI 兼容端点则在设置页里作为 Provider 添加。
[!NOTE] 为什么把数据放在浏览器里?扩展运行在浏览器环境,本地存储是唯一不依赖服务器的数据层,"内容不出机器"由结构保证,可对照源码验证。自动检测则把最常见的 Ollama 本地场景做成零配置,新人不必先读文档再上手。
避坑指南:五类最常见的问题
| 现象 | 原因 | 解决办法 |
|---|---|---|
| 发往 Ollama 的消息报 403 或直连失败 | 浏览器跨域(CORS)限制,请求头自动改写仅对 127.0.0.1 / localhost 生效 | 在 Ollama 设置展开"Advance Ollama URL Configuration"启用自定义 Origin URL;或设置环境变量OLLAMA_ORIGINS=*后重启 Ollama,详见 Ollama 连接排查 |
| Opera、Arc 里没有"打开侧边栏"选项 | 该浏览器不支持侧边栏 API | 换用 Chrome、Edge、Firefox 等,或改用 Web UI |
| 与网页对话报错或响应异常 | 默认 RAG 模式需要 embedding 模型,未配置会失败 | 设置中关闭"Chat with website using vector embeddings"改用原文直发;或安装 nomic-embed-text 等嵌入模型 |
| 模型列表为空、选不到模型 | 模型尚未拉取到 Ollama | 执行ollama list核对,再ollama pull对应模型名 |
| 知识库上传大文件后明显变慢 | 向量存于浏览器存储,无服务端计算 | 按需添加文档,大文件拆分,关闭不用的知识条目 |
生态与参与
项目以 MIT 协议开源。功能细节(侧边栏、知识库、联网搜索、Ollama 配置等)见 docs/ 目录;想提交代码或反馈问题,先读 贡献指南 再开 Issue 或 PR,主要源码位于 src/ 目录。
若你想让 AI 出现在网页旁又绝不让内容离开本机,从应用商店安装后按上面 3 步即可跑起来;想确认数据处理边界,直接翻仓库根目录的 PRIVACY.md 对照即可。
【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assist
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考