@lynn123411/dsh-chat-translate 2.0.0 → 3.0.1

package/README.md

@@ -1,20 +1,21 @@
 # @lynn123411/dsh-chat-translate
 
-DeepSeek Harness Web 界面的**过程折叠块正文翻译**插件。自动把助手「用时 XXX」那个大折叠块里需要阅读的英文（如 `I traced the failing path to a stale lock file.`）翻成中文，采用非侵入式双语对照渲染（点击译文可原地切回原文），不污染会话上下文。折叠块之外的最终汇总、思考链正文与工具调用行一律不翻，代码块原样保留。配置详见 [docs/配置.md](./docs/配置.md)。
+DeepSeek Harness Web 界面的**助手回答正文翻译**插件。它接管助手行的渲染：正文块不论源语言，一律送翻译模型加工成自然简体中文（如 `I traced the failing path to a stale lock file.` → 中文；模型写出的生硬机器腔中文同样送一遍润色——弱模型的中文恰恰最需要加工），译文按原 markdown 结构重新渲染。只翻正文：Think 卡的思考链、工具调用行、用户消息、代码块不动。已翻译的块左缘竖线：译文蓝粗线、原文灰细线、未译无线。不污染会话上下文。开关有两个入口：输入框下方那一行的「译」胶囊与共享「阅读体验」设置页的总开关，同一个状态两处同步。配置详见 [docs/配置.md](./docs/配置.md)。
 
 ## 特性
 
