前言¶
DeepSeek Harness（DSH）通过插件扩展能力，其中模型推理类插件负责调用底层模型服务。在 DSH 中直接发起翻译时，通常会依赖语言检测、固定语言参数或 Agent 工具，难以精确控制提示词。对于需要中英文翻译、流式输出与本地归档的场景，一个轻量、可控的翻译页面是刚需。
插件介绍¶
wanyi424/dsh-quick-translate 是一个为 DSH 提供的翻译插件，将独立的中英文翻译页面集成到左侧菜单。它不依赖语言检测服务、不使用 Agent 或会话交互，而是直接复用 DSH 已配置的模型，将翻译行为完全交给提示词决定。维护者为 Wanyi424，分类为模型推理。
核心功能¶
- 使用 DSH 已配置模型进行翻译，无额外 API Key
- 流式输出：译文逐段出现，按钮在翻译期间变为「停止」，保留已输出部分
- 提示词管理：默认提示词保存在插件内，支持切换到自定义并保存到本地文件
- 本地历史记录：按天分组，每条显示原文与译文首行，支持查看详情与右键操作
- 目录迁移：从旧目录自动迁移到新的
plugin-data/dsh-translate/history - 性能优化：页面按需加载、增量推送、无 Markdown 全文重渲染
安装与启用¶
在 DSH 左侧「插件」页面选择「添加插件」，添加压缩包：
dist/dsh-translate-0.2.6.tgz
按安装页面提示启用或重启后，左侧菜单出现「翻译」。无需修改 DSH 配置文件，也不需要另填 API Key。此项目不会自动安装到用户的 DSH profile，也不会修改笔记插件或已有笔记。
典型用法¶
- 在原文栏底部的模型标签中选择 DSH 已配置的模型。刚在 DSH 设置里修改过模型时，展开菜单点击「刷新模型列表」。
- 输入或粘贴原文，点击「翻译」或按
Ctrl + Enter。翻译期间按钮变为「停止」，停止后保留已输出的部分。 - 译文栏依次显示「正在连接模型 → 模型思考中 → 正在翻译」，文字随光标逐段出现，完成后显示耗时。点击「复制」得到保留原文格式的译文。
- 译文栏底部显示本次的输入 / 输出 token（输入包含缓存命中部分）。点击它打开「翻译详情」：缓存命中、总耗时与首字时间、「等待响应 → 思考 → 输出译文」的耗时分布、输出速度、模型标识、结果与错误代码、当次提示词快照；「复制诊断信息」得到一段纯文本，便于排查或反馈。
- 用量来自模型在流式结束时返回的数据。手动停止、连接中断或旧版本的记录通常没有用量，会显示「无用量数据」。 - 修改原文后，上一次的译文会变淡并提示「原文已修改」，避免误复制旧结果。点击原文栏右上角的「×」清空，开始新的翻译。
- 切换到 DSH 的其他页面时，翻译在后台继续；返回后恢复进度。
- 历史记录按「今天 / 昨天 / 近 7 天 / 月份」分组，每条显示原文和译文的首行，滚动到底部自动加载更多。
- 点击一条记录进入只读查看。顶部显示「返回」，也可按Esc回到当前翻译；「用此原文重译」把原文放回工作台。
- 右键一条记录，可以复制译文、用原文重译、查看翻译详情或删除。
- 顶部「…」可打开这条记录的「翻译详情」，或删除这条记录。
- 历史记录栏收起时，顶部左侧显示带记录数的「历史记录」按钮，新记录产生时数字会轻微跳动；译文栏底部的「已保存到历史」也可以直接打开历史记录。 - 窗口较窄时，历史记录变为从左侧滑出的抽屉，点空白处滑回；宽屏下收起和展开历史栏时栏宽平滑过渡。更窄时，原文和译文上下排列。菜单、设置面板和对话框关闭时也有退场动画。
提示词与历史记录¶
默认提示词保存在 prompts/default.md，为普通文本，不插入语言参数或模板变量。模型请求只包含当次提示词和待翻译原文，不带其他翻译历史或 DSH 对话。
在「设置 → 提示词」中切换「默认 / 自定义」：默认提示词只读显示；选择「自定义」后编辑并点击「保存」，会自动生成或更新独立的 Markdown 文件：
%USERPROFILE%\.dsh\plugin-data\dsh-translate\prompts\custom.md
切回「默认」立即生效，不改写也不删除 custom.md；再次选择「自定义」即恢复已保存的版本。未保存的修改在关闭设置面板后仍会保留，直到你保存或放弃。修改只用于之后发起的翻译，正在运行的任务和历史记录继续使用各自的提示词快照。改变模型不会改写提示词文件。
设置文件只保存当前使用默认还是自定义，不存储提示词正文；历史记录保留当次提示词正文用于回看。当前仍在开发阶段，本版本不读取或迁移旧的 .dsh-quick-translate 和 Documents/DSH Translations 数据，已移除旧版提示词兼容逻辑。
所有工作区共用一套翻译历史，默认在：
%USERPROFILE%\.dsh\plugin-data\dsh-translate\history
若存在旧版本 plugin-data/dsh-quick-translate 会自动无缝平滑迁移；文件仍保持普通 JSON / Markdown 格式。每次翻译单独保存为 UTF-8 JSON 文件，包含原文、译文、时间、模型提供方、模型名称、当次提示词、状态和错误信息，以及模型返回的 token 用量、首字与首段译文时间、提供方错误代码。旧记录没有这些字段，照常可读。
适用场景与注意¶
适合需要中英文翻译、流式输出与本地归档的 DSH 用户。插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。使用 DSH 现有模型服务会占用所选模型的额度或产生其正常费用；插件不会发起后台自动翻译或自动重试整篇翻译。宿主自身的模型重试策略仍然适用。
小结¶
这个插件通过复用 DSH 的模型与提示词机制，提供了一个可控、轻量的翻译页面，兼顾流式输出与本地历史归档。在需要精确提示词与本地归档的场景下，可以作为补充工具使用。
外部链接¶
- 插件目录页：https://www.skillhub.cn/plugins/Wanyi424/dsh-quick-translate
- GitHub 仓库：https://github.com/Wanyi424/dsh-quick-translate
