EN
🐛 BugEzy

🐛 BugEzy 使用指南

让 AI 帮你修 Bug，只需三步。

详细安装流程 → 安装指南　·　完整功能说明 → 功能说明

🚀 第一步：安装与登入

  1. 从 Chrome Web Store 安装 BugEzy 扩展程序
  2. 点击右上角 BugEzy 图示 🐛
  3. 按「用 Google 登入」→ 完成

🎯 第二步：录下 Bug（六种模式任选）

🎬 录制
适合：完整重现 Bug 过程
用法：按「录制」→ 操作网页重现 Bug → 语音描述问题 → 按「停止」
录到：DOM 变化 + Console + Network + 语音
⏪ 30 秒回溯
适合：Bug 已经发生，来不及录
用法：按「回溯 30s」→ 自动抓回最近 30 秒的操作
不用提前按录制，BugEzy 在背景持续记录
📸 截图标注
适合：快速指出画面问题
用法：按「截图标注」→ 画笔/箭头/框框标出问题 → 加文字说明
三种模式：整页截图 / 可见范围 / 自选区域
🔇 键盘模式
适合：吵杂环境（咖啡厅、办公室）
用法：开启键盘模式 → 关闭语音辨识 → 用文字描述 Bug
🔍 即时监控
适合：挂著等 Bug 自己出现
用法：开启即时监控 → 页面右下角出现 🐛 badge → 有 error 自动变红 + 显示数字
点 badge 展开 error 清单
🖥 终端机
适合：Server 端的错误（Node.js、Python 等）
用法：终端机输入 npx bugezy-watch -- npm run dev
自动拦截 stderr / throw / crash

📝 第三步：编辑与上传

  1. 录制停止后进入编辑页
  2. 可以编辑语音文字、加补充说明
  3. 按「🔧 AI 校正」修正错字（选用）
  4. 按「🤖 AI 精简」浓缩重点（选用）
  5. 按「上传」→ 报告自动储存到云端

🤖 第四步：让 AI 帮你修

方法一：在 Claude / Cursor / VS Code 直接问
「读我最新的 BugEzy 报告，告诉我怎么修」
AI 透过 MCP 自动读取报告 → 分析 Console error + Network error → 给出修复建议

方法二：分享报告连结
上传后会产生报告连结，传给同事或贴到 Issue

🔌 MCP 连接设置
BugEzy MCP 网址（所有工具通用）：
https://bugezy.dev/mcp
⚠ 注意：这个网址不能用浏览器开，它是专给 AI 工具连接的协议。用浏览器开只会看到一段错误讯息，属正常现象——请依下方步骤在 AI 工具里设置。
Claude.ai
Settings → Connectors → Add → 贴上网址 → 连接
Claude Desktop
编辑 claude_desktop_config.json，加入：
{
  "mcpServers": {
    "bugezy": {
      "url": "https://bugezy.dev/mcp"
    }
  }
}
Cursor
Settings → MCP → Add Server → 贴上网址
VS Code
Settings → 搜寻 MCP → Add Server → 贴上网址
Claude Code（终端机）
执行： claude mcp add --transport http bugezy https://bugezy.dev/mcp
Zed
设置档加 context_servers
连接成功后，直接问 AI：
「读我最新的 BugEzy 报告，告诉我怎么修」
AI 就会透过 MCP 自动读取你的 Bug 报告。

💡 小技巧