Xmind 技能与命令行界面 (CLI) 命令行工具)

什么是 Xmind Skill & CLI？

Xmind Skill & CLI 将 Xmind 的视觉思维能力带入 Codex, Claude Code, Cursor, 和 OpenCode 等 AI Agent（智能体）。Xmind CLI 允许您的 Agent 创建、读取、编辑和检查本地原生的 .xmind 文件，而 Xmind Skill 则帮助其整理内容、选择合适的结构和主题，并突出展示重点内容。

只需给您的 Agent 设定一个目标和源材料——无论是文档、网页、图片、代码，还是已连接的应用——它就能生成一个结构化、可编辑的 Xmind 文件。Xmind Skill 将 Xmind 积累的产品经验、视觉设计思维以及经过验证的导图实践融入您的工作流。它不随机套用结构和主题，而是帮助您的 Agent 整理内容，根据具体任务选择合适的视觉结构，并进行重点标注。

为什么选择 Xmind Skill & CLI？

• 整合您 Agent 生态中的多方资源 — 在单个导图工作流中整合本地文件、网页内容以及 Notion 和 Slack 等已连接应用中的内容。

• 应用成熟的 Xmind 导图实践 — 该 Skill 基于 Xmind 的产品经验、视觉设计思维和实际验证，能引导您的 Agent 梳理内容并选择对应的结构、主题、布局及视觉划重点。

• 创建可编辑的本地文件 — 生成原生的 .xmind 格式文件，您可以随时打开、修改、存档或分享。

• 交付前进行质量把控 — Skill 能够根据清晰的维度审查内容结构和视觉呈现，而 CLI 则会在创建或编辑后对 .xmind 文件的完整性进行验证。

• 持续引入新的 Xmind 专业经验 — Xmind Skill 将随着全新的应用场景、结构方法和视觉实践持续更新，帮助您的 Agent 应对更丰富的场景，制作出质量更高的思维导图。

安装并连接 Xmind Skill & CLI

让您的 Agent 自动配置

1️⃣ 打开支持的 AI Agent，向其发送指令：

Agent 将自动安装 Xmind CLI 及随附的内建 Xmind Skills。

2️⃣ 当 Xmind 授权页面打开时，登录并确认授权。

3️⃣ 返回 Agent 并让其验证 Xmind CLI 是否已成功连接。

手动配置

如果您的 Agent 提示您手动进行配置，请在终端（Terminal）中运行以下命令：

最后一条命令将打开您的浏览器，以便您使用 Xmind 账户对 Xmind CLI 进行授权。

后续如需检查连接状态，请运行：

⚠️ 注意： 创建、读取及编辑 .xmind 文件需要您登录账号。

创建您的第一张思维导图

1️⃣ 向您的 Agent 提供源材料，并用 Prompt（提示词）告知该导图需要达到的目标、它的使用者是谁，以及需要将其保存为本地的 Xmind 文件。

您的 Agent 可以使用单一来源，也可以将多个来源结合：

• 直接输入 — 提示词、粘贴的笔记或粗略的想法。

• 本地内容 — 文档、PDF、电子表格、代码、图片以及现有的 .xmind 文件。

• 网页内容 — 网页、文章、在线文档和公开的图片链接。

• 连接的应用 — 您的 Agent 可访问的外部应用中的内容，例如 Notion, Slack, Google Drive 或 GitHub。

例如：

2️⃣ 当 Agent 返回文件路径和检查结果时，即可直接在 Xmind 中打开该 .xmind 文件进行查看或继续编辑。

协助您的 Agent 提升制作效果

在 Prompt 中包含以下细节能够帮助更好地生成导图：

• 目的： 学习、规划、对比、演示、决策或复盘。

• 受众： 您自己、项目团队、决策者、客户或学生。

• 深度： 快速概览或详尽的思维导图。

• 侧重点： 结论、风险、行动点、证据、时间顺序或对比差异。

• 视觉方向： 偏好的结构、色彩调性或演示风格。

💡 部分高级导图选项可能需要消耗 Xmind 点数（credits）。如果需要使用点数，您的 Agent 会做出提醒。若请求的选项不可用，Xmind CLI 可能会生成一个较为基础的版本并报告处理差异。

读取、编辑与完善已有的思维导图

1️⃣ 告诉 Agent 本地 .xmind 文件的名称，让其读取并总结导图，并告诉它您想从中了解什么，例如关键决策、风险、缺失的信息或下一步的行动。

例如：

2️⃣ 向 Agent 提供您需要更新的本地 .xmind 文件名，并用通俗易懂的语言描述您的修改需求。

例如，您可以让 Agent 执行以下操作：

• 添加、重命名、移动或删除主题。

• 展开某个分支并补充更多细节。

• 重新组织层级结构或更改局部布局。

