-
Notifications
You must be signed in to change notification settings - Fork 1
增加 Pixelle CLI 任务完成后的总结与变更摘要卡片 #31
Copy link
Copy link
Open
Labels
cliCLI experience and terminal interfaceCLI experience and terminal interfacedeveloper-experienceDeveloper experience improvementsDeveloper experience improvementsfeatureNew feature or capabilityNew feature or capabilityuxUser experience improvementsUser experience improvements
Description
Metadata
Metadata
Assignees
Labels
cliCLI experience and terminal interfaceCLI experience and terminal interfacedeveloper-experienceDeveloper experience improvementsDeveloper experience improvementsfeatureNew feature or capabilityNew feature or capabilityuxUser experience improvementsUser experience improvements
背景
Agent 完成任务后,用户需要快速确认做了什么、改了哪些文件、调用了哪些工具、验证是否通过。这是决定是否继续追问、手动检查或 git commit 的关键。当前 CLI 已有
FileChangeCard、RuntimeNote和 trace note,但它们按事件顺序分散展示,缺少任务级最终摘要。没有收尾摘要时,用户需要回看整段 timeline 才能理解结果,长任务尤其不方便。
目标
任务完成后展示一个清晰的 Run Summary:最终状态、修改文件列表、工具调用摘要、验证结果、trace/checkpoint 路径,以及必要的下一步提示。这个摘要应适合作为用户确认和 commit 前检查的入口。
当前问题
CLI state 分散保存 messages、tools、changeSets、verifications、traces;
selectTimelineItems只是按事件时间排序渲染,没有聚合视图。trace.persisted默认 debug 才可见。验证结果只显示 passed/failed,文件变更和工具调用之间缺少最终归纳。参考体验
参考现代 Agent CLI 的任务收尾体验:结束时有一个简短但完整的 summary block,清楚列出 changed files、commands run、checks passed/failed 和后续建议。
改动方向
新增
RunSummaryCard,在一次 agent run 完成后基于现有 CLI state 聚合摘要。先使用现有事件和状态,不要求 runtime 新增复杂协议;后续如果 runtime 增加 run stopped/task completed 事件,再进一步精确关联 runId。可能涉及模块
src/cli/state/cli-state.tssrc/cli/state/timeline.tssrc/cli/components/timeline/TimelineItem.tsxsrc/cli/components/timeline/FileChangeCard.tsxsrc/cli/components/timeline/RuntimeNote.tsxsrc/cli/runtime-events.tssrc/cli/types.ts大致实现方案
RunSummaryState和RunSummaryCard任务清单
RunSummaryCard展示变更、工具、验证和 trace验收标准
建议标签
cli、ux、feature、developer-experience