@lynn123411/dsh-chat-translate
DeepSeek Harness Web 界面的助手回答正文翻译插件。它接管助手行的渲染：过程步骤的正文块送翻译模型加工——外文译成简体中文，已经写好的中文原样抄回（只有读不通的句子才改那几句），译文按原 markdown 结构重新渲染。结论步骤的正文不译，按原文呈现——那一步由模型直接写给读者，通常已经是写好的中文。只翻正文：Think 卡的思考链、工具调用行、用户消息、代码块、空白块不动。切换译文与原文在贴着正文左缘的一条 10px 透明窄带上，不污染会话上下文。
功能
- 过程步骤翻成简体中文，结论步骤不译：一轮回答里，前面几步在干活，最后一步把结论交给读者。干活那几步的散文往往是英文，要翻；结论那一步通常是模型已经写好的中文，再送一遍只换来等待与改坏的风险，所以整行按原文呈现、左缘什么都不出现。判据读宿主算好的结论步骤号（
TurnProcessSpec.answerStep），细节见 DETAILS.md 的「翻译范围与时机」。
- 过程步骤的正文翻成简体中文，已写好的中文原样抄回：过程步骤的每一块都送模型——整段中文、纯数字、纯标点的块同样照送，只有 trim 后为空的块不送译。提示词让模型把中文当抄写对象：能读通就一个字都不动，只有句子读不通时才改那几句；外文正常译，专名、数字、术语与 markdown 记号原样保留。模型返回与原文一模一样的文字时同样算翻译过、同样可切换。
- 块一写完就翻：正文只往后追加，写定的块立刻送译，正在长的尾块保持原文；行进入视口（150px 缓冲）后开始首跑，先回的段先出中文。
- 译文与原文一键切换：鼠标停在正文左缘那条 10px 透明窄带上时，光标右边出一条气泡报出此刻能做的动作（读译文时「查看原文」，读原文时「查看译文」），点一下切过去，再点切回来；正文整块不响应点击，选中文字、拖选复制都不会误触。
- 失败保持原文、只手点重试：失败分两类——通道伤（超时、断流、空返回）与设置没配好（缺 Key / Base URL / 模型）。失败块保持原文，左缘留下一个 ↻ 按钮，悬停报出哪一类失败与原因；点它只重发这一块，已成功的块原地不动。失败不自动重试，一块失败不连坐。
- 设置没配好不再无声：缺 Key / Base URL / 模型时如实报出「设置没配好」，气泡与读屏都指向配置页；总开关关着则是纯粹的「不要翻译」，不挂任何标记。
- 开关两个入口：输入框下方那一行的「译」胶囊与本插件配置页的总开关，读写同一个
enabled，状态同步、拨一下即时生效。
- 配置页挂在「插件」页：注册进
plugins.bundle.config（key 为包名），路径是「插件」→ 本插件详情页；卡片提供总开关、API Key、Base URL、模型、单次请求超时、提示词与「测试 AI 通道」，改动在离开输入框时自动保存。配置项、安装与校验见 DETAILS.md。
特性
- 接管助手行渲染：经 keyed slot
conversation.chat.node（key assistant-step，priority -1）替换宿主的助手行渲染器。正文块从数据层拿原始 markdown（AssistantBlock.text），译文同样以 markdown 交给宿主公开的基线组件 MarkdownText（micromark + GFM + KaTeX）重渲染——表格、列表、加粗、行内代码、公式的结构由官方渲染器保证，插件不自拼 markup。接管渲染器抛错时按框架退位规则退出该 cell，宿主原渲染器自动回位。
- 除正文外与宿主逐分支等价：Think 折叠行（含工作细节策略下的摘要预览、Turn-process 折叠隐藏与页内搜索揭示）、连续图片组、工具调用行、未知内容块、中断前缀行尾的「已停止」都交回宿主渲染，chrome 文案复用宿主
chat 词典，两侧逐字一致。
- 正文排版原生，左缘不画任何东西：正文没有竖线、没有缩进，文字位置与列表、引用的缩进与宿主默认逐字一致。两个可点物都落在正文之外：成功块是左缘 10px 宽的透明窄带（不占正文一个像素），失败块是一个 ↻ 按钮（
dsh-ct-retry），失败段不放窄带——一段落只对应一个动作。窄带与 ↻ 都落在宿主正文列左侧的空白里，不压任何宿主元素。
- 结构重装配，形状问题只修不拒：宿主先把块按 markdown 结构切段——代码围栏与纯空白段逐字保留、永不送模型——散文段再按输入上限（4096 估算 token）切片、相邻片段打包成一个请求（输出上限 8192 token）。回来的译文过形状修复（
repairShape）：按段落块对齐，块内结构行（记号类别、表格竖线数、链接个数、缩进代码缩进）逐一对齐并把行首前缀修回原文同款，散文行自由重排，空行布局一律取原文，[文字](URL) 的 URL 按出现序逐字拼回。修不齐的片段自动重掷一次，仍不齐就照收模型的译文——形状问题不否决内容，失败标记只留给「这一段没译出来」。
- 整段没写回来不算译好：模型只把开头那段写回来、后面几段整段不写时，那几段正文会被永久丢掉，所以这一份不照收——重掷一次，而且第二问换成带标记的形状（模型因此不再把开头那段当整段），仍然少就整块保持原文并留下 ↻ 等手点重翻。
- 内容寻址的翻译池：客户端按原文内容记已送达的译文，同一段原文在别处出现直接复用，不再打通道；行键加文本清单判同代，换代（文本被整份重写）时旧结果作废，迟到的旧代结果丢弃。
- 上游重试按块作废：唯一让已写定的块作废的是上游模型自己重试（整次尝试清空从零重来）；那时按块判断，内容一字未变的块其中文留在原地，真变了的块才重翻。
- 单通道：OpenAI 兼容协议：对接任意 OpenAI 兼容的
chat/completions 服务（OpenAI、DeepSeek、通义、Ollama、本地 vLLM 等）。Key / Base URL / 模型三者齐备才翻译，缺任何一项保持原文并如实报「设置没配好」，不做降级兜底。API Key 经 DSH 凭据服务读写 ~/.dsh/.credentials.yaml 的 TRANSLATE_API_KEY。
- 串行与超时：同时最多一个在途请求，单次超时
aiTimeoutMs（默认 600000 毫秒，范围 500–900000）；每行首跑与每次手点都等到真实结果。
- 提示词写在配置页上：拼在待译正文前面的那段指令平时只读，点「编辑」才进改写态——先看清模型收到的是什么，再动手改。配置里空着就用内置默认，一字不差贴回默认同样存成空值；多段打包的标记约定由插件自己追加，读者只写指令正文。内置默认的写法有几条承载行为，改动前后的对照见 DETAILS.md 的「提示词」。
- 缓存按提示词世代整体作废：磁盘池
~/.dsh/dsh-chat-translate/cache.json（1000 条 LRU）在文档里登记 rev，世代跟着此刻生效的提示词与采样参数走——改了提示词或换了参数，旧产出整池作废（浏览器这一侧的译文池同时丢掉）；同一代里命中即复用。
- 跟随宿主显示设置：Think 行的折叠摘要预览跟随「工作细节」模式（读
ui-chat 配置的 transcriptView，含旧取值映射），设置缺席时按 standard。
- DSH 原生配置接入：配置就是本插件在 profile 里的插件配置——配置页经
ctx.configForms 读写 dsh-chat-translate 条目的 config，用户层落在当前 profile 的 patch；无任何自研配置文件，译文从不写回会话上下文。
- 离开输入框即自动保存：Base URL、模型、超时、提示词与 API Key 都是草稿——打字期间一个字都不写盘，离开那个输入框时提交上去，没有保存按钮。空着离开等于清除该项，超时草稿不合法时不写盘、页面报出原因。想验通道就点「测试 AI 通道」。总开关拨一下即时生效。
安装
dsh plugin --profile web add @lynn123411/dsh-chat-translate
