ShiXiangYu2/dsh-translate-pro

🌐 DSH Translate Pro

为 DeepSeek Harness 提供的专业翻译 — 支持 18 种目标语言、4 种写作风格、术语控制，以及保留格式的整文件翻译。

dsh-plugin DeepSeek Harness License: MIT

✨ 为什么选择这个插件

LLM 可以“勉强”翻译。DSH Translate Pro 为你提供专业级翻译，并带有随意聊天提示词无法获得的控制能力：

| 功能 | 作用 |
|---|---|
| 🌍 18 种目标语言 | 中文、英语、日语、韩语、法语、德语、西班牙语、俄语、葡萄牙语、意大利语、阿拉伯语、泰语、越南语、印尼语、土耳其语、印地语、波兰语、荷兰语 |
| 🎭 4 种写作风格 | formal / casual / technical / literal — 从法律文件到日常聊天 |
| 📖 术语表控制 | 固定术语：API=应用程序接口, LLM=大语言模型 — 在每次翻译中保持术语一致 |
| 📄 整文件翻译 | 翻译 README、文档、字幕、代码注释，同时保留 Markdown、代码块、URL 和路径 |
| ✍️ 原地写回 | 一次调用即可翻译你的文件并将结果写回 — 即时本地化文档 |
| 🧠 DeepSeek 引擎 | 通过 SiliconFlow 由 DeepSeek V4-Flash（快速/便宜）或 V3.2（最高质量）驱动 |
| 🎨 对话卡片 | 在聊天流中直接渲染并排的原文/译文卡片 |

📸 演示

截图即将推出 — 该插件会直接在 DSH 对话中渲染双语对照卡片。

你: 把这段翻译成日语，正式风格：
"Please find attached the revised contract for your review."

DSH: 🌐 translate → 日语 · formal
原文: Please find attached the revised contract for your review.
译文: 修正後の契約書をレビューのため添付しましたので、ご確認ください。

🚀 安装

前置条件：一个免费 API 密钥

在 SiliconFlow 注册（包含免费额度）并设置密钥：

export SILICONFLOW_API_KEY=sk-xxxxxxxx

安装插件

从 GitHub 安装（无需构建步骤 — 直接提供纯 ESM）
dsh plugin --profile demo add github:ShiXiangYu2/dsh-translate-pro

从 npm 安装（预构建）
dsh plugin --profile demo add dsh-translate-pro

验证该层：

dsh --profile demo --dump-config   # 显示 "# == dsh-translate-pro" 层

启动并使用：

SILICONFLOW_API_KEY=sk-xxx dsh --profile demo

🛠 工具

translate

完全可控地翻译文本：

| 参数 | 类型 | 描述 |
|---|---|---|
| text | string（必填） | 要翻译的文本 |
| target | string | 目标语言（默认：中文） |
| source | string | 源语言（省略时自动检测） |
| style | string | formal / casual / technical / literal |
| glossary | string | 术语映射表，例如 API=应用程序接口,LLM=大语言模型 |
| model | string | deepseek-ai/DeepSeek-V4-Flash（默认）或 deepseek-ai/DeepSeek-V3.2 |

translate_file

翻译整个文件，并保留其格式：

| 参数 | 类型 | 描述 |
|---|---|---|
| path | string（必填） | 要翻译的文件（相对于工作区或绝对路径） |
| target | string | 目标语言（默认：中文） |
| style | string | 翻译风格 |
| glossary | string | 术语映射表 |
| inPlace | boolean | 将翻译结果写回文件（默认：false） |
| model | string | 引擎模型 |

💬 示例

翻译："The quick brown fox jumps over the lazy dog." 到英语 casual 风格

用 translate_file 把 README.md 翻译成中文并写回 (inPlace: true)

把这段 API 文档翻译成日语，术语表：API=API, function=関数

🧩 结构

dsh-translate-pro/
├── package.json       # 声明 dsh.bundle
├── cordis.patch.yml   # 当某个 profile 列出此 bundle 时应用的层
└── index.js           # 插件模块：translate + translate_file 工具

⚠️ 注意

- inPlace 写入需要你的 dsh profile 沙箱策略中的文件写入权限。
- 翻译由托管在 SiliconFlow 上的 DeepSeek 模型提供支持——数据会发送到该 API。

📄 许可证

MIT