核心用法
XMind Generator 是一款基于 Node.js 的命令行工具，利用 XMind SDK 将结构化文本转换为 .xmind 文件。用户可通过两种方式输入内容：Markdown 大纲格式（支持 # 标题、- 列表、缩进层级）或自由文本描述（需先转换为大纲结构）。
典型工作流程：
1. 接收用户输入（大纲文件路径或内联文本）
2. 若为自由文本，先转化为层级化 Markdown 结构
3. 调用 scripts/generate_xmind.js 生成文件
4. 输出至指定路径（默认为工作区目录）
命令示例：
node scripts/generate_xmind.js --input outline.md --output mindmap.xmind
显著优点
- 格式兼容性强：同时支持标准 Markdown 大纲和自然语言描述，降低使用门槛
- 原生格式输出：直接生成
.xmind文件，非图片或 PDF，支持后续在 XMind 客户端中完全编辑（调整布局、样式、添加图标等） - 灵活输入方式：支持文件路径、内联文本（
--text）和标准输入（stdin）三种模式 - 本地化处理：依赖预装的
xmindnpm 包，无需联网调用 API
潜在缺点与局限性
- 依赖 Node.js 环境：必须在技能目录内执行，对非技术用户存在路径认知门槛
- 样式控制能力弱：仅生成基础结构，不支持主题样式、图标、标签、备注等高级 XMind 特性
- 错误反馈有限：命令行工具的错误提示较为技术化，缺少可视化校验机制
- 缩进敏感：Markdown 解析依赖严格缩进，格式不规范时可能导致层级错乱
- 平台限制：输出文件需 XMind 桌面端打开，无法直接生成在线协作版本
适合人群
- 需要快速将文本大纲可视化的项目经理、产品经理、学生
- 习惯用 Markdown 做笔记，希望一键转为脑图的知识工作者
- 需在本地 XMind 中二次精修结构，而非仅获取静态图片的用户
常规风险
- 路径执行风险：必须
cd到指定技能目录运行，路径错误会导致模块加载失败 - 输入注入隐患：若直接传递未过滤的用户输入到
--text参数，存在命令注入可能性（建议对输入进行转义或限制特殊字符） - 文件覆盖风险：默认输出路径固定，重复生成可能覆盖旧文件，建议显式指定带时间戳的文件名
- 依赖失效风险：
node_modules若被清理或损坏，脚本将无法运行