企业官网建设流程全解析

Page Assist 快速上手指南：3 步让本地 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 是一款开源浏览器扩展，把 Ollama 等本地 AI 模型的对话能力装进任意网页的侧边栏，并提供一个完整的 Web UI，适合想让网页浏览随时调用本地模型、又不愿把内容交给云端服务的人。本文基于仓库源码，带你从零跑通构建、加载到第一次对话。

动手前，先确认这三样东西都就位

扩展本身不内置模型，它依赖一个本地模型服务。依次做三件事：

1. 拿到源码。执行git clone https://gitcode.com/GitHub_Trending/pa/page-assist，进入目录。
2. 安装 Bun 运行时。执行bun --version，看到版本号输出即就绪；如果提示命令不存在，说明 Bun 没装好，处理：到 Bun 官方安装指南装完后再验证一次。
3. 安装 Ollama 并拉一个模型。执行ollama list，看到模型列表即就绪；如果列表为空，处理：先执行ollama pull拉取一个对话模型，并确认 Ollama 服务已启动。

三条验证命令都能输出预期结果，就可以进入构建。

构建并加载扩展，关键是选对目录

在仓库根目录先执行bun install安装依赖，再执行bun run build:chrome只构建 Chrome 版。构建成功后仓库根目录会生成build目录——这是最直观的完成信号。

然后打开chrome://extensions，开启右上角"开发者模式"，点"加载已解压的扩展程序"，选择build目录。工具栏出现 Page Assist 图标，说明加载成功。

如果出现"清单文件缺失或不可读取"，说明你选的是仓库根目录而不是build目录（manifest.json 在build里），处理：重新选择build子目录加载。

第一次对话：按 Ctrl+Shift+Y 验证侧边栏

打开任意网页，按默认快捷键Ctrl+Shift+Y，网页右侧滑出侧边栏即成功；它也能通过右键菜单的Open Page Assist Sidebar打开。侧边栏里发消息后模型正常回复，整条链路就通了。

Ollama 跑在localhost:11434时无需任何配置，Page Assist 会自动识别并拉取模型列表，直接选模型开聊即可，还能用"Chat With Webpage"模式针对当前页面提问。

如果发送消息报 403 或连接错误，说明是浏览器跨域（CORS）拦截了扩展与 Ollama 的通信，处理：参考仓库里的连接排障文档，在 Ollama 设置页开启 Custom Origin URL，或为 Ollama 服务设置环境变量OLLAMA_ORIGINS=*后重启。

快捷键没反应时，去快捷键设置页定位

扩展有两个默认快捷键：Ctrl+Shift+Y打开侧边栏，Ctrl+Shift+L打开 Web UI。按了没反应时，先打开chrome://extensions/shortcuts，找到 Page Assist 条目换一个不常用的组合；换完按新组合测试，侧边栏弹出即生效。

如果换了组合仍无反应，说明该组合键被系统或其他扩展占用，处理：逐个排除其他扩展的快捷键占用，再换一组。

到这里，你的本地 AI 网页助手已经可用，源码结构可以顺着 src/ 目录自行探索。想继续了解知识库、MCP、页面操作等完整功能，见官方文档 🙂

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