dsh-ui-translate
隐私优先的 DeepSeek Harness Web 浏览器本地中文界面和内容翻译
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:RadicalGitter/dsh-ui-translate#7d28b163911a9494225a810673673c76f9e88ccfUi Translate 以 dsh-ui-translate 发布，当前版本为 0.4.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A privacy-first DeepSeek Harness Web plugin that can translate all visible Chinese UI and content—including session titles, workspace names, messages, search results, and plugin text—without enabling Chrome auto-translate.
textarea, input, select, contenteditable, code/preformatted content, [data-input-backdrop], translate="no", and .notranslate remain untouched to avoid corrupting authored or executable text.Text.data; element structure, attributes, stable session/workspace IDs, links, listeners, and React ownership remain intact.| Backend | Default | Network behavior |
|---|---|---|
| Offline glossary | Yes | No network. Translates approved Chinese labels and bounded pet count/point templates to English; unknown labels stay unchanged. |
| Browser-local OPUS-MT | No | Chinese-to-English only. Translates all visible Chinese UI and content. On first use, downloads about 110 MB of pinned quantized model files from Hugging Face, caches them in the browser, and performs inference inside a dedicated local Worker. Page text is not uploaded. |
| OpenAI-compatible | No | Sends only allowlisted UI phrases after the user explicitly selects this backend and enables translation. Calls run through a token-authenticated, same-origin, rate-limited, loopback-only Host route. |
The browser-local backend uses Xenova/opus-mt-zh-en pinned to revision 39d480d52a9ea3065a1f117adfe4dbc55de10e6f. Selecting it is explicit consent to download public model artifacts from Hugging Face. The model files are the only remote payload in this mode: source UI text and translations stay inside the browser Worker. Long messages are segmented into bounded sentences/chunks and reconstructed locally. Cancelling, disabling, reconfiguring, or unloading the plugin terminates active inference. This compact local model can produce literal or awkward translations; pathological blank, excessively long, and repeated-punctuation output is discarded or normalized before it reaches the page.
Translated text is visually marked through the browser Custom Highlight API, with plugin-owned range overlays where that API is unavailable. The floating control box lives outside React-owned content, requires a deliberate text hover, and shows one action at a time: reveal the original, then invalidate the local result cache and re-translate it.
The OpenAI-compatible provider defaults to http://127.0.0.1:11434/v1 and model qwen2.5:7b. Loopback, RFC1918, link-local, .local, and host.docker.internal endpoints are accepted. Public hosts require the explicit Allow a public endpoint setting and HTTPS.
An optional bearer token is read by the Host from DSH_UI_TRANSLATE_API_KEY (or the composition-only apiKeyEnv setting). It is never stored in browser state or sent to the settings UI. Redirects are rejected so credentials are not forwarded to another origin.
Provider code is isolated behind TranslationProvider / TranslationProviderRegistry on the Host and ClientTranslationBackend / ClientBackendRegistry in the browser, so more providers can be added without changing the DOM safety engine.
After npm publication:
dsh plugin --profile web add dsh-ui-translate
From this repository checkout:
dsh plugin --profile web add link:/absolute/path/to/dsh-ui-translate
Or add the Git repository directly if your DSH profile installer supports Git dependencies:
dsh plugin --profile web add https://github.com/RadicalGitter/dsh-ui-translate.git
Restart dsh web, then open Settings → UI translation. The plugin stays off until you enable it.
The settings page exposes:
The same values can be supplied in a later Cordis patch:
- id: ui-translate
config:
enabled: true
targetLanguage: en
backend: openai-compatible
markerStyle: overlay
endpoint: http://127.0.0.1:11434/v1
model: qwen2.5:7b
allowRemoteEndpoint: false
apiKeyEnv: DSH_UI_TRANSLATE_API_KEY
The optional browser-local backend builds on these open-source projects:
Helsinki-NLP/opus-mt-zh-en, developed by the Language Technology Research Group at the University of Helsinki and licensed under CC BY 4.0;Xenova/opus-mt-zh-en, the browser-compatible ONNX conversion published by Xenova (Joshua Lochner) and used at the pinned revision listed above;@huggingface/transformers 3.8.1, licensed under Apache-2.0;Please see THIRD_PARTY_NOTICES.md for the full attribution, model citation, revision, license links, and limitations.
npm install
npm run typecheck
npm test
npm run build
npm pack --dry-run
cordis.patch.yml makes this repository a standard DSH profile bundle. The package's dsh.client metadata tells the Web client module scanner to serve lib/client.js.
See SECURITY.md. In brief: installation and the default backend perform no translation requests, browser text is never stored on disk by this plugin, and remote endpoints require an explicit opt-in. Review endpoint ownership and model retention policy before enabling a networked provider.
MIT