From f2eb46d217a2415c5fe56b576d5cf5bfafddfe39 Mon Sep 17 00:00:00 2001
From: MemRelay <memrelay@gmail.com>
Date: Wed, 30 Sep 2026 15:41:49 +0800
Subject: [PATCH] create: Checkpoint 2026-09-30 07:41:46 UTC [2531a81339]

MemRelay-Operation: checkpoint-save:chk-sdk-k00-k05-ready-20260930-1538
MemRelay-Resource: 38da5bd2-5733-473d-a413-107e03ae665a
---
 ...nt 2026-09-30 07-41-46 UTC [2531a81339].md | 50 +++++++++++++++++++
 1 file changed, 50 insertions(+)
 create mode 100644 projects/25464650-ed5d-440e-b362-190f2852d451/Checkpoint 2026-09-30 07-41-46 UTC [2531a81339].md

diff --git a/projects/25464650-ed5d-440e-b362-190f2852d451/Checkpoint 2026-09-30 07-41-46 UTC [2531a81339].md b/projects/25464650-ed5d-440e-b362-190f2852d451/Checkpoint 2026-09-30 07-41-46 UTC [2531a81339].md
new file mode 100644
index 0000000..2d3ba83
--- /dev/null
+++ b/projects/25464650-ed5d-440e-b362-190f2852d451/Checkpoint 2026-09-30 07-41-46 UTC [2531a81339].md	
@@ -0,0 +1,50 @@
+---
+title: Checkpoint 2026-09-30 07:41:46 UTC [2531a81339]
+type: checkpoint
+permalink: main/projects/25464650-ed5d-440e-b362-190f2852d451/checkpoint-2026-09-30-07-41-46-utc-2531a81339
+stable_id: 38da5bd2-5733-473d-a413-107e03ae665a
+scope: project
+memory_type: checkpoint
+project_id: 25464650-ed5d-440e-b362-190f2852d451
+usage_profile_id: 0c9feb46-d06e-43cd-9ef0-c5813c84a998
+status: active
+revision: 1
+request_id: chk-sdk-k00-k05-ready-20260930-1538
+created_at: '2026-09-30T07:41:46.734141+00:00'
+updated_at: '2026-09-30T07:41:46.734141+00:00'
+tags:
+- ready-to-merge
+---
+
+完成：SDK 线 K-00–K-05 全部实现并推送分支 `feat/fix-sdk-k00-k05`，HEAD `569bcd4` 已与 `origin/feat/fix-sdk-k00-k05` 一致。未 merge `main`。
+
+原因：复审 issue #57–#62 要求按 K-00 统一约定修复四语言 SDK 断线重交/退避/锚误语义，并增加 `task sdk:check`。
+
+关键实现：工作树 `E:\code\NixMsg-wt\r2-k`，基线 `origin/main` `4059a15`。六个 commit：
+- K-00 `0764b76` docs: 写入 K-00 SDK 行为约定附录
+- K-01 `1aa3a6f` fix: 按 K-00 约定修复 Go SDK 断线重交与退避
+- K-02 `6c20d63` fix: 按 K-00 约定修复 JS SDK 断线重交与退避
+- K-03 `24a64cc` fix: 按 K-00 约定修复 Python SDK 断线重交与退避
+- K-04 `cc47ca4` fix: 按 K-00 约定修复 Java SDK 断线重交与退避
+- K-05 `569bcd4` chore: 增加 sdk:check 并对齐 Go SDK 版本
+
+验证：
+- Go/JS/Python/Java SDK 单测已过（Python 本机若无 paho-mqtt 则 skip）
+- Java `mvn -q test` 通过
+- `task sdk:check` exit 0（Python skip 无 paho-mqtt；Java mvn 静默通过）
+- 已 `git push -u origin feat/fix-sdk-k00-k05` 成功；PR 链接 https://git.asio.asia/nixevol/NixMsg/pulls/new/feat/fix-sdk-k00-k05
+- 未 merge main
+
+问题与解决：
+- 首次 push 被 Windows `credential-helper-selector` 交互挂起；改用临时 credential helper + `空 credential.helper` 跳过 GCM 后推送成功。Gitea 密码库存在两条同名 `git.asio.asia` 重复项（`7ca9fa6b-...` 与 `9a97e594-...`），`secret_resolve` 会 SECRET_AMBIGUOUS，以后用 `secret_item_get` 取一条即可。
+- Taskfile 内联 PowerShell `function` 会被 Task DSL 解析；K-05 改为 `taskfiles/sdk-check.ps1` / `.sh`。
+- Java 首次连接超时后第二次 connect 卡在 CONNECTING：`runLoop` 改 `waitWake`，超时设 `stopReconnect`。
+
+下一步：等总控审阅并 merge；本线不 merge main。
+
+给下个会话：
+- 分支已推送，不要再改 K-00–K-05 除非复审意见。
+- 不 merge main。
+- 推送请跳过 Windows credential-helper-selector（交互挂起）；两条 git.asio.asia 密码库项重复。
+- 不要 publish npm/PyPI/Maven。
+- 工作树 `E:\code\NixMsg-wt\r2-k`。