使用指南 · BugEzy

🚀 第一步：安裝與登入

從 Chrome Web Store 安裝 BugEzy 擴充功能
點擊右上角 BugEzy 圖示 🐛
按「用 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

📝 第三步：編輯與上傳

錄製停止後進入編輯頁
可以編輯語音文字、加補充說明
按「🔧 AI 校正」修正錯字（選用）
按「🤖 AI 精簡」濃縮重點（選用）
按「上傳」→ 報告自動儲存到雲端

🤖 第四步：讓 AI 幫你修

方法一：在 Claude / Cursor / VS Code 直接問
「讀我最新的 BugEzy 報告，告訴我怎麼修」
AI 透過 MCP 自動讀取報告 → 分析 Console error + Network error → 給出修復建議

方法二：分享報告連結
上傳後會產生報告連結，傳給同事或貼到 Issue

🔌 MCP 連接設定
BugEzy MCP 網址（所有工具通用）：
https://bugezy-api.bugezy-api.workers.dev/mcp

⚠ 注意：這個網址不能用瀏覽器開，它是專給 AI 工具連接的協議。用瀏覽器開只會看到一段錯誤訊息，屬正常現象——請依下方步驟在 AI 工具裡設定。

Claude.ai

Settings → Connectors → Add → 貼上網址 → 連接

Claude Desktop

編輯 claude_desktop_config.json，加入：

{
  "mcpServers": {
    "bugezy": {
      "url": "https://bugezy-api.bugezy-api.workers.dev/mcp"
    }
  }
}

Cursor

Settings → MCP → Add Server → 貼上網址

VS Code

Settings → 搜尋 MCP → Add Server → 貼上網址

Claude Code（終端機）

執行：claude mcp add --transport http bugezy https://bugezy-api.bugezy-api.workers.dev/mcp

Zed

設定檔加 context_servers

連接成功後，直接問 AI：
「讀我最新的 BugEzy 報告，告訴我怎麼修」
AI 就會透過 MCP 自動讀取你的 Bug 報告。

💡 小技巧

錄製時對著麥克風說「這個按鈕按下去沒反應」比打字快 10 倍
即時監控可以掛一整天，有 error 才通知你
免費版每月可錄 10 次，截圖和即時監控無限用
用 BugEzy MCP 讀報告比截圖貼給 AI 省 95% Token

🐛 BugEzy 使用指南

🚀 第一步：安裝與登入

🎯 第二步：錄下 Bug（六種模式任選）

📝 第三步：編輯與上傳

🤖 第四步：讓 AI 幫你修

💡 小技巧