SuperAPI AI 工具集

mushi-setup

编程与开发

查看项目

更新于 10-16 07:07

技能介绍

Mushi Setup 用于将当前仓库接入 Mushi Mushi。其核心思路是:CLI 向导已经自动化了检测、认证、安装与环境变量写入,应委托向导执行而不是手工编辑文件,然后再进行验证。

一、用途 把当前代码仓库引导接入 Mushi Mushi,完成 SDK 安装、凭据配置、初始化代码接入、MCP 服务器接入编辑器,并做端到端验证。

二、主要能力

  1. 运行向导(SDK 安装 + 凭据):命令为 npx mushi-mushi。它会检测框架与包管理器,打开浏览器登录(设备认证,无需复制粘贴),允许选择或创建项目,安装匹配的 @mushi-mushi/* SDK,把带框架前缀的环境变量(例如 VITE_MUSHI_PROJECT_ID / VITE_MUSHI_API_KEY,或 NEXT_PUBLIC_MUSHI_*)写入 .env.local,并打印要粘贴的初始化片段。
  2. 环境变量说明:SDK 只需要这两个环境变量,不需要 Supabase,也不需要 LLM 密钥。在 mushi-mushi 源码仓库根目录可能看到的 .env.example 是用于自托管后端的,不是给 SDK 用户使用的。
  3. 非交互 / CI 回退方式:mushi login --api-key mushi_... --project-id <uuid>。
  4. 已安装时的健康检查:npx mushi-mushi --audit(而不是重新运行向导)。
  5. 框架到包的决策树:向导会自动应用该映射(可用 --framework <id> 强制指定)。手动安装或核对向导选择时可参考:next → Next.js → @mushi-mushi/react;react(无元框架)/ react-scripts / @remix-run/* → React / CRA / Remix → @mushi-mushi/react;vue v3 → Vue 3 → @mushi-mushi/vue;nuxt → Nuxt → @mushi-mushi/vue;svelte / @sveltejs/kit → Svelte / SvelteKit → @mushi-mushi/svelte;@angular/core → Angular → @mushi-mushi/angular;astro / solid-js → Astro / Solid → @mushi-mushi/web;expo / react-native → Expo / React Native → @mushi-mushi/react-native;@capacitor/core → Capacitor (Ionic) → @mushi-mushi/capacitor;以上都不是 → Vanilla JS → @mushi-mushi/web;Node 服务器(Express/Fastify/Hono)→ Server → @mushi-mushi/node。
  6. 从 Sentry 迁移:不要移除 Sentry,参见 Sentry + Mushi 指南(可增强或独立使用;mushi migrate 会检测 @sentry/* 并给出建议)。
  7. 粘贴初始化片段:向导会打印框架专属片段(例如 React 的 <MushiProvider>,vanilla 的 initMushi()),粘贴到应用入口点。若片段丢失,可在 https://kensaur.us/mushi-mushi/docs/sdks 下各框架页面找到。
  8. 将 MCP 服务器接入编辑器:npx mushi-mushi setup --ide cursor(或 claude | continue | zed)。同一工作区有多个项目时:mushi setup --all-projects。
  9. 端到端验证:mushi doctor --onboarding。若缺少任何内容(SDK 已导入但未初始化、环境变量缺失、MCP 条目过期、从未收到心跳等),它会打印单一后续操作。每条 FAIL 行都带有 → Fix: 提示。完整扫描使用 mushi doctor --full。随后发送测试报告:在运行中的应用触发任意错误(或使用向导的“send test report”选项),确认它出现在 get_recent_reports(MCP)或控制台仪表盘中。

三、使用方式 按步骤执行:先运行 npx mushi-mushi 完成 SDK 安装与凭据配置;再粘贴向导输出的初始化片段到应用入口;然后用 npx mushi-mushi setup --ide <ide> 接入 MCP 服务器;最后用 mushi doctor --onboarding 验证并发送测试报告确认。CI 场景使用 mushi login 命令。

四、适用场景 需要把前端框架(Next.js、React、Vue、Nuxt、Svelte、Angular、Astro、Solid、Expo/React Native、Capacitor)、Vanilla JS 或 Node 服务器(Express/Fastify/Hono)项目接入 Mushi Mushi 的场景;已安装后做健康检查;在 Cursor、Claude、Continue、Zed 等编辑器中接入 MCP;从 Sentry 迁移或与 Sentry 共存。

五、限制与暂未提供 资料未说明 Mushi Mushi 的收费、价格、平台支持范围、性能效果等具体信息,暂未提供。

六、交接(Handoffs) 接入后的管道健康 → mushi-health;摄取/MCP/管道故障 → mushi-debug;双向循环、经验教训、修复派发 → mushi-integration。