前言¶
在 DeepSeek Harness (DSH) 的使用场景中，思维导图通常需要手动绘制或与源文件分离。dsh-mindmap 插件将两者合二为一：Markdown 文件即思维导图，聊天窗口即编辑器，AI 通过工具逐步修改 .md 文件，右侧面板实时渲染导图。插件处于 pre-1.0 阶段，核心功能已覆盖并通过测试。
核心功能¶
该插件通过四个核心工具 (mindmap_create / mindmap_open / mindmap_get / mindmap_update) 驱动工作流。
-
文件与根节点同步
Markdown 文件的根节点标题与文件名保持同步。当 AI 修改根节点名称时，文件名也会随之更新（需处理冲突）。 -
实时渲染与状态恢复
插件使用零额外通道的实时渲染机制，基于会话快照 (mindmap_*工具结果) 更新视图。它具备可靠的打开机制和可恢复的加载状态，即使在结构指纹变化或路径不匹配时也能恢复。 -
画布与交互
- MarkGrove 风格映射：支持标题层级、嵌套列表、代码块以及段落作为独立节点。
- 操作：支持居中画布、缩放（25%-300%）、平移、节点搜索与快速导航、折叠子树。
- 布局：支持浮动面板（280px~80% 视口）或原生侧边栏（需安装
dsh-better-sidebar）。
-
草稿与刷新保护
- 草稿保护：使用主机输入快照保护草稿、引用和附件。
- 从磁盘刷新：可在不发送模型请求的情况下刷新文件，保留草稿和附件，且不会让旧请求覆盖新视图。
-
导出与安全
- 导出：支持一键导出 PNG 图片，以及将当前导图复制全文为 Markdown 源码。
- 安全性：默认写入审批为“单次会话/文档”，避免 AI 持续写入打断工作流。客户端无直接文件系统写入权限，所有编辑通过 AI 工具进行。
安装与启用¶
此插件依赖 DSH 主环境及可选的侧边栏插件。
-
依赖项：
@deepseek-ai/dsh-tools(需满足特定版本要求)dsh-better-sidebar(可选，用于原生侧边栏集成，版本 >= 0.10.0)@deepseek-ai/schemastery(>= 3.18.0)
-
获取方式：
插件源码位于 GitHub 仓库：https://github.com/guhanfei-ai/dsh-mindmap
典型用法¶
- 打开与渲染：在会话工作目录中打开一个 Markdown 文件，插件将其解析为思维导图。根节点标题自动对应文件名。
- 迭代编辑：在聊天中输入指令，AI 调用
mindmap_update工具修改文件，右侧面板即时跟随变化。 - 导出：点击工具栏的“导出图片”生成 PNG，或点击“复制全文”将 Markdown 源码复制到剪贴板。
- 导航：使用缩放条或快捷键（⌘/Ctrl+F）搜索节点，按 Enter 键在匹配项间跳转。
适用场景与注意¶
- 适用场景：适合需要将结构化文档（如大纲、笔记）转化为可视化导图的场景，以及通过 AI 协作逐步完善思维导图结构的场景。
- 注意：
- 项目处于 pre-1.0 阶段，跨版本兼容性尚未认证。
- 写入审批默认为单次会话/文档，需注意安全性设置。
- Markdown 文件的层级结构、嵌套列表和代码块均支持 MarkGrove 风格映射。
结尾¶
dsh-mindmap 提供了一种将 Markdown 文件与思维导图紧密结合的工作流。通过工具链和实时渲染机制，它降低了从文本到结构的转换成本。项目地址：https://github.com/guhanfei-ai/dsh-mindmap
