用途：该技能教你直接调用 Mindmap.io 的 HTTP 节点 API 来驱动思维导图，是 mindmapio-mcp 服务器的替代方案，使用相同的原语，但不需要 MCP 客户端，只需带认证的 HTTP 请求。
认证与设置：每次调用都需在请求头中携带个人访问令牌：Authorization: Bearer $MINDMAP_API_TOKEN。令牌在 Mindmap.io 的 settings → API access 生成，重新生成会立即吊销旧令牌。可设置环境变量 MINDMAP_API_TOKEN 与可选的 MINDMAP_API_BASE_URL（默认 https://mindmap.io）。切勿打印、回显或提交令牌。
读取：GET /api/mindmaps 列出地图；GET /api/mindmaps/{id} 读取完整地图；GET /api/mindmaps/{mapId}/nodes/{nodeId} 读取单个节点；GET /api/mindmaps/{mapId}/nodes/{nodeId}/subtree?depth=N 读取子树，省略 depth 返回完整子树，0 仅返回节点，1 返回节点及直接子节点。
结构写入：POST /api/mindmaps 创建地图；POST /api/mindmaps/{mapId}/nodes 创建节点，nodeId 需在地图内唯一，由客户端自行生成；PATCH /api/mindmaps/{mapId}/nodes/{nodeId} 更新节点；DELETE 删除节点（级联删除后代，根节点不可删）或删除地图。节点内容以 UIMessage 数组形式发送，每条消息为 {role, parts}，每个 part 为 {type: "text", text}。
生成式操作：POST .../submit 运行 LLM 并阻塞至祖先节点生成完毕；POST .../auto-expand 生成后续提示作为排队的子节点（count 1–4，默认 2，仅一层，不运行子节点）；POST .../retry?force=true 重试；POST .../interrupt 中断。生成式操作计费，超预算返回 429。
发布：POST /api/mindmaps/{mapId}/publish 将地图从私有转为公开并生成公开 id；DELETE 取消发布。可据此构建查看链接与 iframe 嵌入链接。
限制：auto-expand 不递归、不运行子节点，需自行驱动递归；常见错误状态包括 401、403、404、400、409、429，遇 429 应停止生成并展示升级提示而非盲目重试。