快速跑通 Page Assist新手从克隆到网页聊天的 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 模型对话。本文聚焦新手最容易卡住的四类问题依赖安装失败、扩展无法加载、Ollama 连接报错、快捷键冲突。动手前自检清单按顺序核对任何一项不达标就先补上再往下排障终端能跑bun --version并返回版本号若没装 Bun用npm代替即可。终端能跑ollama --version并返回版本号说明本地 AI 服务Ollama一个在你电脑上跑大语言模型的后台程序已装好。仓库已克隆且执行bun install后生成了node_modules目录。执行bun run build后生成了build目录——加载扩展时要选它不是仓库根目录。浏览器是 Chrome、Brave、Edge、Firefox 等受支持版本Opera 和 Arc 不支持侧边栏功能。Ollama 默认跑在localhost:11434时 Page Assist 会自动识别无需额外配置。装依赖卡住或报 Bun 相关错误换 npm 兜底触发场景执行bun install时终端报版本不兼容、网络超时或压根找不到bun命令。快速判断单独运行bun --version。若报「command not found」或版本号过旧就是运行时的锅不是代码问题。处置动作打开终端确认能打印bun --version不行就按官方说明装好并把路径加进环境变量。仍报错时把后续所有命令里的bun换成npmnpm install装依赖、npm run build构建。构建命令是串联的npm run build会依次产出 Chrome、Firefox、Edge 三个版本的扩展。验证收尾build目录下出现chrome、firefox、edge三个子目录各含一个manifest.json就算构建成功。加载扩展提示无法加载三步定位目录触发场景按流程去浏览器加载刚构建的扩展却报「无法加载扩展程序」或找不到 manifest。快速判断检查你选中的文件夹里有没有manifest.json。选错层级选了仓库根目录而非build下的浏览器子目录是最常见原因。处置动作打开扩展管理页Chrome 系访问chrome://extensionsFirefox 访问about:addons。Chrome 系打开右上角「开发者模式」开关Firefox 点击「管理您的扩展程序」再点「加载临时附加组件」。选中build目录下对应浏览器的子目录Chrome 选chromeFirefox 选firefox里的manifest.json别选仓库根目录。验证收尾扩展列表出现 Page Assist 且状态为「已启用」点击工具栏图标能弹出 Web UI 即成功。发消息报 403 或连接被拒Ollama 跨域拦截触发场景侧边栏里点发送消息发不出去提示 403 或直接连接失败。快速判断浏览器能正常打开http://localhost:11434说明 Ollama 本身活着报 403 就是跨域CORS浏览器阻止不同来源页面互访拦截了扩展的请求。处置动作打开 Page Assist点工具栏图标进入 Web UI再点设置图标。切到 Ollama Settings 选项卡展开「Advance Ollama URL Configuration」。打开「Enable or Disable Custom Origin URL」开关自定义地址默认保留不动点 Save。若 Ollama 改过端口再把 Custom Origin URL 改成对应端口。验证收尾重新发一条消息能收到模型回复即通。仍报错时在系统环境变量里设OLLAMA_ORIGINS*并重启 Ollama 服务再试。快捷键没反应或被抢去浏览器改映射触发场景按默认键CtrlShiftY想开侧边栏没反应或触发了别的应用/扩展。快速判断确认浏览器支持侧边栏Opera、Arc 除外再确认没被其他扩展占用同一组合键。处置动作Chrome 系访问chrome://extensions/shortcuts找到 Page Assist。把「Open Sidebar」改成一个空闲组合键避开系统常用键。Firefox 在about:addons里点设置图标进「Manage Extension Shortcuts」改。验证收尾在任意网页按新按键侧边栏能弹出即生效。应用内快捷键如CtrlE切换对话模式不受浏览器影响无需改。防坑清单构建产物分三份加载时认准与当前浏览器同名的子目录选错层级是「无法加载」的头号原因。bun出问题别死磕npm全流程可平替README 也明确给了这个退路。跨浏览器复制经验时先看支持矩阵侧边栏在 Opera、Arc 上不可用不是 bug。改了 Ollama 端口后记得同步更新 Page Assist 里的自定义 Origin URL否则自动识别失效。临时附加Firefox 的 Load Temporary Add-on重启浏览器后会失效长期用请走正式发布渠道安装。完整配置项与更多报错场景见 docs/settings.md 与 docs/connection-issue.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），仅供参考