# SwarSight — DESIGN.md（dogfood 项目基线，静态合成）

Provenance: observed（showcase 演示面提炼；本轮 P3 升级前绑定）。

## 布局段（layout conventions）

- 工作台骨架：顶栏全局操作 + 主工作区；顶栏不承载任务级数据。
- 主列表区：可比较表格（行记录），等权卡片墙仅用于画廊型内容。
- 分区无框：页面分区靠间距与字重；有界容器仅用于对话框与抽屉。
- 中性面主导；语义色仅作状态命名（成功/警告/失败），不作装饰。
- 控件几何各自特定（按钮/输入/复选不共享统一胶囊半径）。
- 紧凑控制台层级用结构与字重表达，不引入 display 级大字号。
- 动效仅用于状态反馈（进入/退出/进行中），永不用于装饰。

## 反馈段

- 进行中动作：入口 busy + 禁重复；页面级通知用 toast（含可访问名称与 role）。
- 空态：非白屏空态 + 下一步 CTA；加载态优先条目级进度。

## 命名段

- 运行状态枚举：queued / running / paused / failed / completed / aborted / timeout。
- 批量操作条：选中后浮现；破坏性动作保留显式文字。