企业官网建设流程全解析

Page Assist 完全实战指南：4步在浏览器侧边栏接入本地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 模型直接出现在当前网页的侧边栏里，不用换标签页就能提问，所有对话内容都保留在你的浏览器中。

先搞清楚它是什么：本地 AI 助手和云端聊天有什么区别

Page Assist 是一个开源（MIT 协议）浏览器扩展，核心就三块东西：任意网页上可打开的侧边栏、一个类似 ChatGPT 网页版的独立 Web UI、以及"与当前网页对话"的能力。它和云端 AI 服务的差异，可以用这几条可验证的事实说清：

• 模型跑在你自己的机器上：支持 Ollama、Chrome AI（Gemini Nano）以及任何兼容 OpenAI API 的端点（如 LM Studio、llamafile），默认不依赖任何远程大模型服务
• 数据存哪里一目了然：对话历史、设置、知识库全部保存在浏览器本地存储，代码完全开源可自查
• 离线也能用：只要本地模型服务在运行，断网状态下侧边栏照常工作

核心卖点一句话：你的提问内容只发往你自己机器上运行的模型；唯一例外是你主动使用"分享对话"功能时才会产生对外通信，且该功能可在设置中关闭。

快速上手：4步把扩展部署到浏览器

先确认三样东西就位：

然后按顺序执行下面四步：

1. 克隆项目仓库

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

2. 安装项目依赖

bun install

3. 构建扩展（一次构建会同时产出 Chrome、Edge、Firefox 三个版本）

bun run build

4. 加载扩展。Chrome 系浏览器打开chrome://extensions，开启"开发者模式"，点"加载已解压的扩展程序"，选中build目录；Firefox 则在about:addons里选择"加载临时附加组件"，指向build目录中的manifest.json。

避坑提示：如果bun install或bun run build报错，项目官方建议直接用npm替代bun重跑这两条命令，大多数情况即可解决。

加载成功后，工具栏会出现 Page Assist 图标——到这一步，扩展就已经在跑你的本地模型上了。

功能演示：先跑通 3 个高频任务

跑起来只是第一步，真正高频的动作是下面三件。每个任务都按"你要做什么→怎么操作→得到什么"来走。

把当前长文总结成要点，还能追问

你要做什么：总结眼前这篇文章，并对某个段落追问细节。

怎么操作：

1. 按Ctrl+Shift+Y打开侧边栏
2. 打开Chat with Website开关
3. 直接输入"把这篇文章总结成 5 条要点"，之后可以继续追问

得到什么：回答会引用当前网页内容，而不是凭空作答。Ctrl+E可以在"普通聊天"和"结合当前页面聊天"两种模式间切换。如果你不想走向量检索（RAG），可以在侧边栏设置里关闭Chat with website using vector embeddings，改由"普通模式网页内容大小"控制直接发给模型的页面文本量，细节见 侧边栏对话文档。

不下终端，把 Ollama 模型拉进本地

你要做什么：新增或清理本地模型，全程不碰命令行。

怎么操作：

1. 点扩展图标进入 Web UI，或按Ctrl+Shift+L打开
2. 进入Settings→Manage Models，已拉取的模型会列出来，可删除
3. 点Add New Model填模型名并Pull Model；或者更省事——浏览 Ollama 官网或 Hugging Face 的模型页时，页面上会出现 Pull 按钮，点一下就开始下载

得到什么：下载进度显示在扩展图标上，完成后模型立刻可在聊天中选择。Ollama 之外，设置里也能填兼容 OpenAI API 的端点地址。不同来源适合什么场景：

更多接入细节见 提供商文档。

对着自己的 PDF 和 CSV 提问

你要做什么：让模型基于你本地的文档回答，而不是靠它"记起来"。

怎么操作：

1. 先在 RAG 设置里指定一个 embedding 模型（官方推荐nomic-embed-text，注意不要选纯文本对话模型）
2. 进入Settings→Manage Knowledge，点Add New Knowledge上传文件
3. 回到聊天输入框，点旁边的知识库图标，勾选要引用的文档
4. 提问

得到什么：回答会带上你文档中的内容作为依据。支持的文件格式：

注意：知识库没有服务端，向量化在浏览器本地完成并存在浏览器存储里，大文件会占用不少空间，详见 知识库文档。

进阶玩法：快捷键怎么配最顺手

Page Assist 的快捷键分两层：浏览器层面管"打开入口"，应用层面管"聊天操作"。

按场景给两条选型建议：

• 高频在网页里问答：把Ctrl+Shift+Y（打开侧边栏）和Ctrl+E（切页面模式）设为无冲突的组合，形成"打开→切换→提问"的肌肉记忆；Chromium 系浏览器在chrome://extensions/shortcuts修改，Firefox 在about:addons的扩展快捷键管理里改
• 多份文档并行问答：保留Ctrl+B快速开合历史栏，用Ctrl+Shift+O一键开新对话，避免旧上下文互相污染

浏览器兼容方面，Chrome、Brave、Edge、Firefox、Vivaldi、LibreWolf、Zen Browser 的侧边栏、网页对话、Web UI 三项功能全部可用；Opera 和 Arc 因不支持侧边栏 API，只有 Web UI 可用。完整矩阵见 浏览器支持文档。

常见报错排查清单

按出现频率从高到低排：

1. 现象：发消息时提示连接失败或直接连接错误，甚至返回 403。原因：Ollama 只监听本机地址，而扩展请求经过的 Origin 与 Ollama 的访问控制对不上（CORS 问题）。解决：在设置里检查 Ollama URL 是否正确，并启用/配置自定义 Origin 选项，见 连接问题文档。

2. 现象：知识库上传后处理慢、浏览器整体卡顿。原因：向量化和存储都在浏览器本地完成，大文件会产生大量向量数据。解决：大文档拆小再传，定期清理不用的知识库和对话历史释放浏览器存储。

3. 现象：安装好扩展后模型列表是空的。原因：Ollama 没在运行，或者本机还没有拉取过任何模型。解决：启动 Ollama 服务，然后在Manage Models里拉取一个模型即可，无需打开终端。

4. 现象：Ctrl+Shift+Y等快捷键无反应。原因：被浏览器或其他扩展占用了同一组合键。解决：到扩展快捷键设置页换一组键位。

5. 现象：在 Opera 或 Arc 里打不开侧边栏。原因：这两个浏览器不支持扩展侧边栏。解决：改用 Chrome、Edge、Firefox 等浏览器，或在 Opera/Arc 中仅使用 Web UI。

文档与生态：接下来去哪看

关于数据流向，三个设计决策值得知道：

• 不收集任何用户数据，代码里没有接入任何第三方统计或追踪服务
• 全部本地存储：对话历史、设置、知识库向量都存在浏览器本地，你随时可以审查 MIT 协议的源码验证这一点
• 对外通信只有一个触发点：你主动使用分享功能时才会连接服务器，且该功能可关闭、分享内容可随时删除

写在最后

Page Assist 把本地 AI 从"要切出去用的网站"变成了"随手可问的侧边栏"。现在就可以按前面的 4 步完成部署，然后在任意一个长网页上按Ctrl+Shift+Y试试你的第一句提问。

建议的上手路径：先只装 Ollama + 侧边栏对话跑通网页问答 → 再配置 embedding 模型启用知识库 → 最后按需调快捷键和接入更多模型端点，每加一层都有明确的收益。

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