前言¶
在 DeepSeek Harness（DSH）裏跑智能體時，軌跡裏每條工具調用的 description 會出現在 參數 面板中，用來回顧「這一次調用在做什麼」。若模型只寫英文，非英語讀者掃讀成本高；這些內容又會原樣進入會話記錄，相當於項目的操作留痕，事後也不會再自動改寫。
翻譯層加在軌跡之後也解決不了問題：description 由模型生成、原樣入庫。能施加影響的只有兩處——在 提示詞 裏聲明格式，以及在 調用前守衛 裏拒絕不合規的入參。社區插件 dsh-bilingual-description（維護者 che0911，GitHub：che0911/dsh-bilingual-description）同時做這兩件事，要求帶 description 參數的工具調用按「中文在前、英文在後」的一行格式書寫，漏寫中文則在執行前被拒並回傳改寫提示。
這是什麼¶
dsh-bilingual-description 屬於 DSH 社區插件目錄中的 模型推理 類擴展，當前 npm 包版本爲 0.1.0，許可證 MIT。它不依賴其他插件，僅使用 DSH 提供的 ctx.systemPrompt.section() 與 ctx.tools.guard() 鉤子。
核心功能¶
下面按 README 已說明的機制歸納。
提示詞段（Prompt section）¶
在每個 Agent 的系統提示詞末尾（靠近內置 shell 相關說明）追加一條短規則，讓模型在寫出 description 之前就知道格式要求。
工具守衛（Tool guard）¶
在工具真正執行前檢查 description。不合規則拒絕本次調用，並把需要重試的完整文案返回給模型，便於下一輪改正。
要求的單行格式（使用全角引號，避免 JSON 轉義問題）：
中文:“<中文描述>” 英文:“<English description>”
校驗失敗時的典型提示包含 invalid description: must be bilingual（可用僅英文的 description 試跑一次做驗證）。
作用範圍¶
- 僅針對工具定義裏聲明瞭頂層
description參數的工具；守衛在調用時讀取當前工具 schema，隨已安裝工具變化。 - 若無法讀取定義，則回退到已知的 shell 類工具列表，而不是對全部工具泛猜。
- 像
read、write等沒有description參數的工具不受影響。 - 插件內部任何異常都走 allow，不會因插件自身錯誤阻斷合法調用。
配置¶
均爲可選，通過環境變量設置：
| 變量 | 默認值 | 含義 |
|---|---|---|
DSH_BILINGUAL_DESCRIPTION_DISABLE |
未設置 | 設爲 1 時關閉整個插件。 |
DSH_BILINGUAL_DESCRIPTION_SCOPE |
all |
設爲 shell 時只對命令類工具做檢查。 |
DSH_BILINGUAL_DESCRIPTION_EXTRA_TOOLS |
未設置 | 逗號分隔的額外工具名，在 schema 不可用時仍強制校驗。 |
若需改成其他語言對或分隔符，文案在倉庫 index.js 頂部的 CN_LABEL / EN_LABEL / RULE 及消息構造處修改。
安裝與啓用¶
從 DSH 插件市場安裝¶
在 DSH 插件市場中安裝包名 dsh-bilingual-description（與社區目錄頁 che0911/dsh-bilingual-description 對應同一插件）。
手動裝進某個 profile¶
先將插件目錄裝到 profile，再在 dsh.profile.bundles 中註冊並重啓 DSH：
cd ~/.dsh/profiles/<profile>
npm install /path/to/dsh-plugin-bilingual-description
在該 profile 的 package.json 裏把 "dsh-bilingual-description" 加入 dsh.profile.bundles，然後重啓 DSH。
環境要求¶
- DeepSeek Harness
>= 0.2.0-rc.1（README 註明在0.2.2-rc.1上測過）。
典型用法與驗證¶
安裝並啓用後，無需額外 API：模型發出的帶 description 的工具調用會自動受規則約束。
驗證步驟：
- 發起一次工具調用，故意只寫英文
description。 - 調用應被拒絕，並看到雙語格式相關的錯誤與重寫指引。
- 按返回格式改寫後重試，調用應能通過守衛。
開發者在倉庫內可用下列命令做本地檢查（不依賴完整 DSH 運行時）：
node scripts/smoke.mjs # 16 條斷言
node --check index.js
適用場景與注意¶
適合誰： 需要在軌跡裏穩定留下中英對照操作說明的團隊；希望把「雙語 description」寫進模型行爲而不是事後翻譯的 DSH 用戶。
權限與安全： 插件隨當前 DSH 進程權限運行，能改系統提示詞並攔截工具調用。安裝前應閱讀 GitHub 源碼 與 MIT 許可證，確認組織策略允許從社區目錄或本地路徑引入該 bundle。
生態說明： DSH 奉行「一切皆插件」；SkillHub 插件目錄 爲社區站點，與 DeepSeek / 幻方無官方從屬關係，不要把它等同於廠商應用商店。
結尾¶
dsh-bilingual-description 用提示詞聲明 + 調用前守衛，把工具 description 固定爲「中文 + 英文」一行格式，並儘量在不誤傷無 description 工具的前提下收窄校驗範圍。需要進一步瞭解安裝細節、截圖與配置表，可查閱目錄頁與倉庫 README。
