Files
pikasTech-unidesk/docs/MDTODO/cli-output-progressive-disclosure.md
T
Codex eed42e7351
Pipelines as Code CI / hwlab-web-probe-sentinel-nc01- Success
Pipelines as Code CI / platform-infra-gitea-nc01- Success
Pipelines as Code CI / unidesk-host- Success
docs(mdtodo): 收口 AgentRun 事件摘要
2026-07-12 03:42:02 +02:00

2.7 KiB

CLI 输出渐进披露

本文件长期跟踪 UniDesk 高频 CLI 的紧凑默认输出、语义化逐级披露、显式原始输出与错误可见性合同。单个命令、一次 dump 或一个 issue 作为 ITEM 纳入,不以临时故障扩散文件。

R1 [completed]

解决 UniDesk #1809:收敛 Gitea webhook status、trans --help 及未知/错误命令的高频 dump,建立 compact 默认输出、语义化 drill-down、显式 raw 和无 stack 错误合同;只改只读 CLI 可见性,不新增 mirror、sync、flush、trigger 或 apply,完成任务后将详细报告写入任务报告

R1.1 [completed]

复现并冻结 #1809 的输出合同:默认输出有界、repository key/deliveryId drill-down 语义化、--full 域聚合、--raw 显式;trans --help、未知子命令和可预测 option 错误不得回显内部 stack,完成任务后将详细报告写入任务报告

R1.2 [completed]

实现共享 CLI 错误边界与 Gitea webhook 有界逐级披露,复用既有 formatter/命令路由;默认输出给出可执行的语义化 next,不依赖临时 dump,且不增加任何交付或 mirror 写入口,完成任务后将详细报告写入任务报告

R1.3 [completed]

覆盖 compact/full/raw、repository/deliveryId、错误参数和 trans --help 回归,完成静态验证、非草稿 PR、架构审查与自动交付后原入口验收,完成任务后将详细报告写入任务报告

R2 [completed]

依据 UniDesk #1817 收敛 AgentRun event 高频摘要的输出爆炸,只改 UniDesk render-only CLI,不改变 AgentRun/Kafka durable event facts,完成任务后将详细报告写入任务报告

R2.1 [completed]

默认 human 与 -o json|yaml 只展示有界 tool_call/event summary,保留 seq/type/status/commandId、命令首行、exit/duration 和 output bytes/hash/截断标记,完成任务后将详细报告写入任务报告

R2.2 [completed]

显式 --full|--raw 或稳定 event identity 保持完整下钻,并用固定 run_d7f1cbb11ab04a75ad435ee462c2e60d 和大 output 离线夹具证明默认不再触发 dump,完成任务后将详细报告写入任务报告