dsh-approval-zh

dsh-approval-zh

Automatically translate English approval prompt text and ask_user_question cards in DeepSeek Harness (DSH) into Chinese.

It changes display text only. It never changes an approval outcome or an answer: the same prompt still asks you to allow or reject, and question options keep their original English labels as answer values. The plugin never auto-approves or auto-denies anything.

English | 中文

Before / after

Before:

允许本次操作使用 danger-full-access 权限：plugin_manager {"action":"list_plugins","limit":50}. Profile changes persist across sessions; installed Host code runs outside the workspace sandbox.

After:

允许本次操作使用 danger-full-access 权限：plugin_manager {"action":"list_plugins","limit":50}。配置文件更改会在会话之间保留；已安装的 Host 代码在工作区沙箱之外运行。

The Chinese prefix, tool names, JSON arguments, and sandbox mode names are preserved.

An ask_user_question card:

Which repo?
1. It's private — I'll provide a token or make it public
   Anonymous requests can't read private repos; a read-only PAT would let me clone and summarize it.

becomes Chinese in the question and description while the option label stays English:

你说的是哪个仓库？
1. It's private — I'll provide a token or make it public
   匿名请求无法读取私有仓库；一个只读 PAT 可以让我克隆并总结它。

What it does

• Listens to the Host approval/request waterfall and rewrites displayReason (or the reason fallback) before the request is forwarded to the browser.
• Listens to user-questions/request and translates the question, optional header, and option descriptions; option labels are intentionally preserved because they are returned to the model as answer values.
• Translates only the English part while protecting:
  • localized Chinese prefixes such as 允许本次操作使用 danger-full-access 权限：;
  • tool names such as plugin_manager and ops_bash;
  • JSON/command arguments, inline code, URLs, Windows paths, and sandbox mode names.
• Caches identical text in memory.
• Starts with the anonymous Bing endpoint. If it is slower than llmDelayMs or fails, the current session model races it; the first successful translation wins and the other request is aborted.
• If both paths fail, shows the original text and lets the approval continue. It never blocks or denies a call.
• Does not modify approval/asked / approval/decided audit records; they keep the original English reason.

Install

From the DSH plugin manager

1. Put this directory anywhere on the machine, for example D:\plugins\dsh-approval-zh.

2. Use “install from local directory” on the Plugins page, or ask the agent to call:

   plugin_manager install_bundle target=<absolute path to this directory>
   

3. Restart DSH when prompted. Host plugins usually load at startup.

CLI

dsh plugin --profile desktop add "D:\plugins\dsh-approval-zh"

desktop is the reserved profile of the desktop app; use the matching profile for Web/TUI.

From GitHub

dsh plugin --profile desktop add github:879745uhjun/dsh-approval-zh

Reload the Web UI page after installing.

Configuration

Override the row with id dsh-approval-zh in the profile's cordis.patch.yml:

- id: dsh-approval-zh
  config:
    enabled: true
    target: zh-Hans
    timeoutMs: 8000
    llmDelayMs: 1200
    useLlm: true
    translateReason: true
    translateDisplayReason: true
    translateUserQuestions: true
    debug: false

Field	Default	Meaning
enabled	true	Master switch; false loads no listener.
target	zh-Hans	Target language passed to the translation endpoint.
timeoutMs	8000	Overall deadline for the Bing/model race; the original text is shown on timeout.
llmDelayMs	1200	Start the current-session model if Bing has not answered by then.
useLlm	true	Allow the current-session model as fallback; false uses Bing only.
maxTextChars	4000	Text longer than this is left untranslated.
translateReason	true	Translate the reason fallback when displayReason is absent.
translateDisplayReason	true	Translate the displayReason rendered by the approval card.
translateUserQuestions	true	Translate ask_user_question questions, headers, and option descriptions; option labels stay unchanged.
debug	false	Log load and failure events (never the source text).
glossary	{}	Extra term replacements.

Privacy

• Sends only the approval or question text that needs translation to Microsoft Edge's anonymous translation endpoint (edge.microsoft.com). No account or API key is required.
• If Bing is slower than llmDelayMs or fails, the same text is sent to the model already used by the current session as a fallback; this consumes a small number of model tokens. Set useLlm: false to disable.
• Does not send file contents, full sessions, credentials, or tool results.
• The original English reason remains in DSH's audit log; only the browser display is rewritten.
• Set enabled: false to disable all network access.

Limitations

• Prefers edge.microsoft.com; if it is slow or unavailable, the current-session model is used. Only when both fail (or useLlm: false and Bing is unavailable) is the English text shown.
• A slow Bing response can trigger a model call, adding a small token cost and 1–3 seconds of latency.
• Only approval and question-card display text is translated. Command bodies, the tool-detail panel, and button labels follow DSH's own locale setting.
• Question-card option labels stay in English because they are returned to the model as answer values; only the question, header, and option descriptions are translated.
• Code, JSON, paths, URLs, and tool names are intentionally not translated.
• Translation adds up to timeoutMs of display latency; cached prompts are effectively instant.
• An already-open approval prompt is never updated retroactively. If a source update still behaves like the old version, restart DSH to clear the loaded Host module cache.

Development

node test/translate.test.js   # unit tests, no network
node test/live.mjs            # one real request to the translation endpoint

• index.js: Cordis entry point and approval/request listener.
• lib/translate.js: prefix splitting, technical-span protection, anonymous translation, cache, and glossary.
• test/translate.test.js: pure-function and request-rewrite tests.

License

MIT