前言¶
在 DeepSeek Harness (DSH) 中，会话往往很长，关键信息（结论、决策、待办事项）分散在数十轮对话中，复盘时阅读完整记录效率较低。dsh-session-mindmap 插件旨在解决这个问题，它根据当前会话生成一个独立的 HTML 脑图文件，让重要信息一目了然。
这是什么¶
dsh-session-mindmap 是一个 DSH 客户端插件，由 jianyuepei 维护。它的核心功能是将 DeepSeek Harness 会话转换为独立的 HTML 脑图。生成的文件无需网络、字体或 CDN，完全离线可用。它通过增量生成和状态缓存，在保证准确性的同时减少对模型调用的消耗。
安装与启用¶
在安装前，请确保 DSH 版本为 0.2.0-rc.2 或更高。通过插件管理器安装：
dsh plugin add dsh-session-mindmap
安装后，插件会注册 /mindmap 命令及相关工具。
典型用法¶
插件支持通过命令行或直接与模型对话来触发。以下是可用的命令示例：
/mindmap：为当前会话生成脑图。/mindmap last：为最近一次会话生成脑图。/mindmap session-abc --reveal：为指定会话 ID 生成脑图，并自动在文件管理器中选中。/mindmap --no-open：静默生成文件，不自动打开。/mindmap --focus=发布方案：仅针对特定主题生成脑图。/mindmap --kinds=topic,file：包含文件类型的节点。/mindmap --lang=en：指定输出语言（默认为配置中的语言）。/mindmap list：列出最近的会话 ID 及标题。
核心能力¶
- 离线与独立：生成的 HTML 文件完全自包含，使用内联 SVG 绘制，不依赖外部资源，可离线查看或发送给他人。
- 交互功能：支持节点折叠、拖拽平移、滚轮缩放、搜索高亮以及悬停查看节点来源（如 conversation segment）。
- 导出功能：支持将脑图导出为 PNG、Markdown 和 Mermaid 格式。
- 增量生成：如果会话已有生成记录，再次运行会显示节点变更（如 13 → 18 nodes · +6 · -1），并标记新增节点。
- 智能缓存：基于会话状态缓存结果，在会话未新增内容时跳过模型调用，避免重复成本。
配置与缓存¶
插件支持在配置文件中设置参数。例如，设置默认语言和最大节点数：
- id: session-mindmap
name: 'dsh-session-mindmap'
config:
language: en
maxNodes: 120
结果文件默认存储在 <session workspace>/.dsh/mindmap/ 目录下。插件会自动处理增量更新，并在 .cache 目录中保存状态。
注意事项¶
- DSH 版本要求：必须使用 DSH 0.2.0-rc.2 或更高版本。
- Mermaid 渲染限制：DSH Web GUI 不支持渲染 Mermaid 代码块，因此插件生成的脑图本身不包含 Mermaid 渲染，但支持将其导出为 Mermaid 代码。
- 数据读取：会话数据通过
ctx.sessionQuery读取，磁盘日志需解压后才能获取完整信息。 - 错误处理：如果模型返回失败，插件会报错并终止，不会生成后备大纲。
- 隐私与权限：插件仅读取会话内容并发送给已配置的模型，数据仅写入会话工作区，不涉及其他外部传输。
结尾¶
dsh-session-mindmap 提供了一种将长对话转化为结构化文档的高效方式。通过离线文件、增量更新和交互式查看，它帮助开发者更好地梳理会话脉络。更多详情可查看插件目录或 GitHub 仓库。
