# V8 决策可视化设计规范

## 阅读顺序

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

```text
确定方向 → 实现规划 → 多路实现 → 多方案评审 → 主 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` 只关闭最上层，关闭后恢复到原触发按钮。
- 桌面端按轮次纵向分行，每轮内部保持横向流程；移动端使用同一业务投影的轮次折叠列表，不在浏览器里另行解释业务。