dsh-mindmap：DeepSeek Harness 的打印级复习思维导图生成插件

dsh-mindmap 是 DeepSeek Harness（DSH）的思维导图模式插件（DSH plugin），由 chenw2759-wq 维护，采用 TypeScript 编写，最近更新于 2026-08。它解决的是学生和教师将课件（PPT/PDF/Word）与电子书快速整理成打印级复习思维导图 HTML 的痛点，输出 A3 横向、每主干一页、大括号式横向布局、黑体字体的文档，并支持封面总览与交互式测试题，方便直接打印复习。核心能力包括：四种思维导图风格（经典大括号、极简商务、活泼创意、学术整理）、Agent 工具 mm_generate 与 mm_extract、以及固化构建方法的 mindmap-builder skill。

dsh-mindmap 这个 DSH plugin 支持哪些核心特性？

插件提供两种 Agent 工具：mm_generate 一键生成 HTML（含逐页溢出报告与风格参数），mm_extract 提取纯文本课件。产出规格严格对齐范例：A3 横向（420mm×297mm），每页一个主干知识点，根节点在左（渐变盒 + 高光），SVG 大括号，右侧分组堆叠；字体采用黑体（微软雅黑/思源黑体），字号相对大（条目 17pt 起，密集页自动降至 12.5–15pt），内容纵向均匀铺满页面（填充率 60–96%）。防溢出机制会在渲染前按字符量预算，超量自动降字号，仍超则报告需拆分主干页。此外，右侧虚线框笔记区留白供学生补充，封面页包含大标题、依据来源与目录索引，可选交互式测试题页（choice/tf/fill/short 题型，一键批改，题目多时自动紧凑排版）。

dsh-mindmap 怎么安装？

安装命令如下（在 DSH 的 web profile 中执行）：

dsh plugin --profile web add github:chenw2759-wq/dsh-mindmap

安装后需构建插件（在插件目录运行 pnpm install --no-frozen-lockfile、pnpm exec tsc -p tsconfig.build.json、pnpm exec tsdown），然后安装到 web profile 并清理 pnpm 引入的 harness 嵌套副本，最后重启 dsh web 加载新 bundle 与预设。建议一并安装 dsh-IDE 插件用于预览生成的 HTML，因为本插件专注生成，不内置预览。

dsh-mindmap 怎么使用？

推荐方式：新建会话时选择「思维导图模式」，然后让 Agent 处理课件与电子书，例如说「把 D:\课件\ 下的 PPT 与电子书按 mindmap-builder skill 整理成思维导图，每个主干一页，输出到 D:\复习\思维导图_01.html，附带测试题」。Agent 会用 MinerU 解析资料，提取共同重点，组织 MindmapDoc JSON，调用 mm_generate 生成，并按溢出报告拆分/压缩直到每页放得下。生成后可用 dsh-IDE 打开 HTML 预览或打印。

dsh-mindmap 的 MindmapDoc JSON 结构是怎样的？

MindmapDoc JSON 是生成思维导图的核心数据结构，包含 title、course、ebook、branches（主干数组，每个含 id、title、en、groups，组内为 heading 与 items，条目可含 subs 子条目）以及可选的 quiz 数组（题型、问题、选项、答案、解析与易错点）。该结构由 Agent 组织后传给 mm_generate 渲染成 HTML。

dsh-mindmap 兼容哪些 DeepSeek Harness 版本和平台？

插件基于 DSH 官方 bundle 构建，依赖 @deepseek-ai/dsh-client-locale、@deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-ui-slots、@deepseek-ai/dsh-host-webserver、@deepseek-ai/dsh-llm、@deepseek-ai/dsh-system-prompt、@deepseek-ai/dsh-tools 等官方模块，因此兼容 DSH 的 web profile 环境，支持 Windows（安装示例使用 PowerShell）等平台。建议配合 dsh-IDE 插件获得最佳预览体验。

查看更多 DSH 插件，访问 dsh-plugin.org