Page Assist 新手排障指南侧边栏本地 AI 对话的 3 类高频问题一次讲清【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assistPage Assist 是一款在任何网页上唤起侧边栏、直接和本地 AI 模型对话的浏览器扩展。本篇故障排查指南按新手踩坑的自然顺序把 Ollama 端口冲突、扩展加载失败、快捷键不生效这 3 类常见问题一次讲清每一步都告诉你怎么查、怎么确认修好了。Ollama 连不上、端口冲突本地模型服务起不来的排查方法先别急扩展装好了模型却连不上这件事九成不在扩展身上。先对号入座你看到的是哪种现象你看到的现象多半是什么情况侧边栏提示连不上 Ollama发消息报 403跨域限制拦住了连接跨域浏览器默认不让扩展和别的地址直接通信终端里 Ollama 启动一下就退出提示 11434 端口已被占用端口冲突11434 是 Ollama 默认工作端口被别的程序占了执行构建命令时提示 command not found系统没找到 Bun 这个构建工具Bun 是下载依赖、打包扩展用的运行时环境三步查清楚排查动作具体做法为什么有效第 1 步确认 Ollama 真的在跑终端执行ollama serve手动拉起服务能立刻分清没启动还是起不来问题范围缩小一半第 2 步查 11434 端口是否被占终端执行lsof -i :11434结束占用进程端口只能被一个程序独占清掉占用方Ollama 才能绑回默认端口第 3 步仍连不上就放开跨域限制按 Ollama 连接问题文档 操作在扩展设置里启用自定义 Origin URL或按系统设置OLLAMA_ORIGINS环境变量这一步相当于给 Ollama 发放行签证浏览器不再拦截扩展发来的请求⚠️ 三个系统的差别只有一处设置OLLAMA_ORIGINS的方式不同Windows 改环境变量macOS 和 Linux 在终端导出文档里都写好了照抄即可。另外 Windows 没有lsof用系统自带的netstat查端口就行。如果你卡在 Bun 装依赖这一步README 给了一条兜底路线把命令里的bun换成npm再跑一遍效果一样。修好长什么样✅ 扩展设置里的 Ollama 页签能刷出模型列表并且你在侧边栏发一句你好能收到回复——到这一步本地链路就算全部打通了。防复发的小习惯每次重启电脑后先确认 Ollama 的托盘图标Windows或菜单栏图标macOS亮着再去用侧边栏。改过端口或 Origin 配置后记得先重启 Ollama 服务再回扩展里试。Chrome 扩展加载失败manifest 报错、加载已解压装不上的解法病根其实就一句话Chrome 只认打包好的构建产物build目录不认源码目录——你看到的红色报错多数是还没构建或选错了文件夹。三种场景分别这样处理场景一提示清单文件无效或根本找不到 manifest先确认仓库已拉到本地首次使用才需要仓库地址就一条命令git clone https://gitcode.com/GitHub_Trending/pa/page-assist cd page-assist bun run build然后打开build目录确认里面有manifest.json——这是 Chrome 识别扩展的身份证缺了它一定加载失败。场景二页面提示需要先开启开发者模式到chrome://extensions打开右上角的开发者模式开关。这是 Chrome 允许加载本地未签名扩展的前提不开这个开关加载按钮就是灰的。场景三重新加载过报错却一点没变注意一下多半是浏览器还在读旧的缓存文件先把 Page Assist 从扩展列表移除再点加载已解压的扩展程序这次选中build目录本身而不是项目根目录——选错文件夹等于白加载。如果你在 Firefox 里安装走的是另一条路about:addons→ 加载临时附加组件选build目录里的manifest.json文件。装好的验收标准✅ 扩展列表里 Page Assist 显示已启用没有任何红色报错点工具栏图标能打开 Web UI。两条都满足才算真正装好。✅build目录里应包含manifest.json和编译后的脚本文件缺哪个都不行⚠️ 改过源码却没重新构建build里永远是旧版本错误不会自己消失⚠️ 浏览器不是万能适配Opera、Arc 目前不支持侧边栏功能完整对照表见 浏览器支持文档扩展快捷键不生效CtrlShiftY 按了没反应怎么办先分清是哪种没反应没反应其实分两种处理方式完全不同侧边栏压根没弹出→ 快捷键本身可能没生效走下面的检查清单弹出了但同时触发了别的功能比如切输入法、系统截图 → 组合键被系统或其他软件抢走了直接换一个组合对照清单逐项检查确认用的是扩展级快捷键Page Assist 默认CtrlShiftY开侧边栏、CtrlShiftL开 Web UI完整快捷键表见 docs/shortcuts.mdChrome、Edge、Brave 等 Chromium 系地址栏打开chrome://extensions/shortcuts找到 Page Assist 一行确认快捷键没有被清成空Firefox 系打开about:addons点设置图标进管理扩展快捷键同样核对一遍确认你的浏览器支持侧边栏Opera、Arc 不支持快捷键再对也没用对照 浏览器支持文档⚠️ 中文输入法开着时部分CtrlShift开头的组合会被输入法截走先切到英文状态再按一次 换组合时优先挑CtrlShift字母这类和系统快捷键撞车的概率最小改完不用重启浏览器当场按一次就能看到效果。怎么确认修好了✅ 在任意网页按下新组合键侧边栏从右侧滑出来——这一帧出现说明快捷键已经正常工作。如果快捷键实在配不好也别卡住右键网页空白处选打开 Page Assist 侧边栏或者右键工具栏图标选Open Sidebar两条路都不依赖快捷键详见 侧边栏文档。问题还没解决反馈渠道与提交模板issue 提交模板复制下面模板按空行填写问题类型[环境配置 / 扩展加载 / 快捷键 / 模型连接 / 其他] 环境信息 - 操作系统[如 Windows 11 / macOS 14 / Ubuntu 24.04] - 浏览器及版本[如 Chrome 131.0.x.x] - Page Assist 版本[如 v1.0.x] 复现步骤 1. [第一步] 2. [第二步] 3. [预期结果____实际结果____] 相关日志 [粘贴报错信息或终端输出]社区支持渠道官方文档docs 目录功能说明、快捷键、连接问题都有对应页面讨论区Discussions提问前先搜一遍关键词很多新坑已经有人踩过交流群README 里给了 Discord 入口适合实时交流⚠️ 两个小提醒提 issue 前先搜索已有问题列表避免重复提问日志里如果出现 API 密钥、代理地址等敏感信息先自查一遍脱敏后再贴。 排障顺序别乱先确认 Ollama 在跑 → 再确认扩展装好了 → 最后才调快捷键。多数玄学问题倒过来看其实是最前面那一步没打通。【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assist创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考