Page Assist 本地 AI 模型浏览器扩展排查指南安装、连接与快捷键修复【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assistPage Assist 是一款让你在任何网页上直接和本地 AI 模型对话的浏览器扩展。本文整理了从源码安装到日常使用中常见的 4 个卡点bun install报错、扩展加载失败、Ollama 连接 403、快捷键无响应带你逐个完成自助修复。安装阶段环境依赖与编译报错修复 bun install 提示 command not found现象复现终端里执行bun install时报bun: command not found或者刚装完 Bun新开终端依旧提示同样的错误。根因拆解Bun 是独立的 JavaScript 运行时安装后默认落在~/.bun/bin这个目录不一定在你的 PATH 里当前终端会话不会自动读取新写入的环境变量需要重新加载安装脚本可能因网络中断没有执行完导致可执行文件缺失修复步骤克隆项目git clone https://gitcode.com/GitHub_Trending/pa/page-assist进入page-assist目录按官方方式安装 Buncurl -fsSL https://bun.sh/install | bash结束时终端会打印版本号执行echo $PATH | grep .bun/bin验证 PATH没有输出就执行export PATH$HOME/.bun/bin:$PATH运行bun --version能打印版本号说明环境已就绪回到项目根目录执行bun install等待依赖全部拉取完成 如果 Bun 在你的机器上始终不稳定官方 README 建议直接换npm install替代效果一样。 ⚠️ 临时 export 只在当前终端生效记得把 PATH 一行写入.bashrc或.zshrc。排查 build 之后 Chrome 提示无法加载扩展程序现象复现点击「加载已解压的扩展程序」后弹出红色错误提示清单文件缺失或无法加载扩展程序。根因拆解选的是项目根目录而不是编译生成的build目录bun run build会依次构建 Chrome、Firefox、Edge 三个目标没跑完就去加载会缺文件开发者模式没开Chrome 默认禁止加载未签名的本地扩展修复步骤在项目根目录执行bun run build等三个目标全部输出完毕确认build目录已生成打开chrome://extensions开启右上角「开发者模式」点击「加载已解压的扩展程序」选中build目录不要选项目根目录若仍报错用编辑器打开build/manifest.json检查 JSON 语法是否完整加载成功后工具栏出现 Page Assist 图标说明扩展已就位⚠️ 每次改动源码后必须重新执行bun run build否则浏览器里跑的还是旧版本。使用阶段Ollama 连接失败与 403 错误排查 Ollama 直连报错和发送消息 403现象复现打开侧边栏时模型列表是空的提示直连错误或者输入消息点发送直接返回 403。根因拆解Page Assist 通过浏览器与 Ollama 通信浏览器会对跨域请求做 CORS 拦截扩展内置的 Origin 头重写只对http://127.0.0.1:*和http://localhost:*生效Ollama 服务没启动或监听在局域网地址而非 localhostOllama 服务端的OLLAMA_ORIGINS限制拒绝了扩展来源的请求修复步骤执行ollama list确认 Ollama 服务在运行能列出模型点击工具栏 Page Assist 图标进入设置切到Ollama Settings标签页展开Advance Ollama URL Configuration启用Enable or Disable Custom Origin URL如果你改过端口同步把Custom Origin URL改成对应端口然后点Save仍出现 403 就设置环境变量OLLAMA_ORIGINS*并重启 Ollama 服务再回侧边栏重新发送⚠️ 不要把 Custom Origin URL 填成 Ollama 服务器地址完整对照可看仓库里的 Ollama 连接问题。使用阶段快捷键与侧边栏调不出排查 CtrlShiftY 无法调出 Page Assist 侧边栏现象复现按下默认快捷键CtrlShiftY没有任何反应或者反而触发了系统截图、输入法切换。根因拆解快捷键组合被系统或其他扩展占用扩展重新加载后commands 的快捷键映射丢失浏览器快捷键设置页里残留了错误的旧绑定修复步骤地址栏输入chrome://extensions/shortcuts找到 Page Assist 条目点击Open the side panel对应的输入框按下新组合比如CtrlShiftQ先在文本编辑器里试一下新组合确认不会触发别的系统功能打开任意网页按下新快捷键侧边栏从右侧滑出即配置成功Firefox 用户改走about:addons→ 设置 →Manage Extension Shortcuts 应用内快捷键如CtrlE切换对话模式和修改方法都在 快捷键文档 里有完整列表。还卡住了在项目仓库提交 issue 时附上这 6 项信息回复会快很多操作系统及版本浏览器及版本Chrome / Firefox / EdgePage Assist 版本源码版本号或商店版本出问题的具体操作步骤完整报错文字或截图Ollama 版本与启动方式连接类问题必填项目 issue 区适合报告 bug 和连接异常维护者通常 24 小时内回复仓库docs/目录文档适合查功能说明、Ollama 配置等细节README 里提供的社区群组适合实时交流玩法和功能建议别急离跑通只差一步。【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assist创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考