legal-document-restoration

name	legal-document-restoration
description	法律文件脱敏稿还原——将外审后的脱敏稿 docx 按比对文件 .md 中的映射表 runs 级还原为原文，保留批注/修订/格式。 适用情形：用户要求还原脱敏稿/还原审核稿/runs 级还原/收到脱敏稿后还原成原文/外审回来后还原入库。 核心：解析比对文件 mapping 段 → runs 级精确替换（不跨 run 边界）→ 每替换一处重建 runInfo → round-trip 校验。 与 legal-document-redaction 互为反向操作——一个写出去，一个读回来。
argument-hint	[脱敏稿 docx + 比对文件 .md] → 输出还原稿 docx + 还原日志 + round-trip 校验
legal_frame	cn-mainland
last_reviewed	"2026-06-24T00:00:00.000Z"
version	1.0.0
risk_level	high
trigger_phrases	["还原脱敏稿","还原审核稿","还原","比对还原","runs 级还原","restore redaction","restore","reverse redaction","unredact"]

/legal-document-restoration — 法律文件脱敏稿还原

场景通用原子 skill。本 skill 与 legal-document-redaction 互为反向操作。 输入：脱敏稿（docx）+ 比对文件（.md）+ 比对文件 hash（可选） 输出：还原稿（docx）+ 还原日志 + round-trip 校验报告

一、加载上下文（必读）

调用本 skill 前必须确认：

1. 脱敏稿路径（必填）
2. 比对文件路径（必填）—— 必须包含 mapping 段
3. 输出格式（docx 默认 / md / txt）
4. 是否保留批注 / 修订痕迹（默认保留）
5. round-trip 校验是否启用（默认启用）
6. 适用法域（cn-mainland 默认 / hk / tw / sg / mo / eu）

未指定 → 暂停，要求补充（按 GCL 原子 skill 规范）。

---

二、还原输入解析

2.1 解析脱敏稿结构

读取脱敏稿 docx → 解析为：
  ├─ 段落树（paragraphs）
  ├─ 每个段落含 N 个 run（runs）
  ├─ 每个 run 含文本（text）+ 格式属性（font, size, color）
  └─ 批注 / 修订 / 表格 / 图片 保留

2.2 解析比对文件

读取比对文件 .md → 提取：
  ├─ ## 批次元数据（批次 UUID / 法域 / 生成时间）
  ├─ ## 映射表（占位符 | 原文 | 实体类型 | 上下文角色）
  └─ 可选 ## 文件 hash（SHA256）—— 用于校验完整性

2.3 完整性校验

若有 hash：
  - 计算脱敏稿当前 hash → 与比对文件声明的 hash 对比
  - 不一致 → 拒绝还原（标 [ERROR] 比对文件与脱敏稿不匹配）
若无 hash：
  - 提示用户确认脱敏稿未被篡改

---

三、runs 级精确替换（核心）

3.1 替换原则

• 不跨 run 边界：每个占位符必须完整位于一个 run 内，若跨 run 则失败（标 [WARN]）
• 按出现顺序处理：从文档头到尾逐个 run 处理，避免重复匹配
• 每替换一处重建 runInfo：替换后立即重建 run 的格式属性（font / size / color / bold 等），避免格式错位
• 大小写敏感：占位符大小写必须与比对文件 mapping 完全一致

3.2 替换流程

步骤 1：扫描所有 run，构建占位符 → run 位置索引
步骤 2：按位置顺序遍历索引
步骤 3：每个占位符执行：
        a. 检查是否完整在单 run 内（否则 [WARN] 跳过）
        b. 用 mapping 中的原文替换占位符
        c. 重建该 run 的格式属性
        d. 记录替换日志（位置 / 占位符 / 原文 / 上下文）
步骤 4：保存还原稿 docx

3.3 失败处理

失败类型	处理
占位符跨 run	标 [WARN] 跳过该占位符，记录位置
占位符在 mapping 中找不到	标 [WARN] 跳过，记录脱敏稿位置
原文在脱敏稿中已存在	标 [WARN] 可能重复占位符，跳过
run 格式属性丢失	重建 runInfo，使用前一个 run 的格式兜底

---

四、格式保留

4.1 必须保留