-- **只翻大折叠块里的正文**：范围判定直接用内核标在 flow item 上的 `data-turn-process-member`（折叠块成员）与 `data-turn-process-answer`（最终汇总）——只翻前者。不做「轮尾行之前」这类位置推断：轮尾行要等轮次结束才出现，进行中的轮次会把折叠块里的正文整片漏掉。折叠块之外的最终汇总、思考链正文、工具调用标题与折叠摘要永不参与，代码块及其内容原样保留。
-- **全自动，无需点击**：回答还在流式输出（markdown 根带 `data-streaming`）时不翻，落定后整条转成中文，中文一段一段出现。开关只有一个：设置页里的总开关。
-- **中文段落原样保留**：不含拉丁字母的块（整段中文、纯数字、纯标点）不进请求也不占缓存，交付正文里已经写好的中文段落不会被再翻一遍。
-- **按块翻译与打包**：正文按 markdown 块级元素切分，混合块（列表项文字 + 子列表 / 代码块）拆成行内片段，嵌套结构留在原位；客户端按 2048 估算 token 分块逐块请求、逐块挂载，宿主把相邻片段打包成一个请求（输入上限 4096 估算 token、输出上限 8192 token），单块超限时按空行、单行、句末依次切开再拼回。
-- **失败即保留原文**：块内任一片段失败就整块不译，界面上不留提示，控制台留一条警告；失败的译文不进缓存，下次滚动重扫时会自然重试。
-- **非侵入式 DOM 挂载与双语对照**：非侵入式包装保留原始 DOM 节点与 React Fiber 事件系统；点击某一块的译文原地切回该块原文，再点原文切回译文，块与块互不影响。
-- **智能内容脱敏与占位符保护**：翻译前对多行代码块、内联代码、URL 链接、文件路径及 CLI 命令行参数做占位符脱敏与鲁棒还原，杜绝代码与路径被误翻译。占位符是 `⟦<随机短码><序号>⟧` 形式的独立片段，构建时会在紧邻拉丁字母的一侧补一个空格，避免译回时与相邻单词粘连。译文只有在每个占位符都按原顺序完整还原时才被采用：占位符被改写、遗失或重复时整条译文作废、退回原文，且绝不写入缓存；升级前旧格式写入的污染译文在读取时被驱逐。
-- **单通道：AI 翻译（OpenAI 兼容协议）**：对接任意 OpenAI 兼容的 `chat/completions` 服务（OpenAI、DeepSeek、通义、Ollama、本地 vLLM 等）。Key / Base URL / 模型三者齐备才翻译，缺任何一项都保持原文，不做任何降级兜底。API Key 经 DSH 凭据服务读写 `~/.dsh/.credentials.yaml` 的 `TRANSLATE_API_KEY`，保存后立即生效；Base URL 与模型在设置面板配置。
-- **串行请求与熔断保护**：同时最多一个在途请求（长回答按阅读顺序逐段出中文），单次请求超时 `aiTimeoutMs`（默认 600000 毫秒，范围 500–900000），连续失败熔断自愈，7 天 LRU 磁盘缓存 `~/.dsh/dsh-chat-translate/cache.json`。
-- **当前会话作用域与视口懒加载**：只翻译当前查看的会话，切换会话自动跟随新内容；回答进入视口（150px 缓冲）才开始翻译，历史会话因此只在真的被读到时才花请求，命中缓存的回答滚到即整条显示中文。
-- **DSH 原生配置接入**：配置就是本插件在 profile 里的插件配置——设置面板经 DSH 的共享配置表单（`ctx.configForms`）读写本插件配置条目 `dsh-chat-translate` 的 `config`，用户层落在当前 profile 的 patch；密钥走 DSH `credentials` 服务。无任何自研配置文件。
+- **接管助手行渲染**：经 keyed slot `conversation.chat.node`（key `assistant-step`，priority -1）替换宿主的助手行渲染器。正文块从数据层拿**原始 markdown**（`AssistantBlock.text`），译文同样以 markdown 交给宿主公开的基线组件 `MarkdownText`（micromark + GFM + KaTeX）重渲染——表格、列表、加粗、行内代码、公式的结构由官方渲染器保证，插件不自拼 markup。接管渲染器抛错时按框架退位规则退出该 cell，宿主原渲染器自动回位。
+- **一律送译，不判源语言**：正文的每一块都进模型，包括整段中文、纯数字、纯标点的块。提示词要求模型把每一段都改写成自然、地道的简体中文——意义、语气、专名、数字与术语不动，不增不删；同时要求 markdown 记号原样保留。模型判断某段已经最好而返回一模一样的文字时，同样算翻译过、同样挂线（标记传达的是「这段过了模型」）。
+- **除正文外与宿主逐分支等价**：Think 折叠行（含工作细节策略下的摘要预览、Turn-process 折叠隐藏与页内搜索揭示）、连续图片组交回宿主渲染、工具调用行由宿主独立渲染、未知内容块落 JSON 展示、中断前缀行尾带「已停止」——这些 chrome 文案复用宿主 `chat` 词典，两侧逐字一致。
+- **已翻译标记与双语切换**：已翻译的块左缘一条竖线——显示译文为 1px 主色蓝线、点回原文为 0.5px 中性灰线（留有译文、可再点回的线索；0.5px 上虚线会被抗锯齿糊平，区分走色相与粗细），未译成则无线；整块可点击（键盘 Enter/Space 同样）在译文与原文间切换，块与块互不影响，关闭开关即全部回到原文。
+- **落定才翻、进视口才翻**：回答流式期间整行按原文渲染；`data-streaming` 落定且行进入视口（150px 缓冲）后，整行正文按估算 token 预算切批、逐批顺序请求——先回的段先出中文，按阅读顺序逐段呈现。历史会话因此只在真的被读到时才花请求。
+- **失败即原文，界面静默**：块级失败（通道错误、占位符被改写/遗失、空结果）不进缓存、不显示标记，保持原文；一批失败只败在这一批，含失败块的行停在待重试态，该行滚出视口再回来或重挂载时自然重走、同一代文本封顶三次（已成功的块由宿主磁盘缓存直接命中，不再花模型调用）。控制台留一条警告。
+- **按行幂等的翻译池**：客户端按会话锚点键登记整行结果，同文本重复渲染不重发请求；行内容换代则整行重译，迟到的旧代结果作废。
+- **打包请求与脱敏保护**：宿主把相邻块打包成一个请求（输入上限 4096 估算 token、输出上限 8192 token），单块超限按空行、单行、句末切开再拼回；翻译前对代码块、内联代码、URL、文件路径、CLI 参数做 `⟦…⟧` 占位符脱敏，译文必须逐位原样带回占位符，否则整块作废、绝不入缓存。
+- **单通道：AI 翻译（OpenAI 兼容协议）**：对接任意 OpenAI 兼容的 `chat/completions` 服务（OpenAI、DeepSeek、通义、Ollama、本地 vLLM 等）。Key / Base URL / 模型三者齐备才翻译，缺任何一项保持原文，不做降级兜底。API Key 经 DSH 凭据服务读写 `~/.dsh/.credentials.yaml` 的 `TRANSLATE_API_KEY`；Base URL 与模型在设置面板配置。
+- **串行与熔断**：同时最多一个在途请求，单次超时 `aiTimeoutMs`（默认 600000 毫秒，范围 500–900000），连续传输失败熔断自愈——只数传输故障，内容级拒收（占位符没原样带回等）当场作废该块而不计入熔断账本，一段坏内容挡不住其他行。磁盘缓存池 `~/.dsh/dsh-chat-translate/cache.json`（7 天 TTL、1000 条 LRU）**按提示词修订号整体作废**：文档里登记 `rev`，换提示词语义后旧译文不会串代。
+- **跟随宿主显示设置**：Think 行的折叠摘要预览跟随「工作细节」模式（读 `ui-chat` 配置的 `transcriptView`，含 legacy 取值映射）；设置缺席时按 standard。
+- **DSH 原生配置接入**：配置就是本插件在 profile 里的插件配置——设置面板经 `ctx.configForms` 读写条目 `dsh-chat-translate` 的 `config`，用户层落在当前 profile 的 patch；无任何自研配置文件，译文从不写回会话上下文。
 - **设置面板集成**：设置面板挂在「设置 - 阅读体验」页（本插件贡献其中一张卡片），页内提供总开关、API Key、Base URL、模型、单次请求超时与「测试 AI 通道」。
 
 ## 安装

