Page Assist 本地 AI 侧边栏加载不了从 Bun 安装到解包加载的完整避坑自查【免费下载链接】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对话。本文按真实使用顺序把新人最常卡住的三类问题——依赖装错、扩展加载失败、快捷键与连接没反应——逐条拆开帮你一次跑通。30 秒自诊症状最可能原因对应章节终端提示bun: command not foundBun 未装好或未加入 PATH阶段一 1.1Ollama 装完但拉不到模型列表服务没起或没拉模型阶段一 1.2bun run build报错或没有build目录依赖没装完Bun 版本问题阶段二 2.1chrome://extensions提示“无法加载扩展程序”没开开发者模式或选错目录阶段二 2.2按CtrlShiftY没反应快捷键未分配或被占用阶段三 3.1扩展加载成功发消息报 403Ollama 的 CORS 限制阶段三 3.2阶段一环境准备1.1 Bun 命令找不到先查这两处症状终端里敲bun --version提示“找不到命令”后续所有bun install无从谈起。根因速判安装脚本没跑成功Bun 实际不在磁盘上Bun 装上了但安装路径没进系统 PATH修复路径执行安装命令curl -fsSL https://bun.sh/install | bashWindows 按官网指引操作。关掉终端重新打开运行echo $PATH确认输出里包含~/.bun/bin。不包含就手动把该路径写进 shell 环境变量再用bun --version验证。 提示Bun 反复搞不定就别死磕。项目明确允许全程把bun换成npm执行下文命令同理替换。预防装完立刻bun --version版本号能打印出来才算过关。1.2 Ollama 起没起来一条命令验证症状Ollama 装完了但 Page Assist 里模型列表是空的或终端报连接被拒绝。根因速判Ollama 服务进程没在跑服务在跑但本地一个模型都没拉过修复路径运行ollama --version确认客户端正常。服务没起就执行ollama serve手动拉起。执行ollama pull llama3.1或你选的任意模型拉一个本地模型。ollama list里能看到模型名就算就绪。预防Page Assist 默认自动识别localhost:11434上的 Ollama不用配置改了端口就去扩展的 Settings → Ollama Settings 里填地址参见 docs/providers/ollama.md。阶段二构建与加载2.1bun run build没产出 build 目录症状构建命令跑完报错或项目根目录里根本没有build文件夹。根因速判依赖没装完或postinstall里的wxt prepare被跳过Bun 环境异常导致构建中途失败修复路径先确认仓库已拉好git clone https://gitcode.com/GitHub_Trending/pa/page-assist然后cd page-assist。在项目根目录执行bun install等它完整跑完。再执行bun run build。该命令会依次构建 Chrome、Firefox、Edge 三端任何一步失败都会中断。构建产物落在build目录先确认里面有manifest.json再进入下一步。⚠️ 注意Bun 持续报错时整条构建链换成npm installnpm run build即可脚本定义在 package.json 里。2.2 加载解包扩展时提示“无法加载”症状在chrome://extensions选择目录后页面弹“无法加载扩展程序”或不说明具体原因。根因速判右上角的开发者模式开关没打开选的是项目根目录而不是编译产物build子目录修复路径地址栏输入chrome://extensions打开右上角“开发者模式”。点“加载已解压的扩展程序”选中build目录。Firefox 用户走另一条路about:addons→ 扩展 → 管理扩展 → “加载临时附加组件”选择build里的manifest.json文件。 提示Firefox 的临时加载在浏览器重启后会失效属正常现象重启后重新加载即可日常开发可用bun dev的监听模式。阶段三使用调优3.1 按CtrlShiftY没反应症状扩展图标正常显示按默认快捷键开侧边栏却毫无动静或触发了别的功能。根因速判扩展的快捷键根本没分配成功按键组合与其他扩展或系统热键冲突修复路径地址栏输入chrome://extensions/shortcuts直达快捷键设置页。找到 Page Assist点“打开侧边栏”旁的按键输入框改一组新的如CtrlShiftAltP。打开 Web UI 的快捷键是CtrlShiftL同页可改。开一个普通网页按新组合键验证侧边栏弹出。⚠️ 注意仍冲突时优先选AltShift字母这类冷门组合并在输入框下方确认没有“与其他扩展冲突”的提示。完整快捷键清单见 docs/shortcuts.md。3.2 首条消息发出后报 403症状模型列表正常但消息发出去后回一个 403 错误。根因速判Ollama 的 CORS 策略拦截了浏览器扩展的跨源请求Page Assist 的请求头改写只对localhost/127.0.0.1生效你的 Ollama 跑在别的地址上修复路径打开 Web UI → Settings → Ollama Settings → “Advance Ollama URL Configuration”。打开 Custom Origin URL 开关Ollama 不在默认端口就同时改对端口点 Save。仍失败则设置环境变量OLLAMA_ORIGINS*Linux/macOS 用export或launchctl setenvWindows 在系统环境变量里新增再重启 Ollama 服务。预防只用localhost:11434默认地址时什么都不用配扩展会自动识别。完整排障步骤见 docs/connection-issue.md。上手前自查清单bun --version与ollama --version都能打印版本号ollama list里至少有一个本地模型bun install在项目根目录完整跑完无报错bun run build成功且build目录内有manifest.jsonChrome 开发者模式已开扩展从build目录加载成功chrome://extensions/shortcuts中侧边栏与 Web UI 两项快捷键均已分配在侧边栏发一条测试消息模型能正常回复更多细节看官方文档入口 docs/index.md 与浏览器兼容矩阵 docs/browser-support.md本文没覆盖到的报错直接去项目 issue 区检索或提问。【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assist创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Page Assist 本地 AI 侧边栏加载不了？从 Bun 安装到解包加载的完整避坑自查
Page Assist 本地 AI 侧边栏加载不了从 Bun 安装到解包加载的完整避坑自查【免费下载链接】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对话。本文按真实使用顺序把新人最常卡住的三类问题——依赖装错、扩展加载失败、快捷键与连接没反应——逐条拆开帮你一次跑通。30 秒自诊症状最可能原因对应章节终端提示bun: command not foundBun 未装好或未加入 PATH阶段一 1.1Ollama 装完但拉不到模型列表服务没起或没拉模型阶段一 1.2bun run build报错或没有build目录依赖没装完Bun 版本问题阶段二 2.1chrome://extensions提示“无法加载扩展程序”没开开发者模式或选错目录阶段二 2.2按CtrlShiftY没反应快捷键未分配或被占用阶段三 3.1扩展加载成功发消息报 403Ollama 的 CORS 限制阶段三 3.2阶段一环境准备1.1 Bun 命令找不到先查这两处症状终端里敲bun --version提示“找不到命令”后续所有bun install无从谈起。根因速判安装脚本没跑成功Bun 实际不在磁盘上Bun 装上了但安装路径没进系统 PATH修复路径执行安装命令curl -fsSL https://bun.sh/install | bashWindows 按官网指引操作。关掉终端重新打开运行echo $PATH确认输出里包含~/.bun/bin。不包含就手动把该路径写进 shell 环境变量再用bun --version验证。 提示Bun 反复搞不定就别死磕。项目明确允许全程把bun换成npm执行下文命令同理替换。预防装完立刻bun --version版本号能打印出来才算过关。1.2 Ollama 起没起来一条命令验证症状Ollama 装完了但 Page Assist 里模型列表是空的或终端报连接被拒绝。根因速判Ollama 服务进程没在跑服务在跑但本地一个模型都没拉过修复路径运行ollama --version确认客户端正常。服务没起就执行ollama serve手动拉起。执行ollama pull llama3.1或你选的任意模型拉一个本地模型。ollama list里能看到模型名就算就绪。预防Page Assist 默认自动识别localhost:11434上的 Ollama不用配置改了端口就去扩展的 Settings → Ollama Settings 里填地址参见 docs/providers/ollama.md。阶段二构建与加载2.1bun run build没产出 build 目录症状构建命令跑完报错或项目根目录里根本没有build文件夹。根因速判依赖没装完或postinstall里的wxt prepare被跳过Bun 环境异常导致构建中途失败修复路径先确认仓库已拉好git clone https://gitcode.com/GitHub_Trending/pa/page-assist然后cd page-assist。在项目根目录执行bun install等它完整跑完。再执行bun run build。该命令会依次构建 Chrome、Firefox、Edge 三端任何一步失败都会中断。构建产物落在build目录先确认里面有manifest.json再进入下一步。⚠️ 注意Bun 持续报错时整条构建链换成npm installnpm run build即可脚本定义在 package.json 里。2.2 加载解包扩展时提示“无法加载”症状在chrome://extensions选择目录后页面弹“无法加载扩展程序”或不说明具体原因。根因速判右上角的开发者模式开关没打开选的是项目根目录而不是编译产物build子目录修复路径地址栏输入chrome://extensions打开右上角“开发者模式”。点“加载已解压的扩展程序”选中build目录。Firefox 用户走另一条路about:addons→ 扩展 → 管理扩展 → “加载临时附加组件”选择build里的manifest.json文件。 提示Firefox 的临时加载在浏览器重启后会失效属正常现象重启后重新加载即可日常开发可用bun dev的监听模式。阶段三使用调优3.1 按CtrlShiftY没反应症状扩展图标正常显示按默认快捷键开侧边栏却毫无动静或触发了别的功能。根因速判扩展的快捷键根本没分配成功按键组合与其他扩展或系统热键冲突修复路径地址栏输入chrome://extensions/shortcuts直达快捷键设置页。找到 Page Assist点“打开侧边栏”旁的按键输入框改一组新的如CtrlShiftAltP。打开 Web UI 的快捷键是CtrlShiftL同页可改。开一个普通网页按新组合键验证侧边栏弹出。⚠️ 注意仍冲突时优先选AltShift字母这类冷门组合并在输入框下方确认没有“与其他扩展冲突”的提示。完整快捷键清单见 docs/shortcuts.md。3.2 首条消息发出后报 403症状模型列表正常但消息发出去后回一个 403 错误。根因速判Ollama 的 CORS 策略拦截了浏览器扩展的跨源请求Page Assist 的请求头改写只对localhost/127.0.0.1生效你的 Ollama 跑在别的地址上修复路径打开 Web UI → Settings → Ollama Settings → “Advance Ollama URL Configuration”。打开 Custom Origin URL 开关Ollama 不在默认端口就同时改对端口点 Save。仍失败则设置环境变量OLLAMA_ORIGINS*Linux/macOS 用export或launchctl setenvWindows 在系统环境变量里新增再重启 Ollama 服务。预防只用localhost:11434默认地址时什么都不用配扩展会自动识别。完整排障步骤见 docs/connection-issue.md。上手前自查清单bun --version与ollama --version都能打印版本号ollama list里至少有一个本地模型bun install在项目根目录完整跑完无报错bun run build成功且build目录内有manifest.jsonChrome 开发者模式已开扩展从build目录加载成功chrome://extensions/shortcuts中侧边栏与 Web UI 两项快捷键均已分配在侧边栏发一条测试消息模型能正常回复更多细节看官方文档入口 docs/index.md 与浏览器兼容矩阵 docs/browser-support.md本文没覆盖到的报错直接去项目 issue 区检索或提问。【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assist创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考