观察执行
如何读任务详情:两栏结构、节点详情的渐进披露顺序、代码与产物的证据入口,以及实时连接的语义。
任务详情的结构
任务详情不使用四栏布局。顶部只承载任务定位、状态和任务级控制;下方保持左侧 Agent 会话与右侧证据栏的稳定两栏关系。
任务头部采用三层信息层级:任务定位与标题主线、状态与进度与分支副线、任务操作区。长目标只能在弹性内容区单行截断并通过任务上下文查看全文,生命周期标记固定水平且不可收缩。
证据栏是单层状态机
右侧栏默认完整展示依赖图。点击节点后,整栏替换为该节点的概览,再在代码、产物、链路与 Agent 之间切换。
拓扑与详情不同时出现,因此文件阅读器可以使用整个右栏高度。详情状态允许右栏适度加宽,左侧会话仍持续可见。
详情顶部必须提供明确的返回流程入口,返回后恢复完整依赖图。
这个设计的原因是:在一个狭窄的并排布局里同时放下依赖图和文件内容,会让两者都不可用。替换比压缩更诚实。
节点详情的披露顺序
节点详情遵循结论 → 契约 → 证据 → 原文的顺序。
概览先展示可扫读的执行结论,再展示输入输出契约、任务上下文、冻结代码与产物证据。
需要注意:只有任务快照已经提供的执行次数、耗时或返工事实才允许出现,前端不得用演示常量补齐。因此如果某个字段没有显示,通常是数据本身不存在,而不是界面遗漏。
代码展示该次执行完成时冻结的代码修订与完整代码树,不读取最终任务分支。这个区别很重要:最终分支是所有节点提交合并后的结果,它不代表任何一个中间节点的当时状态。
产物展示冻结的结果摘要、产物清单与声明的交接产物,不开放任意运行时文件。
链路展示节点调用摘要并深链到任务全宽的可观测性页面。
Agent 展示运行时、模型、能力及其版本和锁定信息。
读结果摘要
结果摘要是每个成功节点唯一的用户可见摘要权威,按固定结构包含结果、文件、链接、验证、风险与后续。
文件部分逐一列出经运行器校验后的产物相对路径。因此摘要是可信的:它的文件列表与冻结产物一一对应,不是 Agent 的自由描述。
链接部分只记录本节点实际创建或发现的外部地址,不把相对产物路径伪装成网页地址。
结果摘要默认只显示从冻结正文提取的短摘要,用户显式展开后才加载完整内容。这是为了在列表中保持可扫读性。
依赖图的读法
依赖图节点只保留顺序、标题和状态,不在每个节点重复固定的执行次数。
节点编号与执行队列由冻结依赖做确定性拓扑排序,不使用配置数组的下标。画布只隐藏可由其他路径推导的传递边,并以箭头保留真实依赖方向——独立分支不能显示成串行。
实时连接状态
任务执行状态与物理连接状态必须分离。
只有运行中的任务才展示实时、重连中、离线与活跃状态。已完成或已失败的任务使用稳定的终态、只读和最终依赖图语义。
历史积压只补齐会话记录,不能把当前快照回退到旧节点状态。终态订阅回放完成后停止重连。
因此:已完成的任务上看到「重连中」是一个缺陷,不是正常现象。如果你观察到这种情况,值得报告。
文件阅读器
代码与产物共用整宽文件工作区、筛选、原始文件阅读器和下载动作。
文件树提供足够的可用宽度。文件名、元数据和正文使用可读的阅读尺度,不通过极小字号把内容硬塞进侧栏。
阅读器显示原始路径、字节大小、媒体类型以及代码对象标识或内容摘要。文本按页读取并保持编码边界,二进制只提供原文件下载。
旧任务没有冻结修订时明确显示兼容说明,不把运行器方法错误或空白面板暴露给用户。
可观测性
资源大盘展示集群内平台遥测、可观测性运行与任务关联。空态不得伪造容量或健康数据。
观测应从原有业务对象进入,并保留返回原对象的定位。追踪是执行证据,跨度是证据中的操作;运行时会话标识只在需要诊断时作为技术信息展示。
对话、轮次、任务、自动化运行、观测运行与追踪标识不可因显示名称统一而混成同一身份。从对话发起的流程用持久提案回执关联,不能把后台任务完成状态等同于发起它的轮次状态。