dsh-agent-lang
August 31, 2026 · View on GitHub
Agent language control — three independently configured channels for DeepSeek Harness (DSH) model output: tool-call descriptions (including PTC mode's
run_codedescription, the call card title), model thinking, and replies — each follows the GUI language, forces a fixed language, or turns off, with one-click sync-all / off-all shortcuts. By default only the descriptions channel is on.
Why
Every tool call in DSH carries a required description argument that is displayed verbatim as the call's UI label. The tool schemas describe that field with English wording and English examples ("5-10 words … Examples: 'Count TODO markers…'"), so models default to English descriptions regardless of the GUI language.
This plugin changes only the PROMPT side: one global dynamic runtime-context directive states the GUI's display language and instructs the model to write every tool-call description in it. No preset, persona, or tool schema is modified — those are deployment-owned assets an upgrade overwrites anyway.
Coverage
| Mode / preset | Supported | Notes |
|---|---|---|
standard | ✅ | |
ptc (PTC mode, formerly code) | ✅ | run_code's description included |
cordis (Creation mode) | ✅ | |
User presets (incl. ptc-cordis, dsh-gitbash-shell variants) | ✅ | Host-plane registration covers every unsealed preset in the process |
minimal | ❌ (by design) | minimal mounts a complete persona and suppresses runtime context — its prompt is sealed against every late contributor; no prompt-level plugin can reach it |
How it works
- Detection order (auto mode): the explicit Settings → General → Language choice > the browser-reported active locale. English is a regular target too (v0.3.0+): some models mix languages inside thinking/replies, and an explicit English directive pins them; only a fully undetected language injects nothing.
- Channel:
systemPrompt.context()— the same per-request runtime-context snapshot as the sandbox/approval policies, rendered near the end of each request so recency beats the English tool-schema guidance. A GUI language switch takes effect on the very next request. - Settings card: Settings → Plugins pairs Host-served namespaces with registered cards automatically; switch behavior (follow GUI language / force a BCP 47 tag — pick from the dropdown or type one, e.g.
zh,ja/ off) and inspect the detection chain.
Install
dsh plugin --profile web add dsh-agent-lang
Plain JS, no build step, no installed dependencies (schemastery is a peer resolved through the profile). Restart DSH after installing.
Verify
- Install, restart DSH, open the Web GUI (browser language or setting on Chinese);
~/.dsh/settings.yamlgains aagent-lang:section (uiLocale: zh) once a page loaded;- Any new session: tool-call descriptions come out in Chinese;
- Switch the GUI language in Settings → General — descriptions switch on the next request;
- Settings → Plugins → Tool Description Language: pick
jafrom the force-language dropdown (or type any tag), switch off, etc.
Known limits
minimalis sealed by design (see table).- Without a browser page (pure CLI deployments) only the explicit choice is detectable.
- The GUI language is one global value; the most recently loaded page's report wins.
- Subagents / workflow models see the directive too (their descriptions are user-facing as well).
License
MIT