dsh-cait 1.0.5 → 1.1.6

package/README.zh-CN.md

@@ -16,12 +16,12 @@
 <p align="center">
   <a href="https://www.npmjs.com/package/dsh-cait"><img alt="npm 版本" src="https://img.shields.io/npm/v/dsh-cait.svg" /></a>
   <img alt="DSH 0.2.x" src="https://img.shields.io/badge/DSH-0.2.x-4d6bfe.svg" />
-  <img alt="15 套测试" src="https://img.shields.io/badge/tests-15%20suites-brightgreen.svg" />
+  <img alt="41 套测试" src="https://img.shields.io/badge/tests-41%20suites-brightgreen.svg" />
   <img alt="无需 API Key" src="https://img.shields.io/badge/API%20key-not%20required-6b7280.svg" />
 </p>
 
 CAIT 为 DSH Web UI 和 DSH 桌面端增加一个 CAT 翻译工作台。它从左侧栏入口打开，
-工作台与七个 Agent 工具共用一个数据存储，覆盖从导入源文件到导出译文的完整流程。
+工作台与二十一个 Agent 工具共用一个数据存储，覆盖从导入源文件到导出译文的完整流程。
 
 > **已在 DSH `0.2.2-rc.1` 中验证。** CAIT 使用 DSH 自己的模型路由和凭据，
 > 不会要求用户填写 API Key。内部回退提供方仍叫 `mock`，界面显示为
@@ -32,11 +32,11 @@ CAIT 为 DSH Web UI 和 DSH 桌面端增加一个 CAT 翻译工作台。它从
 | | |
 |---|---|
 | **原生集成 DSH** | 真正的侧栏入口、主工作台、DSH 主题令牌，以及人和 Agent 共用的同一份数据。不是 iframe，也不是另一个独立应用。 |
-| **可解释的翻译记忆** | 支持多个 TM 库、仅检索已挂载库、精确/近似精确/高/中/低模糊等级，确认句段时自动写回。 |
+| **可解释的翻译记忆** | 支持多个 TM 库、仅检索已挂载库、上下文 101%、精确/近似精确/高/中/低模糊等级，确认句段时自动写回。 |
 | **术语感知编辑** | 支持多个术语库、按源语言过滤、行内高亮、点击插入术语，以及按术语设置是否区分大小写。 |
 | **完整文档流程** | 文档标签页、关闭/重新打开、最近文档清理、重复导入复用、逐文档进度。 |
 | **真实格式覆盖** | TXT、Markdown、DOCX、EPUB、TMX、CSV、SRT/VTT、PO、XLIFF 1.2/2.0/SDLXLIFF、HTML、JSON、XLSX、PPTX、RTF。 |
-| **面向 Agent** | 七个工具共享当前文档和存储，Agent 可以与用户同时翻译。 |
+| **面向 Agent** | 二十一个工具共享当前文档和存储，Agent 可以与用户同时翻译。 |
 
 ## 快速开始
 
@@ -53,13 +53,42 @@ CAIT 为 DSH Web UI 和 DSH 桌面端增加一个 CAT 翻译工作台。它从
 
 ## 功能
 
