dsh-plugin-translation
A translation toolkit for DeepSeek Harness agents: chunking, glossary extraction, source–target QA, tone guides, and a durable translation memory. The model translates; the plugin chunks, checks, and remembers.
Compatibility
Tool schemas are validated against the @deepseek-ai/dsh-tools value-schema DSL at plugin load (checked against dsh-tools 0.1.0-rc.6 and 0.1.1-rc.2). Earlier releases used JSON-Schema required at the root of output.schema and closed nested objects without declared properties, which made the host abort the whole profile boot with unsupported JSON schema: schema.required is not supported by the value schema DSL and could reject the tool's own results. Current releases fix both; if an affected version left your DSH unable to start, remove the plugin from the profile (or upgrade) — no data is lost.
Install
dsh plugin --profile <profile> add dsh-plugin-translation
Restart DSH. The translate_kit tool is registered host-wide.
Tool
| action | purpose |
|---|
segment | Split text into numbered, bounded chunks for chunked translation |
glossary | Extract candidate terms (acronyms, camelCase, domains, numbers+units, emails, URLs) with counts |
check | Source–target QA: numbers/units, brackets, length ratio, doubled punctuation |
tone | Register-specific tone guide (formal / colloquial / technical, en / zh) |
memo_get | Read the translation memory (newest first) |
memo_add | Save a source→target pair to the memory file in the session workspace |
glossary_get | Read the durable glossary (newest first) |
glossary_add | Add or update a source→target glossary term in the workspace glossary file |
glossary_remove | Remove a glossary term by source |
consistency | Cross-segment terminology consistency check against the glossary |
tone_get | Read saved tone guides (filterable by tone and language) |
tone_save | Save a tone guide for a tone@language pair |
quality | Heuristic quality score (0-100) with fidelity/fluency breakdown |
Config
All optional, on the composition row's config:
| key | default | meaning |
|---|
personaSection | true | register the translation prompt-guidance section |
sectionOrder | 6 | prompt section order (persona is 0, ascending) |
memoFile | .dsh/translation-memo.md | memory file path (relative to the session workspace; cannot escape it) |
glossaryFile | .dsh/translation-glossary.md | glossary file path (relative to the session workspace; cannot escape it) |
maxGlossaryEntries | 200 | entries kept in the glossary file |
toneFile | .dsh/translation-tone.md | tone-memory file path (relative to the session workspace) |
maxToneEntries | 50 | saved tone guides kept |
maxMemoEntries | 200 | entries kept in the memory file |
Design
Pure logic (lib/translation.js) has zero DSH/Cordis imports and is unit-tested in isolation; lib/index.js is the thin Cordis plugin. Memory access goes through ctx.fs and every resolved path is containment-checked against the session workspace.
License
MIT
Roadmap
See ROADMAP.md — next five versions (v0.2.0 – v0.6.0): glossary management & consistency, tone memory & quality scoring, side-by-side diff & placeholder protection, conflict detection & effort stats, glossary versioning & batch pipeline.
