dsh-hwp-translate

DSH 插件：把 .hwp / .hwpx（한글）文档翻成中文，保留表格、项目符号与缩进。

不需要任何 API Key：翻译由当前会话的模型完成，插件只负责本地抽取与写回。

三个工具

工具	作用	联网
`hwp_extract(path, offset?, limit?)`	抽取待翻段落（id + 原文）	否
`hwp_apply(path, translations, out_dir?)`	把 `{id: 译文}` 写回文档	否
`hwp_translate(path, target?, out_dir?)`	旧接口：让 exe 自己调 API（需自带 Key）	是

用户：把 D:\资料\행정절차.hwpx 翻成中文

1. hwp_extract → 4 段韩文
2. 模型自己翻译成中文
3. hwp_apply({"1": "专业体验活动照片", ...}) → 输出 D:\资料\행정절차_zh.hwpx

分页：hwp_extract 返回 next_offset，用它继续取下一页；写回后返回值里的 missing 是没交回的 id。

在 DSH 的插件安装界面安装，或：

dsh plugin --profile web add github:Sanshui258/dsh-hwp-translate

HWP_Translator.exe --file 文档.hwpx --extract-json segments.json
HWP_Translator.exe --file 文档.hwpx --apply-json translations.json --output-dir out

工具

作用

联网

hwp_extract(path, offset?, limit?)

抽取待翻段落（id + 原文）

否

hwp_apply(path, translations, out_dir?)

把 {id: 译文} 写回文档

否

hwp_translate(path, target?, out_dir?)

旧接口：让 exe 自己调 API（需自带 Key）

是

典型用法（模型自动完成）

用户：把 D:\资料\행정절차.hwpx 翻成中文 1. hwp_extract → 4 段韩文 2. 模型自己翻译成中文 3. hwp_apply({"1": "专业体验活动照片", ...}) → 输出 D:\资料\행정절차_zh.hwpx

分页：hwp_extract 返回 next_offset，用它继续取下一页；写回后返回值里的 missing 是没交回的 id。