Files
agent-workbench/references/design-system.md
T

2.3 KiB

固定设计系统

assets/dashboard/ 是本项目的实际前端模板,不是截图参考。基于 React、TypeScript、Vite、Tailwind 与官方 shadcn/ui 组件;上游来源、授权和版本以模板内说明和 lockfile 为准。

页面与布局

复用官方 sidebar block 的侧边导航、页头和内容容器,登录复用官方 login block 的表单与组件。维持五个独立路由:

页面 主要问题 内容
总览 现在进展如何? 少量状态统计、当前阶段/阻塞、重要汇报与决策摘要
任务 谁在做什么? 工作包、状态、阶段、ETA 范围/依据和更新时刻
集群 资源和调度是否可用? 节点内存/负载、NFS、Slurm、LSF与故障/采集时间
沟通 我如何询问进度和讨论方案? 默认专门会话、来源明确的历史、输入框与投递状态
决策 哪些事项需要我决定? 方案、影响、依据、待定与已决定记录

总览不重现所有详情;页面不把数据全部挤在一个长列。窄屏折叠导航,沟通输入和消息列表保持可操作。

颜色和组件

  • 固定 zinc 中性基础与官方 blue 主色,使用模板 CSS 变量;状态色仅表达成功、注意、失败和未知。
  • 不为每个任务生成另一套色板,不用渐变、发光或装饰插画取代信息层级。不在组件内散布临时 hex 色值。
  • 复用 Sidebar、Card、Badge、Button、Input、Textarea、Table、Progress、ScrollArea 等现有组件。新增交互先找已安装组件;确需增加时使用官方 registry/CLI并保留授权。
  • 区分运行状态、任务阶段与验证结论。颜色配文字,未知不使用健康颜色;预计时间有范围和依据。
  • 不写模拟运行数值当作生产内容。空状态说明缺配置、待同步或没有数据,尽量就近给可执行入口。

AI 修改方式

先定位已有页面和数据适配层,复用组件完成需求;只在设计系统确需变化时修改集中 token。业务数据来自当前 API,不能为了套模板保留示例收入、销售图、假用户或无效按钮。

提交前运行锁定依赖构建,并验证五页切换、刷新/返回、沟通会话目标、登录退出、过期/离线状态和窄屏布局。截图和生产数据仅留在私有验收产物,不自动加入公开库。