Page Assist 故障排查本地 AI 浏览器扩展从零跑通4 个新手坑快速讲清【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assistPage Assist 是一个开源浏览器扩展让你在任意网页旁边就能直接和本地 AI 模型聊天。这篇 Page Assist 故障排查指南带你把项目从零跑通并提前绕开新手最容易卡住的 4 个环节依赖装不上、扩展加载失败、快捷键失灵、Ollama 连不上。这篇文章适合谁刚 clone 完 Page Assist依赖还没装上的新手点加载已解压的扩展程序却弹出红字报错的人按了默认快捷键没反应或弹出别的软件的人扩展装好了发消息却连不上 Ollama 的人依赖 / 环境要求Bun已安装bun --version能显示版本号Ollama已启动ollama --version能显示版本号浏览器Chrome、Edge 或 Firefox能进开发者模式排查前 30 秒自检终端里敲git clone https://gitcode.com/GitHub_Trending/pa/page-assist确认代码能完整拉下来。接着跑bun --version和ollama --version两个都能显示版本号才算依赖就绪。然后开浏览器访问http://localhost:11434确认 Ollama 端口是通的。再确认项目根目录跑过bun run build生成了build目录。走完这四步后面排查基本都有据可查。Bun 或 Ollama 装完没反应怎么排查敲bun --version提示命令未找到刚装完 Bun 一敲就报命令未找到别慌八成是环境变量没生效。装完 Bun 后关掉当前终端重新开一个再敲bun --version。还不行就输入echo $PATHWindows 用echo %PATH%看输出里有没有~/.bun/bin。没有就手动加进环境变量保存后重启终端。这时候再敲一次版本号能打印出来就搞定了。顺便说一句Linux/macOS 安装命令报权限错误时在命令前加sudoWindows 记得用管理员身份开终端。Page Assist 故障排查Chrome 加载扩展失败最快修复法点了加载已解压的扩展程序弹红字无法加载红字错误还不说具体原因挺崩溃的。按这个顺序来基本都能搞定。先打开chrome://extensions确认右上角开发者模式开关是亮着的。接着回项目根目录跑bun run build等它跑完确认生成了build目录。然后点加载已解压的扩展程序选中的必须是build目录本身不是项目根目录。还报错就用编辑器打开build里的manifest.json看有没有语法错误。最容易忽略的坑改了源码后build目录不会自动更新记得重新跑一遍bun run build。快捷键没反应Page Assist 侧边栏快捷键冲突怎么解决按CtrlShiftY没反应还弹出了别的软件默认快捷键按下去一点动静没有多半是和其他软件撞车了。地址栏输入chrome://extensions/shortcuts直达快捷键设置页。往下翻找到 Page Assist看打开侧边栏那条现在绑的是什么组合键。点进输入框重按一个组合比如CtrlShiftP注意下面有没有冲突提示有就再换一个。然后随便开个网页按新快捷键侧边栏弹出来就说明解掉了。全部清单在 快捷键文档 里可查Web UI 默认是CtrlShiftL。挑键小技巧优先用CtrlShift字母或AltShift字母和系统快捷键撞车的概率最低。Page Assist 故障排查Ollama 连不上、发消息报连接错误怎么办模型选好了一发消息就提示连接失败侧边栏打开、模型也选了一发消息就报错新手踩这个坑最多。先在终端敲ollama --version确认服务活着不行就重启 Ollama。接着浏览器打开http://localhost:11434能出页面说明端口是通的。这时候进 Page Assist 的 Ollama 设置展开高级 URL 配置打开启用自定义 Origin URL再保存。还连不上就在系统环境变量里加OLLAMA_ORIGINS*然后重启 Ollama。每种系统的加法连接问题文档 里都写好了。注意Ollama 跑在默认端口 11434 时不用配地址Page Assist 会自动识别先别急着改配置。一张表搞定的速查四条对号入座之后这里再留一张速查表下次卡住瞄一眼就能定位。症状关键词第一步该做什么常见原因bun 命令未找到重开终端再敲bun --version环境变量没生效无法加载扩展开开发者模式重新bun run buildbuild 目录缺失或过期快捷键无反应进chrome://extensions/shortcuts看绑定与其他扩展冲突Ollama 连不上敲ollama --version确认服务Ollama 没启动或 CORS 限制四行看完基本能覆盖大部分新手卡点。还卡住了下一步去哪找答案官方文档首页docs/index.md安装和功能说明都在这里Ollama 配置与多实例docs/providers/ollama.md设置项全集docs/settings.md等它顺利跑起来那天你会想谢谢现在跟着这份指南一步步走的自己。【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assist创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
