dsh-translator

DSH Translator

Turn DeepSeek Harness into a real AI translation application.

中文 · Install · Features · Architecture

DSH Translator is a native DeepSeek Harness plugin. It replaces the central chat surface with a two-pane translation workspace: choose languages, paste text, watch the result stream in, then copy, speak, download, or revisit it from history.

It introduces no translation API of its own. Translation uses the model selected in dsh and retains its credentials, sessions, and streaming transport.

This release targets the dsh 0.1.0-rc.6 Web profile.

Features

• Automatic source-language detection and configurable target language
• Native two-pane editor with a responsive mobile layout
• 12 common languages and one-click language/content swap
• Streaming result display with stop support
• Natural, professional, academic, technical, and literal styles
• Target-only and bilingual output modes
• Character/word counts and Ctrl / ⌘ + Enter
• Paste, copy, browser speech, and .txt download
• Text/Markdown/CSV/JSON/HTML/XML import up to 2 MB
• Searchable local history for the latest 100 translations
• Markdown, tables, HTML/XML tags, links, and placeholder preservation
• Editable terminology glossary and per-request requirements
• Optional copy-on-completion
• JSON-encoded untrusted source content to resist instruction-like source text
• No additional service or API key

Install

dsh is currently a developer preview. Use Node.js 22.19+ or 24+, with dsh and pnpm available.

Install the bundle into the official web profile:

dsh plugin --profile web add github:SiYue-ZO/dsh-translator
dsh web

Open the URL printed in the terminal (by default http://127.0.0.1:3080) and create a session. The translation workspace appears in the center column.

For a local checkout:

git clone https://github.com/SiYue-ZO/dsh-translator.git
cd dsh-translator
npm install
npm run check
dsh plugin --profile web add .
dsh web

Uninstall with:

dsh plugin --profile web remove dsh-translator

Use

Choose source and target languages, paste the source, and select Translate. The button becomes Stop translation while the model is generating.

The source toolbar supports clipboard paste, text-file import, and clear. The result toolbar supports speech, download, and copy. Settings contain style, bilingual mode, formatting preservation, glossary entries in source = target form, and custom requirements. Browser settings and history remain in local storage.

Configure

Defaults live in cordis.patch.yml. A later dsh patch can override the row by id. dsh replaces a row's entire config rather than deep-merging it, so repeat every field in an override:

- id: translator
  config:
    sourceLanguage: auto
    targetLanguage: Japanese
    style: professional
    outputMode: bilingual
    preserveFormatting: true
    translateCodeComments: false
    glossary:
      DeepSeek Harness: DeepSeek Harness
      agent: エージェント
      plugin: プラグイン
    customInstructions: 'Japanese punctuation must use the full-width style.'
    includeRuntimeContext: false

Apply it for one launch:

dsh --profile web --patch ./translator.override.yml

Architecture

The Host half registers a complete translation persona through dsh/Cordis. The Web half occupies dsh's native conversation slot and calls SessionFace.prompt/cancel, preserving dsh's selected model and streaming pipeline. Dynamic workspace context is disabled by default.

Each translation creates a request with its own language, style, glossary, and layout controls. Source text is placed in a JSON string explicitly marked as untrusted data so instruction-like content is translated rather than followed. History and UI preferences stay in browser local storage.

Develop

npm install
npm run check
npm pack --dry-run

npm run build compiles the Host entry, Client types, and dsh-compatible lib/client.js. Tests cover the persona, request isolation, glossary parsing, and Cordis registration.

Limitations

• Quality, context length, and language coverage depend on the selected model.
• This release targets text and plain-text files; it does not parse PDF, DOCX, images, or audio.
• History is browser-local and disappears if site storage is cleared.
• dsh is a developer preview, so future breaking API changes may require an update.

License

MIT © 2026 SiYue-ZO