docs: mark apiserver auto-rejoin note as fixed (e505066) — task #12 done

This commit is contained in:
lei.chen 2026-08-14 08:05:20 +00:00
parent e505066162
commit 62778930e2

View file

@ -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 支持。