前言¶
在 DeepSeek Harness（DSH）里查资料、改提示词、读文档时，中英混排很常见。浏览器页签和独立翻译站点能出译文，但例句、纠错、跟进问答往往要再开一轮工具，上下文也容易断。下面介绍社区插件 dsh-translate：把 DSH 侧边栏扩展成中英互译工作台，在同一块面板里完成流式翻译、学习向附注、常驻 AI 助教、例句与纠错，以及英文神经朗读。
这是什么¶
dsh-translate 是 DSH 的 sidebar 插件（仓库 ChenYichener/dsh-translate，维护者 ChenYichener）。在 SkillHub 目录 中归类为「联网工具」。插件复用当前 profile 的默认模型，不单独要求额外 API Key；朗读可选依赖本机 Python 与网络，核心翻译能力随 DSH 宿主与模型配置运行。
许可证为 MIT；package.json 标注版本 0.1.0，运行需 Node.js >= 20。README 写明在 DSH 0.2.1-rc.5 上做过验证，外部插件 API 仍处于早期阶段。
翻译与交互¶
方向与流式输出¶
支持 zh↔en，默认可 自动 判断方向：CJK 占比高走中→英，拉丁字符为主走英→中；页头也可锁定 中→英 或 英→中。
翻译走流式输出。README 说明调用时会关闭模型推理、使用紧凑提示；本地测试中首 token 约 0.3–0.8 s，常见句子约 1 s 内结束。源文框在面板打开时即获焦点：Enter 发起翻译（流式过程中再按 Enter 可中止），Shift+Enter 换行。单次最多 6000 字符，界面有实时计数。
历史复用与学习模式¶
同一源文、同一方向、同一「学习深度」完全重复时，可直接复用历史记录（标记 已复用历史），不产生新的模型调用；需要新译文时用 重译 / Retranslate。
可选 学习模式 / Study mode（默认关，开关会记忆）：在同一次翻译结果上附加简短教学说明（约 2–4 个有用表达及释义、用法与搭配，必要时含语法点）。切换侧边栏面板时，草稿、当前结果与学习状态仍在内存中保留，重启应用后清空。
常驻 AI 助教¶
译文旁有 IM 风格的聊天栏，提问时不遮挡译文。可问语法、用法、搭配、更自然的说法或例句；回答流式输出、可中止，并用轻量 Markdown 渲染（粗体、斜体、行内代码、列表、标题、围栏代码块），不执行 HTML。
每条问题最多 1000 字符，会自动带上当前原文、译文与学习附注；最多 12 轮已完成对话纳入上下文。会话仅存于内存，不入历史、不写盘。
单次 Insight 附带的学习块¶
每次翻译完成后，宿主再发起 一次 额外模型调用，一次性返回下列块并写入该条历史；从历史重放时这些块不再调用模型。
| 块 | 内容 |
|---|---|
| 常用例句 | 2–3 句，基于译文中有用表达；英文句与中文释义分行 |
| 猜你想问 | 2–3 条可能追问；一点击即发给助教 |
| 原文纠错 | 仅检查你输入的一侧：中→英查中文；英→中查英文语法、时态、一致、复数、冠词、介词、所有格、语序、拼写、大小写与搭配等；每行 错 → 建议、类别标签与一行理由及正例 |
| 音标 | 2–4 个有用英文词/短语及 IPA 与中文释义 |
| 译文优化 | 在确有改进空间时给出 1–2 条更自然、礼貌或准确的译法及理由 |
纠错要求模型引用的片段必须真实出现在你的原文中，否则丢弃，避免「对着译文编造纠错」。拼写、语法、大小写、搭配分块返回。任意纠错可一键变成「为什么 X 改成 Y？」类问题交给助教。
朗读（TTS）¶
只读 英文侧：中→英读英文译文，英→中读英文原文。默认 Microsoft Edge 神经音色 Aria（en-US），由宿主经插件私有 edge-tts 环境合成 MP3；内置 15 种在线音色（美/英/澳/加/爱/印等口音）。语速四档：慢 / 稍慢 / 正常 / 快（100 / 140 / 165 / 190 wpm，默认 140）。
回落顺序：Edge 神经音 → macOS 本地 say（含 Premium/Enhanced）→ 浏览器 speechSynthesis。Windows/Linux 若无 Python，插件保持浏览器语音而不失败。音频按提供方 + 文本 + 音色 + 语速缓存；译文就绪后后台预合成，点 朗读 接近即时，再点可停止；改音色或语速会使缓存失效并重新预热当前结果。
首次使用在线朗读时，插件在 ~/.dsh/dsh-translate/tts-venv 创建私有 venv 并安装 edge-tts 7.3.1（约 20–60 s、~20 MB），需 Python 3.9+ 与网络，不修改系统 Python。
历史记录¶
完成的翻译自动保存（原文、译文、方向、学习附注、例句、猜问、纠错、IPA、优化译法等），按日分组、新者在前。可搜索原文/译文/笔记、重新打开、单条删除或两步确认清空全部。中止或未完成的翻译不保存。最多保留 500 条；宿主每天在历史文件旁保留一份按日备份（保留 7 份）。
界面¶
颜色取自 DSH 主题 token，明暗模式可用；文案随应用语言在中英文间切换。窄面板（≤ 880 px）时助教栏移到结果下方。输入框无焦点光晕，按钮保留键盘焦点环。安装启用后，侧栏入口在番茄钟项下方（顺序 22；未装 dsh-pomodoro 时紧挨上一项）。
安装与启用¶
官方推荐从 GitHub 安装（将 <profile> 换成你的 profile 名）：
dsh plugin --profile <profile> add github:ChenYichener/dsh-translate
也可克隆仓库后从本地路径添加，或在 DSH 桌面应用 Plugins → Install from local directory 选中 dsh-translate 文件夹并启用。安装后重启 dsh web 或刷新页面。
依赖概览：DSH 桌面或自托管 Web profile；Node >= 20；模型用当前 profile 默认模型；朗读在线可选 Python 3.9+ 与网络；macOS 本地 say 开箱可用；浏览器 speechSynthesis 零依赖回落。
典型用法¶
- 侧栏点 翻译 / Translate。
- 输入或粘贴中文或英文；方向选 自动，或锁定中→英 / 英→中。
- 按 Enter 或点翻译；流式完成后查看例句、猜你想问、音标、纠错与译文优化。
- 在助教栏追问语法、用法或更自然的表达。
- 需要听发音时点朗读（仅英文侧）；可在历史里搜索并复开旧记录。
适用场景与注意¶
适合在 DSH 内做中英对照阅读、提示词润色、短句学习与纠错，又不想在多个标签页间来回粘帖的场景。插件与当前 dsh 进程同权限 运行，会调用 profile 已配置的模型；启用在线 TTS 时会拉取依赖并在用户目录下建 venv。安装前建议自行查看仓库源码与 MIT 许可证。社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本文介绍的是社区维护的联网工具类插件之一。
结尾¶
dsh-translate 把翻译、教学向 insight、侧边助教和英文朗读收进 DSH 一侧栏，历史可搜可复用，适合日常在 Harness 里处理中英文本时减少工具切换。详情与更新以仓库 README 为准：
- 目录页：https://www.skillhub.cn/plugins/ChenYichener/dsh-translate
- GitHub：https://github.com/ChenYichener/dsh-translate
