AI Agent 执行一次任务，往往会留下工具调用、命令执行、思考过程等大量过程信息。如果把这些内容全部平铺到界面上，用户可能刷 10 屏都看不到最终答案，也无法快速确认任务是否成功。据掘金一篇关于 Agent 交互设计的文章拆解，Trae、Claude Code、Cursor 等 Agent 工具处理海量输出的核心，并不是把信息藏起来，而是采用“渐进式披露”：默认给用户一层干净、可操作的界面，再把细节放进可展开的容器里。
结论、证据、原始轨迹：把输出分成三层
渐进式披露落到结构上，是一套分层信息架构。第一层是结论面，包括最终答案，以及“思考了 8 秒”“正在读文件”这类状态；第二层是证据面，包括工具结果、引用和关键数据；第三层是原始轨迹，包括完整思考链、完整命令输出和每一步日志。
这种结构类似报纸的标题、导语和全文：标题让人扫一眼知道结果，导语补充关键事实，全文留给需要深究的人。对于 Agent 工具来说，过程信息对调试者有价值，但对普通用户可能构成噪音。折叠的关键，不是减少信息本身，而是区分不同用户在什么场景下需要哪一层信息。
文章给出的一个直观类比是：Agent 的输出来自“后厨”，用户先看到的是摆好的菜；如果切菜、颠勺、洗碗都被端上桌，反而会形成认知负担。但当用户想知道菜是怎么做的时，也不能完全封闭追溯入口。因此，默认展示结果、保留可展开的过程细节，成为这类产品共同的设计起点。
时间、工具、思考、结果：四种折叠对应四类噪音
具体到折叠方式，文章总结了四种形态，分别处理不同类型的过程信息。
- 时间折叠：把思考耗时压缩为状态信息，例如“思考了 8 秒”，而不是让等待过程占满屏幕。
- 工具折叠：把工具调用收进摘要式卡片，用户点开后再查看具体参数和返回。
- 思考折叠：将思考链收起，只保留必要的过程提示，避免大段内部推理干扰最终结论。
- 结果折叠：对过长的命令或文件输出进行截断和展开，防止原始结果直接占据整个界面。
从 Claude Code、VS Code 插件、Cursor 以及 Trae 类 IDE Agent 的做法看，通用模式并不是简单隐藏内容，而是有选择地浮出关键信息。折叠的是过程细节，不折叠的是结果和异常。这条分界线决定了用户是否会漏掉重要状态。
文章中的一个 HTML 示例展示了这种组合：结论面显示“任务完成：已修复 config.py 中的端口配置，测试全部通过。”状态条显示“Agent 已结束，共执行 3 个工具调用”。下方工具卡片默认折叠，例如“已读取 config.py（128 行）”“已编辑 config.py：8080 → 9090”。而“测试曾有 1 个失败（已修复）”的异常项默认展开并高亮，不藏在折叠里。
折叠的体验底线：干净、可深挖、有反馈
用户能否顺畅查看 Agent 输出，取决于三件事。第一是干净，默认界面不能把大量过程信息直接推到用户面前。第二是可深挖，想查看细节的人能点开对应容器。第三是实时反馈，即使详情被折叠，也要让用户知道系统正在执行或已经完成到哪个阶段。
如果缺少实时反馈，折叠反而可能带来新问题：用户面对静止界面，会猜测任务是否卡住。如果折叠过度，关键失败可能被藏起来；如果全部暴露，用户又会被工具日志和思考链淹没。文章将这两种问题分别称为“藏过头”和“全暴露”。
因此，失败和异常需要优先浮出。对于多步工具调用、长思考链和大量命令输出的 Agent 产品，三层架构和四种折叠是必要设计；但对于单步、短输出，或者开发者需要全程查看完整 trace 的场景，直接平铺可能更合适。判断标准是用户是否“只看结果、偶尔看过程”。
随着 Agent 从问答走向执行，输出界面不再只是展示文本，而是在组织工具调用、状态变化和验证结果。把 90% 的噪音折叠，把 10% 的信号留下，并为异常保留可见入口，正在成为 AI 编程工具提升可消费性的一条基础路径。
原创文章，作者：点点，如若转载，请注明出处：https://www.dian8dian.com/agent-shu-chu-shua-10-ping-kan-bu-dao-da-an-trae-claude
