前言¶

在 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