用途:在首次使用新项目时运行该向导,为当前项目配置 mem0 插件,完成约 60 秒的初始化。
主要能力与步骤(须严格按 0→6 顺序执行,不可并行或跳跃): 0. 确保 mem0ai SDK 已安装;插件在会话开始时通过 ${CLAUDE_PLUGIN_DATA}/venv 自动安装。若第 5 步因导入错误失败,可运行 "${CLAUDE_PLUGIN_ROOT}/scripts/ensure_deps.sh"(静默且幂等)。
- 配置 API key:用 [ -n "${MEM0_API_KEY:-${CLAUDE_PLUGIN_OPTION_API_KEY:-}}" ] && echo "SET" || echo "NOT_SET" 检查。切勿运行 echo $MEM0_API_KEY 以免明文泄露。未设置时从 https://app.mem0.ai/dashboard/api-keys 获取,可选写入 ~/.zshrc 或使用桌面应用的环境变量编辑器。
- 连接 MCP server:先检查 mem0 search_memories 工具是否存在;MCP 使用第 1 步的 API key 认证,无需 OAuth。可运行 /plugins、/mcp 排查。
- 验证连通性并显示身份:调用 search_memories 查询 "project setup",输出 user、project、branch。
- 导入项目文件:检测 CLAUDE.md、AGENTS.md、.cursorrules、.windsurfrules、mem0.md,并用 auto_import.py 导入。
- 编码分类:会话启动时后台自动安装,幂等且自缓存;可用 auto_setup_categories.py 前台验证。
- 输出汇总:user_id、project_id、文件数、分类状态。
适用场景:mem0 插件在新项目中的首次配置。限制:全程依赖 mem0 API key 与 MCP 工具,MCP 未就绪须重启 Claude Code 后重试;价格、平台支持等未提供。