sd-mind-map 是一个面向 Codex 的中文文章总结与思维导图 Skill。它能把长文、网页正文、短视频口播稿和会议转写稿，按阅读目的重构为 Mermaid mindmap、流程图、论证图及可下载的深色 PNG。
它不是机械缩写工具。Skill 会先确认用户准备怎样使用导图，再决定内容重点与图形结构；在 Mermaid 场景下同步交付可渲染导图、可复制源码、.mmd 文件和高清 PNG 成品。
A local-first Codex skill for article summarization, transcript structuring, Mermaid mind maps and PNG export.
点击横版图查看全部真实案例；每个案例都提供输入材料、同源 .mmd 和可放大的 PNG。
在 Codex 中粘贴下面这段内容：
$sd-mind-map
目的：4，执行落地。
请把下面内容整理成思维导图：
写短视频前，先确定观众看完只改变哪一个判断或动作。再保留理解这个结论必须出现的解释、例子和下一步，最后从正文最有冲突的内容中提炼开头。
没有指定目的时，Skill 会先展示带解释的选择菜单，而不是直接替你决定。还没安装？跳到安装说明。
这不是单独绘制的效果概念图。下面的 PNG 由仓库中的 sd-mind-map 读取同一篇口播稿、生成 Mermaid 源码，再通过内置本地预览器实际导出。
输入稿件的开头：
真正做好一条短视频，第一步不是写开头，也不是找爆款模板。先回答一个问题：观众看完，到底要发生什么变化？
导图定位：
- 阅读目的：执行落地。
- 内容类型：方法教程型。
- 核心问题：怎样让短视频重点清楚、容易听懂？
- 一句话结论：好短视频不是说得最多，而是让对的人完成一次明确变化。
点击图片可打开高清原图并继续放大。
查看完整 90 秒口播稿 · 查看 Mermaid 源文件 · 下载深色 PNG
这个案例刻意保留了一条清楚主线：定义一次变化 → 回答三个问题 → 先写价值再提炼开头 → 录制前回收承诺。导图没有机械塞入稿件的每一句话。
这个案例使用 GitHub 官方 README、Topics 和社交预览文档，区分官方材料直接支持的事实、总结者分析以及不能越过的结论边界。
点击图片可打开高清原图。导图的结论是：这些优化能改善理解、发现入口和分享识别度，但官方材料不支持“保证排名或流量增长”的绝对说法。
查看来源与准确性说明 · 查看 Mermaid 源文件 · 下载深色 PNG · 浏览全部案例
- 支持快速了解、学习复习、汇报分享、执行落地和可信度判断。
- 清洗口播与自动字幕转写，但不擅自改变原意。
- 区分实质内容、传播包装、作者自述、证据、分析与推论。
- 识别标题承诺与正文结论之间的表面矛盾。
- 根据真实关系选择 Mermaid mindmap、flowchart、argument map 或 Markdown 树。
- Mermaid 输出自动生成与内置本地预览器一致的深色 PNG。
- 同步提供
.mmd源文件，方便继续编辑与复用。 - 支持 XMind-friendly Markdown、Markmap、OPML 和 Excalidraw 结构。
- 打开 最新版本。
- 下载
sd-mind-map-v1.3.0.zip。 - 解压后，把
sd-mind-map文件夹复制到 Codex Skills 目录。
Windows：
C:\Users\<你的用户名>\.codex\skills\sd-mind-map
macOS / Linux：
~/.codex/skills/sd-mind-map
如果 Codex 没有立即识别，重新打开任务或刷新 Skills 列表。
git clone https://github.com/Allensen/sd-mind-map.git然后只复制仓库中的 skill/sd-mind-map 到本机 Skills 目录。不要把仓库根目录的 README、CI 或开发文件复制进去。
在 Codex 中调用 $sd-mind-map，随后粘贴正文或提供可访问的内容。
$sd-mind-map
请把下面这篇文章整理成思维导图：
……
如果没有说明阅读目的，Skill 会先展示目的菜单。回复序号即可：
1 快速了解
2 学习复习
3 汇报分享
4 执行落地
5 判断文章是否可信
1 + 5 快速了解为主，可信度判断为辅
也可以直接指定格式：
1，使用 Mermaid flowchart
2，输出 XMind-friendly Markdown
4，PNG 使用透明背景
Skill 内置离线 Mermaid 预览器：
skill/sd-mind-map/assets/mermaid-preview-lite/index.html
直接用浏览器打开即可手动粘贴、缩放、平移和导出。自动 PNG 使用相同的渲染与导出逻辑，默认参数为：
- 深色背景。
- 2× 清晰度。
- 32px 安全边距。
- 最长边 8192px 保护。
- 同名文件自动添加数字后缀。
自动导出需要：
- Node.js 18 或更高版本。
- Chrome 或 Edge。
- Playwright。Codex Desktop 通常已包含；其他环境可以安装 Playwright，或通过
CODEX_NODE_MODULES指向包含 Playwright 的node_modules。
也可以手动运行：
node path/to/sd-mind-map/scripts/render_mermaid_png.mjs \
--input path/to/diagram.mmd \
--output path/to/diagram.png \
--scale 2 \
--background darkWindows PowerShell 示例：
node "$env:USERPROFILE\.codex\skills\sd-mind-map\scripts\render_mermaid_png.mjs" `
--input ".\diagram.mmd" `
--output ".\diagram.png" `
--scale 2 `
--background darksd-mind-map/
├─ README.md
├─ LICENSE
├─ CHANGELOG.md
├─ .github/
├─ docs/
├─ tests/
├─ tools/
└─ skill/
└─ sd-mind-map/
├─ SKILL.md
├─ agents/
├─ references/
├─ scripts/
└─ assets/
只有 skill/sd-mind-map 是可安装的 Skill 本体。
仓库的 GitHub Actions 会检查：
- Skill frontmatter 和必要目录。
- 本机用户名、临时路径、备份文件与常见密钥痕迹。
- Node 渲染脚本语法。
- 内置 Mermaid 资源和第三方许可证。
- Flowchart 到深色 PNG 的真实导出。
- Release ZIP 是否能够重复构建。
本地验证：
python .github/scripts/validate_skill.py skill/sd-mind-map
node --check skill/sd-mind-map/scripts/render_mermaid_png.mjs
node --check tools/render_social_preview.mjs
python tools/package_release.py --version 1.3.0- 自动 PNG 依赖本机浏览器和 Playwright；只有预览器本身可以完全独立打开。
- 极大导图会自动降低实际导出倍率，避免浏览器画布超过 8192px。
- Skill 只能忠实处理实际获得的内容；无法确认完整正文时会明确标记范围限制。
- PNG 是阅读成品，不是可编辑源文件；继续编辑请使用同步生成的
.mmd。
可以。粘贴文章、网页正文、口播稿或会议转写后，Skill 会先确认你是想快速了解、学习复习、汇报分享、执行落地，还是判断内容是否可信，再按目的保留不同信息。
支持。Skill 会根据内容关系选择 mindmap、flowchart 或 argument map，并同步生成可复制 Mermaid 源码、.mmd 文件和深色 PNG。
不需要。仓库已经内置可离线打开的 Mermaid 本地预览器，可以缩放、平移和导出 PNG；自动导出也复用同一套渲染逻辑。
GitHub 主页中的案例图片可以点击打开原图。继续编辑时，使用同目录下的 .mmd 源文件在内置预览器中缩放和导出即可。
问题与建议可以提交到 Issues。提交前请移除文章原文、账号数据、访问令牌和其他私人内容。
本项目使用 MIT License。
内置 Mermaid 文件保留其原始许可证，详见 第三方声明 和 skill/sd-mind-map/assets/mermaid-preview-lite/vendor/MERMAID-LICENSE.txt。