前言¶
在 DSH 裏寫技能說明、插件 README 或內部文檔時，同一品牌或產品名經常出現中英文混寫、簡稱與全稱並存。人工通讀成本高，也容易在發佈前漏掉不一致。DeepSeek Harness 支持通過插件擴展工作流；@deepwhale-cn/dsh-terms-glossary（倉庫 feely0208/dsh-terms-glossary）面向這類問題：掃描指定目錄下的文本類文檔，按文件統計你關心的多種寫法各出現多少次，便於發現混用。插件只提示、不修改文件。
這是什麼¶
深鯨術語統一 是 DSH 工作流類插件，npm 包名爲 @deepwhale-cn/dsh-terms-glossary（當前資料中版本爲 0.1.0，MIT 許可證）。維護者與源碼託管在 GitHub 用戶 feely0208；作者在 package 中標註爲溫州深鯨智能科技有限公司。社區目錄頁：skillhub.cn 插件頁。該目錄爲社區站點，與 DeepSeek / 幻方無官方從屬關係。
一句話定位：給定一組術語別名（如 深鯨 與 DeepWhale），在 .md / .txt 中計數並彙總，幫助統一用語。
核心功能¶
根據 README 與 package 描述，已覈實能力如下：
- 多寫法掃描：通過
--terms傳入逗號分隔的多種寫法，在同一概念下對比出現次數。 - 按文件彙總：結果按文件列出各寫法的出現次數，便於定位需要統一的文檔。
- 格式範圍：僅處理
.md與.txt，不覆蓋其他後綴。 - 只讀行爲：掃描與提示，不自動改寫磁盤上的文件。
- Web 側欄：安裝並啓用 Web profile 後，可在側欄使用「深鯨術語統一」面板（與 CLI 同屬該插件能力）。
運行環境要求（來自 package.json）：Node.js >= 18；DSH 引擎 >=0.1.0-rc.6 且 <0.3.0。插件依賴 @deepwhale-cn/dsh-guard-core，並以 Web 客戶端方式注入（platform: web）。
安裝與啓用¶
在已安裝 DSH 且使用 web profile 的前提下，安裝命令以 README 原文爲準：
dsh plugin --profile web add @deepwhale-cn/dsh-terms-glossary
安裝前建議自行查看 GitHub 源碼與 LICENSE，並確認插件將以當前 dsh 進程權限訪問你指定的輸入路徑。
典型用法¶
命令行入口爲 dsh-terms-glossary（見 package bin 配置）。README 示例：
dsh-terms-glossary --input ./文檔 --terms '深鯨,DeepWhale'
說明這一步在做什麼：--input 指向待掃描目錄（示例中爲 ./文檔），--terms 列出需要一併統計的寫法。執行後得到按文件劃分的次數信息，用於檢查是否混用「深鯨」與「DeepWhale」等別名。
若已在 DSH Web 中安裝該插件，可在側欄打開「深鯨術語統一」，在面板中完成同類掃描（具體表單項以插件 UI 爲準，行爲原則與 README 一致：只掃 .md/.txt，只提示不改文件）。
適用場景與注意¶
適合：維護多份 Markdown/純文本文檔的團隊；在發佈前做術語一致性自查；與 DSH 文檔、技能說明寫作流程配合。
注意：
- 插件不替代人工定稿，只輔助發現混用。
- 掃描範圍限於
.md/.txt；代碼註釋、JSON、HTML 等不在默認範圍內。 - 社區目錄顯示的星標等信息可能變動；以 GitHub 倉庫與 README 爲準。
- 任何 DSH 插件均在本地以當前用戶權限運行，請勿對不可信目錄盲目執行掃描。
結尾¶
dsh-terms-glossary 把「同一概念多種寫法」從主觀通讀變成可復現的按文件計數，適合寫文檔、改 README 前的快速自檢。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub 倉庫。
