快速上手 Page Assist：在浏览器侧边栏与本地 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 是一款开源浏览器扩展：在任何网页打开 AI 侧边栏，和你本地运行的 AI 模型对话。模型跑在你自己电脑上，页面内容和聊天记录不离开设备，这是它最大的卖点。
适合人群：
- 浏览网页时想随手问 AI，又不想把页面内容交给云端服务的人
- 已经装好 Ollama 等本地模型、只缺一个浏览器入口的人
- 想从源码加载扩展、而不是从应用商店安装的人
场景引入：想在网页上用本地 AI 模型的时候
- 读一篇外文长文，想问"这段是什么意思"，可把文字复制进云端聊天工具又总觉得不妥。
- 工作中对着一个页面整理思路、写段回复，希望旁边直接有个完整的聊天界面，不用来回切窗口。
最小依赖清单：开始前三件工具
- Bun—— 负责安装项目依赖和构建扩展。用
bun --version验证，能打印版本号即可。不可跳过，没有它扩展构建不出来。 - Ollama—— 本地模型运行时，提供对话用的模型。用
ollama --version验证并确认服务已启动。如果你已经在用 LM Studio 等 OpenAI 兼容的本地运行环境，这一项可以跳过。 - Git—— 用来拉取源码。用
git --version验证，多数电脑自带，有就跳过安装。
从零跑通：构建并加载扩展的 4 个步骤
拿到项目源码
把整个项目下载到电脑，后面的操作都在这个目录里进行。
git clone https://gitcode.com/GitHub_Trending/pa/page-assist
目录下出现新的page-assist文件夹，说明代码拿全了。
用 Bun 安装依赖
进入项目目录执行这条命令，Bun 会一次性装好项目用到的全部包。
bun install
输出跑完且没有红色报错，依赖就绪。
最容易卡住的地方：安装长时间卡住多半是 Bun 版本过旧或网络受限，升级到最新 Bun 再重跑一次即可。
构建 Chrome 版扩展
这一步把源码编译成浏览器能加载的扩展包。
bun run build:chrome
项目根目录下多出一个build目录，里面能看到manifest.json，说明构建成功。
把扩展加载进 Chrome
打开chrome://extensions/，把右上角的"开发者模式"开关打开。
点"加载已解压的扩展程序"，选中刚刚生成的build目录。
扩展列表里出现 Page Assist、工具栏多出它的图标，加载成功。
最容易卡住的地方：文件选择器必须选
build目录。选了项目根目录会报"清单文件缺失或不可读取"，因为 manifest.json 在build里面，退回去选对位置再试。
验证与排障：扩展加载报错怎么办
跑通后的样子：打开任意网页按Ctrl+Shift+Y，右侧弹出侧边栏，输入"你好"本地模型直接回复。默认地址下的 Ollama 会被自动识别，服务开着就不用额外配置。
| 现象 | 原因 | 解法 |
|---|---|---|
| 装依赖或构建卡住 | Bun 版本过旧、网络受限 | 升级最新 Bun 后重跑bun install |
| 按快捷键没反应 | 组合键被其他应用或扩展占用 | 在chrome://extensions/shortcuts换一个组合键 |
| 侧边栏能开但模型不回复 | Ollama 服务没启动或没拉模型 | 启动服务、拉一个模型再试 |
进阶与资源
想用"与网页对话"、知识库、MCP 这些功能，从官方文档开始看；对实现感兴趣，直接翻源码。
接下来可以试的轻量玩法：先拉一个小模型，在任意网页打开侧边栏，切到"与当前页面对话"模式，让模型基于眼前内容回答，这是它最好用的地方。
跑起来之后，怎么用就交给你和模型了。🙂
【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assist
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
