docs: 记录 #152/#153 connector 验收

2026-08-31 15:20:22 +08:00
parent b25498f58c
commit c090344815
1 changed files with 13 additions and 0 deletions
@@ -266,3 +266,16 @@
 - 轮换先登记新 `kid`，最多并存 24 小时，切换后移除旧 key；禁用 principal 或吊销 `kid` 对每次请求即时生效。
 - 回退只能关闭 connector 并恢复三端独立运行，不得降级为明文、共享管理员身份、共享 JWT 或跳过签名/TLS 验证。
 <!-- machine-identity-v1:end -->
+
+<!-- integration-connectors-v1:start -->
+## Connector 持久性与故障隔离规则
+
+- **配置事实与运行投影分离**：Sense 的期望 revision 不等于 Brain 已应用 revision；只以 Brain runtime-status 的实际值更新只读投影。
+- **最后有效配置**：Brain 对过期、未知版本、摘要错误或不安全配置拒绝应用，并保留 last-known-good；不得用失败输入覆盖当前配置。
+- **机器重放与业务幂等分离**：每次网络重试必须使用新 jti；事件仍沿用原 `producer_id/source_event_id` 与规范载荷。
+- **Sense 同事务网关**：Brain 事件只有在 Sense 的 InboundEvent、EvidenceRecord 与 Bell Outbox 同一事务成功后才算被 Sense 接受。
+- **Bell 永久收据**：同键同摘要只形成一个 Receipt/Event；同键异摘要是终止冲突并追加脱敏审计，不能覆盖或删除原事实。
+- **证据降级独立**：pending、failed、timeout、expired 不改变 Event 不可变性，也不自动 ack/close Alert。
+- **停用规则**：关闭 connector 只停止新接入或投递；不得清空未投递 Outbox、持久 replay、Receipt、Event、证据元数据或审计。
+- **独立运行**：Sense、Brain、Bell 不因对端未安装、离线或 connector 关闭而停止各自核心能力；不得以共享数据库/JWT/Cookie 规避故障隔离。
+<!-- integration-connectors-v1:end -->