package/docs//351/205/215/347/275/256.md

@@ -1,6 +1,6 @@
 # 配置
 
-> 本文档为 [@lynn123411/dsh-chat-translate](../README.md) 的配置说明（自 README 的「## 配置」段迁出，内容保持一致）。
+> 本文档为 [@lynn123411/dsh-chat-translate](../README.md) 的配置说明。
 
 1. **API Key**：打开「设置 - 阅读体验」，在 AI 翻译卡片中直接填写 API Key 并保存（经 DSH 凭据服务写入 `~/.dsh/.credentials.yaml` 的 `TRANSLATE_API_KEY`，权限 0600，保存后立即生效；留空保存 = 清除该键）。也可以手动编辑该文件：
 
@@ -11,7 +11,7 @@
 
    > ⚠️ **注意**：DSH 的凭据加载器要求 refs 键值非空。手动编辑时要么填写真实 Key，要么**直接删除该行**——不要写成 `TRANSLATE_API_KEY: ""` 这类空值，否则 DSH 启动会失败。未配置时插件不翻译，正文保持原文，不会报错。
 
-2. **Base URL 与模型等设置**：在「设置 - 阅读体验」中填写 Base URL（如 `https://api.openai.com/v1` 或 `https://api.deepseek.com/v1`）与模型名（如 `gpt-4o-mini`、`deepseek-chat`），点击「测试 AI 通道」验证。所有设置（开关、超时、Base URL、模型、目标语言）都是本插件在 profile 里的插件配置：写入当前 profile 的 patch（`~/.dsh/profiles/<profile>/cordis.patch.yml`）中 `dsh-chat-translate` 条目的 `config`，可直接编辑该文件——字段都是可实时更新的，改完立即生效，不需重载：
+2. **Base URL 与模型等设置**：在「设置 - 阅读体验」中填写 Base URL（如 `https://api.openai.com/v1` 或 `https://api.deepseek.com/v1`）与模型名（如 `gpt-4o-mini`、`deepseek-chat`），点击「测试 AI 通道」验证。所有设置（开关、超时、Base URL、模型）都是本插件在 profile 里的插件配置：写入当前 profile 的 patch（`~/.dsh/profiles/<profile>/cordis.patch.yml`）中 `dsh-chat-translate` 条目的 `config`。开关 `enabled` 有两个入口：设置页总开关，与聊天输入框下方那一行（composer dock）的「译」胶囊——两处读写同一个字段，状态同步；这一行只在会话形态渲染，新建会话的 Hero 形态没有它。字段都是可实时更新的，改完立即生效，可直接编辑该文件，不需重载：
 
    ```yaml
    - id: dsh-chat-translate
@@ -21,21 +21,17 @@
        aiTimeoutMs: 600000
        baseUrl: https://api.deepseek.com/v1
        model: deepseek-chat
-       targetLang: zh-Hans
    ```
 
-   > 从 1.2 起，插件不再读写独立的 `~/.dsh/dsh-chat-translate-config.json`：升级后首次加载会自动把旧文件的值迁移进这个配置条目并删除旧文件（若你已在 UI 中改过设置，则以你的设置为准）。
+   目标语言固定为简体中文，没有配置项。
 