+### 1.1.6 新增
+
+- **查找替换**：原文/译文预览、一次应用、撤销上次替换；已确认句段的译文被改动时自动回到待审状态。
+- **命令面板**（`Ctrl/Cmd+K`）与 `Ctrl/Cmd+F` 查找替换。
+- **句段备注**，以及句段内的**草稿撤销/重做**（`Ctrl/Cmd+Z`、`Ctrl/Cmd+Shift+Z`、`Ctrl/Cmd+Y`）。
+- **合并、拆分、锁定**文本句段；合并/拆分目前只开放 TXT 与 Markdown，Office 段落映射还不能安全回填。
+- **单次专名术语发现**：引号内术语、句中大写名、中文人名/地名/造物名即使只出现一次也会进入候选，并带类型、置信度和原句证据；不会自动入库。
+- **AI 审校**：QA 标签页可以请求当前 DSH 模型给出结构化建议，跳到对应句段或把建议填入译文；Agent 可调用 `cat_review`，两者都不会直接写文档。审校默认跟随翻译模型，也可以在设置里单独选择 provider 和模型。
+
+### 1.1.5 新增
+
+- 每份文档可以**继承全局 TM/术语库挂载，或绑定自己的库**，并指定默认写入 TM；检索、术语命中、QA、预翻译和确认都按该作用域执行。
+- **字数与匹配率分析**：统计句段、词数、字符、重复、ICE/精确/模糊/新增分桶、匹配率和 leverage，可下载 CSV 或 JSON。
+- 导出**双语审校 DOCX**（原文/译文/状态），给不使用 CAIT 的审校人。
+- 导出并回填 **XLIFF 1.2 审校包**：按 uid、XLIFF id 或唯一源文匹配，源文不一致的条目拒绝回填，并报告未匹配数量。
+- **TM 维护**：合并、去重、清理都先预览再确认。
+
+### 1.1.4 新增
+
+- 每份文档可以带一份**翻译 brief**：领域、读者、语气、备注、禁译词和风格样例；它会被注入 MT 请求，Agent 可用 `cat_get_brief` 读取。
+- 预翻译改为**一次最多八段**批量请求，带上 brief 和相邻原文；模型漏掉的句段逐段回退，不再整篇中断。
+- 术语条目可以标记 **forbidden**（禁用译法）和 **preferred**（必用译法），CSV/JSON/TBX 导出与 CSV 导入都会保留。
+- QA 按 **high / medium / low** 分级，新增禁用术语和长度漂移检查；QA 面板可跳转、复制原文、清空译文、插入必用术语，Concordance 可检索所有已挂载 TM。
+- 已确认句段可以**撤销确认**，保留译文和 TM 条目；编辑已确认句段会自动退回 `translated`，再次确认时更新同一条 TM。
+- 句段栏可以**批量清理未确认的预翻译译文**；清理前会显示句数以及 MT/TM/自动传播的构成，并说明已确认句段、人工草稿和已写入 TM 的内容不受影响。
+
 ### 翻译记忆
 
 - 支持多个 TM 库，每个库有 id、名称、挂载状态和默认写入库。
+- **上下文匹配（ICE）为 101%。** 每次确认都会记录前后两句源文；之后相邻句相同的
+  句段得 101%，等级为 `context`；文本相同但相邻句不同仍为 100%。每个 key 最多保留
+  8 条上下文变体，并且始终保留无上下文的那一条。
 - 支持精确、近似精确和三个模糊等级：
   - `near_exact` 使用忽略数字、标点和空白后的 key 比较，不依赖分数阈值。
   - `high_fuzzy` 为 `>= 0.85`，`medium_fuzzy` 为 `0.75–0.85`，
-    `low_fuzzy` 低于 `0.75`（高于可配置下限，默认 `0.55`）。
+    `low_fuzzy` 低于 `0.75`（高于可配置下限，默认 `0.70`）。
 - 模糊评分是词法级的：72% 字符二元组 Dice + 28% token Jaccard。
   拉丁文本按单词切分，CJK 文本按单字切分；不做词干、同义词或语义匹配。
 - 检索只查已挂载的库。`cat_submit_translation` 支持可选 `targetTmId`；
@@ -68,7 +97,8 @@ CAIT 为 DSH Web UI 和 DSH 桌面端增加一个 CAT 翻译工作台。它从
   `bootstrap().tm.count` 是已挂载数量，`bootstrap().tm.total` 是所有库的总数。
   完整数据请使用 `cat_lookup_tm` 或库面板。
 - 支持 TMX 1.4 `<tu>/<tuv>/<seg>` 导入/导出。TMX 内联占位符会扁平化为
-  纯文本，并给出明确警告。
+  纯文本，并给出明确警告。上下文以 `<prop type="x-context">` 往返，所以 CAIT
+  自己导出的文件再导入后仍保留 101% 匹配。
 
 ### 术语库
 
@@ -77,11 +107,57 @@ CAIT 为 DSH Web UI 和 DSH 桌面端增加一个 CAT 翻译工作台。它从
 - 支持 CSV/TSV 导入、术语备注、源语言过滤，以及工作台和
   `cat_lookup_glossary` 都遵循的 `caseSensitive` 标记。
 - 语言代码会规范化（`EN` → `en`，`ZH_cn` → `zh-CN`）。