• ✅ 字体 / 字号 / 颜色 / 加粗 / 斜体 / 下划线
• ✅ 段落结构 / 缩进 / 对齐
• ✅ 表格结构 / 单元格合并 / 边框
• ✅ 列表（有序 / 无序 / 多级）
• ✅ 修订痕迹（w:ins / w:del）
• ✅ 批注（w:commentReference）
• ✅ 页眉页脚 / 页码

4.2 不应变更

• ❌ 不修改脱敏稿之外的元数据（作者 / 创建时间）
• ❌ 不删除批注 / 修订（即使与脱敏内容无关）
• ❌ 不重新计算页码 / 目录

---

五、round-trip 校验

核心安全机制：还原后的文件再次脱敏，应得到与原脱敏稿一致的输出。

5.1 校验流程

还原稿 → 调用 legal-document-redaction（相同参数）→ 输出新脱敏稿
对比：新脱敏稿 与 原脱敏稿
  ├─ 一致 → round-trip 通过 ✅
  └─ 不一致 → round-trip 失败 [ERROR]

5.2 失败场景

失败原因	排查方向
占位符未完全还原	检查 runs 跨边界情况
还原时引入新占位符	检查原文是否含触发脱敏的字符
格式破坏导致识别失败	检查 runInfo 重建逻辑
比对文件与脱敏稿不匹配	检查 hash 校验

5.3 强制约束

• ❌ round-trip 校验失败时禁止输出还原稿——输出"[ERROR] 还原失败，请人工核对"
• ❌ 不可跳过 round-trip 直接交付还原稿

---

六、输出格式

## [A] 还原元数据
- 原脱敏稿：<文件名>
- 比对文件：<文件名>
- 还原计数：N 处
- round-trip 校验：<通过/失败>
- hash 校验：<通过/失败/未提供>

## [B] 还原后文本
[完整原文，保留原格式]

## [C] 还原日志
- [WARN] 占位符未匹配（位置 / 占位符）
- [WARN] 跨 run 边界（位置 / 占位符）
- [ERROR] hash 不一致 / round-trip 失败
- [SKIP] 批注 / 修订未处理（附说明）

---

七、与场景的协作

本 skill 是 legal-document-redaction 的反向操作，调用方相同但顺序相反：

上游场景	触发时机	用途
contract-review	外审合同稿收回后	还原入库 + 内部留底
litigation-support	外审案例分享稿收回后	还原入内部案例库
data-compliance	PIPL 审查外发样本收回后	还原留底
cocounsel-legal	外部律师协办稿收回后	还原到内部系统
employment-legal	监管外发文书收回后	还原留底
government-investigation	外审调查材料收回后	还原归档
law-student / legal-clinic	外部批改收回后	还原到教学档案

配套 references / 相邻 skill：

• legal-document-redaction/ — 反向操作（脱敏）
• legal-document-redaction/references/config.md — 白/黑/自定义类型（脱敏时的配置）
• shared/matter-workspace/ — 案件工作区（实际路径 plugins/legal-scenes/<本场景>/matters/<slug>/）

---

八、禁用与边界

• ❌ 不可逆模式不可还原——映射表已销毁，物理上无法还原
• ❌ 比对文件被篡改 → 拒绝还原——hash 校验失败的脱敏稿不予还原
• ❌ 跨案映射表不可复用——每个案号独立比对文件
• ❌ 禁止还原刑事证据原件——破坏证据完整性，需走原件流程
• ❌ 禁止跳过 round-trip 校验——失败即拒绝输出
• ❌ 禁止跨 run 边界强行替换——可能导致 run 错位，宁可标 [WARN] 跳过

---

九、版本与变更

版本	日期	变更
1.0.0	2026-06-24	初版：runs 级精确替换 + 格式保留 + round-trip 校验

★ Insight ─────────────────────────────────────

• runs 级替换是 docx 还原的核心难点：docx 不是纯文本，每个字符在 run 里。直接正则全文替换会破坏 run 边界与格式属性。必须按 run 粒度逐个处理，每替换一处重建 runInfo——这是参考通用开源工具还原逻辑的核心工程要求。
• round-trip 是安全网：还原后再次脱敏应得到原脱敏稿。看似多余但实际是检测"还原完整性 + 还原过程不引入新触发字符"的关键校验。失败即拒绝输出，宁可人工核对也不冒险。
• 本 skill 与脱敏 skill 互为镜像：trigger_phrases、§ 七协作链路、§ 八禁用边界都成对设计。修改任一边时记得同步另一边，避免一致性漂移。 ─────────────────────────────────────────────────