Codex
11 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、ack/cancel、dispatch、run/command/runner 状态 drill-down 和 HWLAB Code Agent/CaseRun follow-up 必须使用 `agentrun get|describe|events|logs|result|ack|cancel|dispatch|create|apply|send` 资源原语。用户提到 codex、Code Queue、submit、send、resume、tasks、unread、code-queue、aipod、Artificer、HWLAB Code Agent 时使用。 |
UniDesk Code Queue / AgentRun CLI
旧 Code Queue 已冻结新任务和写入口。bun scripts/cli.ts codex ... 现在只作为历史归档、只读排障和残留任务停止入口；新的指挥官派单、Aipod/Artificer 执行、events/logs/result、ack/cancel、dispatch、session follow-up 必须走 AgentRun 资源原语，并按 cli-spec 渐进披露。UniDesk 是 render-only client：默认输出是低噪声 human 表格/摘要，脚本读取显式使用 -o json|yaml 的稳定客户端 schema，--raw 只用于查看直连 AgentRun REST envelope。
固定入口前缀: cd /root/unidesk && bun scripts/cli.ts agentrun ...
新任务入口
# 查看 AgentRun 指挥官队列
bun scripts/cli.ts agentrun get tasks --queue commander --limit 20
bun scripts/cli.ts agentrun get tasks --queue commander -o wide
# 查看一个 task/run/command/runnerjob/session 生命周期
bun scripts/cli.ts agentrun describe task/<taskId>
bun scripts/cli.ts agentrun events run/<runId> --after-seq <lastSeq> --limit 100
bun scripts/cli.ts agentrun logs session/<sessionId> --tail 100
bun scripts/cli.ts agentrun result run/<runId> --command <commandId>
bun scripts/cli.ts agentrun describe command/<commandId> --run <runId>
bun scripts/cli.ts agentrun describe runnerjob/<runnerJobId> --run <runId>
# 查看 / 渲染 AipodSpec（Artificer 是默认分布式开发 agent）
bun scripts/cli.ts agentrun get aipodspecs
bun scripts/cli.ts agentrun describe aipodspec/Artificer
bun scripts/cli.ts agentrun aipod-specs render Artificer --prompt-stdin
# AipodSpec apply/delete 仍由客户端资源原语发起，服务端只返回 REST 业务事实
bun scripts/cli.ts agentrun aipod-specs apply --yaml-stdin --dry-run
# 提交 AgentRun task manifest
bun scripts/cli.ts agentrun apply -f - --dry-run <<'YAML'
kind: Task
spec:
tenantId: unidesk
projectId: example
queue: commander
title: 任务标题
payload:
prompt: 任务说明
YAML
# 用 AipodSpec 提交，优先用于新任务和 Artificer
bun scripts/cli.ts agentrun create task --aipod Artificer \
--prompt-stdin --idempotency-key <key>
# 查看/控制 AgentRun session
bun scripts/cli.ts agentrun logs session/<sessionId> --tail 100
bun scripts/cli.ts agentrun ack session/<sessionId>
bun scripts/cli.ts agentrun dispatch task/<taskId>
bun scripts/cli.ts agentrun send session/<sessionId> --aipod Artificer --prompt-stdin
bun scripts/cli.ts agentrun cancel session/<sessionId> --reason <text> --dry-run
bun scripts/cli.ts agentrun cancel command/<commandId> --run <runId> --reason <text> --dry-run
日常 task manifest 优先使用 YAML heredoc：agentrun apply -f -；单 prompt 派单优先 agentrun create task --aipod Artificer --prompt-stdin；同 session 续跑只使用 agentrun send session/<sessionId>。UniDesk 客户端按 config/agentrun.yaml 直连 AgentRun REST API，不经过 HWLAB runtime、SSH official CLI 或旧 bridge wrapper；send 是唯一用户级 session follow-up 写入口，服务端按 durable session/run/command 状态自动决定内部 steer 或新 turn，旧 CLI turn/steer 路径不保留兼容。--json-file、--prompt-file 和 --runner-json-file 只是客户端输入来源，用于已审阅且可复用的受控文件。它不是旧 Code Queue adapter，不双写，也不迁移旧历史。
AipodSpec 是 AgentRun v0.1 的声明式 agent 装配：模型 profile、gitbundle、skills/tools、SecretRef 和 tool credential 都从 YAML 规格渲染。Artificer 默认用于 UniDesk 分布式开发任务，使用 sub2api provider、gpt-5.5、reasoningEffort=xhigh，并通过 SecretRef 注入 GitHub PR token、GitHub SSH 和 UniDesk SSH 透传能力。更新规格时使用 agentrun aipod-specs apply --yaml-stdin --dry-run 先看计划，确认后再去掉 --dry-run；不得把 API key、SSH key 或 token 写入 prompt、payload、YAML 或 issue。
AgentRun task payload 需要 runner 内使用 UniDesk SSH 透传时，只通过 executionPolicy.secretScope.toolCredentials[].tool=unidesk-ssh 请求 agentrun-v01-tool-unidesk-ssh/UNIDESK_SSH_CLIENT_TOKEN SecretRef；不要把 token 写入 prompt、payload 或 transientEnv。非敏感 endpoint 使用 UNIDESK_MAIN_SERVER_IP、UNIDESK_MAIN_SERVER_HOST 或 UNIDESK_FRONTEND_URL，可由 runner-job transientEnv 显式提供；G14 agentrun-v01 manager 也会在缺省时按受控默认值自动补齐，并在 trace 中只显示 env name/count/hash 与 valuesPrinted=false。
Queue 渐进披露
AgentRun queue 生命周期不是一个单独的 queue lifecycle 命令，而是一组资源原语的渐进披露组合：
- 默认总览用
get tasks --queue commander --limit 20，只看 task state、queue/lane、run/cmd/rjob/session ref、age 和 attention。 - 单任务用
describe task/<taskId>，读取latestAttempt.runId、commandId、runnerJobId、sessionId/sessionPath和少量Next:。 - Run 级状态用
events run/<runId>和result run/<runId> --command <commandId>，判断 terminalClassification、failureKind、provider interruption、timeoutBudget 和 recoveryActions。 - Command 级状态用
describe command/<commandId> --run <runId>和result command/<commandId> --run <runId>，确认 command state、ack、terminal status 和结果摘要；确认为单个 active command 卡住时，用cancel command/<commandId> --run <runId> --reason <text>清理该 command，保留同一个 session 后再用send session/<sessionId>续跑。 - Runner job 只读状态用
describe runnerjob/<runnerJobId> --run <runId>，确认 env image reuse、jobName、namespace、phase、exitCode、retention 和valuesPrinted=false。不要为了这些字段手动调用trans G14:k3s kubectl ...。 - Session trace/output 只在
describe task或 result 里有实际sessionId时使用logs|ack|send|cancel session/<sessionId>；sessionRef=null时不要猜 session 命令。用户级 follow-up 一律使用send session/<sessionId>，不要回到旧turn/steer或sessions ...兼容路径。 - 已创建但尚未运行的 task 使用
dispatch task/<taskId>派发，不再退回旧 bridgequeue dispatch。
默认视图必须低噪声且不是 JSON envelope，-o json|yaml 才输出稳定机器结构，--raw 才保留直连 AgentRun REST envelope；命令返回里的下一步应优先是 bun scripts/cli.ts agentrun ... 资源原语，不得把人工 k8s 查询作为日常下一步。
HWLAB Code Agent 入口整合
HWLAB Code Agent / CaseRun follow-up 的日常派单也归入 AgentRun 资源原语：新任务用 create task --aipod Artificer 或包含 HWLAB gitbundle 的 apply -f -；运行中纠偏用 send session/<sessionId> --aipod Artificer。需要验证 HWLAB Web/Cloud API 原入口时，仍按 $hwlab-code-agent 使用 G14 /root/hwlab-v02 的 hwlab-cli client agent ... 拉取同一 trace/result/inspect；不要回到旧 codex submit/resume/steer。
冻结的旧写入口
以下命令必须返回 ok=false、frozen=true、degradedReason=legacy-code-queue-frozen，并提示 AgentRun 替代命令：
bun scripts/cli.ts codex submit ...
bun scripts/cli.ts codex enqueue ...
bun scripts/cli.ts codex steer <taskId> ...
bun scripts/cli.ts codex resume <taskId> ...
bun scripts/cli.ts codex queue create <queueId>
bun scripts/cli.ts codex queue merge <sourceQueueId> --into <targetQueueId>
bun scripts/cli.ts codex move <taskId> --queue <queueId>
不要用兼容开关、legacy mode、adapter、双写或 fallback 绕开冻结边界。
历史任务视图
Commander（低噪声轮询）
bun scripts/cli.ts codex tasks --view commander [--limit N]
返回旧 Code Queue 历史/残留任务的有界 action map：active runners 计数、少量 active item、queued/retry_wait 计数、terminal-unread 总数、关键风险计数、分类计数和 drill-down 命令。新任务队列状态用 agentrun get tasks --queue commander。
Supervisor（分区视图）
bun scripts/cli.ts codex tasks --view supervisor \
[--status succeeded|running|queued|failed|canceled|judging|retry_wait] \
[--unread] [--limit N] [--before-id id]
返回 activeRunning、running、completedUnread、recentCompleted、queued 分区。状态 alias：completed|successful → succeeded、cancelled → canceled、pending → queued。
单任务
bun scripts/cli.ts codex task <taskId> [--detail|--full] [--trace]
未读积压
# 摘要
bun scripts/cli.ts codex unread [--queue id] [--repo owner/name] [--issue N]
# 详细列表
bun scripts/cli.ts codex unread list [--view full] [--limit N]
# 标记已读
bun scripts/cli.ts codex unread mark-read --confirm [--queue id]
mark-read 必须 --confirm，单任务审阅优先用 codex read <taskId>。
Trace / Output 分页
# 逻辑 trace（分页）
bun scripts/cli.ts codex task <taskId> --trace \
[--tail|--from-start|--after-seq N|--before-seq N] [--limit N] [--full]
# 原始 output（分页补取）
bun scripts/cli.ts codex output <taskId> \
[--tail|--from-start|--after-seq N|--before-seq N] [--limit N] [--full-text]
标记已读
bun scripts/cli.ts codex read <taskId>
标记单个终态任务已读，同时返回任务身份、终态 attempt 摘要和最终 response。
Judge（复现评判）
bun scripts/cli.ts codex judge <taskId> --attempt N [--dry-run] [--include-prompt]
按指定 attempt 单步复现 judge，诊断入口。
中断/取消
bun scripts/cli.ts codex interrupt <taskId>
bun scripts/cli.ts codex cancel <taskId>
仅用于停止旧 Code Queue 残留任务；新 AgentRun session 使用 bun scripts/cli.ts agentrun cancel session/<sessionId>，单个卡住 command 使用 bun scripts/cli.ts agentrun cancel command/<commandId> --run <runId>。
旧队列归档
bun scripts/cli.ts codex queues [--full|--all] [--limit N] [--page N]
只读查看旧队列摘要。旧 queue create/merge 和 move 已冻结。
Dev Ready / PR Preflight
bun scripts/cli.ts codex dev-ready
bun scripts/cli.ts codex pr-preflight [--remote] [--push-dry-run ...] [--pr-create-dry-run ...] [--issue N] [--full|--raw]