chenw2759-wq/dsh-mindmap 预览 preview

chenw2759-wq/dsh-mindmap

DSH 思维导图模式插件:课件(PPT/PDF/Word)+电子书 → 打印级复习思维导图 HTML(A3 横向、每主干一页、大括号式横向、黑体、4 种风格、右侧笔记区、封面总览 + 交互式测试题)。建议配合 dsh-IDE 插件预览生成的 HTML。

Project Overview项目介绍

dsh-mindmap is a native plugin built exclusively for DeepSeek Harness (DSH), designed to turn course materials including PPT, PDF, Word slides and e-books into print-ready HTML mind maps. It adds a new "Mind Map Mode" option to DSH's new session preset picker, which sits alongside the existing standard mode and creation mode. After selecting the mode, users can pick one of four built-in styles: classic bracket, minimalist business, creative lively, and academic, which will be used as the default for all generated mind maps. The plugin ships with two Agent tools, mm_generate and mm_extract, and codifies the complete mind map building workflow for the DSH Agent.

This plugin is targeted at students who need to organize course review materials. To use it, users simply select Mind Map Mode when creating a new DSH session, specify the file path of their course materials, and ask the Agent to generate a mind map. The DSH Agent will first use MinerU to parse the original files, extract key content, organize it into a structured MindmapDoc JSON format, then call the generation tool to output the final HTML. It automatically handles content overflow by adjusting font sizes or splitting content across multiple pages to fit the print layout.

dsh-mindmap does not include a built-in preview feature, so the developer recommends installing the dsh-IDE plugin alongside it to preview the generated HTML files directly inside DSH. All content parsing relies on a local installation of MinerU, as the plugin itself only works with extracted plain text from the source materials. The output HTML is a completely self-contained file with no external dependencies, so it can be printed directly from any browser. To install the plugin, users need to build it via pnpm, clean up nested dependency copies, then restart DSH Web to load it.

这是一款专为 DeepSeek Harness 打造的原生插件,可帮用户将 PPT、PDF、Word 格式的课件和电子书整理成可直接打印的复习思维导图 HTML 文件。它在 DSH 新建会话的预设选择器中新增「思维导图模式」选项,和标准模式、创造模式并列,选择模式后还可从四种风格(经典大括号、极简商务、活泼创意、学术整理)中挑选默认生成风格,自带两个 Agent 工具 mm_generate 和 mm_extract。

这款工具主要面向需要整理课程复习资料的学生用户,典型工作流是用户在新建会话时选中思维导图模式,指定对应路径的课件和电子书,要求 Agent 生成思维导图。Agent 会先调用 MinerU 解析原始资料,提取重点内容并整理成结构化的 MindmapDoc JSON,再调用生成工具输出符合格式要求的 HTML,还会自动处理内容溢出问题,调整字号或拆分页面。

本插件本身不内置预览功能,推荐搭配 dsh-IDE 插件预览生成的 HTML 文件。内容解析依赖用户本地安装的 MinerU,插件仅处理提取后的纯文本。生成的 HTML 是自包含文件,无外部资源依赖,可直接用浏览器打印。安装需要通过 pnpm 构建,安装后需清理嵌套的依赖副本再重启 DSH Web 才能加载。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
  • Only 4 stars - very few users, little community feedback星标只有 4,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

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

把 chenw2759-wq/dsh-mindmap 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-mindmap(思维导图模式)

把课件(PPT/PDF/Word)与电子书整理成打印级复习思维导图 HTML 的 DSH 插件 + Agent 预设。

效果预览(一键生成的输出)

模式选择栏(与创造模式并列) 封面总览
模式选择 封面
封面总览 交互式测试题(一键批改)
封面 测试题

四种思维导图风格(新建会话选择「思维导图模式」后,在模式下方选择,选中即默认)

经典大括号 极简商务
经典 极简
活泼创意 学术整理
创意 学术

以上为实际渲染输出(Playwright 截图):模式选择栏与风格子栏目截自运行中的 DSH Web GUI; 思维导图页由 mm_generate 依据《证券投资与技术分析·第七讲 技术与趋势》课件真实生成, A3 横向、黑体、每主干一页、右侧笔记区留白,打印即分页。

  • 前端:新建会话时选择「思维导图模式」→ 模式下方弹出风格选择(经典大括号 / 极简商务 / 活泼创意 / 学术整理),选中后作为生成默认风格。新建会话的预设选择器中「思维导图模式」与「标准模式 / 创造模式」并列。
  • 预览:本插件不内置预览——生成的 HTML 用 dsh-IDE 打开预览(建议一并安装 dsh-IDE 插件,见下文)。
  • Agent 能力:mm_generate(一键生成 HTML,含逐页溢出报告 + 风格参数)、mm_extract(提取纯文本课件);mindmap-builder skill 固化「大括号式横向思维导图」的完整构建方法。
  • 产出规格(与范例 组胚思维导图_02_人体发育总论.html 一致):
    • A3 横向(420mm×297mm),打印即分页;每页 = 一个主干知识点
    • 大括号式横向布局:根节点在左(渐变盒 + 高光),SVG 大括号,右侧分组堆叠
    • 字体黑体(Microsoft YaHei / 微软雅黑 / 思源黑体),比宋体更清晰现代
    • 美术美工:4 种风格 × 每风格多套主题色按页轮换;根节点渐变、分组标题主色胶囊、条目圆点连接线、页眉渐变分隔线、页角装饰;节点圆角、配色克制、布局平衡、留白呼吸感
    • 字号相对大、占满页面:条目 17pt 起(密集页自动降至 12.5–15pt 保持不溢出),标题/根节点 21pt、分组 19pt、子条目 15pt;内容纵向 space-evenly 均匀铺满页面(填充率 60–96%),不留大片空白
    • 防溢出:渲染前按字符量预算,超量自动降字号,仍超则报告需拆分主干页
    • 右侧虚线框笔记区留白,供学生补充
    • 封面页(大标题 + 依据来源 + 目录索引);可选交互式测试题页(choice/tf/fill/short + 一键批改,题目多时自动紧凑排版)

安装

# 1. 构建插件(在插件目录)
cd ~/.dsh/plugins/dsh-mindmap
pnpm install --no-frozen-lockfile
pnpm exec tsc -p tsconfig.build.json
pnpm exec tsdown

# 2. 安装到 web profile(依赖 + bundle 均已加入 package.json)
cd ~/.dsh/profiles/web
pnpm install --no-frozen-lockfile

# 3. 清理 pnpm 引入的 harness 嵌套副本(每次 install 后必做)
cd ~/.dsh/profiles/web/node_modules/@deepseek-ai
Remove-Item cordis,cosmokit,dsh-credentials,dsh-home-paths,dsh-tools,schemastery -Recurse -Force -ErrorAction SilentlyContinue

# 4. 重启 dsh web(加载新 bundle 与预设)

建议一并安装 dsh-IDE 插件(用于预览生成的思维导图 HTML): 在 DSH 设置 → 插件中安装 dsh-IDE,生成后即可直接在 IDE 中打开 .html 预览。 本插件专注生成(课件 → 打印级思维导图 HTML),不内置预览。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-model-router 下一个 Next dsh-plugin-mermaid →