-   > 从 2.0 起，`concurrency`、`timeoutMs`、`thinkTimeoutMs`、`aiEnabled`、`bingEnabled`、`thinkEnabled` 与 `channels` 都已退役：这些键在旧版本里描述的能力（工具标题翻译、思考链翻译、Bing 兜底、并发池）已经删除。首次加载会把它们从你的配置条目里清掉，`~/.dsh/dsh-chat-translate/think-cache.json` 也一并删除。`targetLang` 只在这里配置，设置面板不提供入口。
+3. **翻译范围与时机**：插件接管助手行的渲染（keyed slot `conversation.chat.node` / `assistant-step`，priority -1）。正文块不论源语言一律送模型改写成自然简体中文——「用时 XXX」大折叠块里每一步露出的正文与最终汇总那一步一视同仁；整段中文同样照送（意义、术语、数字不动，顺掉机器腔）。模型返回与原文一模一样的文字时同样算翻译过：照常显示、照常可切换。左缘线的色相与粗细随显示态：显示译文挂 1px 主色蓝线（`--dsw-alias-state-business-primary` 65%），点回原文挂 0.5px 中性灰线（`--dsw-alias-border-l2`，备着译文、可点回），未译成无线——线宽只差 0.5px，切换不跳字。分组判据是座次传入的 `groupPart`（`response` 分组排除思考块，`reasoning` 分组只渲染思考块，不送译），流式判据是行数据的 `status === "running"`。流式期间整行按原文渲染；落定且该行进入视口（150px 缓冲）后，整行正文按估算 token 预算切批、逐批顺序请求，先回的段先出中文，不需要点任何按钮。
 
-3. **翻译范围与时机**：只翻「用时 XXX」那个大折叠块里的正文（给人读的那些段落）。范围判定用内核标在每条 flow item 上的 `data-turn-process-member`（折叠块成员）与 `data-turn-process-answer`（最终汇总）：只翻前者，后者一个字都不碰。回答还在流式输出（markdown 根带 `data-streaming`）时不动，落定后整条自动转中文，不需要点任何按钮。
+   - 不送译的内容：Think 卡的思考链正文、工具调用行、用户消息、代码块（`pre`）及其内部——这些与宿主渲染逐分支等价，接管渲染器抛错时按框架退位规则由宿主渲染器自动回位。
+   - 译文用宿主基线组件 `MarkdownText` 重新渲染，表格、列表、加粗、行内代码的结构保持原样。
+   - 失败即保留原文：块内任一片段失败就整块按原文渲染、不挂线，界面上不留提示，控制台留一条警告；失败结果不进缓存，一批失败只败在这一批，含失败块的行停在待重试态——该行滚出视口再回来或重挂载时自然重走、同一代文本封顶三次（`MAX_ROW_ATTEMPTS`，换代重置），已成功的块由宿主磁盘缓存直接命中。熔断账本只数传输故障：占位符/块标记没原样带回属于内容级拒收，记通道可用、当场作废该块，一段弱模型啃不动的内容不会把其他行挡在冷却期外。
+   - 点击翻译过的块在译文与原文间切换（键盘 Enter/Space 同样），块与块互不影响；关闭总开关即全部回到原文。
 
-   - 永不翻译：折叠块之外的最终汇总、思考链正文、工具调用标题、工具卡片折叠起来的那一行摘要。
-   - 原样保留：代码块（`pre`）及其内部；不含拉丁字母的块（整段中文、纯数字、纯标点）不进请求也不占缓存。
-   - 混合块（列表项文字 + 子列表 / 代码块）只翻行内文字，嵌套结构留在原位。
-   - 失败即保留原文：块内任一片段失败就整块不译，界面上不留提示，控制台留一条警告；失败结果不进缓存，下次滚动重扫时自然重试。
-   - 点击某一块的译文原地切回该块原文，再点原文切回译文；块与块互不影响。
-
-4. **请求方式**：客户端按 2048 估算 token 分块，逐块请求、逐块挂载；宿主把相邻片段打包成一个请求（输入上限 4096 估算 token、输出上限 8192 token），单块超过输入上限时按空行、单行、句末依次切开，译回后拼回。同时最多一个在途请求，超时由 `aiTimeoutMs` 控制（默认 600000 毫秒，范围 500–900000）。译文进唯一的缓存池（客户端 500 条、磁盘 1000 条，7 天 TTL）；已命中缓存的块在进入视口时立即显示中文，不发请求。
+4. **请求方式**：按行请求——落定的助手行把它全部正文块一次送出，宿主把相邻块打包成一个请求（输入上限 4096 估算 token、输出上限 8192 token），单块超过输入上限时按空行、单行、句末依次切开，译回后拼回。同时最多一个在途请求，超时由 `aiTimeoutMs` 控制（默认 600000 毫秒，范围 500–900000）。客户端只保留一个按行的内存翻译池（会话锚点为键，LRU 200 行）；持久缓存只有宿主的磁盘池 `~/.dsh/dsh-chat-translate/cache.json`（1000 条、7 天 LRU），文档形态是 `{ rev, entries }`，其中 `rev` 登记写入它的提示词修订号——修订号（`src/server/prompt-revision.ts` 的 `PROMPT_REVISION`，单点登记）与实际加载的提示词不符时整池作废重来，换提示词不会让旧译文串代。
 
 5. **通道行为**：只有一条通道——Key / Base URL / 模型三者齐备才翻译，缺任何一项都保持原文，不做降级兜底。