Codex
3.3 KiB
3.3 KiB
name, description
| name | description |
|---|---|
| unidesk-code-queue | UniDesk AgentRun-backed Code Queue CLI — Skill(cli-spec)。legacy `codex` 子命令只保留历史只读和残留停止；新任务提交、Aipod/Artificer 派单、session follow-up、events/logs/result、attempts/retry、ack/cancel、dispatch、run/command/runner 状态 drill-down 和 HWLAB Code Agent/CaseRun follow-up 必须使用 `agentrun get|describe|events|logs|result|retry|ack|cancel|dispatch|create|apply|send` 资源原语。用户提到 codex、Code Queue、submit、send、resume、retry、tasks、unread、code-queue、aipod、Artificer、HWLAB Code Agent 时使用。 |
UniDesk Code Queue / AgentRun CLI
新任务、Aipod/Artificer 派单、session follow-up、events/logs/result、attempts/retry、ack/cancel、dispatch 和 run/command/runner drill-down 走 AgentRun 资源原语。legacy codex 只保留历史只读、未读积压和残留任务停止。
高频入口
bun scripts/cli.ts agentrun get task --limit 20
bun scripts/cli.ts agentrun describe task/<taskId>
bun scripts/cli.ts agentrun events run/<runId> --limit 20
bun scripts/cli.ts agentrun logs session/<sessionId> --tail 120
bun scripts/cli.ts agentrun result command/<commandId> --run <runId>
bun scripts/cli.ts agentrun get attempts --task <taskId>
bun scripts/cli.ts agentrun retry task/<taskId> --idempotency-key <key> --reason <text> --dry-run
bun scripts/cli.ts agentrun send <session> --prompt-stdin
资源命令未传 --node/--lane 时固定使用 config/agentrun.yaml#controlPlane.default，当前为 NC01/nc01-v02；只有查询非默认 lane 时才显式传目标参数。主机 direct HTTP auth 只保留独立诊断，固定 Secret 文件路径为 /root/.unidesk/.env/agentrun.env，不得回退到 worktree 或旧 /root/.config/hwlab-* 路径。
AipodSpec/Artificer、task manifest 和 queue 渐进披露见 references/resources.md；session 控制、HWLAB Code Agent 整合、trace/output 分页、judge、中断/取消见 references/sessions.md；旧队列归档见 references/legacy.md。
P0 边界
- 新写入口不要用
codex submit/steer/resume；这些 legacy mutation 已冻结。 - 默认输出保持低噪声表格/摘要；机器消费显式
-o json|yaml或--raw。 - Session follow-up 使用
agentrun send，由服务端决定内部 steer vs turn。 - 终态失败重试只使用
agentrun retry task/<taskId>：保持同一 task，新增不可变 attempt；先用--dry-run完成服务端全校验，再以同一幂等键执行真实重试。 - retry 只接受 Queue 已处于
failed或blocked；completed、cancelled和其他状态必须 fail closed。不得复制 task、重置 task、引入本地 scheduler/backoff/judge 或直接创建 runner Job 来模拟重试。 - HWLAB Code Agent/CaseRun follow-up 也优先落到 AgentRun resource primitive，不绕过队列状态。
何时读取 reference
- 创建/应用 AgentRun task 或 AipodSpec：读 references/resources.md。
- 查历史
codex tasks/unread/output/trace：读 references/legacy.md。 - 需要 judge、取消、中断、Dev Ready 或 PR preflight：读 references/sessions.md。