dsh-auto-translate

English | 中文

模型输出全链路中文翻译插件,面向 DeepSeek Harness Web GUI。

模型思考时(Think 折叠行内)、最终回复、工具调用输出,凡英文内容都就地显示中文——思考过程中实时翻译,不等待回合结束。所有翻译由一条独立的提供方请求完成,不进入会话上下文:不占用上下文窗口,也不污染对话历史。

一键安装：

dsh plugin add qwert702/dsh-auto-translate

重启 harness（dsh web），刷新页面。

功能

• 思考过程实时翻译:模型的 reasoning 思考块(Think 折叠行)展开后,原文下方直接显示中文翻译;模型仍在思考时按防抖节奏滚动更新"进行中"译文,思考完成后用完整文本重翻一次并缓存。
• 最终回复就地翻译:每条英文文本块下方一行小字译文(带"译"徽标)。中文回复、代码为主的输出不会触发翻译;纯代码输出会被启发式跳过。
• 工具输出中文摘要:每个工具调用卡片下方一行"译"摘要,用简体中文概括该工具输出的要点(而非逐句翻译输出数据);bash / web / read 等有专用视图的工具、以及无专用视图的自定义工具,摘要统一渲染在卡片外下方。
• 工具调用中文注释:无专用视图的工具显示简化卡片,卡头标注 工具名 — 中文含义(内置词典覆盖 bash / read / write / edit / glob / grep / web_search / todo_write / ask_user_question / skill / goal / subagent / workflow / cordis_* 等)。
• 翻译不占用上下文:翻译/摘要请求由 host 半区独立调用提供方 /chat/completions,与对话 agent 循环完全隔离;插件本身不向任何会话添加提示词、工具或消息,也不改写模型请求。
• 模型可配置:默认跟随当前对话使用的模型;可在设置里覆盖为任意模型(见下)。当前对话模型在提供方不可用时,自动回退重试 deepseek-chat。

实现方式(影子上色,不替换插槽声明)

聊天视图里"每条消息内部"没有可加性插槽,所以本插件用生态通用的影子注册做法:在 conversation.chat.node 上以 priority: -100 注册 assistant-step 与 tool-call 两个渲染器,低于内置的 priority: 0 而胜出。渲染器从公开基础件(dsh-client-ui-primitives 的 MarkdownText / DisclosureRow / JsonBlock,dsh-client-ui-attachment 的 ImageGallery)重新实现了默认渲染结构,并保留 tool.call.toolview 子槽分发(所以 bash / web / read 等专用工具卡片原样保留)。若影子渲染器崩溃会自动退位,内置渲染器无感接管。这与 dsh-better-markdown 插件是同一技术路线。

设置(可选)

在 ~/.dsh/settings.yaml 添加命名空间 dsh-auto-translate:

dsh-auto-translate:
  enabled: true          # 总开关
  model: ''              # 空 = 跟随当前对话模型;可填 deepseek-chat / deepseek-reasoner 或自定义
  apiKeyRef: DEEPSEEK_API_KEY   # 凭据引用,在 harness 凭据中配置
  baseURL: https://api.deepseek.com
  temperature: 0.3       # 翻译请求的采样温度
  maxInputChars: 4000    # 超长输入截断,防烧钱

不配置即使用以上默认值。API key 只存在于服务端,由 harness 凭据服务解析,绝不离开服务器。

仓库布局

• lib/index.js — 插件 node 半区:settings 命名空间 + POST /api/auto-translate/translate 路由(独立翻译/摘要请求,mode: translate | summarize,带模型回退)。
• lib/client.js — 浏览器半区:两个影子注册(assistant-step 与 tool-call,priority: -100)+ 就地翻译组件(思考块内、文本块下、工具卡片外)。
• test/smoke.cjs — node test/smoke.cjs:语法检查 + host 路由全路径(禁用/坏请求/空文本/无 key/成功/摘要模式/模型回退)+ client 影子注册断言 + ReactDOMServer 渲染测试(思考/文本/流式/工具卡片)。

已知限制

• 与 dsh-better-markdown 冲突:两者都以 priority: -100 影子注册 assistant-step,同时安装会在启动时报"同 key 同 priority"错误。二选一安装;若需共存,改其中一方的 priority。
• 接管默认渲染:影子注册意味着思考块与文本块的渲染由本插件维护,升级 dsh 后若内置渲染结构变化需跟随适配(崩溃时内置渲染器会自动接管兜底)。
• 流式译文是"进行中"版本:思考/回复仍在输出时,译文基于当前已见文本、按防抖节奏更新,内容可能不完整;输出停止后自动用完整文本重翻。
• 工具摘要只处理 text 块:图片、二进制输出不翻译;超长输出先截断(maxInputChars)再概括。
• 语言判断是启发式:短于 10 个字母的英文、中日韩混排、代码占多数的输出不会翻译;判断逻辑在 lib/client.js 的 isEnglishProse / isMostlyCode。
• 翻译缓存在浏览器内存中(按消息节点/工具调用标识),刷新页面后同一内容会重新请求。
• 设置界面:目前通过 settings.yaml 配置,尚无设置 UI 面板。

License

MIT