docs: define idempotent Client registration contract (#12)

2026-08-06 17:21:36 +08:00
parent 62d46bf10a
commit 02073eab37
8 changed files with 306 additions and 206 deletions
@@ -241,5 +241,5 @@ CMAutoBuy/                    整个文件夹拷到任何机器都能用
 **已定案（不再是待确认项）：**

 - Admin 只分配任务给指定 Client，Client 不读全局任务池。见 [04](04-admin-api-contract.md) §5.1。
- **没有租约、没有心跳、没有状态回查。** Client 只有领取、提交结果、提交失败三个调用。见 [04](04-admin-api-contract.md) §1.1。
+- **没有租约、没有心跳、没有状态回查。** 任务流程只有领取、提交结果、提交失败三个调用；设置页另有无任务副作用的幂等 Client 登记调用。见 [04](04-admin-api-contract.md) §1、§4.1。
 - 本地只存已领取任务，已完成任务**永久保留**。诊断产物（截图、XML、日志）仍按 `diagnostics.retention_days` 清理，两者不是一回事。见 [03](03-data-model.md) §3.1。