前言¶
在 DSH 裏和模型長期協作時，「你說的 X 指什麼」往往要在每個新會話裏重新解釋一遍。模型不會持久記住你們之間的稱謂約定，僅靠對話記憶或每輪重複說明，成本高也容易不一致。
下面介紹社區插件 dsh-term-dict（維護者 taoziliyouchong）：把約定寫成文本文件，某個詞在會話裏第一次出現時，把口徑自動注入模型上下文；並提供查、寫、體檢工具與設置面板。在 DSH 社區目錄中歸類爲「記憶」。
這是什麼¶
dsh-term-dict 是 DeepSeek Harness 上的術語字典插件。核心思路是：不靠模型記憶，不靠每輪複述——詞條寫一次，存於 $DSH_HOME/evolve/dict/，會話中首次命中詞條名或別稱時，以 runtime-context 注入定義與默認指代等字段。
除人工維護詞條外，插件可選「詞條檢測」：模型在對話中發現字典未收錄的新稱謂時，按模板寫入本會話賬本；同一候選在足夠多個不同會話重複出現且已有定義或默認指代時，可自動轉正進通用層（狀態 待觀察）。裝了進化模式插件 plugin-evolution 時，整套檢測會失效。
當前倉庫版本爲 0.2.0，許可證 MIT。
數據分層與詞條格式¶
詞條分兩層，各對應一個 Markdown 文件：
| 層 | 文件 | 收什麼 |
|---|---|---|
| 通用 | $DSH_HOME/evolve/dict/general.md |
跨任務類型都成立的稱謂 |
| 任務 | $DSH_HOME/evolve/dict/domains/<任務slug>.md |
只在本類任務裏成立的稱謂；表頭可寫 > 任務類型：中文任務名、> 工作空間：<路徑片段> 以綁定工作區 |
單條詞條建議採用如下結構（除「定義」外字段均可選）：
## 詞條名（別名：另一個叫法）
- 定義：一句話說清它是什麼
- 默認指代：單獨出現時默認優先指哪件事／哪份文件／哪條命令
- 邊界：它不是什麼
- 狀態：已確認 / 部分確認 / 待觀察 / 已廢
- 備註：可選；撞名認哪條也寫這裏
類型由主字段推斷：有定義＝稱謂型；只寫默認指代＝落點型；狀態爲已廢＝留檔型。手改文件時二級標題須爲 ## 詞條名；插件寫操作前會留 .bak。卸載插件不會刪除 evolve/dict/ 目錄，需自行清理。
核心功能¶
四條工具¶
| 工具 | 用途 |
|---|---|
dict |
統一入口：lookup 查（不傳 term 則列索引）／write 寫／lint 體檢／mute、unmute 管理當前會話是否灌注 |
dict-lookup |
只查：索引或詞條全文，別名等同詞條名 |
dict-write |
只寫：增改詞條；連續改同一詞到第 3 次會拒寫，需先問用戶 |
dict-lint |
只體檢：空定義、缺狀態、同層重名、別稱衝突等；查不到時給疑似同詞候選，不當作錯誤 |
自動激活¶
同一會話內，詞條名或別稱第一次出現時注入該條口徑；同一詞條只注入一次，狀態記在 $DSH_HOME/evolve/dict/.activation.json。用戶消息裏的詞在本次模型調用前生效；模型輸出中的詞需到下一步或下一輪才生效。
灌注範圍、單會話條數上限（默認 64）、總字數上限（默認 12000）等可在設置面板「高級設置」調整。未勾選「灌注的模式」時，新建模式默認不灌且可能看不到字典工具；可按工作空間路徑子串、會話 id 配置不灌注名單。
詞條檢測（可選）¶
默認在面板「高級設置」開啓。會話開始時注入判別機制與賬本路徑；模板見 $DSH_HOME/evolve/dict/auto/template.md。候選塊須含 EVID: 與「結論：」（去空白後大於 10 字）。跨會話權重記在 auto/weights.json；到 3 個不同會話且已有定義或默認指代時轉正進通用層。
設置面板¶
DSH 設置 →「術語字典」：左欄管理通用層與任務層；右欄「詞條」「原文」視圖編輯；設置頁含自動激活、注入上限、檢測開關、灌注模式、跳過工作空間等。「結構」頁管理模塊與類型組合。
面板後端在本機註冊 25 條路由，前綴 /dsh-term-dict，僅接受迴環地址；遠程非本機訪問面板可能 403。
安裝與啓用¶
要求 DSH >= 0.2.1-alpha.1（README 寫明實測 0.2.1-alpha.3、0.2.2-rc.1）。使用非 desktop 的 profile 時，將命令中的 profile 名替換爲你的配置名。
dsh plugin --profile desktop add github:taoziliyouchong/dsh-term-dict
裝完後重啓 DSH。插件以當前 DSH 進程權限運行，安裝前建議在 GitHub 查看源碼與 MIT 許可。
典型用法¶
1、查已有詞條或列索引
通過 dict 或 dict-lookup，action=lookup；不傳 term 即列索引。未收錄時返回疑似同詞，便於決定是否新建。
2、寫入或修訂詞條
dict-write 或 dict 的 write 增改一條；面板「詞條」視圖也可就地改字段。任務層需在面板新建並可選綁定工作空間路徑片段。
3、入庫前體檢
對某層文件跑 dict-lint，處理同層重名、別稱衝突、跨層同名等問題。
4、本會話臨時不灌注
工具 mute／unmute，或輸入欄「詞條·注／禁」按鈕；狀態納入會話層配置。
5、首次運行
通用層不存在時會預置「詞條」「詞典」兩條默認稱謂型詞條，已有字典不會被覆蓋。
適用場景與注意¶
適合需要穩定稱謂口徑的智能體或桌面 DSH 用戶：多倉庫別名、項目內部黑話、默認落點（某路徑／某命令）等。任務層適合按工作區或任務類型拆分詞典。
使用時需注意 README 列出的限制：自動激活只做精確命中，不做形近聯想；任務層未綁定工作空間時對所有工作空間生效；檢測質量由模型按模板填寫，插件只校驗格式與路徑；候選轉正只進通用層且爲 待觀察，需人工確認；面板路由限制本機迴環。
問題反饋可開 GitHub Issues，或按 README 說明通過 QQ 聯繫（請註明所裝插件）。反饋時建議帶上 DSH 版本、插件版本與報錯原文。
結尾¶
dsh-term-dict 把「我們之間約定俗成的稱謂」落到純文本字典裏，用自動灌注減少重複解釋，用檢測與權重輔助發現新詞。社區目錄與倉庫相互印證，DSH 插件生態由社區維護，與 DeepSeek／幻方無官方從屬關係。
- 目錄頁：https://www.skillhub.cn/plugins/taoziliyouchong/dsh-term-dict
- GitHub：https://github.com/taoziliyouchong/dsh-term-dict
