Kmind Markdown 转思维导图

KMind Zen 是一款专业的思维导图产品，提供桌面端应用、网页端应用、思源笔记（SiYuan）插件和 Obsidian 插件。其官方网站为 https://kmind.app。

本技能可将 Markdown 标题层级结构转换为 KMind 思维导图图像。该技能完全离线运行，本地转换过程无需任何网络连接。

最佳输入是使用 Markdown 标题（如 #、##、###）构建的层级结构。各级标题将转化为思维导图中的节点；标题下方的非标题正文内容则作为该节点的备注（notes）。在图像导出时，备注默认以备注入口图标（note-entry icon）形式显示，而非展开的备注文本。如需查看或继续编辑这些备注，请导出 .kmindz.svg 文件，并在 KMind Zen 客户端中打开。

其主要优势在于：可在本地离线生成风格统一、视觉精美的思维导图。支持导出 PNG 或 SVG 图像，并提供主题预设（theme presets）、根布局（root layouts）、分支连线样式（branch edge routes）、明暗模式（light/dark appearance）以及彩虹色分支（rainbow branches）等配置选项。当用户仅要求“一张思维导图图像”时，默认输出 PNG；仅当用户明确要求矢量格式输出时，才使用 SVG。

当用户需要可编辑的 KMind 项目包时，优先导出 .kmindz.svg。该格式包可被任意 KMind Zen 客户端直接导入并无缝编辑。即使本地尚未安装 KMind Zen 客户端，用户仍可先以 SVG 文件形式快速打开并浏览导图内容，后续再导入客户端进行持续编辑。

适用于会议提纲、阅读笔记、头脑风暴清单、项目提案，以及各类 Markdown 标题大纲转思维导图的工作流场景。

本技能为可发布、自包含的独立能力模块。请始终从 {baseDir} 目录调用其内置入口脚本：

node {baseDir}/scripts/kmind-render.mjs ...

工作流程如下：

1. 若用户指定了特定主题、布局或连线样式，应首先查询可用选项：
   node {baseDir}/scripts/kmind-render.mjs themes --format json
2. 若用户提供的输入为原始 Markdown 文本（而非文件路径），请通过标准输入（stdin）传入。
3. 使用 render-markdown 命令启动导出流程。
4. 默认情况下，命令会尝试以无头模式（headless mode）自动启动用户本地的 Chromium 浏览器。
5. 首条标准输出（stdout）为 JSON 对象，含字段 status: "ready"。
6. 命令执行完成后，最后一条 stdout 输出为 JSON 对象，含字段 status: "done" 及最终的 outputPath。
7. 仅当自动启动浏览器不可用、且需由用户手动打开控制台打印出的本地 URL 时，才使用 --browser manual 参数。

若用户机器上无可使用的 Chromium 浏览器，则无法执行自动 SVG / PNG 导出。此时，可选择使用 --browser manual 手动打开本地页面完成导出；或明确告知用户：当前环境不支持自动导出。切勿伪造成功状态。

常用命令模板（默认推荐 PNG 输出）：

node {baseDir}/scripts/kmind-render.mjs render-markdown INPUT_OR_DASH --output OUTPUT.png --theme-preset PRESET_ID --layout LAYOUT_ID --edge-route EDGE_ROUTE_ID --appearance light|dark --rainbow auto|on|off --png-scale 1 --browser auto

参数说明：

• --output 在未指定 --image-format 时决定输出格式：.png 表示位图输出，.svg 表示矢量输出。当用户仅要求“一张思维导图图像”时，默认优先选用 .png。
• --theme-preset 应从 themes 命令输出中选取。推荐候选值包括：
  kmind-material-3-slate
kmind-rainbow-breeze
kmind-midnight-neon
kmind-material-3-rounded-orthogonal-ocean
kmind-material-3-rounded-orthogonal-forest
• --layout 应从 themes 命令输出中选取。常用选项包括：
  logical-right
logical-left
mindmap-both-auto
• --edge-route 应从 themes 命令输出中选取。常用选项包括：
  cubic
edge-lead-quadratic
center-quadratic
orthogonal
• --appearance dark 强制启用深色模式。
• --rainbow on 强制启用彩虹色分支（即使当前主题默认未启用）。
• --png-scale 1 与当前 KMind Zen 网页版默认导出分辨率一致。仅当用户明确要求更高分辨率 PNG 时，才提高该值。
• --browser auto 为默认行为，尝试自动启动本地浏览器。
• --browser manual 为手动回退模式。
• 请勿主动向用户暴露 --svg-mode 或 --png-mode 参数。内部默认已采用最贴近 KMind Zen 网页版实际导出行为的组合：SVG=fidelity（保真模式），PNG=accurate（精确模式）。仅当用户明确要求底层导出调优时，才提及这些高级参数。
• 图像导出采用类卡片式节点正文布局，与 KMind Zen 网页版行为高度一致。由非标题正文转换而来的备注，在图像中不展开显示，仅以备注入口图标呈现。

当用户未显式指定参数时，采用以下默认值：

• theme-preset： kmind-material-3-slate
• 推荐的图像输出后缀： .png
• image-format：优先根据 --output 推断；若无法推断，则默认回退为 svg
• layout：默认不显式覆盖，保持 KMind 的默认根布局
• edge-route：默认不显式覆盖，保持所选主题预设的默认连线样式
• appearance： light
• rainbow： auto
• svg-mode：内部默认为 fidelity
• png-mode：内部默认为 accurate
• png-scale： 1
• viewport-width： 1600
• viewport-height： 900

当前本技能发布安全白名单（publish-safe allowlist）如下：

• layouts： logical-right、logical-left、mindmap-both-auto
• edge-routes： cubic、edge-lead-quadratic、center-quadratic、orthogonal

若用户需要的是 KMind 项目文件（而非图像），请勿使用本图像导出流程。应改用：

node {baseDir}/scripts/kmind-render.mjs import-markdown INPUT_OR_DASH --output OUTPUT.kmindz.svg