rehydrate

confide:rehydrate — 将真实值还原到占位符分析中

这是 CONFIDE 往返流程的最后一步：

1. 使用 confide:anon 在本地进行脱敏（默认可逆模式）→ 得到一份 GREEN 副本，其中包含唯一的保留哨兵占位符（[CONFIDE_PERSON_0001]、 [CONFIDE_EMAIL_0001]、[CONFIDE_DATE_0002]……），以及一份保密的 <name>.map.json （结构化数据：green_sha256、entries[]……），并将其留在本机。
2. 在任意位置分析 GREEN 文本，包括使用云端 LLM。返回的分析中会包含相同的占位符 （有时会被改写为 CONFIDE_PERSON_0001、[CONFIDE PERSON 0001]……但始终保留完整的 CONFIDE_TYPE_NNNN 核心）。
3. 在这里还原：使用你自己的映射文件，将每个占位符替换为其原始值，生成真实分析——云端始终不会看到原始值。

隐私原则（不得违反）

• 仅在本地操作，使用用户自己的映射文件。 映射文件绝不会离开本机。本技能不会获取或传输任何内容。
• 标准输出中仅显示计数。 摘要报告 restored N, unmatched M。还原后的文本（其中包含原始值）会写入本地文件；除计数外，绝不会回显到标准输出。
• 未匹配 = 可能是幻觉。 映射文件中不存在的占位符会报告为 unmatched，并保留原样——绝不为其编造值。提醒用户，这些占位符可能是 LLM 产生的幻觉。
• <name>.restored.md 输出文件包含原始值：仅限本地使用，请勿分享或提交。

运行

python3 skills/rehydrate/scripts/rehydrate.py ANALYSIS_FILE [--map <name>.map.json]

• ANALYSIS_FILE — 包含占位符的文本／分析。
• --map <name>.map.json — 来自 confide:anon 的保密映射文件。如果省略，则自动查找同目录下的 *.map.json（例如，与 session.map.json 同目录的分析文件，或从 session.green.md 派生的文件）。
• --out PATH — 输出路径（默认值：输入文件同目录下的 <name>.restored.md）。
• --verify-green <green_file> — 检查映射文件的 green_sha256 是否与该 GREEN 文件匹配；如果不匹配（此文档使用了错误的映射文件），会发出醒目警告。

可稳健处理仍保留完整 CONFIDE_TYPE_NNNN 核心的 LLM 改写结果： [CONFIDE_PERSON_0001]、[CONFIDE PERSON 0001]、CONFIDE_PERSON_0001 和 confide_person_0001 都会还原为同一映射条目。不含 CONFIDE 前缀的普通文本 （例如“Person 1”“patient 1”“section 2”）绝不会被处理，并且 0001 绝不会误匹配 0010。还原操作具有幂等性（对已还原的文本再次运行不会产生变化）。同时接受结构化映射文件架构和旧版扁平映射文件。

运行后

1. 报告还原摘要（restored N, unmatched M）——绝不粘贴 PII。
2. 如果 unmatched > 0，指出这些占位符可能是映射文件中不存在的幻觉。
3. 提醒用户 *.restored.md 仅限本地使用（其中现在包含原始值）。