故障排除

扩展未连接

现象： MCP 工具调用返回"扩展未连接"或超时。

1. 检查 chrome://extensions 中 DevBridge 扩展是否已安装并启用
2. 重启 MCP 服务器（在 AI 工具中停止并重新添加）
3. 重新加载扩展（点击 chrome://extensions 中的刷新图标）
4. 若 native messaging host 未安装，运行 npx devbridge-mcp@latest --install 强制重新安装

工具被静默拒绝，无弹窗提示

现象： 工具调用立即返回"user rejected"，没有任何授权对话框弹出。

这发生在 Claude Code 中：当某个工具未被预先批准，且 Claude Code 处于非交互式环境时（CI、无终端弹窗场景），未经授权的工具会被静默拒绝，不会弹出任何提示。

解决方法： 在项目的 .claude/settings.local.json 中添加 DevBridge 白名单：

{
  "permissions": {
    "allow": ["mcp__devbridge__*"]
  }
}

这将一次性批准全部 18 个 DevBridge 工具。详见配置 MCP 服务器中的 Claude Code 章节。

权限被拒绝

现象： 工具调用返回某域名的权限错误。

DevBridge 要求对每个域名的敏感操作进行明确授权。如果误点了拒绝：

1. 点击工具栏中的 DevBridge 图标
2. 进入权限，清除该域名的拒绝规则
3. 重试操作，系统会重新弹出授权提示

调试器已被占用

现象： "另一个扩展正在此标签页上使用调试器"。

同一时间只有一个扩展可以将 Chrome 调试器附加到标签页。请断开其他使用 chrome.debugger 的扩展（如其他自动化工具）后重试。

操作指示器卡住

现象： DevBridge 发光指示器在操作完成后仍然显示。

点击指示器中的停止按钮，或重新加载标签页。正常情况下操作完成后指示器会在 50ms 内自动隐藏。

GIF 未生成

现象： gif_creator 返回错误或空结果。

• 确保标签页处于可见状态（GIF 捕获需要标签页处于活跃状态）
• 减少步骤数量或缩短捕获时长
• 检查 Chrome 是否有足够的可用内存

仍然无法解决？

查看浏览器控制台（chrome://extensions → DevBridge → 背景页 → 控制台）获取详细错误信息。