+- 任何库（无论是否挂载）里的条目都能编辑或删除；挂载状态只决定工作台搜索
+  和写入哪些库。
+- **术语提取**：术语库工具栏的「从文档提取术语」会列出候选词，带出现次数、
+  记忆库里已有的译法和「已有」标记。统计负责找候选并排序（拉丁 n-gram；
+  中日韩重复子串用左右邻接熵过滤），模型只判断一份短名单——这正是模型擅长
+  的部分。
+
+### 库页面
+
+顶栏的「文档 / 库 / 对齐」在三个工作区之间切换，库页面不需要打开文档。
+
+- TM 一张表、术语一张表，支持分页（20/50/100/200，会记住）、语言筛选，以及
+  可限定在任意若干库内的搜索。
+- 右侧边栏直接编辑选中的条目、新增条目，并在有未保存改动时提示。
+- TM 导出 **TMX**；术语库导出 **TBX**、**CSV** 或 **JSON**。导入与清空仍在同一
+  个工具栏里。
+- 右侧面板的库按钮会把面板当前的搜索词一起带进库页面，在面板里查到的东西
+  可以接着在完整列表里看。
+
+### 对齐
+
+顶栏的「文档 / 库 / 对齐」第三个视图用两份成品文件建记忆库：源文一份、
+译文一份，可以是完全不同的语言，格式任选。
+
+- 跨语言打分：共享锚点（数字、`{0}` 占位符、URL、首字母大写的名字）、按语言
+  归一化的长度比例、段落结构。刻意不用字面相似度，因为它比不了两种语言。
+- 分块动态规划可以配对 1:1、1:0、0:1、2:1、1:2；每行分高置信 / 待确认 / 可疑
+  三档，只有高置信默认勾选。
+- 写入前每行都能与下一行合并、按换行拆开或删除；目标库在工具栏里选，完全
+  相同的条目会被跳过而不是重复写入。
 
 ### 工作台
 
 - 按段落/句子切分，并逐句编辑译文。
-- 支持保存草稿、确认并下一句、上一句/下一句导航和进度。
+- 句段三态：**待译** → **待审** → **已确认**，同时记录每句译文的来源
+  （`tm`、`mt`、`agent`、`manual`）。句段栏可按状态筛选，搜索覆盖原文、
+  译文和建议。
+- **句段分页**：句段栏按 20/50/100/200 的页大小分页，并有一个输入框可直接
+  跳到某个编号。如果目标句段被当前筛选隐藏，跳转时会先清空筛选。
+- **预翻译** 用 TM 精确命中加机器翻译把整篇铺底：按小块推进，显示
+  `已完成/总数`，可在块与块之间停止；已确认或已有译文的句段永远不会被覆盖。
+- **上下排列的审校区**：原文、机器/agent 基线、可编辑译文从上到下依次排列，
+  每一块都占满面板宽度。**全部确认** 在一次确认弹窗后接受所有待审句段。
+- 支持保存草稿、确认并下一句、上一句/下一句导航和进度。当前句段与草稿会
+  防抖落盘，重启后能回到原位。
+- **重复句段自动同步**：确认一句后，本文档里其它相同原文的未确认句段会填上
+  同一译文（来源 `auto`），编辑草稿也会同步；「铺满重复句段」可一次性处理整篇。
+  已确认的句段永远不动。
+- 句段栏里的 QA 提醒与导出前的汇总：占位符/标签缺失、数字不一致、
+  术语未使用、空译文、译文仍是原文、同一原文多种译法。只提醒，不阻挡导出，
+  也不写盘。
 - 文档标签页；关闭标签页不会删除文档。
 - **打开已有文档** 可重新打开已关闭的文档。
 - **设置 → 界面** 提供界面语言切换：跟随 DSH 语言（默认）、简体中文、English、
@@ -91,9 +167,11 @@ CAIT 为 DSH Web UI 和 DSH 桌面端增加一个 CAT 翻译工作台。它从
   不会影响 TM、术语库或其他文档。
 - 同格式、同内容的再次导入会复用已有文档，而不是新建重复文档。
   指纹覆盖语言、源文、格式和交换元数据。
