From 62778930e201d10bca74d06d81c1f674f8398805 Mon Sep 17 00:00:00 2001 From: "lei.chen" Date: Fri, 14 Aug 2026 08:05:20 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20mark=20apiserver=20auto-rejoin=20note?= =?UTF-8?q?=20as=20fixed=20(e505066)=20=E2=80=94=20task=20#12=20done?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/left_scheduler_work.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/left_scheduler_work.md b/docs/left_scheduler_work.md index d02143aa..dc5b2f30 100644 --- a/docs/left_scheduler_work.md +++ b/docs/left_scheduler_work.md @@ -177,7 +177,7 @@ spec 声称 36/36 任务完成，但 re-audit（research.md）发现缺陷。来 - **人类可读 jobid（2026-08-13）**：apiserver 响应加 `job_id_human`/`human_id`（`cluster-apiserver-时间戳-序号`，如 `1-0-1786585485-0`），复用 `backend.FormatJobID`——MCP 原来只返回裸 64 位数字（`73930964699447296`），xce_test/xcecli 只认连字符格式，导致跨工具无法引用。架构原则：**apiserver 负责数据正确性，mcp-server 只读取透传**。 - **Claude Code 集成**：`.mcp.json` 注册 `xce-scheduler` server，key 用 `${XCE_API_KEY}` 环境变量（不硬编码提交）；apiserver 重启后 key 失效需重新生成。 -**注意**：apiserver 在 controller 重启后**不会自动重新 join**（只重连 TCP，DataStore 保持陈旧为空）——controller 重启后需手动重启 apiserver 才会重新收到作业推送。这与 scheduler/worker 的重连缺口同类，属 component-failover-adoption 待办。 +**注意**：apiserver 在 controller 重启后的自动恢复**已修复（2026-08-14，e505066）**——`needsRejoinAfterHeartbeat` 让熔断在 `IsDegraded()` 时恢复，lib `xcecli_force_reconnect` + apiserver 2s `recoveryLoop` 强制重连+rejoin（见第四节）。controller 完整死亡+重启后无需手动重启 apiserver。 代码：`src/frontend/mcp-server/`（14 工具）、`src/frontend/schedulerclient/`（~50 测试）、apiserver API Key + RBAC + SSE 支持。