Przeglądaj źródła

docs: refine agent workflow visual style

Mochocyang 2 miesięcy temu
rodzic
commit
6c170a438b

+ 55 - 5
docs/superpowers/specs/2026-07-02-agent-workflow-thought-process-design.md

@@ -169,16 +169,65 @@
 
 ## 视觉设计
 
-参考 TRAE/Codex 风格,采用轻量纵向列表,而不是大面积卡片堆叠
+参考 TRAE/Codex 风格,采用轻量纵向过程流,而不是大面积蓝底卡片列表
 
-1. 每个阶段左侧有状态图标:运行中、完成、等待确认、失败、跳过。
-2. 阶段标题使用 13-14px,摘要使用 12-13px,避免在聊天侧栏里显得拥挤。
-3. 默认视图只显示阶段标题和一句摘要。
-4. 展开内容使用浅边框或缩进,不使用重卡片嵌套。
+### 禁止的呈现方式
+
+当前截图中的样式必须废弃:
+
+1. 不使用整块浅蓝色背景包住全部思考过程。
+2. 不把每一步做成一条圆角浅蓝卡片。
+3. 不重复显示大量同类卡片,例如连续多条“整理资料范围”。
+4. 不把过程区做成像表单列表、通知列表或日志面板。
+5. 不让“工具详情”按钮成为视觉重点。
+
+这类样式显得老旧,并且会把简单过程放大成沉重的信息块。
+
+### 新呈现方式
+
+采用“文本过程流 + 细分隔 + 局部展开”的样式:
+
+1. 外层背景保持透明或接近聊天背景,只用左侧细线、轻量图标和小标题组织层级。
+2. 每个阶段默认是一行过程摘要,视觉上像 Agent 正在汇报工作,而不是像卡片列表。
+3. 当前运行阶段可以有非常轻的背景高亮,但不能使用整行大圆角卡片堆叠。
+4. 阶段之间使用留白和细分隔,不使用厚边框。
+5. 已完成阶段显示为简洁文本,例如:`已读取 1 个章节,2 条记忆,1 个大纲`。
+6. 正在执行阶段显示一句自然语言,例如:`正在读取章节《chapter-017》`。
+7. 展开内容在阶段下方缩进显示,使用小号文本和项目符号,不再套一层卡片。
+8. 技术工具名默认隐藏,放入“查看工具详情”的二级折叠区。
+
+### 信息密度
+
+1. 阶段标题使用 13-14px,摘要使用 12-13px,避免在聊天侧栏里显得拥挤。
+2. 默认视图只显示阶段标题和一句摘要。
+3. 同类工具调用需要合并摘要,例如多次 `list_*` 合并为“整理资料范围”,不要重复刷屏。
+4. 读取类工具可以在展开内容里逐条列出目标对象。
 5. 长内容必须换行,文件名和章节名不能撑破聊天框。
 6. 移动或窄宽度下保持单列,不出现横向滚动。
 7. 最终回答区域与过程面板视觉分离,避免用户误以为过程文本属于正文。
 
+### 推荐视觉结构
+
+示例:
+
+```text
+思考过程  ·  任务耗时 1m 4s
+
+任务理解  >
+识别为章节细纲生成,需要读取大纲与目标章节。
+
+上下文准备  v
+正在读取章节《chapter-017》
+  - 已读取大纲《总大纲》
+  - 已读取记忆《人物设定》
+  - 已读取章节《chapter-017》
+
+生成与校验  >
+将按章节细纲格式输出,正文区不显示过程分析。
+```
+
+这个结构的重点是“像 Agent 在汇报处理进度”,不是“把每个工具调用包装成一个卡片”。
+
 ## 数据模型
 
 新增显示模型:
@@ -286,3 +335,4 @@ interface AgentWorkflowDetail {
 5. 最终正文保持干净,不混入过程分析。
 6. AI 会话和 AI 大纲表现一致。
 7. 没有破坏写入确认和现有工具调用逻辑。
+8. 思考过程不再使用整块蓝底加多条圆角卡片的老式列表样式。