-- 响应式密度：工作台测量自身 DSH 面板，并应用 1×–1.8× 的 `--cait-u`
-  缩放系数。1600×900 面板约为 1.32×，2560×1440 面板为 1.8×；
-  窗口较矮时保持 1×，不会继续缩小。
+- 响应式密度：工作台测量自身 DSH 面板，并应用经过衰减的 1×–1.45× `--cait-u`
+  缩放系数。1600×900 面板约为 1.17×，最大化的 4K 面板停在 1.45×：
+  大窗口贴近 DSH 自带界面，不再比宿主明显放大。
+- 工作台跟随 DSH 的亮/暗主题，包括原生控件（`color-scheme`），
+  下拉框、复选框和滚动条都与面板一致。
 
 ### 预处理
 
@@ -128,7 +206,7 @@ provider/model/code/status，客户端只会收到 `MT_PROVIDER_FAILED`。
 | CSV | ✅ | ✅ | 自动识别逗号、分号、制表符或竖线分隔；可通过表头名称或从 1 开始的列号指定源/目标列；现有双语导出 |
 | DOCX | ✅ | ✅ | 正文段落；导入时排除表格块。导出会修改原包，保留样式、编号、图片、页眉、表格和版式。 |
 | EPUB | ✅ | ✅ | 按 EPUB 3 spine 顺序读取 XHTML 文本块，内联标记保留为 token 并回写到保留的源包。不支持 DRM、固定版式和脚本化 EPUB。 |
-| TMX 1.4 | ✅ | ✅ | 常见 `<tu>/<tuv>/<seg>` 子集；内联标记扁平化并警告 |
+| TMX 1.4 | ✅ | ✅ | 常见 `<tu>/<tuv>/<seg>` 子集；内联标记扁平化并警告；上下文用 `<prop type="x-context">` 往返 |
 | SRT / WebVTT | ✅ | ✅ | 一个字幕 cue 对应一个句段；保留时间轴/设置/标识；保留语义标签；非法时间范围会拒绝 |
 | PO | ✅ | ✅ | 支持上下文、复数形式、译者注释和废弃 `#~` 条目 |
 | XLIFF 1.2 | ✅ | ✅ | 内联标签转换为 `{n}` token；缺少 token 时阻止确认 |
@@ -178,7 +256,7 @@ CAIT 以 DSH bundle 的形式安装；发布的 npm 包名为 `dsh-cait`，插
 plugin_manager install_bundle target: dsh-cait
 ```
 
-需要固定版本时写 `dsh-cait@1.0.5`，需要最新版时写 `dsh-cait@latest`。管理器会解析 registry
+需要固定版本时写 `dsh-cait@1.1.6`，需要最新版时写 `dsh-cait@latest`。管理器会解析 registry
 上的包、应用 bundle patch 并激活插件，不需要手工在配置档里加行。
 
 使用 CLI 管理的配置档：
@@ -255,7 +333,8 @@ TM 返回条数、MT 路由/模型/温度，以及界面语言（`uiLang`：`aut
 
 如果快照损坏或版本未知，CAIT 会记录警告，将其移动到
 `store.json.corrupt-<timestamp>`，然后以空状态启动，而不是让插件激活失败。
-版本 1 快照会迁移到版本 2，并创建默认 TM 和术语库。
+版本 1、2 快照会迁移到版本 3，并创建默认 TM 和术语库；版本 2 里「有译文但未
+确认」的草稿会变成 `translated`，来源记为 `manual`。
 
 ## Agent 工具
 
@@ -268,6 +347,20 @@ TM 返回条数、MT 路由/模型/温度，以及界面语言（`uiLang`：`aut
 | `cat_list_documents` | 列出文档和进度 |
 | `cat_switch_document` | 选择活动文档 |
 | `cat_suggest_mt` | 通过所选 DSH 路由调用 MT，或使用明确的离线回退 |
+| `cat_pre_translate` | 用 TM + MT 填一块，跳过已确认/已有译文的句段，返回 `next` |
+| `cat_get_segments` | 取一段有界句段窗口，含状态、来源和建议 |
+| `cat_confirm_segments` | 确认索引列表、一段窗口，或全部待审句段 |
+| `cat_propose_translation` | 只留下建议和理由，不动已确认的译文 |
+| `cat_align` | 对齐两段文本，报告高置信 / 待确认 / 可疑的配对 |
+| `cat_consistency_report` | 按原文分组列出译文不一致的句段 |
+| `cat_term_candidates` | 术语候选短名单：频次、例句、记忆库里已有的译法 |
+| `cat_add_terms` | 一次性把选中的术语写进术语库 |
+| `cat_review` | 请求模型给出结构化审校建议；不会直接写文档 |
+
+因此 Agent 可以完全不点界面就把整篇铺底：反复调用 `cat_pre_translate`
+（`from: next`）直到 `next` 为 `null`，用 `cat_get_segments` 查看，再用
+`cat_confirm_segments` 批量接受。做术语时读 `cat_term_candidates`，判断这份
+短名单，再用 `cat_add_terms` 写入。
 
 工作台和工具共用一个 `CatStore`，因此 Agent 可以翻译用户当前打开的同一份文档。
 
@@ -277,7 +370,7 @@ TM 返回条数、MT 路由/模型/温度，以及界面语言（`uiLang`：`aut
 flowchart LR
   UI["DSH Web UI<br/>(侧栏 + 工作台)"] --> Client["client.js<br/>生成的 Web bundle"]
   Client --> API["/cait/api/rpc<br/>同源 JSON"]
