DSH 裏的工具調用 description 參數是必填的,且原樣顯示在 UI 的調用卡片上。由於工具 schema 裏的說明和示例全是英文,模型默認永遠輸出英文描述,導致界面語言爲中文時,用戶看到的每一步都是英文。本插件通過註冊一條全局動態運行時上下文,指示模型使用當前界面語言或強制語言輸出描述,不修改任何預設、persona 或工具 schema。
定位與功能¶
dsh-agent-lang 是一個 Agent 語言控制插件,由 KannaKuron 維護。它通過 systemPrompt.context 全局注入,控制模型的工具調用描述、思考過程、回覆輸出三個通道的語言。支持三種模式:跟隨界面語言、強制指定語言或關閉該功能。
安裝與啓用¶
使用 npm 包安裝:
dsh plugin --profile web add dsh-agent-lang
安裝完成後,重啓 DSH。首次啓動或更新後,建議對瀏覽器頁面進行硬刷新(⌘/Ctrl+Shift+R),以確保設置卡片正常加載。
使用方法¶
安裝並重啓後,通過以下步驟驗證或配置:
- 檢查配置文件
~/.dsh/settings.yaml,確認是否出現agent-lang段。 - 在 Web GUI 中切換語言,觀察工具調用描述的變化。
- 進入「設置 → 插件」頁面,找到「工具描述語言」卡片。
- 選擇「跟隨界面語言」。
- 選擇「強制指定語言」,從下拉菜單選擇目標語言(如
ja),或手動輸入 BCP 47 標籤。 - 選擇「關閉」以恢復默認行爲。
適用範圍與限制¶
本插件支持多種 DSH 模式和預設,包括 standard(標準模式)、ptc(PTC 模式)、cordis(創造模式)、用戶自建 preset 以及智能體/子代理。對於 minimal(極簡模式),插件不受支持,因爲其提示詞對運行時上下文是封閉的。
- 依賴要求:依賴
@deepseek-ai/dsh >= 0.1.6-alpha.2。 - 環境限制:無瀏覽器頁面(如純 CLI 部署)僅支持「顯式選擇」模式;多瀏覽器或遠程頁面時,界面語言爲全局單值。
- 機制說明:通過
systemPrompt.context注入,與沙箱/審批策略處於同一刷新週期,能夠有效覆蓋工具 schema 中的英文指引。
總結¶
dsh-agent-lang 解決了 DSH 中工具描述與界面語言不一致的問題。它通過輕量級的運行時注入,在不改動部署資產(preset/schema)的前提下,實現了對工具調用語言的控制。若需使用,請確保宿主環境滿足版本依賴,並在安裝後進行硬刷新以生效。