前言¶
在 DSH 插件生態裏,智能體可以調用模型完成翻譯,但長文本翻譯通常還要處理分塊、術語抽取、源文與目標文檢查、語氣指南,以及翻譯記憶的保存和複用。
dsh-plugin-translation 針對這些步驟提供工具化能力:模型負責翻譯,插件負責分塊、檢查、術語維護和翻譯記憶。
這是什麼¶
dsh-plugin-translation 是面向 DeepSeek Harness agents 的翻譯工具包。
- 維護者:863683348
- 許可證:MIT
- 核心定位:提供分塊、術語/詞表抽取、源目標 QA、語氣指南,以及會話工作區中的持久化翻譯記憶
- 註冊工具:安裝並重啓 DSH 後,
translate_kit工具會 host-wide 註冊
核心功能¶
translate_kit 通過不同 action 提供以下能力:
segment:將文本拆分爲編號、有邊界大小的塊,用於分塊翻譯glossary:提取縮寫、camelCase、領域詞、數字+單位、郵箱、URL 等候選術語,並計數check:對源文和目標文進行數字/單位、括號、長度比例、重複標點檢查tone:按語域提供語氣指南,包括正式、口語、技術語域,支持en / zhmemo_get:讀取翻譯記憶memo_add:將 source→target 翻譯記憶保存到 session workspace 文件glossary_get:讀取工作區詞表glossary_add:添加或更新工作區詞表項glossary_remove:刪除工作區詞表項consistency:對照詞表做跨段術語一致性檢查
安裝與啓用¶
1、執行官方安裝命令。
dsh plugin --profile <profile> add dsh-plugin-translation
2、重啓 DSH。
3、重啓後,translate_kit 工具會 host-wide 註冊,可在後續會話中作爲翻譯工作流工具使用。
典型用法¶
一個常見流程如下:
1、先用 segment 將長文本拆分爲編號、有邊界大小的塊。
2、再用 glossary 提取候選術語,識別縮寫、camelCase、領域詞、數字+單位、郵箱、URL 等。
3、對需要長期統一表達的術語,用 glossary_add 寫入工作區詞表。
4、逐塊翻譯後,用 check 對源文和目標文做 QA,檢查數字/單位、括號、長度比例、重複標點。
5、用 tone 獲取正式、口語或技術語域的語氣指南,再調整目標文表達。
6、用 memo_add 保存 source→target 翻譯記憶。
7、後續翻譯時,用 memo_get 讀取已有記憶。
8、跨段完成後,用 consistency 對照詞表檢查術語一致性。
9、如果詞表中已有不合適或過時的條目,用 glossary_remove 刪除。
配置與文件位置¶
所有配置項均爲可選,位於 composition row 的 config。
已覈實的默認文件路徑包括:
memoFile: .dsh/translation-memo.md
glossaryFile: .dsh/translation-glossary.md
這兩個路徑相對 session workspace,不能逃逸。
glossary 文件和 memo 文件默認最多保留 200 條。
Memory access 通過 ctx.fs 進行,並且每個解析路徑都會與 session workspace 做 containment check。
適用場景與注意¶
適用場景:
- 需要在 DSH agents 中做長文本分塊翻譯
- 需要提取並維護術語表
- 需要檢查 source→target 翻譯中的數字、單位、括號、長度比例和重複標點
- 需要按正式、口語、技術語域調整語氣
- 需要在 session workspace 中保存和讀取翻譯記憶
- 需要跨段檢查術語一致性
注意事項:
- 插件以當前 DSH 進程權限運行,安裝前應檢查源碼與許可證。
- 文件寫入路徑受 session workspace 限制,不能逃逸。
- 許可證爲 MIT。
- peerDependencies 要求以下依賴版本:
@deepseek-ai/cordis ^4.0.1
@deepseek-ai/dsh-fs ^0.1.0-rc.6
@deepseek-ai/dsh-system-prompt ^0.1.0-rc.6
@deepseek-ai/dsh-tools ^0.1.0-rc.6
@deepseek-ai/schemastery ^3.18.1
相關鏈接¶
- GitHub:https://github.com/863683348/dsh-plugin-translation
- 目錄頁(插件線索,僅作爲入口參考):https://www.skillhub.cn/plugins/863683348/dsh-plugin-translation