白匣子（Rein Whitebox）

> 多 Agent 协作的治理交接内核——平时隐形工作，出事/复盘/换人时作用明显。

解决什么问题

AI Agent 从"单机单会话"走向"多 Agent 协作"时，最缺的不是更强的模型，而是：

• 谁说了什么——跨 Agent、跨会话的对话承接与留痕
• 谁有权做什么——治理语义（授权边界、越界留痕、失联发现）
• 怎么交接——新 Agent / 新会话无缝接棒的交接仪式与证据链

为什么是"白"匣子

黑匣子是出事以后才打开；白匣子从第一天就在工作——记录、承接、交接、留痕全程在场。用户感知不到它存在，但它的作用一直都在：新对话记得旧对话。

核心能力（v0.2.0 已实现）

1. 交接包协议（Handoff Package Protocol）

• 结构化交接包：handoff_id / from / context(摘要+决策+卡点+待办) / evidence / signature
• sha256 签名：覆盖除 signature 块外全部字段，任何篡改立即校验失败
• 大小上限：全包 10KB + context 段 3KB（注入量是上下文爆炸源头，分层设限）
• 过期策略：默认 7 天，project 级可配（战略 30 天/日常 3 天）——过期不注入但存档保留（"自动遗忘"≠删数据）

2. G6 收口钩子

会话收口时自动写交接包（不阻塞主流程，失败降级最小包——铁律：必须写，绝不跳过）

3. G0 开工钩子

新会话启动时按 project 读 top-5 交接包，只注入 context 段（结构化摘要，不拉原文），无缝接棒

4. 用户看板

侧栏图标 → 交接记录面板：时间倒序列表 + 搜索 + Agent/项目筛选 + 卡点红色标记 + 点击详情——客户唯一的保命手段（没有记忆库/知识库兜底的客户，白匣子对话库就是他们的追责依据）

5. 证据链联动

evidence 引用指向 Rein Evidence 哈希链（路径+hash，不复制原文），关键交接可验证

快速开始

# 生成交接包（G6 收口）
python g6_hook.py --project demo --agent my-agent --session sess_001 \
  --summary "完成xxx" --decisions "决策1" --next "待办1"

# 读取交接包（G0 开工，注入格式）
python g0_hook.py --project demo --top 5

状态

• v0.1.0：概念占位（2026-08-21）
• v0.2.0：MVP 实现——交接包协议 + G6/G0 钩子 + 用户看板 + 验证 18/18 全过（2026-08-21）
• 二期：形态 A（DSH 插件完整化）、跨平台适配器、L0-L3 承接检索分层

与同类项目的差异

> 检索范围：2026-08 GitHub 实测（agent black box / flight recorder / memory vault 赛道）
> 口径：未见同组合（治理语义 + 交接仪式 + 证据链 + 生态整合），不宣称首创。