梧桐设计语言v0.4.1

页面模式Patterns

页面只有几种。把它们定死,agent 生成的应用和人手写的页面才会长得一样。


列表页(台账)

指标行(4–5 个 Metric)→ 主面板:工具行(筛选 · 搜索 · 自定义列,右侧主按钮)→ Table → 多选时 BatchBar。点行开侧滑面板看详情,不跳页。

  • 筛选条件以芯片形式显示在工具行下方,可逐个点掉;「只看超期」这类高频筛选做成 Segmented 放在标题旁。
  • 搜索即时生效,不要「搜索」按钮;空结果显示「没有匹配「xxx」的工单」+ 清除筛选。
  • 表格默认按更新时间倒序;排序列表头带小箭头。
  • 每页 20 条,Pagination 在表格底部右侧;移动端改无限滚动。

详情页(侧滑面板)

标题 = 编号 + 名称,右上关闭;下面按「基本信息 → 处理记录 → 附件 → 沉淀的经验」分区,heading 分区标题。状态 pill 在标题行。主操作(派单 / 关单)固定在面板底部。

  • 桌面从右侧推入,宽 panel 480,列表不动、可对照。
  • 移动端是整页,返回箭头在左上,主操作固定底部通宽。
  • 字段用「标签在上、值在下」两行式,不用「标签:值」一行式——值经常很长。

表单

桌面:表单弹窗(宽 520)或侧滑面板;移动:底部抽屉。主操作在右(桌面)/ 底部通宽(移动),取消在左 / 退化为文字。

  • 字段间 space-5 20;标签 label 在上;选填在标签后标「选填」,必填不标星号(默认都是必填)。
  • 校验在失焦时做,错误文案在字段下方说明为什么与怎么办。提交时把第一个错误字段滚到视野内。
  • 长文本字段右侧常驻麦克风。日期在移动端用原生控件。
  • 提交成功:关闭表单 + Toast「已派单给王强 · 撤销」。失败:表单不关,顶部 ErrorBlock。

首页:三型,按角色分

  • 一线型(师傅):今日待办列表(64 高行)+ 底部两个大按钮(拍照报修 / 语音记录)。不放指标图表——他要的是「我今天干什么」。
  • 管理型(班组长、管理层):指标行 + 超期列表 + 趋势图。要的是「哪里有问题」。
  • 冷启动型(新客户第一天):数据为 0 时不显示空指标,显示引导清单(导入设备台账 → 建第一张工单 → 邀请同事)。满 20 条记录或满 7 天自动切换到前两型。

首页框架固定,指标与入口由业务包填,不由 agent 从零生成

空状态

一个 icon-lg 图标(subtle)+ 一句话说明这里会有什么 + 一个主按钮做第一件事。不放插画、不放吉祥物。搜索无结果与真正的空状态文案不同。

加载态

  • < 3 秒:loading 转圈或什么都不显示(内容瞬间到位比闪一下骨架好)。
  • 列表首屏:文字骨架,只做表头 + 5 行灰条,不套娃、不做闪光动画。
  • 3–40 秒:呼吸点 + 一句话说在做什么。
  • 40 秒:ProgressPanel。

  • 弱网:先展示本地缓存的旧数据 + 顶部「正在刷新」,不清空页面。

设置页

分组列表,每组 heading 标题,每项一行「标签 + 右侧控件(Switch / 值 + chevron)」,行高 44(桌面)/ 56(移动)。危险操作(退出、注销企业)单独一组放最底、用 destructive 文字。