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.