dsh-mindmap: A Print-Ready Review Mind Map Generator Plugin for DeepSeek Harness
chenw2759-wq/dsh-mindmap
A DSH plugin that turns courseware and ebooks into print-ready review mindmap HTML with 4 styles and interactive quizzes.
Turn courseware and e-books into A3 landscape, one-main-branch-per-page review mind map HTML with four styles and interactive quizzes, ready for printing.
dsh plugin --profile web add github:chenw2759-wq/dsh-mindmap- Category
- Data & Knowledge
- Platform
- DSH-Plugin
- Author
- chenw2759-wq
- Distribution
- Plugin
dsh-mindmap Key Features
dsh-mindmap Repository
dsh-mindmap Repo Summary
dsh-mindmap is a mindmap mode plugin (DSH plugin) for DeepSeek Harness, maintained by chenw2759-wq, written in TypeScript, and last updated in 2026-08. It solves the pain point of converting courseware (PPT/PDF/Word) and e-books into print-ready review mind map HTML, outputting A3 landscape, one main branch per page, curly-brace horizontal layout, with bold fonts, cover overview, and interactive quiz questions for easy printing. Core capabilities include four mind map styles (classic curly brace, minimal business, creative, academic), Agent tools mm_generate and mm_extract, and a mindmap-builder skill that encapsulates the complete construction method.
What core features does the dsh-mindmap DSH plugin support?
The plugin provides two Agent tools: mm_generate for one-click HTML generation (with per-page overflow report and style parameters), and mm_extract for extracting plain text from courseware. Output specifications align with the example: A3 landscape (420mm×297mm), one main branch per page, root node on the left (gradient box + highlight), SVG curly braces, right-side grouped stacking; bold fonts (Microsoft YaHei / Source Han Sans), relatively large font sizes (items start at 17pt, auto-reduce to 12.5–15pt on dense pages), and content vertically space-evenly fills the page (fill rate 60–96%). The overflow prevention mechanism budgets character count before rendering, auto-reduces font size if over, and reports if a main branch needs splitting. Additionally, a right-side dashed note area is left blank for student annotations, the cover page includes a large title, source attribution, and table of contents, and an optional interactive quiz page (choice/tf/fill/short question types, one-click grading, auto-compact layout for many questions).
How to install dsh-mindmap?
Run the following command in the DSH web profile:
dsh plugin --profile web add github:chenw2759-wq/dsh-mindmap
After installation, you need to build the plugin (run pnpm install --no-frozen-lockfile, pnpm exec tsc -p tsconfig.build.json, pnpm exec tsdown in the plugin directory), then install to the web profile and clean up pnpm-introduced harness nested copies, and finally restart dsh web to load the new bundle and presets. It is recommended to also install the dsh-IDE plugin for previewing generated HTML, as this plugin focuses on generation and does not include a built-in preview.
How to use dsh-mindmap?
The recommended way: when creating a new session, select "Mindmap Mode", then ask the Agent to process courseware and e-books, for example: "Organize the PPT and e-books under D:\课件\ into a mind map following the mindmap-builder skill, one main branch per page, output to D:\复习\思维导图_01.html, with quiz questions." The Agent will parse materials with MinerU, extract common key points, organize MindmapDoc JSON, call mm_generate to generate, and split/compress based on overflow reports until each page fits. After generation, use dsh-IDE to open the HTML for preview or printing.
What is the MindmapDoc JSON structure of dsh-mindmap?
MindmapDoc JSON is the core data structure for generating mind maps, containing title, course, ebook, branches (array of main branches, each with id, title, en, groups, where groups have heading and items, and items can have subs sub-items), and an optional quiz array (question type, question, options, answer, explanation, and pitfall). This structure is organized by the Agent and passed to mm_generate for rendering into HTML.
Which DeepSeek Harness versions and platforms are compatible with dsh-mindmap?
The plugin is built on the official DSH bundle, depending on official modules such as @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, and @deepseek-ai/dsh-tools. Therefore, it is compatible with DSH's web profile environment and supports platforms like Windows (installation examples use PowerShell). It is recommended to pair with the dsh-IDE plugin for the best preview experience.