@lynn123411/dsh-chat-translate 1.9.0 → 3.0.0

package/README.md

@@ -1,25 +1,25 @@
 # @lynn123411/dsh-chat-translate
 
-DeepSeek Harness Web 界面的工具调用与思考链智能翻译插件。自动将当前会话中工具调用标题翻译为中文，并可在开启 AI 翻译后进一步翻译思考正文，采用非侵入式双语对照渲染（点击译文可切换原文），不污染会话上下文。内置 OpenAI 兼容 AI 翻译与免 Key Bing 兜底双通道。配置详见 [docs/配置.md](./docs/配置.md)。
+DeepSeek Harness Web 界面的**助手回答正文翻译**插件。它接管助手行的渲染：正文块不论源语言，一律送翻译模型加工成自然简体中文（如 `I traced the failing path to a stale lock file.` → 中文；模型写出的生硬机器腔中文同样送一遍润色——弱模型的中文恰恰最需要加工），译文按原 markdown 结构重新渲染。只翻正文：Think 卡的思考链、工具调用行、用户消息、代码块不动。已翻译的块左缘竖线：译文蓝粗线、原文灰细线、未译无线。不污染会话上下文。开关有两个入口：输入框下方那一行的「译」胶囊与共享「阅读体验」设置页的总开关，同一个状态两处同步。配置详见 [docs/配置.md](./docs/配置.md)。
 
 ## 特性
 
-- **工具调用标题自动翻译**：仅在渲染层将工具调用动作描述（如 `Locate DSH home directory structure`）翻译为中文，回答正文永不翻译。
-- **思考链翻译（按钮触发，仅 AI 通道）**：展开的思考卡在「Think」右侧有一个 18px 按钮，点击才翻译这条思考正文，**不会自动翻译**；折叠的卡片没有按钮，展开后按钮才出现。三态：未翻译＝描边「译」字，翻译中＝圈内圆环旋转（系统开启「减弱动态效果」时改为静态高亮），已翻译＝实心高亮，再点一次整条切回原文（正文里的点击不再切换，思考链一律靠这个按钮变更）。思考还在流式输出（`data-state="running"`）时按钮置灰；翻译中再点忽略；失败时按钮停止动画、回到可翻译状态，可以再点重试。
-- **缓存与显示规则**：展开卡片时若整条思考的段落都已命中本地缓存，直接显示中文（不发请求）；只命中一部分时展开仍是原文，点按钮时已命中的立刻出现、其余才发请求；翻译中途折叠卡片，本次翻译会跑完并进缓存，再展开时整条命中缓存就直接显示中文。思考卡折叠起来的那一行摘要永不翻译；代码块原样保留；混合块（列表项文字加子列表或代码块）只翻行内文字，嵌套结构留在原位。
-- **按块翻译与打包**：正文按 markdown 块级元素切分，相邻块打包成一个请求，输入上限 4096 估算 token、输出上限 8192 token；单个块超过输入上限时按空行、单行、句末依次切分，译回后拼回；客户端按 2048 估算 token 分块，逐块请求、逐块挂载，中文一段一段出现。请求走独立串行队列，同时最多一个在途，超时独立（默认 600 秒，可调至 900 秒），译文进独立缓存池（客户端与磁盘各 300 条），与工具标题互不挤占。
-- **AI 翻译通道（OpenAI 兼容协议）**：对接任意 OpenAI 兼容的 `chat/completions` 服务（OpenAI、DeepSeek、通义、Ollama、本地 vLLM 等），Base URL 与模型可在设置面板配置；API Key 经 DSH 凭据服务读写 `~/.dsh/.credentials.yaml` 的 `TRANSLATE_API_KEY`，填写后立即生效。工具标题与思考链都由它承接。
-- **Bing 免 Key 兜底通道**：内置微软 Bing 网页翻译（免 Key、国内直连），只用于工具调用标题的兜底；AI 未配置或请求失败时自动降级，思考链翻译永远不走这条通道。双通道均有独立开关，同时关闭则不翻译。
-- **非侵入式 DOM 挂载与双语对照**：非侵入式包装保留原始 DOM 节点与 React Fiber 事件系统；工具标题点击译文原地切换单条，思考链只由标题右侧的按钮在原文与中文之间整条切换，正文里的点击不改变原文与译文。
-- **智能内容脱敏与占位符保护**：翻译前对多行代码块、内联代码、URL 链接、文件路径及 CLI 命令行参数进行占位符脱敏与鲁棒还原，杜绝代码与路径被误翻译。占位符为 `⟦<随机短码><序号>⟧` 形式的独立片段，构建时会在紧邻拉丁字母的一侧补一个空格，避免译回时与相邻单词粘连。译文只有在每个占位符都按原顺序被完整还原时才被采用：占位符被改写、遗失或多个重复时整条译文作废并换通道，退回原文，且绝不写入缓存；升级前旧格式写入的污染译文在读取时被驱逐。
-- **当前会话作用域**：仅翻译当前查看的会话，切换会话自动跟随新内容；视口懒加载（150px 缓冲）与文档顺序排队，译文按阅读顺序出现。
-- **智能调度与熔断保护**：工具标题走 1–100 动态并发限流队列、AI 30s / Bing 2s 超时、连续失败熔断自愈、在途请求合并去重、7 天 LRU 磁盘持久化缓存（工具标题 `~/.dsh/dsh-chat-translate/cache.json`，思考链 `~/.dsh/dsh-chat-translate/think-cache.json`）。
-- **DSH 原生配置接入**：配置就是本插件在 profile 里的插件配置——设置面板经 DSH 的共享配置表单（`ctx.configForms`）读写本插件配置条目 `dsh-chat-translate` 的 `config`，用户层落在当前 profile 的 patch；密钥走 DSH `credentials` 服务（`~/.dsh/.credentials.yaml` 的 `TRANSLATE_API_KEY`）。无任何自研配置文件。
-- **设置面板集成**：设置面板挂在「设置 - 阅读体验」页（本插件贡献其中一张卡片），页内提供总开关、AI/Bing 通道开关、「显示思考链翻译按钮」（默认打开）与思考链超时、Base URL 与模型配置、通道测试与并发数调节。按钮的显示还要求 AI 通道打开且已配置（Key / Base URL / 模型齐全），缺任何一条都不注入按钮并还原已翻译内容。
+- **接管助手行渲染**：经 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 通道」。
 
 ## 安装
 
 ```bash
 dsh plugin --profile web add @lynn123411/dsh-chat-translate
 ```
