@agentunion/fastaun-browser 0.5.19 → 0.5.21

package/_packed_docs/protocol/08-AUN-E2EE.md

@@ -1,12 +1,12 @@
-# AUN-E2EE 历史扩展规范（Legacy）
-
-> 版本：2.0-draft
-> 状态：历史兼容文档
-> 适用范围：AUN 客户端 SDK、客户端应用、跨语言实现
-> 不适用范围：Gateway、Message 模块的加解密实现
-> 定位：旧 P2P E2EE 信封说明；当前默认主路径已迁移到 E2EE V2 多设备 wrap
-
-> **当前实现说明**：最近版本的 SDK 默认使用 V2 多设备 wrap。P2P 加密消息通过 `message.send` 承载 `e2ee.p2p_encrypted` envelope，Group 加密消息通过 `group.v2.send` 承载 `e2ee.group_encrypted` envelope；每条消息一把 `master_key`，按 recipient 设备生成 `3DH` / `1DH` wrap，接收端验证 `sender_signature`、AAD、recipient digest/proof 后解密。当前 V2 链路见 [E2EE_V2消息通信时序图](../sdk/E2EE_V2消息通信时序图.md)；群组 V2 规范见 [08-AUN-E2EE-Group](08-AUN-E2EE-Group.md)。本文保留 `prekey_ecdh_v2` / `long_term_key` 旧格式，用于历史兼容和迁移排查，不应作为新实现的默认发送格式。
+# AUN-E2EE 历史扩展规范（Legacy）
+
+> 版本：2.0-draft
+> 状态：历史兼容文档
+> 适用范围：AUN 客户端 SDK、客户端应用、跨语言实现
+> 不适用范围：Gateway、Message 模块的加解密实现
+> 定位：旧 P2P E2EE 信封说明；当前默认主路径已迁移到 E2EE V2 多设备 wrap
+
+> **当前实现说明**：最近版本的 SDK 默认使用 V2 多设备 wrap。P2P 加密消息通过 `message.send` 承载 `e2ee.p2p_encrypted` envelope，Group 加密消息通过 `group.v2.send` 承载 `e2ee.group_encrypted` envelope；每条消息一把 `master_key`，按 recipient 设备生成 `3DH` / `1DH` wrap，接收端验证 `sender_signature`、AAD、recipient digest/proof 后解密。当前 V2 链路见 [E2EE_V2消息通信时序图](../sdk/E2EE_V2消息通信时序图.md)；群组 V2 规范见 [08-AUN-E2EE-Group](08-AUN-E2EE-Group.md)。本文保留 `prekey_ecdh_v2` / `long_term_key` 旧格式，用于历史兼容和迁移排查，不应作为新实现的默认发送格式。
 
 ---
 
@@ -95,6 +95,11 @@ AUN-E2EE 是 Layer 3 扩展协议，建立在以下核心能力之上：
 - `message_id`
 - `timestamp`
 - `type`
+- `need_render`（可选布尔值，默认 `true`，P2P 与 Group 一致）
+
+`need_render` 是服务端可见的展示/统计提示，由 SDK 从 `message.send` / `group.send` 参数提取到外层信封；历史缺字段或 NULL 按 `true`。它不参与 E2EE AAD、`protected_headers`、消息保护签名或元数据 HMAC，不能当作接收端已验证的业务授权条件。RPC `client_signature` 仍按现有完整业务参数规则覆盖该字段，不为它增加 canonical 排除项。
+
+按 sender 隔离的 Pull/ACK 只改变消费游标，不重写历史密文或 AAD，不引入 `peer_seq`。`prev_peer_seq` 和 peer 扫描覆盖字段均是服务端投递元数据，规则见 [服务协议 §6.3](06-服务协议.md#63-点对点消息-message)。单 peer ACK、slot 级 `legacy_safe_ack_seq` 都不是设备级密钥销毁证明；当前单实例实现可省略 `device_safe_ack_seq`，客户端须保守保留仍可能用于历史解密的旧 SPK。
 
 ### 4.2 密文载荷
 
@@ -110,7 +115,7 @@ AUN-E2EE 是 Layer 3 扩展协议，建立在以下核心能力之上：
 
 ### 5.2 密文消息
 
-旧 `e2ee.encrypted` 信封通过 `message.send` 传输时，`encrypted` 必须为 `true`，`payload.type` 必须为 `e2ee.encrypted`。当前新实现应使用 V2 `e2ee.p2p_encrypted` 信封。
+旧 `e2ee.encrypted` 信封通过 `message.send` 传输时，`encrypted` 必须为 `true`，`payload.type` 必须为 `e2ee.encrypted`。当前新实现应使用 V2 `e2ee.p2p_encrypted` 信封。
 
 ---
 
@@ -188,7 +193,7 @@ AUN-E2EE 支持两种加密模式，SDK 自动按优先级选择。
 
 ### 7.3 模式选择策略
 
-旧版 SDK 在 legacy 信封中按以下优先级自动选择：
+旧版 SDK 在 legacy 信封中按以下优先级自动选择：
 
 1. **优先**：prekey_ecdh_v2（服务端有接收方 prekey）
 2. **降级**：long_term_key（无 prekey 时，需客户端安全策略允许）
@@ -197,7 +202,7 @@ AUN-E2EE 支持两种加密模式，SDK 自动按优先级选择。
 
 ### 7.4 兼容性
 
-- 旧版发送端应优先使用 `prekey_ecdh_v2` 模式发送；当前新实现应使用 V2 多设备 wrap。
+- 旧版发送端应优先使用 `prekey_ecdh_v2` 模式发送；当前新实现应使用 V2 多设备 wrap。
 
 ---