Page Assist 扩展无法加载新手必看的 3 个常见故障快速排查指南【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assistPage Assist 是一个开源浏览器扩展让你在任意网页的侧边栏或 Web 界面里直接和跑在本地的 AI 模型对话、提问、总结。新手最常卡住的地方有三类装依赖时bun或ollama报错、Page Assist 扩展无法加载、快捷键按了没反应——本文按装环境 → 加载启动 → 日常使用三步逐条给出定位和验证方法。快速诊断先定位再细读你看到的现象可能原因对应章节终端里bun --version提示命令不存在Bun 没装好或 PATH 里没配它的路径确认 Bun 是否可用扩展里选不到模型、请求直接失败本地 Ollama 服务没启动确认 Ollama 在运行点加载后弹无法加载扩展开发者模式没开或选错了目录开启开发者模式加载 build 目录文件框里找不到manifest.json选的是项目根目录不是build目录找不到 manifest.json按CtrlShiftY或CtrlShiftL没反应组合键被别的扩展或系统占用了重设被占用的快捷键一、装好开发环境再动手 Page Assist 用 TypeScript 写构建靠 Bun。你不用自己写代码只要把跑模型的 Ollama 和用来打包的 Bun 这两样装好。若要在本地改源码再打包先git clone https://gitcode.com/GitHub_Trending/pa/page-assist把仓库拉到本地。确认 Bun 是否可用现象当你在终端里敲bun --version却看到bun: command not found或不是内部或外部命令时说明终端根本找不到 Bun。原因两种可能Bun 压根没装或者装了但它的安装路径没进系统环境变量PATH终端自然调不到。解决按 Bun 官方说明把它装上。装完若bun --version还是没反应把 Bun 所在路径补进当前 shell 配置如~/.bashrc再重开一个终端。实在和 Bun 过不去多数命令可直接用npm替代。验证再跑一次bun --version。只要它回出一个版本号形如1.x.x就说明终端已能调到 Bun可以往下走。确认 Ollama 在运行现象扩展装好后侧边栏里一个模型都选不到或发一句消息就卡住、报连接错误。原因Page Assist 只是界面真正干活的是本地 Ollama 跑的模型。Ollama 服务没启动扩展自然连不上。解决按 Ollama 官方指南把它装上并确认服务正在后台运行。它默认监听本机的localhost:11434。验证终端跑ollama --version能回出版本号且用浏览器打开http://localhost:11434有返回内容就说明模型服务已就绪。若连不上再看连接问题排查文档和Ollama 说明。二、把扩展装进浏览器 装好依赖后要把源码打包再让浏览器加载打包产物。这一步最容易出现无法加载扩展。开启开发者模式加载 build 目录现象你点加载已解压的扩展程序后要么选不到目录要么加载完浏览器直接提示无法加载扩展。原因浏览器默认只认商店里的扩展要在本地加载未打包的扩展得先打开开发者模式另外把目录选错选了源码而非打包结果也会失败。解决分三步做。先在仓库目录里跑bun install装依赖再跑bun run build打包——它会同时生成 Chrome、Edge、Firefox 三套产物输出到项目根目录的build文件夹。接着打开chrome://extensions把右上角开发者模式开关打开点加载已解压的扩展程序选中刚生成的build目录。验证扩展列表里出现了 Page Assist工具栏也能看到它的图标点开图标能进入 Web UI就算加载成功。找不到 manifest.json现象在文件选择框里翻来翻去找不到叫manifest.json的文件或选了这个文件后浏览器报 manifest 格式错误。原因manifest.json是浏览器识别扩展的身份证它不在源码目录里只在打包后的build目录中。选到仓库根目录时里面没有它就会报找不到或格式错误。解决重新选目录一路选到build文件夹——它里面直接放着manifest.json。如果build目录是空的或不存在说明打包没跑成功回到上一步重新执行bun run build。验证选对目录后扩展能正常出现在列表里且没有红色报错文字即表示 manifest 已被正确读取。Firefox 用户走about:addons→ 扩展 → 管理你的扩展 → 加载临时附加组件选中build目录下的manifest.json即可。三、让快捷键真正好使 ⌨️扩展能打开了但按快捷键没反应通常不是扩展坏了而是键位撞车。重设被占用的快捷键现象你在网页里按默认的CtrlShiftY开侧边栏或CtrlShiftL开 Web UI页面毫无动静又或者一按就触发了别的功能。原因这组组合键可能已经被其他扩展、输入法或系统占用了。浏览器里多个扩展抢同一个键后者往往会失效。解决打开chrome://extensions/shortcutsEdge、Brave 等 Chromium 内核浏览器通用在列表里找到 Page Assist把两个动作的键位换成没被占用的组合比如CtrlShiftK。Firefox 则走about:addons→ 齿轮设置 → 管理扩展快捷键。完整键位与说明见快捷键文档。验证改完随便打开一个网页按新键能弹出侧边栏、或新开一个 Web UI 标签页就说明快捷键已恢复可用。排查清单bun --version能回出版本号ollama --version能回出版本号且http://localhost:11434可访问bun run build跑完build目录里有manifest.jsonchrome://extensions里 Page Assist 无红色报错新设的快捷键在任意网页都能打开侧边栏 / Web UI哪一步还卡着打开 Web UI 的设置页核对模型配置或回到上面快速诊断表按现象对回对应章节重看一次。【免费下载链接】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 扩展无法加载？新手必看的 3 个常见故障快速排查指南
Page Assist 扩展无法加载新手必看的 3 个常见故障快速排查指南【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assistPage Assist 是一个开源浏览器扩展让你在任意网页的侧边栏或 Web 界面里直接和跑在本地的 AI 模型对话、提问、总结。新手最常卡住的地方有三类装依赖时bun或ollama报错、Page Assist 扩展无法加载、快捷键按了没反应——本文按装环境 → 加载启动 → 日常使用三步逐条给出定位和验证方法。快速诊断先定位再细读你看到的现象可能原因对应章节终端里bun --version提示命令不存在Bun 没装好或 PATH 里没配它的路径确认 Bun 是否可用扩展里选不到模型、请求直接失败本地 Ollama 服务没启动确认 Ollama 在运行点加载后弹无法加载扩展开发者模式没开或选错了目录开启开发者模式加载 build 目录文件框里找不到manifest.json选的是项目根目录不是build目录找不到 manifest.json按CtrlShiftY或CtrlShiftL没反应组合键被别的扩展或系统占用了重设被占用的快捷键一、装好开发环境再动手 Page Assist 用 TypeScript 写构建靠 Bun。你不用自己写代码只要把跑模型的 Ollama 和用来打包的 Bun 这两样装好。若要在本地改源码再打包先git clone https://gitcode.com/GitHub_Trending/pa/page-assist把仓库拉到本地。确认 Bun 是否可用现象当你在终端里敲bun --version却看到bun: command not found或不是内部或外部命令时说明终端根本找不到 Bun。原因两种可能Bun 压根没装或者装了但它的安装路径没进系统环境变量PATH终端自然调不到。解决按 Bun 官方说明把它装上。装完若bun --version还是没反应把 Bun 所在路径补进当前 shell 配置如~/.bashrc再重开一个终端。实在和 Bun 过不去多数命令可直接用npm替代。验证再跑一次bun --version。只要它回出一个版本号形如1.x.x就说明终端已能调到 Bun可以往下走。确认 Ollama 在运行现象扩展装好后侧边栏里一个模型都选不到或发一句消息就卡住、报连接错误。原因Page Assist 只是界面真正干活的是本地 Ollama 跑的模型。Ollama 服务没启动扩展自然连不上。解决按 Ollama 官方指南把它装上并确认服务正在后台运行。它默认监听本机的localhost:11434。验证终端跑ollama --version能回出版本号且用浏览器打开http://localhost:11434有返回内容就说明模型服务已就绪。若连不上再看连接问题排查文档和Ollama 说明。二、把扩展装进浏览器 装好依赖后要把源码打包再让浏览器加载打包产物。这一步最容易出现无法加载扩展。开启开发者模式加载 build 目录现象你点加载已解压的扩展程序后要么选不到目录要么加载完浏览器直接提示无法加载扩展。原因浏览器默认只认商店里的扩展要在本地加载未打包的扩展得先打开开发者模式另外把目录选错选了源码而非打包结果也会失败。解决分三步做。先在仓库目录里跑bun install装依赖再跑bun run build打包——它会同时生成 Chrome、Edge、Firefox 三套产物输出到项目根目录的build文件夹。接着打开chrome://extensions把右上角开发者模式开关打开点加载已解压的扩展程序选中刚生成的build目录。验证扩展列表里出现了 Page Assist工具栏也能看到它的图标点开图标能进入 Web UI就算加载成功。找不到 manifest.json现象在文件选择框里翻来翻去找不到叫manifest.json的文件或选了这个文件后浏览器报 manifest 格式错误。原因manifest.json是浏览器识别扩展的身份证它不在源码目录里只在打包后的build目录中。选到仓库根目录时里面没有它就会报找不到或格式错误。解决重新选目录一路选到build文件夹——它里面直接放着manifest.json。如果build目录是空的或不存在说明打包没跑成功回到上一步重新执行bun run build。验证选对目录后扩展能正常出现在列表里且没有红色报错文字即表示 manifest 已被正确读取。Firefox 用户走about:addons→ 扩展 → 管理你的扩展 → 加载临时附加组件选中build目录下的manifest.json即可。三、让快捷键真正好使 ⌨️扩展能打开了但按快捷键没反应通常不是扩展坏了而是键位撞车。重设被占用的快捷键现象你在网页里按默认的CtrlShiftY开侧边栏或CtrlShiftL开 Web UI页面毫无动静又或者一按就触发了别的功能。原因这组组合键可能已经被其他扩展、输入法或系统占用了。浏览器里多个扩展抢同一个键后者往往会失效。解决打开chrome://extensions/shortcutsEdge、Brave 等 Chromium 内核浏览器通用在列表里找到 Page Assist把两个动作的键位换成没被占用的组合比如CtrlShiftK。Firefox 则走about:addons→ 齿轮设置 → 管理扩展快捷键。完整键位与说明见快捷键文档。验证改完随便打开一个网页按新键能弹出侧边栏、或新开一个 Web UI 标签页就说明快捷键已恢复可用。排查清单bun --version能回出版本号ollama --version能回出版本号且http://localhost:11434可访问bun run build跑完build目录里有manifest.jsonchrome://extensions里 Page Assist 无红色报错新设的快捷键在任意网页都能打开侧边栏 / Web UI哪一步还卡着打开 Web UI 的设置页核对模型配置或回到上面快速诊断表按现象对回对应章节重看一次。【免费下载链接】page-assistUse your locally running AI models to assist you in your web browsing项目地址: https://gitcode.com/GitHub_Trending/pa/page-assist创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考