企业官网建设流程全解析

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

Page Assist 是一款开源 Chrome 扩展，让你在任何网页的侧边栏里直接与本地运行的 AI 模型对话。想在浏览网页时随手用上 AI、又不想把内容交给云端？这篇上手指南带你从装环境到第一次对话全部走通。

先判断值不值得装：两个高频场景

• 和当前网页一起读：阅读技术文章或外文资料时，打开侧边栏就能问“帮我总结这一段”“这段代码怎么理解”，不用复制文本、不用切窗口。
• 一键弹出的管理台：按一下快捷键就进入完整的 Web UI，管理历史会话、配置模型和知识库。

值得留意的数据边界：模型跑在你自己的电脑上，网页内容全程不上传任何第三方服务，这也是本地 AI 方案最大的安心点。

加载扩展前，先完成这 3 项检查

1. 备好源码：终端执行git clone https://gitcode.com/GitHub_Trending/pa/page-assist。判据：终端里出现 page-assist 目录，后文所有操作都基于它。
2. 装上 Bun：项目用它安装依赖和构建扩展。执行bun --version，判据：打印出版本号。没有它，扩展包构建不出来，后面全部无从谈起。
3. 装上 Ollama：本地模型运行时。执行ollama --version，判据：打印版本号且服务已启动。没有它，扩展装好了也没有模型可对话，第一次聊天就会失败。

4 步完成首次运行，一步一个验证点

1. 打开开发者模式动作：进入扩展管理页 chrome://extensions/，打开右上角“开发者模式”开关。 看到什么算对：页面左上方出现“加载已解压的扩展程序”按钮。 出错怎么办：开关找不到，说明你进错了页面，确认地址栏是扩展管理页而不是快捷键设置页。

2. 先构建，再谈加载动作：在项目目录用 Bun 运行构建脚本（package.json 里的 build:chrome），等它生成项目根目录下的 build 目录。 看到什么算对：build 目录出现，里面能看到 manifest.json。 出错怎么办：若后续加载时提示 manifest 有 JSON 语法错误，通常是构建没跑完整，重跑一次构建脚本即可。

3. 加载扩展——新手最容易选错目标的一步动作：点“加载已解压的扩展程序”，选择build 目录本身。 看到什么算对：扩展出现在列表里，浏览器工具栏多出 Page Assist 图标。 为什么这里容易错：很多人默认选中整个项目根目录，而 manifest.json 在 build 里，选错就会看到“清单文件缺失或不可读取”的报错。

4. 验证真的能用动作：在任意网页按默认快捷键 Ctrl+Shift+Y。 看到什么算对：网页右侧弹出侧边栏，输入一句话能收到模型回复。 出错怎么办：快捷键没反应，多半是组合键冲突，对照下一节排查。

出问题了，按这 4 个症状自查

• 症状：装依赖或构建卡住→ 先查 Bun 版本是否过旧、网络是否受限。怎么改：升级到最新 Bun 后重新安装依赖再构建。
• 症状：加载时提示 manifest 缺失或不可读取→ 先查加载时选中的目录。怎么改：9 成是选了项目根目录，重新加载并选 build 子目录。
• 症状：按快捷键没反应→ 先查该组合键是否被系统或其他扩展占用。怎么改：到 chrome://extensions/shortcuts 给 Page Assist 换一个不常用的组合。
• 症状：打开扩展后模型无响应→ 先查 Ollama 服务是否启动、是否已拉取过模型。怎么改：启动服务并拉取一个模型，再试一次对话。

默认快捷键与改键方法

扩展预置两组组合键：Ctrl+Shift+Y 打开侧边栏，Ctrl+Shift+L 打开 Web UI。被占用时，进 Chrome 快捷键设置页找到 Page Assist 条目替换掉即可。改完的自测方法：打开任意网页按新组合键，侧边栏或 Web UI 弹出来即生效；仍无反应，再查是否有另一个扩展占用了同一组合。

至此，这台电脑上的本地 AI 网页助手已经就绪。更多功能细节见官方文档，想深入实现原理可直接阅读源码 src/。🎉

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