-  Tools["7 个 Agent 工具"] --> Store["CatStore"]
+  Tools["21 个 Agent 工具"] --> Store["CatStore"]
   API --> Store
   Store --> Snapshot[("store.json<br/>+ sources/")]
 ```
@@ -362,7 +455,7 @@ node _dev/test-mt.mjs
 
 导入/导出 fixture 为 `_dev/sample.docx`、`_dev/sample-table.docx` 和
 `_dev/sample-format.docx`；可用对应的 `python _dev/make-*.py` 脚本重新生成。
-15 套测试应全部通过。
+41 套测试应全部通过。
 
 ### 发布
 
@@ -411,18 +504,25 @@ GitHub release 发布。
 - XLSX 导入/导出是两列表格；不保留单元格样式、公式、合并单元格、图片和额外工作表。
 - HTML/RTF 导出不往返原始样式；JSON 只翻译字符串值。
 - TM 匹配是词法级的，不是语义级；没有词干、同义词或向量。
-- 库重命名/删除和逐标签页挂载状态尚未实现。
+- 每个上下文下，同一原文存一条译文：重复的句子会为每种相邻句组合保留一条变体，
+  每个 key 上限 8 条；相邻句不同时回落到无上下文的通用条目。
+- 上下文只取前后两句源文，不包含文档、客户或项目元数据。
+- TBX 与 JSON 术语导出是单向的；只有 TMX 和 CSV 能再导入回来。
 - 工作台界面提供中文、English、日本語三种语言，可在设置中切换；README 提供英文、简体中文和日文三个版本，以英文版为准。
 
-后续计划：通过多模态 DSH 路由支持图片/视觉输入、更完整的库管理、
-保留样式的 XLSX 输出，以及 XLIFF `<alt-trans>` / 注释支持。
+后续计划：通过多模态 DSH 路由支持图片/视觉输入、保留样式的 XLSX 输出，
+以及 XLIFF `<alt-trans>` / 注释支持。
 
 ## 变更日志与版本
 
 见 [CHANGELOG.md](CHANGELOG.md)。`v1.0.0` 是首个公开发布版本，`v1.0.1` 增加了
 日语界面和界面内语言切换，`v1.0.2` 让「跟随 DSH 语言」真正跟随 DSH 的语言设置，
 `v1.0.3` 把包发布到 npm，`v1.0.4` 起后续版本改由带 provenance 的发布流水线产出，
-`v1.0.5` 增加 EPUB、导入预处理和 PDF 政策；项目在开发阶段使用 `0.1.0`，
+`v1.0.5` 增加 EPUB、导入预处理和 PDF 政策，`v1.1.0` 增加 agent 驱动的预翻译、
+句段三态、上下排列的审校区和轻量 QA，`v1.1.1` 增加带 TMX/TBX/CSV/JSON 导出的
+库页面、句段分页，以及从右侧面板跳进库页面，`v1.1.2` 增加带 101%（ICE）
+匹配的上下文记忆，`v1.1.3` 增加双文件对齐、重复句段自动同步、术语提取，
+以及 agent 写建议用的原语；项目在开发阶段使用 `0.1.0`，
 发布到 GitHub 前统一改为 `1.0.0`。
 
 > **License：** Apache License 2.0，见 [LICENSE](LICENSE)。再分发时需保留