DESIGN.md 3.0 KB

V8 决策可视化设计规范

阅读顺序

画布从上到下按轮次讲述一次构建;每轮内部仍从左到右展示业务流程:

确定方向 → 实现规划 → 多路实现 → 多方案评审 → 主 Agent 最终取舍 → 整体评审 → 本轮产出

实现方案内部使用“发散后汇聚”的结构:工具取数和 Agent 取数平级展开,取数 Agent 内只展示查询与初筛;正式数据取舍始终放在实现 Agent 范围。

卡片信息预算

  • 每张决策卡只展示一条主结论、默认两条摘要,最多三条摘要。
  • Direction 展示最终方向、形成前信息与真实约束。
  • Tradeoff 展示取舍范围、明确处理结果与记录中的理由。
  • Evaluation 展示评审结论、关键达成项与真实问题或建议。
  • Creative 以“产生候选创作表”展示真实记录的创作处理与候选产出;完整创作任务只在前置“实现任务”节点展示,不在产出节点重复。
  • Implementation Plan 使用专用“本轮实施路线”结构,逐路展示动作、类型、作用范围、实施方法与路线侧重;规划理由紧随路线,完整形成依据折叠展示。
  • 输出、取数与普通执行节点不使用决策标签,也不显示 Prompt 入口。

主画布不展示数据库表名、字段名、事件 ID、Tool 名、JSON 或原始 Markdown。

决定权视觉

  • 主 Agent 最终决定:珊瑚色主轮廓,标签为“最终决定”。
  • 评审 Agent:紫色辅助轮廓,标签为“评审建议”,不使用最终态语气。
  • 实现 Agent 内部决策:蓝色轮廓,标签为“本方案内有效”。
  • 成功、暂存、未采用分别使用绿、黄、红,只标注真实状态。

Inspector

Inspector 只保留三层:

  1. 业务详情:按决策类型展示问题、输入关系、结论、理由、评审建议与最终处理。
  2. 产出与改动:仅在存在可确认的候选产物或主脚本变化时出现。
  3. 技术记录:按数据来源、关联方式、原始输入、原始输出、耗时成本与原始记录分组。

Agent 的“本次真实任务 / 当前版本规则”只从 Inspector 内的规则按钮进入;主画布的候选产出卡优先保留“查看完整候选脚本”。

实现规划的画布卡只承担摘要职责;Inspector 不得复用画布 preview,形成依据保留完整业务文本并默认折叠。

评审建议与主 Agent 最终决定并排对照;只有主 Agent 理由明确记录接受、部分接受、延后转化或拒绝时,才显示“对建议的处理”。

交互与响应式

  • 画布支持 Mac 双指平移和捏合缩放,不显示 Minimap。
  • 节点可拖动;轮询刷新不重置视口、用户位置、展开状态或 Inspector 页签。
  • Prompt Drawer 和 Inspector 遵守顶层弹层优先级;Escape 只关闭最上层,关闭后恢复到原触发按钮。
  • 桌面端按轮次纵向分行,每轮内部保持横向流程;移动端使用同一业务投影的轮次折叠列表,不在浏览器里另行解释业务。