---
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`。