Xmind Cloud CLI 是 Xmind 官方提供的命令行工具，用于与 Xmind 在线思维导图进行实时交互。当用户希望读取、编辑或创建云端思维导图时可以使用该工具。
安装与认证
安装命令：
which xmind || npm install -g @xmindltd/xmind-cli
检查认证状态：
xmind cloud auth status
如果返回 {"authenticated":false}，则执行登录：
xmind cloud auth login
# → Opens browser automatically, waits for authorization
# → {"authenticated":true,"source":"config"}
如果已有 token，可使用替代方式：
xmind cloud auth token <value>
会话规则
- 复用会话：打开前先检查
xmind cloud sessions。如果文档已有活动会话，则复用。 - 不要每次编辑后都关闭：会话会持续存在，并在 30 分钟无操作后自动关闭。仅在用户完成或明确要求时关闭。
- 守护进程跨会话持续：关闭会话不会终止守护进程，下次打开更快。
创建思维导图
第一步：发现可用技能
xmind skill list
查看所有可用的 domain、render 策略和 edit 策略。
第二步：加载技能并执行
在一次调用中加载 domain、render 和 strategy：
xmind skill show domain/<name> render render/strategy/<name>
然后按照加载的说明操作：
- 阶段 1 — 内容：遵循 domain 规则规划内容。
- 阶段 2 — 渲染：遵循 render + strategy 规则生成 markdown，选择骨架和颜色。将执行命令替换为云端上传：
cat <<'MD' | xmind cloud create --stdin --skeleton <name> --color <name>
# Central Topic
## Branch
### Sub-branch
MD
返回 {"success":true,"fileId":"...","url":"https://app.xmind.com/<id>"}。
如果在阶段 2 中某个子树需要不同的策略：
xmind skill show render/strategy/<other>
编辑思维导图
连接（仅在没有活动会话时）
xmind cloud sessions
# If empty or no session for this document:
xmind cloud open <link-or-fileId>
# → {"session":"abc","fileId":"...","root":"..."}
快速编辑
xmind cloud read --session <id>
xmind cloud add --session <id> --parent <title> --topic <text>
xmind cloud update --session <id> --topic <old-title> --title <new-title>
xmind cloud delete --session <id> --topic <title>
cat <<'BATCH_EOF' | xmind cloud batch --session <id>
[{"op": "...", ...}]
BATCH_EOF
引导式编辑
对于复杂编辑（优化、审查、重构、重新样式），加载编辑指南：
xmind skill show edit/guide
遵循指南的分析模板，然后通过 xmind cloud batch --session <id> 应用更改。
上传已有文件
xmind cloud upload output.xmind
错误处理
- {"error":"token_expired"} → Token 过期。使用
xmind cloud auth login重新认证。 - {"error":"Session not found"} → 重新打开：
xmind cloud open <link>。 - {"error":"Authentication failed"} → Token 无效。
- {"error":"exceed_files_limit"} → 云存储已满。