ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

如何在浏览器里接入本地AI助手:Page Assist完整配置指南

如何在浏览器里接入本地AI助手:Page Assist完整配置指南 如何在浏览器里接入本地AI助手Page Assist完整配置指南【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assistPage Assist是一款开源的本地AI浏览器扩展它把你电脑上正在运行的AI模型Ollama、LM Studio等接到浏览器里在任何网页上给你一个侧边栏和Web UI。如果你不想让网页内容上传到云端或者希望在阅读时直接让AI回答页面相关问题值得花10分钟把它配起来。快速上手3条命令跑通前置依赖只有两个Bun构建工具和 Ollama本地模型服务也可以换成 LM Studio、llamafile 等任意 OpenAI 兼容端点。装好后克隆代码并构建git clone https://gitcode.com/GitHub_Trending/pa/page-assist cd page-assist bun install bun run build这条命令会为 Chrome、Edge 和 Firefox 三个浏览器各生成一份构建产物。Chrome 系浏览器打开chrome://extensions开启开发者模式点加载已解压的扩展程序选build目录Firefox 则在about:addons里点加载临时扩展选build里的manifest.json。第一次验证终端执行ollama list能看到已拉取的模型比如 llama3就算就绪。Ollama 跑在默认地址localhost:11434时会被 Page Assist 自动探测扩展里的模型下拉框会自动列出它不需要手工配置。加载扩展后点工具栏图标打开 Web UI选一个模型发一句你好收到回复就算跑通了。注意如果 Bun 遇到问题README 里说明可以用 npm 替代。上手之后三个最实用的用法和当前网页对话读一篇长文档或技术文章时按CtrlShiftY在页面右侧打开侧边栏也可以在页面右键菜单里从 Page Assist 进入打开Chat with Website开关然后在输入框直接问这篇文章的核心结论是什么。注意这一步该模式默认需要嵌入模型——它会把页面内容先向量化再检索相关片段。第一次用要么在设置里选一个 embedding 模型要么在设置 → Copilot Chat With Website Settings里关掉Chat with website using vector embeddings改用整页内容直送模型的方式。划词右键总结、翻译、改写打开一个外文页面选中一段文字右键Page Assist 菜单里会列出 5 个内置动作Summarize、Rephrase、Translate、Explain、Custom。点 Translate几秒后侧边栏里出现选中文本的英文翻译。想要检查语法改得更正式这类固定动作可以到设置 → Manage Prompts → Custom Copilot自建提示词模板里用{text}占位符代表选中内容保存后立刻出现在右键菜单里无需重启浏览器。用知识库提问自己的文件在设置 → Manage Knowledge上传 PDF、Docx、Txt、CSV 或 MD 文件。处理完成后聊天输入框会出现一个知识库块图标点它选中刚上传的文件就可以针对这份文件提问了。官方建议的嵌入模型是nomic-embed-text别拿对话模型顶替它。技术内幕浏览器扩展为什么能调本地模型第一个要解决的是跨域。扩展发起的请求和本地 Ollama 服务属于不同源浏览器会直接拦下返回 403。Page Assist 的做法是重写请求头让请求放行但这个自动重写只对http://127.0.0.1:*和http://localhost:*生效——Ollama 跑在别的端口或别的机器上时要手动开启设置里的 Custom Origin URL或者在 Ollama 一侧设OLLAMA_ORIGINS*。[!NOTE] 为什么要绕这么一圈因为扩展只能通过浏览器发请求跨域策略是无法绕过的安全边界。Page Assist 只对本地地址重写请求头而不是全面放开 CORS影响面小、也便于排查问题。第二个是服务商层。Ollama、LM Studio、llamafile甚至 Chrome 浏览器自带的 Chrome AIGemini Nano都接到同一套接入层换成哪个侧边栏的用法都不变。所有模型、对话和知识库数据存在浏览器本地存储扩展本身不收集个人数据唯一会连外网的是 share 分享功能而且可以在设置里直接关掉。避坑清单新手最常见的3个报错连不上、发消息 403现象选完模型发消息立刻报连接错误或 403。原因Ollama 地址不在 localhost 范围内请求被浏览器跨域策略拦截。解决用localhost:11434默认的 Ollama或设OLLAMA_ORIGINS*后重启服务。开启网页对话时提示缺嵌入模型现象打开 Chat with Website 被要求配置 embedding。原因默认 RAG 模式需要文本向量化模型。解决拉取nomic-embed-text并在设置中选用或关闭向量模式开关。构建失败现象bun install或bun run build报错。原因Bun 运行时在部分系统上兼容性不稳。解决README 明确说明可用 npm 替代 bun命令对应替换即可。适合谁不适合谁Page Assist 最适合已有 GPU 能跑本地模型、又对网页内容隐私敏感的人读长文、翻译外文页面、基于本地文件提问全程可以离线完成。反过来如果你没有 Ollama 或任何本地推理服务或者主要需要云端 API 的能力超长上下文、复杂推理它的价值就很有限。源码为 MIT 协议仓库地址与上文 clone 命令相同具体细节可查官方文档 docs/ 和连接排查 docs/connection-issue.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),仅供参考
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进