---
name: xmind-creator
description: Create XMind mind maps (.xmind) from notes, outlines, or conversations. Use when the user asks for a mind map, 脑图, 思维导图, or .xmind file.
---

# XMind Creator

将笔记、需求或对话内容转换为结构化的 XMind 原生思维导图文件（`.xmind`）。

## 输出规则（严格遵守）

1. 调用 `write` 工具，`path` **必须以 `.xmind` 结尾**
2. `content` **必须是纯 Markdown 正文**，严禁使用 ``` 代码块包裹
3. **严禁输出 JSON / XML / XMind 数据结构** —— 插件会在落盘时自动编译为二进制 ZIP
4. 结构组织：
   - 推荐标题风格：`# H1` 为中心主题，`## H2` 为一级分支，下级推荐用 `- 无序列表` 缩进
   - 或纯列表风格：第一个顶层 `- 节点` 为中心主题，Tab 缩进表示层级
   - 多画布：用 `---` 水平分割线划分不同的 Sheet
5. 单图建议：深度 3–4 层，单节点子分支 ≤ 7 个，保持视觉清爽

## XMind 高级组件标记速查

底层转码引擎原生支持以下行内控制标记，书写在 Markdown 中即可自动编译为 XMind 高级节点：

| 组件 | Markdown 标记 | 位置与用法 | 效果示例 |
|---|---|---|---|
| **外框 (Boundary)** | `[B]标题` 或 `[B1]` | 主题行末尾；连续带同标记的主题归入同一外框 | `## 核心微服务 [B]核心服务集群` |
| **概要 (Summary)** | `[G]标题` 或 `[G1]` | 主题行末尾；概要的子节点以 `- [G1] 子主题` 写入 | `## 基础服务 [G]支撑底座` |
| **标注 (Callout)** | `[P]简短标注` | 主题行末尾；依附于主题的独立悬浮气泡 | `- 鉴权网关 [P]要求双因子验证` |
| **联系 (Relationship)** | 起点 `[^1](说明)`，终点 `[1]` | 跨分支建立连线箭头，数字编号必须成对出现 | `- 前端 [^1](调用鉴权)` ... `- 认证中心 [1]` |
| **任务状态 (Task)** | 行首写 `[ ]` `[x]` `[/]` `[-]` | 标记待办、完成、进行中、取消 | `- [ ] 数据库索引重构` |
| **分类标签 (Label)** | `#标签名` | 主题行内任意位置，支持多个 | `- 支付结算 #P0 #Q3重点` |
| **主题备注 (Notes)** | 缩进文本 或 `> 引用文本` | 主题正下方，用于承载长篇说明而不破坏导图结构 | `> 需兼容旧版 v1.0 协议` |
| **数学公式 (Math)** | `$公式$` 或 `$$公式$$` | 原生编译为 MathJax 扩展节点 | `$E=mc^2$` |
| **初始折叠 (Fold)** | `<!--c-->` | 默认收起复杂的子分支 | `- 归档历史模块 <!--c-->` |

> 深入的边界规则（如多层复杂外框编号、富文本备注规范）可按需阅读 `references/XMIND_MARKDOWN_CONVERSION_RULES.md`。

## 示例

```markdown
# 电商中台架构规划

## 用户与网关 #核心入口
- 统一 API 网关 [P]承载百万并发 [^1](RPC调用)
- 用户认证中心 [1]
  > 基于 OAuth 2.1 与 JWT 无状态校验

## 交易履约链路 [B]核心交易外框
- [x] 订单创建服务
- [/] 库存预占服务
- [ ] 支付清算通道

## 仓储物流 [G]供应链履约
- WMS 仓储管理
- TMS 运输调度
- [G] 自动化履约率达 98%

## 历史遗留系统 <!--c-->
- 旧版单体应用
```

## 微调

用户要求修改或补充节点时，重新调用 `write` 写入完整导图 —— `.xmind` 是二进制格式，`edit` 工具不支持。