前言¶
在 DeepSeek Harness(DSH)的插件体系里,常见做法是把不同能力封装成可安装、可触发的插件。对讲解型任务来说,纯文本输出有时不够直观:概念关系、流程步骤、器件结构等,都更容易借助图来表达。
dsh-illustrated-teaching 是一个面向 DSH 的社区插件,用于把知识点渲染成图解画廊,并提供本地导出。
这是什么¶
dsh-illustrated-teaching 是 DeepSeek Harness 插件,由 Henryang777 维护,采用 MIT 许可证。它把知识点自动渲染成图解画廊,定位上专为本科阶段学习设计。
它的主要做法是:由模型规划 3-6 张配图,并为每张填入知识数据;渲染成图解卡片;生成自包含画廊页;同时导出到本地文件夹。
核心能力¶
- 提供 8 套小红书科普风模板。
- 支持 Harness 对话触发和 HTTP API 调用。
- 生成自包含画廊页,图片以 base64 内联。
- 导出
PNG、captions.txt和manifest.json到本地文件夹。 - 支持 Wikimedia Commons / Wikipedia 真实图片检索,并自动署名。
- 无网络时,真实图片自动降级为 SVG 示意图,不会报错中断。
- 渲染降级链为:Playwright → 系统 Chrome/Edge → SVG 原生渲染。
安装与启用¶
前提条件:
- 已安装 DeepSeek Harness,版本为
dsh 0.1.0-rc.6。 - Node 版本满足
node >=22.19.0。
安装命令如下:
dsh plugin --profile web add github:Henryang777/dsh-illustrated-teaching
安装完成后,需要重启 Harness 使插件生效。
如需使用 Playwright 渲染,可先安装 Chromium:
npx playwright install chromium
也可以使用已安装的 Chrome/Edge,插件会尝试自动探测。浏览器路径也可通过环境变量 DSH_ILLUSTRATED_CHROME_PATH 指定。
安装验证接口如下:
curl http://127.0.0.1:3080/illustrated-teaching/health
典型用法¶
在 Harness 对话中,可以直接用自然语言触发。已核实的示例包括:
- “图解一下什么是 MOS 管”
- “图解一下什么是 PN 结”
- “帮我理解操作系统里进程和线程的区别”
- “科普一下蛋白纯化工艺,要配图”
- “一张图看懂芯片产业链”
也可以直接调用 HTTP API,适合脚本或自动化流程:
curl -X POST http://127.0.0.1:3080/illustrated-teaching/generate
适用场景与注意¶
适合把概念、流程、结构等知识点整理成可浏览图解的场景。插件生成的知识数据由调用的语言模型提供,用于严肃场景前请自行核实。
视觉风格学习自小红书 / B 站的优秀半导体科普图,仅借鉴版式语言,未使用其图片素材。
插件以当前 DSH 进程权限运行,安装前应检查源码与 MIT 许可证。社区目录是独立站点,与 DeepSeek / 幻方无官方从属关系。
链接¶
- GitHub:
https://github.com/Henryang777/dsh-illustrated-teaching - 目录页:
https://www.skillhub.cn/plugins/Henryang777/dsh-illustrated-teaching