-

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，保存后立即生效；留空保存 = 清除该键）。也可以手动编辑该文件：
 
@@ -9,33 +9,29 @@
      TRANSLATE_API_KEY: sk-xxx
    ```
 
-   > ⚠️ **注意**：DSH 的凭据加载器要求 refs 键值非空。手动编辑时要么填写真实 Key，要么**直接删除该行**——不要写成 `TRANSLATE_API_KEY: ""` 这类空值，否则 DSH 启动会失败。未配置时插件自动由 Bing 通道兜底，不会报错。
+   > ⚠️ **注意**：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 通道」验证。所有设置（开关、并发数、超时等）都是本插件在 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
      name: '@lynn123411/dsh-chat-translate'
      config:
        enabled: true
-       concurrency: 3
-       aiEnabled: true
-       bingEnabled: true
-       thinkEnabled: true
-       thinkTimeoutMs: 600000
+       aiTimeoutMs: 600000
        baseUrl: https://api.deepseek.com/v1
        model: deepseek-chat
-       targetLang: zh-Hans
    ```
 
-   > 从 1.2 起，插件不再读写独立的 `~/.dsh/dsh-chat-translate-config.json`：升级后首次加载会自动把旧文件的值迁移进这个配置条目并删除旧文件（若你已在 UI 中改过设置，则以你的设置为准）。
+   目标语言固定为简体中文，没有配置项。
 
-3. **思考链翻译按钮**：AI 卡片里的「显示思考链翻译按钮」默认打开；按钮的显示还要求总开关打开、AI 通道打开且已配置（Key / Base URL / 模型齐全），缺任何一条都不注入按钮并还原已翻译内容。按钮只在展开的思考卡上出现，位于「Think」右侧；折叠的卡片没有按钮，展开后才插入。点击才翻译这条思考正文，不会自动翻译。
+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 预算切批、逐批顺序请求，先回的段先出中文，不需要点任何按钮。
 
-   - 三态：未翻译＝描边「译」字，翻译中＝圈内圆环旋转（系统开启「减弱动态效果」时为静态高亮），已翻译＝实心高亮；再点一次整条切回原文；正文里的点击不再改变原文与译文，思考链一律靠这个按钮变更。
-   - 思考还在流式输出（`data-state="running"`）时按钮置灰；翻译中再点忽略；失败时按钮停止动画并回到可翻译状态，可以再点重试。
-   - 缓存规则：展开时若整条思考的段落都命中本地缓存就直接显示中文（不发请求）；只命中一部分时展开仍是原文，点按钮时已命中的立刻出现、其余才发请求；翻译中途折叠卡片，本次翻译会跑完并进缓存。
-   - 翻译范围：展开的思考正文；折叠起来的那一行摘要永不翻译，代码块原样保留，混合块只翻行内文字、嵌套子列表留在原位。只走 AI 通道，Bing 从不参与。
-   - 请求方式：客户端按 2048 估算 token 分块，宿主按块打包（输入上限 4096 估算 token、输出上限 8192 token），走独立串行队列（同时最多一个在途请求），超时由 `thinkTimeoutMs` 控制（默认 600000 毫秒，范围 500–900000）。译文进独立缓存池（客户端与磁盘各 300 条），与工具标题互不挤占。
+   - 不送译的内容：Think 卡的思考链正文、工具调用行、用户消息、代码块（`pre`）及其内部——这些与宿主渲染逐分支等价，接管渲染器抛错时按框架退位规则由宿主渲染器自动回位。
+   - 译文用宿主基线组件 `MarkdownText` 重新渲染，表格、列表、加粗、行内代码的结构保持原样。
+   - 失败即保留原文：块内任一片段失败就整块按原文渲染、不挂线，界面上不留提示，控制台留一条警告；失败结果不进缓存，一批失败只败在这一批，含失败块的行停在待重试态——该行滚出视口再回来或重挂载时自然重走、同一代文本封顶三次（`MAX_ROW_ATTEMPTS`，换代重置），已成功的块由宿主磁盘缓存直接命中。熔断账本只数传输故障：占位符/块标记没原样带回属于内容级拒收，记通道可用、当场作废该块，一段弱模型啃不动的内容不会把其他行挡在冷却期外。
+   - 点击翻译过的块在译文与原文间切换（键盘 Enter/Space 同样），块与块互不影响；关闭总开关即全部回到原文。
 
-4. **通道行为**：AI 开启且已配置 → 工具标题 AI 优先、失败降级 Bing；AI 开启但未配置 + Bing 开启 → Bing 翻译；AI 未配置 + Bing 关闭 → 不翻译；AI 关闭 + Bing 开启 → 直接 Bing；双关 → 不翻译。思考链翻译与此表无关，它只认 AI 通道与自己的开关。
+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 / 模型三者齐备才翻译，缺任何一项都保持原文，不做降级兜底。