Page Assist 上手指南：用本地 AI 模型与任意网页对话
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过去两周我把 Page Assist 挂在 Chrome 里配着 Ollama 读了几篇长文和技术博客。它最打动我的一点是侧边栏在任意页面按CtrlShiftY右侧面板直接打开问这篇文章讲了什么请求全程只打到本机模型不出内网。对经常处理敏感页面内容的人来说这个边界感比功能本身更重要。 一分钟看懂项目说明定位开源浏览器扩展给本地 AI 模型提供侧边栏和 Web UI支持与当前网页对话模式适合人群已跑或愿意跑Ollama、LM Studio 等本地模型又在意隐私或离线使用的用户上手成本商店安装最省源码构建约 10 分钟装依赖、bun run build、浏览器加载build目录 它适合谁重度阅读者。你在一篇论文或长文里读到看不懂的段落时不用复制粘贴到别处按CtrlE在普通聊天和与当前页对话之间切换问题会连同页面正文一起发给模型。YouTube 页面会被特殊处理——扩展直接拉取字幕文本再交给模型总结比让它看页面 DOM 靠谱得多。隐私敏感的办公场景。你在处理内部文档页面、客户资料时不希望正文被送到第三方 API。Page Assist 的 README 声明不收集任何个人数据聊天记录存在浏览器本地的 IndexedDB 里代码用 Dexie 封装只有你主动使用分享功能时才会与服务器通信且可在设置中关闭。本地模型玩家。你已经在 Ollama 或 LM Studio 里跑着模型只差一个趁手的界面。点扩展图标打开 Web UI默认CtrlShiftL就是一个本地版 ChatGPT 网页模型列表会从localhost:11434自动拉取换模型、看流式输出都在这里完成。⚙️ 背后怎么运作给好奇但不想读源码的人说清楚一条链路你问出问题时扩展通过浏览器 scripting 能力抓取当前标签页的完整 HTML按模型上下文上限截断后拼进提示词发给本地服务。源码在src/libs/get-tab-contents.ts里面按站点分流——Wikipedia、Amazon、Twitter 有各自的解析器YouTube 走字幕。换句话说扩展本身不跑模型它是本地模型的输入设备和显示器负责取网页内容、组织上下文、渲染回答模型推理全部发生在 Ollama 或任意 OpenAI 兼容端点那一侧。这也是它支持多模型的原因——换端点只是换个地址UI 和取页逻辑不变。️ 跟着我跑起来先确认两件事本地有 Ollama 且至少拉了一个模型ollama list能看到它以及装好了 Bun没有就用 npm 代替README 明确说了可以。获取源码并安装依赖# 拉取项目 git clone https://gitcode.com/GitHub_Trending/pa/page-assist cd page-assist # 安装依赖 bun install这一步成功长什么样终端无报错退出项目下多出node_modules目录wxt prepare的 postinstall 正常跑完。构建扩展# 一次构建 Chrome、Edge、Firefox 三个版本 bun run build这一步成功长什么样项目根目录出现build目录里面是各浏览器可用的扩展产物。加载扩展。Chrome/Edge 打开chrome://extensions打开开发者模式点加载已解压的扩展程序选build目录Firefox 则在about:addons里选临时载入扩展选build目录中的manifest.json。成功长什么样工具栏出现 Page Assist 图标点开 Web UI 能看到 Ollama 的模型列表。在任意网页按CtrlShiftY打开侧边栏发一句话。收到流式回答就是跑通了。⚠️ 踩过的坑现象Web UI 里发消息报 403 或连接直接失败。原因浏览器对跨域请求有 CORS 限制Ollama 默认只放行部分来源扩展能自动重写的只有localhost/127.0.0.1地址。解法给 Ollama 设环境变量OLLAMA_ORIGINS*后重启服务或在扩展设置的 Ollama 选项里展开高级 Ollama URL 配置启用自定义 Origin URL地址仍指向本机不要改成别的服务器地址。详见 docs/connection-issue.md。现象Firefox 里找不到加载已解压的扩展程序按钮。原因Firefox 对未签名扩展走的是临时加载流程。解法about:addons→ 管理扩展 → 临时载入扩展选build目录里的manifest.json。注意临时扩展在浏览器重启后失效需要重新加载。现象侧边栏打不开或回答似乎没带上页面内容。原因Opera 和 Arc 不支持侧边栏功能只支持 Web UI见 docs/browser-support.md另外超长页面会按上下文长度截断超出部分模型看不到。解法侧边栏功能换 Chrome、Edge、Brave、Firefox 等受支持浏览器内容被截断时换上下文窗口更大的模型。 参与与生态文档入口在仓库的 docs/ 目录覆盖侧边栏、知识库、MCP、快捷键等主题本地跑bun run docs:dev可以起 VitePress 站点预览。快捷键的完整列表和改法在 docs/shortcuts.md隐私承诺写在 PRIVACY.md。项目为 MIT 协议README 邀请通过 issue 提功能请求和 bug 报告想改代码的话入口都在src/entries/下——background.ts、sidepanel/、options/三个目录对应扩展的三大界面bun dev可起开发服务器热更新调试。收尾给你的判断依据如果你已经在 Ollama 或 LM Studio 上跑着模型缺的只是一个浏览器里的入口而且你不想让页面内容经过任何第三方服务器Page Assist 值得装——源码构建一遍也就十分钟。反过来如果你还没跑过任何本地模型那它只能解决一半问题得先花点时间把 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），仅供参考