dsh-translate
English · 简体中文
> 一个 DeepSeek Harness 侧栏插件:把应用变成中英互译工作台——流式翻译、右侧常驻 AI 助教、自动例句、猜你想问、原文纠错、自动保存的历史,以及神经网络语音朗读。
功能
翻译
- 中英互译,自动判断方向:中文占比高的输入走中→英,英文为主的输入走英→中;也可以在顶部手动锁定「中→英」或「英→中」。
- 流式输出、延迟低:翻译请求关闭模型的「思考」阶段并使用精简提示词,本地实测常见句子首字 0.3–0.8 秒出现、整句 1 秒左右完成。
- Enter 就翻译:原文框里按
Enter直接翻译(翻译中再按一次即停止),Shift + Enter换行;打开面板时输入框自动聚焦,粘贴完按一下回车就行。 - 历史快速复用:原文、方向和「学习模式深度」完全一致时,直接回放历史记录——零模型调用、毫秒级返回,状态显示「已复用历史」;点「重译」则强制重新生成。
- 可选学习模式:打开「学习模式」后,同一次翻译请求会额外给出简短讲解:从原文和译文里挑 2–4 个值得学的表达,给中文释义、用法搭配,必要时点一句语法。默认关闭,开关会被记住。
- 单条最多 6,000 字,输入框带实时字数提示。
- 切换面板不丢内容:原文草稿、当前结果和增值信息在侧栏页面之间切换时都保留(只存内存,重开应用清空)。
常驻 AI 助教
- 译文旁边就是 IM 风格的对话框,提问时不会盖掉译文。
- 可以问语法、用法、搭配、更地道的说法、例句;回答流式输出、随时可停,并用一个安全的 markdown-lite 渲染器排版(加粗 / 斜体 / 行内代码 / 列表 / 标题 / 代码块),不 eval 任何 HTML。
- 每个问题最多 1,000 字,会带上当前原文、译文和讲解作为上下文;最多 12 轮已完成对话会折叠进提示词。
- 对话只存在当前应用会话的内存里,不写历史、不落盘。
增值信息(每次翻译只多一次模型调用)
翻译完成后,宿主会用一次额外的模型调用同时生成下面所有内容;结果会写回该条历史记录,所以之后从历史回看时零调用。
| 区块 | 内容 |
|---|---|
| 常用例句 | 2–3 个用译文里值得学的表达造的例句:英文原句 + 中文意思,逐行展示。 |
| 猜你想问 | 2–3 个你最可能追问的问题,点一下就直接发给助教。 |
| 原文纠错 | 只检查你输入的那一侧,而且只用它自己的语言检查:中→英查中文错别字、语病和搭配;英→中查英文语法(时态、主谓一致、单复数、冠词、介词、所有格、词序)、拼写、大小写和搭配。每行给出 错误 → 建议改法、类别标签(拼写 / 大小写 / 语法 / 搭配 / 用词)、一句说明和一个正确例句。 |
| 音标 | 2–4 个值得学的英文单词/短语,标注 IPA 和中文意思;原文拼错的词按纠错后的正确形式给音标(例如 check-in /ˈtʃek ɪn/)。 |
| 译文优化 | 1–2 个更自然、更礼貌或更准确的常见说法和一句原因——只在当前译文确实有改进空间时出现。 |
纠错带有原文存在性校验:模型引用的片段必须真的出现在你输入的原文里,否则会被丢弃,所以模型没法拿自己的译文来「纠错」。语法、拼写、大小写、搭配是分节请求的,拼写问题不会掩盖语法问题。每条纠错都能一键追问「为什么 “X” 要改成 “Y”?」。
朗读(TTS)
- 永远只读英文那一侧:中→英读英文译文,英→中读英文原文。
- 默认 Microsoft Edge 神经语音 Aria(en-US),由宿主调用插件私有的
edge-tts环境合成 MP3。内置 15 个在线音色,覆盖美式 / 英式 / 澳式 / 加拿大 / 爱尔兰 / 印度口音。 - 四档语速——慢 / 稍慢 / 正常 / 快(100 / 140 / 165 / 190 wpm,默认 140),会自动映射成 Edge 的 prosody 百分比。
- 回退链:Edge 在线语音 → macOS 本机
say(含 Premium/Enhanced 音色)→ 浏览器speechSynthesis。没有 Python 的 Windows/Linux 会直接停在浏览器语音,而不是报错。 - 音频按「provider + 文本 + 音色 + 语速」缓存在本机,翻译完成后在后台预合成,所以点「朗读」基本即时出声。再点一次停止;换音色或语速会让缓存失效并重新预合成当前结果。
历史
- 每次完成的翻译自动存档(原文、译文、方向、讲解、例句、猜你想问、纠错、音标、译文优化),最新的在前,按天分组。
- 可搜索原文、译文和讲解;可点开回看、单条删除;清空需要两步确认。
- 停止或中途放弃的翻译不会入库。最多保留最近 500 条,宿主每天最多在历史文件旁写一份带日期的备份(保留 7 份)。
- 复用的命中条件是「原文 + 方向 + 学习模式深度」完全一致;想换一种译法点「重译」即可。
界面与主题
- 颜色全部走 DSH 主题 token,深色 / 浅色自动适配;面板文案有中文和英文两套,跟随应用语言。
- 窄屏(面板宽度 ≤ 880px)时助教会自动叠到译文下面,不挤掉结果。
- 输入框点击时不出现高亮描边;键盘用户仍可通过 Tab 在按钮上看到焦点环。
安装
从 GitHub 安装(推荐)
dsh plugin --profile add github:ChenYichener/dsh-translate
从本地克隆安装
git clone https://github.com/ChenYichener/dsh-translate.git
dsh plugin --profile add /path/to/dsh-translate
DSH 桌面版
打开「插件」页 → 从本地目录安装 → 选择 dsh-translate 目录 → 启用。
装完重启 dsh web 或刷新页面。左侧栏会出现「翻译」(英文界面 Translate),位置紧跟「番茄钟」(侧栏顺序值 22;没装 dsh-pomodoro 时直接接在上一个入口后面)。
环境要求
| 依赖 | 说明 |
|---|---|
| DSH | 桌面版或 self-host 的 Web profile;开发验证版本 0.2.1-rc.5,外部插件 API 仍在早期。 |
| Node.js | >= 20(见 engines)。 |
| 模型 | 复用当前 profile 的默认模型,插件不需要额外的 API key。 |
| 朗读·在线(可选) | 需要 Python 3.9+ 与首次联网。插件会在 ~/.dsh/dsh-translate/tts-venv 创建私有 venv 并安装 edge-tts 7.3.1(约 20–60 秒、~20MB),不污染系统 Python。 |
| 朗读·本机(可选) | macOS 系统 say 开箱可用。 |
| 朗读·兜底 | 浏览器 speechSynthesis,零依赖。 |
使用
- 在左侧栏点「翻译 / Translate」。
- 输入或粘贴中文或英文。方向保持「自动」,或手动锁定「中→英」/「英→中」。
- 按
Enter(或点「翻译」)。译文流式出现;完成后例句、猜你想问、音标、纠错和译文优化会依次补上。 - 在右侧助教框追问,或直接点一个「猜你想问」。
- 点「朗读」听英文那一侧,点「声音」换音色/语速,点「复制」复制译文,点「重译」重新生成。
- 历史在左侧:可搜索、点开回看、单条删除或清空(两步确认)。
快捷键
| 位置 | 按键 | 行为 |
|---|---|---|
| 原文输入框 | Enter |
翻译;翻译中再按一次即停止 |
| 原文输入框 | Shift + Enter |
换行 |
| 原文输入框 | ⌘ / Ctrl + Enter |
翻译(同 Enter) |
| 助教输入框 | Enter |
发送问题;回答中再按一次即停止 |
| 助教输入框 | Shift + Enter |
换行 |
| 助教输入框 | ⌘ / Ctrl + Enter |
发送(同 Enter) |
截图
| 常驻助教 |
|---|
实现方式
- 一个插件两半:
index.js是宿主半,用webServer在/dsh-translate/api挂一个前缀路由,并通过ctx.get('llm')+ctx.get('agentDefaultModel')拿当前 profile 的默认模型;client.js是浏览器半,经宿主模块加载器加载,用slots注册sidebar.panellist入口(idtranslate,order 22)和main.translate面板。 - 翻译流程:
POST /translate是 SSE 接口。宿主先按中英文字符比例解析auto方向,再查历史快速路径,然后用reasoningEffort: 'off'流式调用llm.stream(),依次发出start/delta/done/error事件;完成的记录在宿主侧入库,并在done里返回。 - 增值信息流程:客户端在
done之后调用一次POST /insight。宿主要求模型按固定小节输出(【例句】【猜你想问】【音标】【译文优化】【语法】【拼写】【大小写】【搭配与用词】),解析每行、合并去重、过滤「无需修改」占位行,并丢弃原文里并不存在的纠错片段,最后把结果写回对应的历史记录。 - 助教流程:
POST /ask是独立的 SSE 路由。宿主把当前翻译上下文和最多 12 轮历史折叠进一条提示词,回答不落历史;客户端中断会 abort 模型流。 - 朗读:
POST /tts返回二进制音频——edge-tts在插件私有 venv 里以独立子进程运行,产出audio/mpeg;macOSsay产出audio/wav;响应头x-tts-engine标明实际使用的引擎。宿主返回 503 时客户端改用speechSynthesis。 - 历史可靠性:写入用临时文件 + rename 的原子写,并用 promise 队列串行化 read-modify-write,并发翻译不会互相覆盖;历史文件损坏只会让快速路径失效,不影响翻译本身。
- 本地请求防护:路由只接受 POST,拒绝非回环
Host、Sec-Fetch-Site: cross-site和跨源Origin(防 DNS rebinding / CSRF),并限制请求体和文本长度。 - 界面状态:原文草稿、当前结果、增值信息和助教对话都放在模块级 store 里,侧栏页面切换不会丢;用户偏好持久化在
localStorage。
数据与隐私
| 内容 | 去向 |
|---|---|
| 翻译提示词、讲解和增值信息请求 | 发给你在 DSH 里配置的模型服务商。 |
| 助教问题与上下文 | 发给你在 DSH 里配置的模型服务商。 |
| 用在线语音朗读的文本 | 发到 Microsoft Edge 朗读接口。 |
| 用本机语音朗读的文本 | 不离开本机(macOS say)。 |
| 历史记录 | ~/.dsh/dsh-translate/history.json(最近 500 条)。 |
| 历史备份 | ~/.dsh/dsh-translate/history.YYYY-MM-DD.bak.json(最多 7 份)。 |
| 朗读运行环境 | ~/.dsh/dsh-translate/tts-venv/,插件私有的 Python venv。 |
| 音频缓存 | ~/.dsh/dsh-translate/tts-cache/,按引擎 + 文本 + 音色 + 语速缓存 MP3/WAV。 |
| 界面偏好 | 浏览器 localStorage,key 为 dsh-translate/prefs/v1。 |
插件没有遥测、统计、账号,也没有自己的 API key。助教对话只在内存里。删除 tts-venv 和 tts-cache 即可重置朗读(下次使用会重新准备)。由于默认使用 Edge 在线语音,朗读文本默认会离开本机;想完全本地化就删除 tts-venv 并保持离线(此时会用本机/浏览器语音)。
一条历史记录大致长这样(节选):
{
"id": "04ef945ef4fd4968",
"createdAt": "2026-11-03T04:36:12.000Z",
"direction": "zh-en",
"study": false,
"source": "请给我一杯水。",
"translation": "Please give me a glass of water.",
"notes": "",
"examples": ["Could you give me a glass of water, please? — 请给我一杯水好吗?"],
"questions": ["a glass of water 和 a cup of water 有什么区别"],
"corrections": [],
"phonetics": [{ "word": "glass", "ipa": "/ɡlæs/", "meaning": "玻璃杯" }],
"polish": [{ "suggestion": "Could I have a glass of water, please?", "reason": "更礼貌" }]
}
配置
没有配置文件,也没有环境变量,所有设置都在面板里:
- 方向(自动 / 中→英 / 英→中)和学习模式在顶部。
- 音色和语速在「声音」弹层里。在线音色列表内置在宿主里;本机音色来自系统已安装的 macOS 语音,新装系统音色后最多一分钟出现。
- 默认:在线时 Aria,本机时当前可用的最佳本机音色,语速 140。
偏好按浏览器 profile 存在 dsh-translate/prefs/v1 这个 localStorage key 下。模型就是 DSH profile 当前选中的默认模型——插件没有单独的模型设置。
开发
没有构建步骤,两半都是纯 JavaScript,直接运行。
# 语法检查
node --check index.js
node --check client.js
# 用一次性 profile 试装本地目录
dsh plugin --profile test add /path/to/dsh-translate
index.js 是导出 inject 与 apply 的 ESM 模块;client.js 是包在 window.__ModuleLoader__.load({ id, factory }) 里的浏览器 bundle。插件行为完全在这两个文件里。
项目结构
dsh-translate/
├── index.js # 宿主半:/dsh-translate/api 路由
├── client.js # 客户端半:侧栏入口 + main.translate 面板
├── cordis.patch.yml # 插入插件的 bundle patch
├── package.json # 包元数据 + dsh bundle/client 清单
├── locale/
│ ├── en.json # 插件管理页的标题和描述
│ └── zh.json
├── icon.svg
├── docs/
│ ├── screenshot.png
│ └── screenshot-tutor.png
├── README.md
├── README.zh.md
└── LICENSE
API 一览
宿主半只暴露一个前缀路由 /dsh-translate/api。所有接口都是 POST JSON,流式接口用 SSE;响应是 JSON { ok, ... } 或二进制音频。
| 路由 | 请求 | 响应 |
|---|---|---|
/translate |
{ text, direction?, study?, force? } |
SSE:start → delta* → done(带入库的 record);命中历史时只发 start/done 且 cached: true、没有 delta。force: true 跳过快速路径。 |
/insight |
{ source, translation, direction, notes?, id? } |
JSON { examples, questions, corrections, phonetics, polish, record? }。只调用一次模型;记录已增值过时直接回放已有数据。 |
/ask |
{ question, context?, messages? } |
SSE:start → delta* → done。 |
/tts |
{ text, voice?, rate? } |
二进制 audio/mpeg(Edge)或 audio/wav(say),带 x-tts-engine 响应头;只能用浏览器语音时返回 503。 |
/info |
{} |
模型名、AI 是否可用、历史文件路径与条数、按类别累计的 modelCalls(translate / insight / ask),以及 TTS 默认值、音色列表和 edge.status(idle / installing / ready / failed)。 |
/history/list |
{} |
{ records },最新在前。 |
/history/delete |
{ id } |
{ deleted }。 |
/history/clear |
{} |
删除全部记录。 |
调用成本
设计上刻意保持便宜:一次翻译 = 一次翻译调用 + 一次可选的增值调用,重复翻译免费。
| 场景 | 模型调用次数 |
|---|---|
| 一次新翻译(含例句 / 猜你想问 / 音标 / 纠错 / 译文优化) | 2:1 次翻译(学习模式讲解也在这一次里)+ 1 次增值信息 |
| 重复翻译同一句(命中历史) | 0 |
| 助教提问 | 1 次 / 问 |
| 停止、切换面板、中止 | 0,且未完成的翻译不会入库 |
/info 会返回 modelCalls 计数(translate / insight / ask),可以随时核对实际调用量。
故障排查
| 现象 | 处理 |
|---|---|
| 侧栏没有「翻译」入口 | 插件页确认已启用;刷新页面或重启应用;看应用日志里 dsh-translate 是否加载失败。 |
| 手工 link 安装后「已安装插件」列表里没有它 | 插件管理器缓存了本次应用会话的清单——在插件页点一次「刷新」或重启应用。 |
| 朗读一直用本机/浏览器语音 | 看 /info 里 tts.edge.status:installing 是首次准备中(等 20–60 秒);failed 看 tts.edge.error(常见:没有 Python 3、首次 pip 失败、公司网络拦截)。修好 Python 或网络后重启。 |
| 在线语音突然不可用 | 上游 Edge 朗读接口变动或网络受限;插件会自动回退本机/浏览器语音。想强制只在本机运行:删掉 ~/.dsh/dsh-translate/tts-venv 并保持离线。 |
| macOS 本机音色太少 | 系统设置 → 辅助功能 → 朗读内容 → 系统声音 → 管理声音,下载 Premium/Enhanced 音色;最多 1 分钟后出现在「声音 → 本机」列表。 |
| 想重置朗读环境 | 删除 ~/.dsh/dsh-translate/tts-venv 与 tts-cache,重启应用。 |
| 翻译没有存进历史 | 只有完整完成的翻译才会入库;中途停止不会保存。 |
| 重复输入返回了旧译文 | 这是历史快速复用——点「重译」强制重新生成。 |
| 提示没有可用模型 | 在 DSH 模型设置里选好默认模型;插件复用 profile 默认模型。 |
兼容性
| 平台 | 插件本体 | 朗读 |
|---|---|---|
| macOS | ✅ | Edge 在线语音(推荐)/ 本机 say(含 Premium/Enhanced 音色)/ 浏览器语音 |
| Windows | ✅ | Edge 在线语音(需 Python 3.9+ 与联网,插件自动准备)/ 浏览器语音 |
| Linux | ✅ | Edge 在线语音(需 python3 与 python3-venv)/ 浏览器语音 |
| 离线环境 | ✅ 翻译需联网调用模型 | macOS 用本机 say;其他平台用浏览器语音 |
开发和验证环境:macOS + DSH 0.2.1-rc.5。Windows/Linux 的路径与 Python 探测已按平台分支实现,但未在真机回归——欢迎提 issue/PR。DSH 外部插件 API(webServer、sidebar.panellist / main slot、dsh.bundle.patch)仍处早期,升级 DSH 大版本后如果插件不加载,先对照 package.json 的 dsh 字段检查。浏览器语音兜底依赖 Web Speech API 的 en 音色,不同系统音质不同。
相关 DSH 插件
| 插件 | 作用 |
|---|---|
| dsh-book | Markdown 草稿库 + 小红书 / 公众号 / 通用文案 AI 写作工作台 |
| dsh-notify | DSH 在后台时,会话结束发原生桌面通知 |
| dsh-pomodoro | 侧栏里的免打扰番茄钟 |
| dsh-translate | 中英互译工作台:常驻 AI 助教 + 神经语音朗读 |
| dsh-nce | 新概念英语第一册学习面板(课文、SRS 闪卡、错题本) |
许可证
- 插件代码:MIT,见 LICENSE。
- 在线朗读依赖 edge-tts,许可证为 LGPL-3.0。它由插件在运行时安装到私有 venv,本仓库不打包、不修改、不分发其代码,仅以独立子进程调用;使用在线语音即表示你接受其上游条款与 Microsoft Edge 朗读服务的使用限制。
icon.svg为本仓库自制;界面只用 DSH 主题 token 和系统字体。