• 更换主题颜色或更新视觉划重点。

• 添加任务信息、标签、链接或图片。

• 在拥有多张画布（Sheet）的文件中对特定的画布进行编辑。

💡 小贴士： 如果在 Agent 编辑文件的同时您已经在 Xmind 中打开了该文件，请关闭并重新打开此文件以刷新至最新版本。

添加图片与链接

Xmind Skill & CLI 本身在本地文件的处理流中不支持自主生成新图片，但在需要时支持将现有的适配图片插入到导图中。

您的 Agent 可以插入：

• 您提供的本地图片。

• 网络上可公开访问的适配图片（例如 PNG 或 JPEG 格式）。

• 维基百科（Wikipedia）页面中的图片。

• 网页链接。

• 指向本地文件的链接。

⚠️ 注意： 本地文件链接指向的是您当前电脑上的存储位置。文件拷贝或移动到其他电脑后该链接可能会失效。若需要保持引用长期可用，建议使用网页链接。

您能用 Xmind Skill & CLI 做些什么？

• 快速概览 — 从特定主题、文章、网页或 PDF 中快速提炼核心观点，并将其整理成清晰易懂、一目了然的结构。

• 知识结构与调研导图 — 关联和梳理来自书籍、课程、文献、报告、笔记、数据或截图中的概念、论据、观点、结论及出处。

• 项目推进与执行导图 — 将想法、任务清单、会议纪要、白板照片和项目文档转化为逻辑清晰的背景、决策、优先级、风险、任务以及下一步执行计划。

• 对比分析与决策导图 — 统一标准以对比产品资料、功能文档、电子表格、设计方案、用户反馈或团队讨论，直观展现优劣对比、权衡（trade-offs）、风险和建议。

• 系统级架构图 — 通过分析代码、代码仓库、Issues（议题）、Pull Requests（合并请求）、技术文档和系统日志，直观呈现模块、依赖关系、数据流向以及变更产生的影响。

• 时间线与复盘导图 — 梳理邮件、日历、更新日志、历史文档及相关网页，理清核心事件、发展阶段、关键转折点以及事件背后的深层原因。

Xmind Skill & CLI 与 Xmind MCP 有什么区别？

Xmind Skill & CLI 和 Xmind MCP Server 均能实现创建、读取和编辑 Xmind 思维导图。两者都可以操作脑图内容和视觉元素，其主要区别在于您是从哪里开始工作的，以及您最终需要什么样的工作成果。

工作流偏向对话和云端导图时，选择 Xmind MCP

Xmind MCP 让您能直接在与 AI 工具的对话流中对云端思维导图进行调用和创作。它可以将对话中产生的点子或关键结论当场转化为可编辑的导图、搜索读取已存在于您 Xmind 云端工作空间中的导图、将存好的导图输入给 AI 对话作为参考上下文，并根据您的新指令来对这张导图进行修改。

适合以下场景使用：

• 您的想法、笔记、调研或策划方案等讨论过程就在 AI 应用中进行。

• 您希望在讨论话题与修改思维导图之间快速切换。

• 您想要检索并继续完善以前已经保存在 Xmind 云端工作空间中的导图。

• 您需要一个可以直接用 Xmind 打开、持续协同修改或方便共享的云端导图。

工作流涉及多数据源及本地文件时，选择 Xmind Skill & CLI

Xmind Skill & CLI 能够将您在 Agent 复杂工作流中接触到的各类资产整合输出为本地电脑上的原生 .xmind 格式文件。您的 Agent 可以调用本地存储的文件、网页、代码、图片以及它所接入的各种第三方应用的数据。此时 Xmind Skill 负责指导它如何整理收集到的零碎信息，挑选符合逻辑的结构、主题配色、整体排版及视觉重难点强调；CLI 则负责最终物理生成、检查以及确保输出导图文件是合法完整的。

适合以下场景使用：

• 您的原始材料分散在本地的不同电脑文件夹、多个网络网页或第三方已授权应用中。

• Agent 在正式动笔作图前，需要先做一番调研、分析、综合对比或内容梳理。

• 您需要获得一份分发极其自由的本地 .xmind 原文件以完成归档、工作交接或将其加入到一个更长更复杂的流水线任务中。

• 您希望 Xmind 的制图规范来引导内容的呈现与视觉美化，并在最终向您交付文件前进行合规和视觉质量检测。

由于成品是通过本地文件的形式交付，它能完美契合您项目的本地文件管理归档，成为您自动化工作流的一环。

💡 小贴士： 当您需要直接编辑和使用云端思维导图时，选择 Xmind MCP。而当您需要产出离线可用的本地 .xmind 文件，或者构建一个结合了多种数据源、本地工具的长工作流时，选择 Xmind Skill & CLI。