From 0e9609af6d5c4a2ea9806d50cf474c40f1fb7bf8 Mon Sep 17 00:00:00 2001 From: "lei.chen" Date: Fri, 14 Aug 2026 09:43:44 +0000 Subject: [PATCH] docs: record PEND reason P0+P1 implementation status (4e2ac86) --- docs/left_scheduler_work.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/left_scheduler_work.md b/docs/left_scheduler_work.md index dc5b2f3..14b6e2e 100644 --- a/docs/left_scheduler_work.md +++ b/docs/left_scheduler_work.md @@ -200,7 +200,11 @@ spec 声称 36/36 任务完成，但 re-audit（research.md）发现缺陷。来 ### 4. 推迟 / 未决 - `scheduler_modify` 工具推迟——apiserver 当前无 modify 端点（control 仅 kill/stop/resume/checkpoint），需新增后端端点 - 3 个未决决策：LLM 模型选型（Claude API/自建/混合）、多集群 URM 来源识别、air-gapped LLM 访问 -- **PEND reason 分类体系（未完成，2026-08-13 调查+设计稿已出）**：见 `docs/pend-reason-investigation-design.md`。数据链路已通（bug-1513，ac6131d），但**喂进去的 reason 只有 2 种**——已实现阻挡点 8 处里仅 3 处产生 reason，limit 插件/队列/时间窗/fairshare 等 8 类 LSF 必有原因全部静默或桩。**待统一决策**：(a) code 策略——复用 3 code + 明细子码 vs 扩展 PREASON_* 到 ~20 个；(b) 接线优先级——建议 P0=修 main_reason + limit 插件 attach reason，P1=队列状态/时间窗/worker 过滤，P2=依赖/license/保留/exclusive/fairshare；(c) 是否补 LSF 风格的 `bjobs -p` 等价能力到 MCP 工具。 +- **PEND reason 分类体系（进行中，2026-08-14 已实施 P0+P1 部分）**：见 `docs/pend-reason-investigation-design.md`。**已完成（commit 4e2ac86）**： + - **code 策略已定**：扩展 PREASON_* 枚举到 9 个（BAD_RESREQ/NO_RESOURCE/MATCH_FAIL/LIMIT_GLOBAL/LIMIT_HOST/QUEUE_CLOSED/QUEUE_DRAINING/TIME_WINDOW/HOST_UNAVAIL），capnp UInt32 无限制。 + - **P0**：main_reason 修复（首个 detail code 设为主因，集群验证 PEND 作业 main_reason 非 0 + reason_name）+ limit 插件 attach（host 限额→LIMIT_HOST+limit 名，全局限额→LIMIT_GLOBAL+limit 名）。**集群验证**：PEND 作业 API 显示 `main_reason:3 main_reason_name:"match_fail"` + 每条 host/res reason 带 reason_name。 + - **P1 部分**：队列状态（sched_queue_is_ready 非 stub，closed/inactive 队列不参选 + fcfs election attach QUEUE_CLOSED/DRAINING）；worker 过滤（sched_try_alloc_on_host_ 跳过 UNAVAIL/CLOSED worker + HOST_UNAVAIL）。 + - **剩余**：P1 时间窗（TIME_WINDOW——scheduler 需保留 dispatchwindow 配置 + 自写"now in window"评估，controller 不计算窗口状态）；P2 依赖/license/保留/exclusive/fairshare（机制本身未实现）；MCP `bjobs -p` 等价工具（未做）。 ### 5. 设计层加固（文档已写、代码零实现） - **Auto-pilot 模式**：用户显式授权范围内的自主行为