前言¶
DeepSeek Harness (DSH) 提供了插件擴展能力，用於豐富智能體在特定場景下的表現。在長時間編寫代碼或處理任務時，需要隨時記錄靈感或進行知識回顧。dsh-gaokao 插件提供了一個桌面級的可視化錨點，模擬高三教室的黑板，既能顯示倒計時，也能在合適時機觸發知識點抽背。
插件介紹¶
該插件由 weibaohui 維護，屬於記憶類插件。它通過桌面懸浮的小黑板組件，結合 Markdown 知識卡框架，實現倒計時顯示與隨機抽背功能。內容基於通用高中課程知識點的事實、公式與定義，支持用戶自定義導入知識庫。
核心功能¶
- 雙形態小黑板：支持完整黑板和豎條收起兩種形態，雙擊可切換。豎條模式下僅顯示倒計時天數，不佔空間。
- 倒計時日曆：默認指向 6 月 7 日，可在設置中自定義日期，考後自動切換。
- 自由縮放與外觀：提供 30%-150% 的滑桿縮放控制，支持 7 種底色和 4 種格線樣式的紙張定製。
- Markdown 知識卡渲染：支持標題、列表、代碼、引用、粗體等 Markdown 語法。
- 抽背與瀏覽控制：支持隨機抽卡、上一個/下一個（基於瀏覽歷史），整副洗牌機制確保不重複。
- 收藏與關聯：支持將卡片收藏到本地，支持通過底部 chips 或正文
[[wikilink]]進行關聯跳轉。 - 重點學科過濾：可在設置中勾選重點學科，隨機抽卡時僅從中選取。
- 本地導入與開放框架：支持從本地文件夾導入 Markdown 知識卡（支持
dataDir替換或extraDirs追加），符合學科/分類目錄結構即可自動加載。
安裝¶
使用官方命令安裝 Web Profile 插件：
dsh plugin --profile web add @weibaohui/dsh-gaokao -w
安裝後重啓 dsh web 即可生效。
使用方法¶
- 打開 Web UI，右下角的小黑板默認顯示倒計時。點擊黑板翻開知識卡。
- 雙擊黑板可將其收起爲豎條（僅顯示天數），再次雙擊展開。
- 使用黑板上的按鈕進行操作：
- 🎲 隨機：從當前學科範圍再抽一張。
- ⏮ / ⏭：在瀏覽歷史中前進或後退。
- ❤：收藏當前知識點，點擊 ⭐ 查看收藏夾。
- 在設置（⚙）中調整紙張樣式、縮放比例、導入本地知識卡文件夾、設置重點學科或修改高考日期。
知識卡格式與熱更新¶
知識卡爲 Markdown 文件，按 學科/分類/卡.md 結構存放。支持 Frontmatter 指定學科、年級、標籤和關聯卡片。插件會自動跳過 README.md、. 開頭文件和 _ 開頭目錄。
改動文件後，通過 API 端點觸發熱刷新：
GET /dsh-gaokao/api/reload
版本兼容性¶
插件版本 0.4.2 適配 DeepSeek Harness 版本 0.1.7-rc.2。
結語¶
該插件通過可視化的桌面組件將記憶複習融入日常開發工作流，適合需要高頻複習知識點或進行代碼筆記整理的開發者使用。
