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
想总结一篇长网页,又不想把内容粘给云端 AI?Page Assist 是个现成的办法。这个开源浏览器扩展把本地运行的 AI 模型(Ollama、LM Studio 等)接到浏览器侧边栏和独立对话页里,让你在任意网页上直接提问。
📌 一分钟了解 Page Assist
一句话定位:它是本地大模型的"浏览器对话入口",提供侧边栏和独立 Web 对话界面两种用法。
| 项目 | 说明 |
|---|---|
| 运行位置 | 以扩展形式安装在 Chrome、Edge、Brave、Firefox 等浏览器 |
| 支持的模型 | Ollama、LM Studio、Llamafile,以及 OpenAI、DeepSeek、Groq 等 30+ OpenAI 兼容端点 |
| 隐私机制 | 对话记录与文件数据存在浏览器本地存储,本地模型请求不出本机 |
📦 扩展安装步骤:三步装好
先备齐前置依赖:
| 组件 | 作用 | 获取地址 |
|---|---|---|
| Bun | 运行时环境,用于安装依赖和构建扩展 | Bun 官网 |
| Ollama | 在本地机器上运行 AI 模型 | Ollama 官网 |
| Chrome 或 Firefox | 运行扩展的浏览器 | 保持最新版本 |
安装分三步,每步一条命令:
1. 克隆仓库
git clone https://gitcode.com/GitHub_Trending/pa/page-assist克隆完成后进入page-assist目录。
2. 安装依赖
bun install替代方案:如果 Bun 在你的环境里报错,可全程改用
npm install和npm run build。
3. 构建并加载扩展
bun run build构建会同时产出 Chrome/Edge 和 Firefox 版本。在 Chrome 中打开chrome://extensions,开启右上角"开发者模式",点"加载已解压的扩展程序",选中build目录。Firefox 则在about:addons里点"加载临时扩展",选择build目录中的manifest.json。
💬 三种真实用法
网页内快问快答:侧边栏
什么时候用:你在看一篇资讯或文档,想就地提问"这篇文章讲了什么",但不想切换标签页。
- 按
Ctrl+Shift+Y打开侧边栏,任何网页都可用。 - 开启
Chat with Website模式,模型会结合当前页面内容回答和总结。 - 用
Ctrl+E可在普通对话和网页对话之间来回切换。
独立对话窗口:Web UI
什么时候用:你想把它当成一个独立聊天应用用,回看历史、管理模型。
- 点击工具栏扩展图标,或按
Ctrl+Shift+L,在新标签页打开完整对话界面。 - 对话历史保存在本地,随时切回旧对话继续聊。
- 模型切换、对话参数都在设置面板里,不用离开界面。
让 AI 读本地文档:知识库
什么时候用:手里有 PDF、报告或 CSV 数据,想直接针对文件内容提问。
- 支持格式:PDF、Docx、Txt、CSV、MD。
- 先在 RAG 设置里配一个 embedding 模型(推荐
nomic-embed-text),这是知识库生效的前提。 - 在设置页的 Manage Knowledge 里上传文件,处理完成后,在输入框点知识库图标选中对应文件即可提问。
⚖️ 本地模型对比表:模型怎么选
| 模型类型 | 适用场景 | 建议规格 |
|---|---|---|
| Ollama 本地模型 | 离线使用、隐私敏感 | 7B-13B 参数,按内存选配;本机localhost:11434运行时无需任何配置,扩展会自动检测 |
| Chrome AI | 轻量任务、响应要快 | 内置 Gemini Nano,开箱即用 |
| LM Studio / Llamafile | 想自选本地模型 | 7B-13B 参数,与 Ollama 一样免手动加模型 |
| 云端 OpenAI 兼容端点 | 需要更强能力、可联网 | 在设置中选择端点并填入 API Key |
🛠 遇到问题怎么办:常见故障排查
| 现象 | 排查项 |
|---|---|
| 依赖安装或构建失败 | 检查网络连接后重试;全程改用 npm 再试 |
| 扩展加载失败 | 确认已开启"开发者模式";确认选中的是build目录(Firefox 是其中的manifest.json);重启浏览器后重新加载 |
| Ollama 连不上,报 403 或直连错误 | 确认 Ollama 正在运行且模型已下载;在设置里展开 Advance Ollama URL Configuration 并启用 Custom Origin URL 后保存;或设置环境变量OLLAMA_ORIGINS=*再重启 Ollama |
易踩的坑:启用 Custom Origin URL 时,如果 Ollama 用了非默认端口就填对应 URL,但不要把它改成 Ollama 服务器地址,详见 连接问题排查文档。
⌨ 进阶设置:快捷键自定义与浏览器兼容
扩展级快捷键可在浏览器扩展管理页修改,应用内快捷键一览:
| 操作 | 默认快捷键 |
|---|---|
| 打开侧边栏 | Ctrl+Shift+Y |
| 打开 Web UI | Ctrl+Shift+L |
| 新建对话 | Ctrl+Shift+O |
| 切换对话历史面板 | Ctrl+B |
| 聚焦输入框 | Shift+Esc |
| 切换对话模式 | Ctrl+E |
具体修改路径见 快捷键文档。不同浏览器的功能支持情况如下(摘自 浏览器支持文档):
| 浏览器 | 侧边栏 | 网页对话 | Web UI |
|---|---|---|---|
| Chrome、Edge、Brave、Vivaldi | ✅ | ✅ | ✅ |
| Firefox、LibreWolf、Zen | ✅ | ✅ | ✅ |
| Opera、Arc | ❌ | ❌ | ✅ |
第一次上手,建议先开启Chat with Website在侧边栏对网页提问,这是见效最快的一条路;用熟之后再到 Web UI 里做独立对话;最后尝试上传文档试试知识库。所有数据都存在浏览器本地,可以放心使用。想继续挖 MCP、页面操作等进阶能力,可直接翻阅仓库里的 docs/features/ 功能文档。
【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assist
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考