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

sdk/java/README.md

@@ -45,6 +45,18 @@ c.close();
 
 命令行示例类：`asia.asio.nixmsg.examples.MinimalExample`。
 
+## 行为约定
+
+四种 SDK 同一套对外语义，详见仓库 `docs/DEVELOPMENT.md` 第 9 节附录「SDK 行为约定」。要点：
+
+- 首次连接默认 30 秒内未握手则停止重连，以 `not_connected` 失败；Client 可再次 `connect`。
+- 顶号原因一律 `taken_over`；DISCONNECT `0x8B` 可重试；CONNECT 不带 Receive Maximum；心跳默认 30 秒。
+- 重连退避只维护一个计数 n：第 n 次等待 `min(1s×2^(n-1), 30s)×随机(0.7,1.3)`。仅 `connect` 后第一次可不等待；断线后首次重连也约 1 秒；在线不足 60 秒断开则 n+1，稳定 60 秒后断开 n=1。
+- `rate_limited` 与断线重交：每次重新生成 `rid` 并重新序列化；消息 `id`、正文、`send_at_ms` 不变。
+- `logout` 请求失败时 future 以异常完成；本地仍停止重连、清空令牌、结束队列并发 `offline`。
+- 时长与时间戳用 `long` / `Long`（含 `updateSelf` 的 `defaultDelayMs`）。`sendAt` 是本机时间（epoch 毫秒或 `java.util.Date`，入队时加偏差）；`sendAtMs` 是服务器时间。两者与 `delayMs` 同时给时本地 `bad_request`。停止重连后再 `send` 立即失败。
+- 取消尚未发出的条目即出队；已发出的返回 `result_unknown`，应用应以同一消息号重试。
+
 ## 打包（不发布）
 
 ```bash