前言¶
在 DSH 裏寫代碼、查資料時，單詞往往散落在備忘錄、獨立 App 或在線詞庫裏，和當前工作環境脫節。常見做法是導出詞表再導入背詞軟件，或用通用筆記記釋義，但插圖、發音和練習很難和「這一張卡」綁在一起。
下面介紹維護者 shallinta 出品的 DSH 插件 隨記單詞本（源碼倉庫 shallinta/dsh-agentic-word-book，npm 包名 @suiji-ai/dsh-agentic-word-book，當前版本 1.1.0，MIT 許可證）。它在 DSH 左側欄提供「一個詞一頁」的瀏覽與練習，詞庫以本地目錄保存，插件包只帶功能代碼，不帶詞庫。
這是什麼¶
隨記單詞本屬於 DSH 社區插件目錄中的「記憶」類插件。核心思路是：每個單詞佔一整頁，插圖、音標、發音、常用詞組、例句放在同一視圖裏，並附帶挖字母拼寫練習與單詞辨析；切換頁面再回來，練習進度仍保留。
詞庫、插圖與發音文件落在本機目錄（默認 ~/Documents/dsh/suiji-word-book/，Windows 上爲 %USERPROFILE%\Documents\dsh\suiji-word-book\）。換機時複製該目錄即可遷移數據。
核心功能¶
單詞卡與首頁¶
首頁可配置標題、副標題的對齊與配色，背景圖可替換並調節透明度。單詞卡支持按日期、首字母、字母數量分組，正序或倒序排列；標籤篩選與「已掌握」開關；右下角回到頂部。
單張單詞卡包含大插圖、手寫體詞頭、音標、英文釋義；多詞性時釋義橫向排開，每個詞性配一條例句。提供 4 檔倍速發音、五條常用詞組，內容在卡片內滾動。
練習模塊¶
拼寫練習對當前詞挖掉部分字母，用 Tab 提示、Esc 換題、Enter 重聽或下一題，答完自動進入下一題。
單詞辨析提供 12 種題型輪換，題干與選項都錨定當前單詞。
AI 加詞與標籤¶
點「+單詞」輸入想學的內容後，由 DSH 中的模型寫詞條、生成插圖與發音（需先安裝技能並打開「+單詞」按鈕，默認隱藏）。裝好技能後，也可通過 /suiji-word-book 讓 AI 改詞條、打標籤、換插圖或主音頻。
標籤在設定裏配置選項；卡片右鍵可多選打標，首頁用 chip 快速篩選。「已掌握」爲固有標籤，由首頁右側開關控制顯隱。
設定與字體¶
設定頁分組包括：單詞本外觀、字體、瀏覽與排序、標籤、目錄、技能與權限等。單詞字體與詞組例句字體各選一款；內置 Patrick Hand、Kalam、Comic Neue、Caveat 四款開源字體（SIL Open Font License 1.1，許可證文本在插件 assets/fonts/）。
技能安裝在 ~/.agents/skills/suiji-word-book/，內含 create-word.mjs（建佔位詞條與圖）與 make-audio.mjs（合成發音：macOS 用 say + afconvert，Windows 用 System.Speech）。已安裝技能版本與當前不一致時，首頁左上角會出現「技能有更新，點此重裝」提示。
安裝與啓用¶
把下面整段發給 DSH，按 README 中的安裝說明操作（不要自行拼接未在文檔中出現的 dsh plugin add 命令）：
請幫我安裝 DSH 插件「隨記單詞本」：
源碼倉庫 https://github.com/shallinta/dsh-agentic-word-book
裝好後左側欄應該出現「隨記單詞本」，沒出現就重啓 DSH 或讓模型檢查插件狀態。
本機已有源碼時，可讓模型通過 plugin_manager 的 install_bundle，將 target 指向包目錄。上架後亦可在 DSH 插件市場搜索「隨記單詞本」安裝。
裝好後左側欄應出現「隨記單詞本」；若未出現，重啓 DSH。
插件以當前 DSH 進程權限運行。安裝前請自行查看倉庫源碼與 MIT 許可證，確認符合你的環境與安全要求。
第一次使用¶
- 打開左側「隨記單詞本」。首次運行會自動創建單詞本根目錄（默認
~/Documents/dsh/suiji-word-book/）。 - 點右上角齒輪，進入「技能與權限」，點「安裝技能」。
- 在同一分區打開「+單詞」按鈕（默認隱藏）。
- 回首頁點「+單詞」，輸入幾個想學的詞並回車；插件會新建會話，由 AI 生成詞卡。
- AI 完成後切回單詞本刷新，即可看到新卡片。
數據目錄結構¶
根目錄可在設定中修改。主要文件如下：
~/Documents/dsh/suiji-word-book/
settings.json ← 標題/副標題、背景、分組、排序、根目錄、是否顯示 +單詞 等
meta.json ← tagList 與每詞 tags
words.json ← 詞條數組（多詞性在 senses 裏）
words/<slug>/ ← 插圖、自定義資源、word.wav 與各詞組/例句發音等
插件不上傳詞庫數據，也無遙測。僅在使用「+單詞」時，你輸入的單詞會發往 DSH 裏配置的模型服務。插件更新不會改動根目錄內容；備份即複製該目錄。
適用場景與注意¶
適合需要在 DSH 工作流裏背單詞、希望詞庫完全本地化、並願意用 AI 一次性生成插圖與發音的開發者或學習者。
與同系列本地優先筆記插件「隨記」（@suiji-ai/dsh-agentic-notes）思路一致：數據在本地，功能在插件。
社區目錄頁：skillhub.cn 上的隨記單詞本。目錄爲社區站點，與 DeepSeek / 幻方無官方從屬關係；DSH 生態遵循「一切皆插件」的擴展方式。
更多截圖與約 3 分鐘演示流程見 GitHub README：shallinta/dsh-agentic-word-book。
