docs: 写入 K-00 SDK 行为约定附录

This commit is contained in:
Nixevol
2026-09-30 16:24:13 +08:00
parent 8f47167128
commit 3749b9bdf1
6 changed files with 90 additions and 2 deletions
+9
View File
@@ -1153,6 +1153,15 @@
- 备选:ack 发后不等 `resp`;未采用,以免丢「ack 结果当 revoked」语义。
- 影响:行为更接近文档;单测仍绿。
### 复审修复 K-00
- 日期:2026-09-30
- 原条款:PRD F19「四种 SDK 行为一致」;DEVELOPMENT 第 9 节重连退避原文过简;issue #57 及第二轮审查修订。
- 实际做法:在 DEVELOPMENT 第 9 节增加附录「SDK 行为约定」,四套 README 各加摘要。重连退避按 `min(1s×2^(n-1), 30s)×随机(0.7,1.3)`、只维护一个计数 n;不以现有 JS 实现为参照。rate_limited 与断线重交每次新 rid;logout 失败返回应用;时长用 64 位整数;CONNECT 不带 Receive Maximum;0x8B 可重试;顶号原因 `taken_over`。
- 原因:四套对外语义不一致;第二轮审查核实 JS 退避双重翻倍,照搬会把错误带进四套。
- 备选方案:统一采用旧 S1.3 状态机;否决。
- 影响:K-01 至 K-04 按本附录实现;本条只改文档。
## SDK 二 S2
### S2-PY/JAVA 1–3 2026-09-30