Mushi 是一款面向 AI 快速开发场景的开源 Bug 诊断与修复分派工具。它的核心目标是帮助开发者快速理解 AI 生成的应用为何出错，并将修复流程极大简化。
主要用途：当最终用户遇到 Bug 时，Mushi 能够捕获问题现场，自动分析出通俗易懂的根因，并提供可直接使用的修复提示。它特别设计用于配合 Cursor、Claude Code、Lovable 或 Bolt 等 AI 编程环境，让每个 Bug 的处理时间从数小时压缩到几分钟。
主要能力：
- 捕获：用户点击组件时，记录截图、当前路由、用户备注，以及最后的控制台和网络事件。
- 诊断：用通俗英文写出根因，并附上修复提示。同一按钮报错 20 次会合并为一行。
- 修复：编辑器可以通过 MCP 读取诊断信息，智能体可自动打开草稿 PR 供人工审核。
- 覆盖非抛错类 Bug：例如支付按钮被键盘遮挡、保存按钮重复点击无反应、仪表盘加载耗时 12 秒等。
- 集成能力：支持接入 Sentry（可选），也可通过 Webhook 将 Sentry 告警导入同一队列，并实现双向同步；还提供适配器接入 Datadog、Bugsnag、Rollbar、Crashlytics 等，插件可与 Linear、Jira、GitHub Issues、Slack、Discord、Teams、PagerDuty 同步。
使用方式：
- SDK 需要两个环境变量：VITE_MUSHI_PROJECT_ID / VITE_MUSHI_API_KEY，或 NEXT_PUBLIC_MUSHI_*（参考 examples/sdk.env.example）。无需 Sentry、LLM 密钥或监控栈。
- 在 Cursor 或 Claude Code 中安装 Mushi skills：运行 npx skills add kensaurus/mushi-mushi，然后执行 mushi-setup 技能将 Mushi SDK 和 MCP 服务器接入应用，并发送测试报告验证连接。
- 技能还提供 /mushi-debug、/mushi-health、/mushi-integration 等命令。
- 原生 SDK（iOS、Android、Flutter）为预览版，可从 packages/ios、packages/android、packages/flutter 安装。可运行演示见 examples/react-demo。
- 托管免费版每月 50 次诊断，无需信用卡；也可自托管，自托管需自带 LLM 密钥并按供应商标价付费。
适用场景：适合使用 AI 编程工具快速交付应用的开发者，尤其是希望减少 Bug 排查时间、将用户反馈转化为可执行修复步骤的团队。
限制与说明：原生 SDK 为预览版；自托管需自行承担 LLM 费用；托管服务按诊断次数计费并有支出上限；企业级集成（SSO、留存、区域路由、Kubernetes）需参考 docs/operators/ 文档。其他细节暂未提供。
