企业官网建设流程全解析

网页侧边栏接上本地 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 模型接进每个网页，模型跑在你自己的电脑上，页面内容不出网。

不复制、不切窗口：侧边栏与 Web UI 双入口怎么用

它最直接的价值，是替你省掉"选中文字、复制、切窗口、粘贴"这一整套动作。读技术文章或外文资料时，侧边栏里就能直接讨论当前页面——"这段讲了什么""帮我总结""这段代码怎么理解"，当场得到答案。按下快捷键又能进入功能完整的 Web UI，管理聊天、配置模型；侧边栏与 Web UI 两个入口，让 AI 助手始终待在你的浏览动线里。

跑通本地 AI 模型最快配置方法：源码、Bun、Ollama 三件套

开始之前，先备齐三样东西：

• 项目源码：执行git clone https://gitcode.com/GitHub_Trending/pa/page-assist，后文所有操作都基于这个项目目录。
• Bun：项目的构建运行时。用bun --version验证，能打印版本号即成功。缺了它，扩展包根本构建不出来，后面加载扩展无从谈起。
• Ollama：本地模型的运行环境。用ollama --version验证，并确认 Ollama 服务已启动。缺了它，扩展装好也没有模型可聊，第一次对话必然失败。

把扩展装进 Chrome 的一键加载步骤：开发者模式到 build 目录

先打开扩展管理页 chrome://extensions/，把右上角"开发者模式"开关打开——这个模式是让 Chrome 允许加载商店之外扩展包的前提。

回到项目目录执行构建。所谓构建，就是把源码编译成 Chrome 能识别的扩展包的过程；要跑的是 package.json 脚本里的 build:chrome 一项。构建成功的标志，是项目根目录下多出一个 build 目录——看到它，这一步才算走对。

最后回到扩展管理页，点"加载已解压的扩展程序"，选中 build 目录本身。加载成功后，工具栏会出现 Page Assist 图标，按下默认快捷键 Ctrl+Shift+Y，网页右侧就能弹出侧边栏——看到这一现象，说明前面每一步都对了。

两个坑值得单独说：

最容易卡住的地方：很多人默认选中整个项目根目录，而 manifest.json（扩展的"身份证"，告诉 Chrome 这个扩展是什么、有什么权限）在 build 目录里。选错，就会看到"清单文件缺失或不可读取"一类的报错。

若提示 manifest 存在 JSON 语法错误，多半不是配置问题，而是构建没跑完整——重跑一次构建脚本，再重新加载即可。

第一次对话从哪里发起：默认快捷键与冲突换键自测法

扩展提供两组默认组合键：Ctrl+Shift+Y 打开侧边栏，Ctrl+Shift+L 打开 Web UI。你的第一次对话就从这里发起——打开任意网页，按下组合键即可。

按了没反应时，先怀疑组合键被占用：进入 Chrome 的快捷键设置页 chrome://extensions/shortcuts，找到 Page Assist 条目，换成不常用的组合。

改完做一次自测：打开任意网页，按新组合键——侧边栏（或 Web UI）弹出来即设置生效；仍无反应，就检查是否被另一个扩展占用了同一组合键。

装完对不上号？按现象排查的 4 类故障速查路径

开聊之前卡住了，按现象对号入座：

• 如果你看到安装依赖或构建长时间卡住 → 多半是 Bun 版本过旧或网络受限 → 升级到最新 Bun 后重新安装依赖。
• 如果你看到加载时提示"清单文件缺失或不可读取" → 多半是选了项目根目录而非 build 目录 → 重新点"加载已解压的扩展程序"，这次选中 build 子目录。
• 如果你看到按快捷键毫无反应 → 多半是组合键与系统或其他扩展冲突 → 到快捷键设置页更换组合键（方法见上一节）。
• 如果你看到打开扩展后模型无响应 → 多半是 Ollama 服务未启动，或还没有可用模型 → 启动 Ollama 服务、拉取一个模型后再试。

到这里，你的本地 AI 网页助手已经就绪。更多功能细节见官方文档，想深入实现原理，直接读源码 src/ 🙂

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