5分钟搭建Chrome本地AI助手：Page Assist指南-二趣网

5分钟搭建Chrome本地AI助手：Page Assist指南

【免费下载链接】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 模型接进浏览器侧边栏，让你在任意网页上直接提问、总结和翻译。

项目速览

Page Assist 基于 WXT 扩展框架和 React + LangChain 技术栈构建，提供两个入口：侧边栏（在任何网页上与当前内容对话）和 Web UI（一个类似 ChatGPT 网站的完整对话界面）。后端支持三类本地 AI 提供商：Ollama、Chrome 内置的 Chrome AI（Gemini Nano），以及任意 OpenAI 兼容端点（LM Studio、llamafile 等）。它适合两类人：跑本地模型的技术用户，以及不想让内容离开自己设备的普通用户。

动手上手：从克隆到加载

前置条件：安装 Bun 运行时（也可用 npm 替代）、装好 Ollama 并至少下载一个本地模型。

克隆仓库：

git clone https://gitcode.com/GitHub_Trending/pa/page-assist cd page-assist

安装依赖：

bun install

💡 如果 Bun 遇到问题，直接用npm install替代即可。

构建扩展（默认一次性构建 Chrome、Edge 和 Firefox 三个版本）：

bun run build

加载到浏览器：打开chrome://extensions，开启右上角"开发者模式"，点击"加载已解压的扩展程序"，选择build目录。Firefox 用户改为进入about:addons，点击"加载临时附加组件"，选择build目录下的manifest.json。

⚠️ 加载后找不到图标时，先确认选了正确的build目录，且开发者模式已开启。

能力拆解：四个真实使用场景

阅读长文时，侧边栏一键提炼要点

在任意网页按Ctrl+Shift+Y打开侧边栏，开启 Chat with Website 选项：

AI 会读取当前页面内容直接作答，适合追问文章结构、术语含义和结论
默认使用向量检索模式（需配置嵌入模型），也可在设置中关掉 RAG，改为直接发送页面内容的普通模式
用Ctrl+E随时切换两种聊天模式

外语内容即时翻译与改写

在侧边栏中把选中的外文段落发给本地模型，即可翻译、改写或解释，内容不出本机
同样适合询问页面里的背景知识、相关概念
模型跑在本地，没有按 token 计费，也不担心敏感内容

与自己的文档对话：本地知识库

支持 PDF、Word（.docx）、TXT、CSV、Markdown 共 5 种格式
使用前需在 RAG 设置里配置一个嵌入模型，官方推荐nomic-embed-text，不要用文本生成文本的模型
上传处理完成后，在输入框点击知识库图标即可选中文档，让模型基于你的资料回答
文档处理与向量全部在浏览器内完成，不经过服务端

需要完整对话体验时，打开 Web UI

点击扩展图标或按Ctrl+Shift+L，在新标签页打开完整的 Web UI
支持多轮对话历史、模型切换、知识库管理与各项设置
Ctrl+Shift+O新建对话，Ctrl+B展开历史侧栏，Shift+Esc直接聚焦输入框

踩坑速查

问题现象	解决路径
`bun install`失败	确认 Bun 已安装，或改用`npm install`
扩展加载失败	确认已开启开发者模式，且选择的是`build`目录
Ollama 连接报错或 403	在扩展的 Ollama 设置中启用"自定义源 URL"，或设置环境变量`OLLAMA_ORIGINS=*`后重启 Ollama
快捷键无响应	到`chrome://extensions/shortcuts`重新配置
知识库选不出来	确认 RAG 设置里配了嵌入模型，而不是文本生成模型

个性化配置与进阶

快捷键分两层：扩展级（打开侧边栏、打开 Web UI）可在浏览器扩展管理页修改；应用内快捷键（新建对话、切换历史侧栏、聚焦输入框、切换网页对话模式）保持默认。

后端切换在设置页完成：接 Ollama 跑本地开源模型，用 Chrome AI 调浏览器内置的 Gemini Nano，或填 LM Studio 等 OpenAI 兼容端点的地址和模型名，三选一即可。

浏览器兼容性：Chrome、Brave、Edge、Firefox、Vivaldi、LibreWolf、Zen 均完整支持侧边栏、网页对话与 Web UI；Opera 和 Arc 仅支持 Web UI。

快捷键详情：docs/shortcuts.md
Ollama 连接排查：docs/connection-issue.md
知识库说明：docs/features/knowledge-base.md

隐私与数据边界

Page Assist 不收集任何个人数据，对话记录与知识库全部存在浏览器本地存储中。扩展只在主动使用分享功能时才与外部服务器通信，且该功能可在设置中关闭。使用本地模型时，整个流程可以完全离线运行，源码也可自行审计。

接下来你可以

配置一个嵌入模型，上传第一篇 PDF 试试知识库问答
找一篇长文章，用Ctrl+E切换网页对话模式，对比向量检索与普通模式的效果差异

【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assist

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析