Page Assist 实战指南：3 步把本地 AI 模型装进浏览器侧边栏

Page Assist 实战指南3 步把本地 AI 模型装进浏览器侧边栏【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assistPage Assist 是一个本地 AI 浏览器扩展它把跑在你电脑上的 Ollama、Chrome AI 或任意 OpenAI 兼容模型接进浏览器侧边栏和独立网页界面让你不用离开当前页面就能和 AI 对话、总结网页内容。本文面向刚接触本地模型的新手走一遍从克隆代码到让模型真正应答的完整流程并提前说明两个新手最容易卡住的坑。本地模型缺的不是能力而是一个顺手的入口Ollama 自带的网页界面能聊天但它和你的日常浏览是割裂的看到一篇英文长文想问这段话什么意思你得切窗口、打开新标签页、手动把文字复制过去。上下文断了提问的动机也断了。Page Assist 做的事很简单在任意网页右侧挂一个对话面板并让这个面板知道你现在看的是什么页面。于是总结当前页翻译选中段落这类操作就在一两个快捷键内完成而不是跨窗口搬运文本。它提供两个入口侧边栏贴在任意网页右侧默认快捷键CtrlShiftY适合边看边问Web 界面点击扩展图标或按CtrlShiftL打开的完整聊天页有多轮对话历史、模型管理用法接近一个本地版聊天网站两者共享同一套模型和设置按场景挑一个用即可。装前准备与三条命令的安装流程开始前需要三个东西准备项作用说明Bun 运行时执行项目构建命令装不上或报错时全程用npm替代bunOllama提供本地模型需已安装并拉取过至少一个模型Chromium 内核浏览器承载扩展Chrome、Edge、Brave 均可Firefox 也支持但加载方式不同安装步骤克隆仓库并进入目录git clone https://gitcode.com/GitHub_Trending/pa/page-assist cd page-assist安装依赖bun install这一步会顺带执行wxt prepare初始化扩展工程构建扩展bun run build产物默认同时面向 Chrome、Edge 和 Firefox输出在build/目录加载扩展。Chromium 系浏览器打开chrome://extensions右上角打开开发者模式点加载已解压的扩展程序选择build目录Firefox打开about:addons在扩展页点加载临时扩展选中build目录里的manifest.json成功标志工具栏出现 Page Assist 图标且任意网页按CtrlShiftY右侧弹出对话面板。面板打开即代表扩展加载成功剩下能不能说话就看模型配置。接入模型Ollama 默认免配置其他端点各就各位Page Assist 支持三类本地模型来源Ollama如果跑在默认的http://localhost:11434什么都不用配扩展会自动检测到相关说明Chrome AIGemini Nano浏览器内置零配置适合轻量问答OpenAI 兼容端点LM Studio、llamafile 等在设置的OpenAI Compatible API页签点 Add Provider 填入地址即可多实例 Ollama 的接法在设置页的 OpenAI 兼容页签添加 Provider类型选 Ollama、填 URL模型列表会自动从该实例拉取不需要手动加模型。成功标志在侧边栏选一个模型发一句你好几秒内出现回复本地模型首 token 慢属正常别和云端速度比。第一次真正的对话打开侧边栏让模型读到当前页装好模型后推荐的第一次体验是与当前网页对话这是侧边栏和普通聊天框最本质的区别在任意网页上按CtrlShiftY打开侧边栏开启Chat with Website开关直接提问比如用三句话说清这篇文章的核心论点背后有两种工作方式可在设置里切换默认用向量检索RAG把网页内容切块建索引后再检索作答需要配置一个 embedding 模型官方推荐nomic-embed-text如果不想引 embedding也可以在Copilot Chat With Website Settings里关闭Chat with website using vector embeddings改为直接把网页正文截断后整段发给模型并可调大发送的正文长度上限。详细步骤见官方侧边栏文档。日常操作建议记住这四个面板内快捷键CtrlShiftO新建对话、CtrlB收起/展开历史列表、ShiftEsc直接聚焦输入框、CtrlE在普通聊天和当前页聊天之间切换。扩展级快捷键打开侧边栏/Web 界面则在浏览器的chrome://extensions/shortcuts里修改Firefox 在about:addons的设置入口改快捷键完整清单。两个新手最容易卡住的坑坑一发不出消息报连接错误或 403这是扩展和本地 Ollama 之间的 CORS 限制导致的几乎是新手必踩。处理顺序如下官方排查文档有完整图解先确认 Ollama 进程确实在跑终端执行ollama list能看到模型列表进 Page Assist 设置 → Ollama Settings展开Advance Ollama URL Configuration打开Enable or Disable Custom Origin URL后点 Save。原理是扩展会自动改写请求头来绕过浏览器限制但该改写只对http://127.0.0.1:*和http://localhost:*生效所以 Ollama 用非默认端口时要把 Custom Origin URL 改成对应端口还不行就在系统层面放行来源设置环境变量OLLAMA_ORIGINS*后重启 OllamaWindows 走编辑系统环境变量macOS 用launchctl setenv OLLAMA_ORIGINS *Linux 用export OLLAMA_ORIGINS*坑二知识库传了大文件浏览器变卡Page Assist 没有服务端存储文档解析和向量索引全部在浏览器本地完成并存在浏览器存储里。知识库文档明确提醒使用前先想清楚文件体量。建议一次只加一个中等大小的文档用完在管理页删掉。格式上 PDF、Docx、Txt、CSV、MD 都支持但前提同样是要先在 RAG Settings 里配好 embedding 模型——这里只认 embedding 模型填对话模型进去不会工作。进阶两件事让模型动手操作页面以及对话你传的文件Page Action在聊天侧边栏开启 Page Action光标图标后模型不仅能读页面还能替你点击、输入、滚动、填表。注意它是独立的一个伴随扩展不是主扩展的一部分——因为它需要 Chrome 的debugger强权限做成分离安装让只需要聊天的用户不必授予这个权限。仅 Chromium 系浏览器可用Firefox 不支持。建议保留默认的每次操作前需确认首次体验时它会在每一步等你点确认。Page Action 文档解释了权限隔离的设计原因。知识库问答在设置的 Manage Knowledge 里点 Add New Knowledge 上传文件处理完成后输入框会出现知识库图标选中对应文档即可让模型只基于你的文件回答。它和聊天带网页是两个独立场景前者问的是你传的文件后者问的是你正在看的页面。浏览器兼容性方面Chrome、Edge、Brave、Firefox、Vivaldi 的侧边栏、网页对话、Web 界面三项全支持Opera 和 Arc 因侧边栏 API 限制只支持 Web 界面。遇到问题、想加功能或贡献代码直接到项目仓库提 Issue 即可文档站docs/也接受补充性的 PR。【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assist创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考