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.