41 KiB
Raw Blame History

WishForge 核心页面线框与交互规范 (Page Designs)

文档版本:1.0.0
设计目标:依据《界面文案规范》(参考 droboticflow copy-guidelines.md 最简文案原则)与《设计规范与令牌》(docs/design/tokens.md),为 WishForge 四个核心关键页面提供像素级落地的文字线框、网格布局、断点自适应(桌面 1440px / 移动端 390px)与四态闭环定义(正常、加载中、空数据、错误)。


页面 1:问题诊断 (Copilot 面板)

1. 业务职责与交互流

  • 定位:客户定位生产与测试环境异常的首要入口。通过输入日志片段或现象描述,Copilot 结合只读只取脱敏日志、集群事件与项目 Wiki 进行推理诊断。
  • 核心组件:
    1. 诊断对话流(流式输出、免责置信度标注);
    2. 引用依据(精准到 文件:行号 或 Wiki 条目外链);
    3. 「依据不足 / 不确定」的警戒警示框与免责说明;
    4. 一键「转成许愿 (Create Wish)」带入上下文的快捷表单;
    5. 关联的集群实时资源告警卡片(如 Pod OOMKilled、CPU Throttling)。

2. 界面线框与布局 (Wireframes)

2.1 桌面端 (1440px)

  • 形态:两栏布局(或控制台全局右侧抽屉 520px / 独立全屏视图 1120px 容器)。以下按独立工作台视图展示:
+------------------------------------------------------------------------------------------------------------------+
| TopNav: WishForge  [项目: 泛宇标注平台 v]  [环境: 生产环境 v]                [集群资源] [运行记录] [发布审批] (用户) |
+------------------------------------------------------------------------------------------------------------------+
| 面包屑: 控制台 / 问题诊断 (Copilot)                                                                               |
|                                                                                                                  |
| 诊断会话: #CP-8921 标注切片任务偶发 504 Gateway Timeout                   [清空对话] [导出记录] [关联集群资源告警 (1)] |
|------------------------------------------------------------------------------------------------------------------|
|                                                                                                                  |
| [10:24:02] 用户:                                                                                                 |
| 生产环境今天上午 10 点后,大视频切片任务大量报 504 错误,麻烦排查是哪里的问题。                                             |
|                                                                                                                  |
| [10:24:05] Copilot [AI 诊断助手] · 置信度 [依据确凿 - 92%]                                                         |
| 排查到 10:00~10:20 期间,worker 节点 `fanyu-gpu-01` 发生显存溢出及算子调度堆积:                                       |
| 1. `droboticflow-worker` 切片算子未释放临时显存,触发 Pod 重启。                                                  |
| 2. 网关超时阈值(当前 30s)小于视频切片平均响应时间(42s)。                                                          |
|                                                                                                                  |
| +--- [关联依据 · Wiki 版本 877307cb] --------------------------------------------------------------------------+ |
| | [BookOpen] 算子超时配置规范          docs/operators/视频切片.md:42               [查看 Wiki] [代码跳转]     | |
| | [BookOpen] 网关代理超时基线          k8s/ingress-nginx.yaml:18                   [查看配置]               | |
| | [Terminal] 节点只读事件              Warning: OOMKilled at Pod slice-worker-x9   [查看事件日志 (只读)]     | |
| +--------------------------------------------------------------------------------------------------------------+ |
|                                                                                                                  |
| +--- [关联资源告警卡片] ---------------------------------------------------------------------------------------+ |
| | [!] 告警:节点 fanyu-gpu-01 内存限制 (Limits) 达到 102%,发生 3 次 OOMKilled 重启。                            | |
| | 影响服务:droboticflow-worker (副本 2/2) | 对应指标:Mem Request 24Gi / Limit 32Gi                             | |
| +--------------------------------------------------------------------------------------------------------------+ |
|                                                                                                                  |
| [操作栏] [转成许愿并排期修复]  [仅复制结论]  [补充上下文/重新诊断]                                                   |
|                                                                                                                  |
| - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  |
|                                                                                                                  |
| [10:28:11] 用户:                                                                                                 |
| 能不能把超时时间改到 60s,顺便把 worker 内存限制调大到 48Gi?                                                        |
|                                                                                                                  |
| [10:28:15] Copilot [AI 诊断助手] · 置信度 [不确定 / 依据不足]                                                       |
| +--- [警告:当前结论依据不足] ---------------------------------------------------------------------------------+ |
| | [AlertTriangle] 注意:扩大资源 Limits 需核对集群空闲总账。                                                    | |
| | 当前节点 fanyu-gpu-01 内存已分配 93%,若调至 48Gi 将导致节点 Limits 超卖超标 (118%)。                           | |
| | 涉及生产部署与资源配额调整属于【高风险】变更,平台方禁止 Copilot 自动修改。                                         | |
| +--------------------------------------------------------------------------------------------------------------+ |
| 建议操作路径:                                                                                                   |
| 1. 点击下方按钮,将「网关超时改至 60s」独立拆为许愿;                                                               |
| 2. 节点规格调整请提交集群配额工单,由平台方运维审批。                                                               |
|                                                                                                                  |
| [操作栏] [仅为网关超时创建许愿]  [放弃修改]                                                                        |
|                                                                                                                  |
+------------------------------------------------------------------------------------------------------------------+
| 输入框区域:                                                                                                      |
| +----------------------------------------------------------------------------------------------+ [发送 / Enter]  |
| | 描述异常现象、粘贴日志行、或询问集群组件配置... (支持 Shift+Enter 换行)                       | [上传脱敏日志]  |
| +----------------------------------------------------------------------------------------------+                 |
+------------------------------------------------------------------------------------------------------------------+

2.2 移动端 (390px)

  • 形态:单列自适应流,顶部紧凑状态栏,底部固定输入条。
+---------------------------------------+
| [=] WishForge          [资源告警 (1)] |
+---------------------------------------+
| Copilot 问题诊断 · 生产环境           |
|---------------------------------------|
| 10:24 用户                            |
| 生产切片任务报 504 错误...            |
|                                       |
| 10:25 Copilot                         |
| 诊断发现显存溢出及网关 30s 超时截断。  |
|                                       |
| [依据: 视频切片.md:42]                |
| [日志: Pod slice-worker-x9 OOM]       |
|                                       |
| +-----------------------------------+ |
| | [!] 告警: fanyu-gpu-01 内存超限   | |
| +-----------------------------------+ |
|                                       |
| [转成许愿 (Wish)] [复制诊断]          |
|                                       |
| ------------------------------------- |
| 10:28 Copilot                         |
| [!] 置信度不足:                      |
| 调大内存涉及【高风险】集群超卖。      |
|                                       |
| [仅为网关超时提许愿]                  |
+---------------------------------------+
| [ 输入问题或日志...         ] [发送]  |
+---------------------------------------+

3. 四态定义 (States Definition)

  1. 正常态 (Normal):
    • 气泡区分清晰:用户提问居右(中性浅灰底),Copilot 回答居左(纯白底 + 1px Slate-200 边框 + 左侧 3px Teal-700 标记线)。
    • 「依据确凿」:展示绿色微标及可点击的代码/Wiki锚点。
    • 「不确定」:展示黄红警戒卡片,前景色 Amber-700,底色 Amber-50,明确标示知识库盲区与人工核实建议。
  2. 加载中态 (Loading):
    • 输入框发送按钮变为 LoaderCircle (spin) 态,禁用输入。
    • 对话流尾部追加 Copilot 思考气泡:展示骨架波纹(3 行渐变骨架条,脉冲呼吸动效),附最简文案「正在检索 Wiki 规则与集群事件…」。
  3. 空数据态 (Empty):
    • 首次进入或清空对话后,主屏居中展示微图标 Bot,主标题「输入现象或日志开始诊断」,副标题「已挂载当前项目 Wiki 与集群只读监控」。
    • 下方提供 3 个快速排查建议胶囊按钮(如:「切片任务超时排查」、「查看今日 OOMKilled Pod」、「检查网关 Ingress 状态」)。
  4. 错误态 (Error):
    • 若调用 API 超时或 Token 耗尽:气泡内渲染红色弱底警示栏「暂时无法完成诊断推演 (网络连接超时)」,提供单动作按钮「重新生成」。

页面 2:许愿进度 (Run 详情)

1. 业务职责与交互流

  • 定位:客户跟踪单一许愿从「意图澄清 -> 独立沙箱编码 -> 自动化验证 -> 门禁检查 -> 交付报告」全生命周期的核心看板。
  • 核心组件:
    1. 顶部 Header:目标 (Goal)、分支 (Branch)、触发人、执行器(如 Claude Code)、实时状态;
    2. 阶段时间线 (Timeline):串联意图澄清、沙箱运行、自动化验证、代码审查、待确认;
    3. 风险等级徽标 (Risk Level Badge):动态计算并醒目标注 Low / Medium / High;
    4. 门禁结果矩阵 (Gates Grid):展示 G1 新鲜度门、G2 验证门、G3 基线门、G4 风险分级门等通过情况;
    5. 交付报告四栏 (Four-column Delivery Report):依据 droboticflow 经验沉淀的四栏核验清单:
      • 通过项 (Passed)
      • 失败项 (Failed)
      • 待验证项 (Pending Verification)
      • 未做项 (Out of Scope / Skipped)

2. 界面线框与布局 (Wireframes)

2.1 桌面端 (1440px)

+------------------------------------------------------------------------------------------------------------------+
| TopNav: WishForge  / 运行记录 / RUN-20261109-082                                                     [返回列表]  |
+------------------------------------------------------------------------------------------------------------------+
| PageHeader:                                                                                                      |
| 运行 RUN-20261109-082                                                        [风险等级: 中风险 (Medium)] [运行状态: 待发布确认] |
| 目标:调整视频切片算子超时从 30s 至 60s,并修正网关代理 Ingress 匹配前缀                                            |
| 元信息: 分支 `wishforge/slice-timeout-60s` | 执行器: Claude Code (沙箱运行) | 耗时: 3m 42s | 触发人: 张工 (客户)      |
+------------------------------------------------------------------------------------------------------------------+
| 阶段时间线 (Timeline):                                                                                            |
| (✓) 1. 意图澄清        (✓) 2. 沙箱执行          (✓) 3. 自动化验证        (✓) 4. 防事故门禁        (●) 5. 发布确认      |
|     已对齐验收标准 3 条     改动 2 文件 +14/-3        用例 18/18 通过          G1~G4 全部核准           等待客户负责人审批  |
+------------------------------------------------------------------------------------------------------------------+
| 主内容区栅格 (2:1 左右分栏):                                                                                      |
|                                                                     |                                            |
| [左栏 66%]: 交付报告与证据核验                                       | [右栏 33%]: 防事故门禁结果                 |
| +-----------------------------------------------------------------+ | +----------------------------------------+ |
| | 交付核查四栏报告 (Delivery Ledger)                                | | | 门禁自检结果 (Security Gates)          | |
| |-----------------------------------------------------------------| | |----------------------------------------| |
| | [√ 通过项 (Passed) - 3]                                         | | | [✓ PASS] G1 新鲜度门 (Freshness)        | |
| |   • 视频切片算子超时环境变量配置支持 DEFAULT_TIMEOUT_SECS=60s    | | |   对齐线上 origin/dev 最新提交 877307c     | |
| |   • tests/operators/slice.test.ts 单元测试通过                  | | | [✓ PASS] G2 自动化验证门 (Verify Gate)   | |
| |   • 编译与类型检查 (typecheck) 无错误                           | | |   退出码 0,生成结构化 JSON 证据包         | |
| |-----------------------------------------------------------------| | | [✓ PASS] G3 基线完整门 (Baseline)       | |
| | [× 失败项 (Failed) - 0]                                         | | |   未篡改 known-failures / 未删减断言       | |
| |   无失败项                                                      | | | [! WARN] G4 风险定级门 (Risk Level)      | |
| |-----------------------------------------------------------------| | |   评级: 中风险 (修改网关路由配置)          | |
| | [? 待验证项 (Pending Verification) - 1]                         | | |   权限要求: 需客户团队负责人双重确认       | |
| |   • 线上 4K 巨型视频切片实测需在真实环境观察 (退出码 2)          | | +----------------------------------------+ |
| |-----------------------------------------------------------------| |                                            |
| | [- 没做/延期项 (Out of Scope) - 1]                              | | [代码变更摘要 (Diff Summary)]             | |
| |   • 节点物理内存配额未修改(已拆出独立工单处理)                | | +----------------------------------------+ |
| +-----------------------------------------------------------------+ | | k8s/ingress-nginx.yaml        +4 / -1  | |
|                                                                     | | docs/operators/视频切片.md    +10 / -2 | |
| [代码改动审阅 (Diff Viewer)]:                                       | | [查看完整 Diff 比对 (2 文件)]          | |
| +-----------------------------------------------------------------+ | +----------------------------------------+ |
| | @@ -42,3 +42,5 @@ proxy-read-timeout: 30s                       |                                            |
| | -      proxy-read-timeout: "30s"                                | [操作入口]                                 |
| | +      proxy-read-timeout: "60s"                                | [前往发布确认页面 ->]                      |
| +-----------------------------------------------------------------+ | [终止任务 / 丢弃分支]                     |
+------------------------------------------------------------------------------------------------------------------+

2.2 移动端 (390px)

+---------------------------------------+
| [< 返回] 运行详情 #082                |
+---------------------------------------+
| 调整视频切片算子超时至 60s            |
| 状态: 待发布确认 | [中风险徽标]        |
| 分支: wishforge/slice-timeout-60s     |
|---------------------------------------|
| 阶段: 4/5 步 (自动化验证已过)         |
| 耗时: 3m 42s | 执行器: Claude Code    |
|---------------------------------------|
| 门禁自检结果 (G1~G4):                 |
| [✓] G1 新鲜度对齐                     |
| [✓] G2 验证通过 (exit 0)              |
| [✓] G3 测试基线未动                   |
| [!] G4 评级: 中风险                   |
|---------------------------------------|
| 交付四栏报告:                         |
| [✓ 通过 - 3 项]                       |
|   • 环境变量超时支持 60s              |
|   • slice.test.ts 跑通                |
|   • typecheck 通过                    |
| [? 待验证 - 1 项]                     |
|   • 4K 巨型切片需实测                 |
| [- 没做 - 1 项]                       |
|   • 节点物理配额超卖未改              |
|---------------------------------------|
| 改动文件: 2 个 (+14 / -3)             |
| [查看代码 Diff]                       |
|---------------------------------------|
| [ 前往发布确认页面 (主按钮) ]         |
+---------------------------------------+

3. 四态定义 (States Definition)

  1. 正常态 (Normal):
    • 风险徽标根据级别渲染专属样式:低风险(绿色小盾牌)、中风险(橙黄盾牌)、高风险(刺目红盾牌 + 加粗实线)。
    • 四栏报告以卡片矩阵展示,分类明确,不可折叠隐藏重要未做/待验证项。
  2. 加载中态 (Loading):
    • 顶部 Header 显示 2 条骨架条。
    • 时间线与四栏报告区域渲染 4 块 wf-pulse 灰色占位方块,保持高度 320px,防止内容跳动。
  3. 空数据态 (Empty):
    • 任务刚创建尚未进入执行队列时:时间线第一步高亮,下方四栏报告区域展示空卡片,文案「执行器准备中,等待沙箱启动与分支检出…」。
  4. 错误态 (Error):
    • 若 G2 验证失败或命令超时(退出码 124):时间线第 3 步标记红叉 (X),四栏报告「失败项」置顶并展开红色终端日志框,展示最近 50 行错误输出与一键「向 Copilot 发起修复」快捷按钮。

页面 3:发布确认 (Release Review & Approval)

1. 业务职责与交互流

  • 定位:变更投入运行环境(测试/生产)前的最后一道安全门。
  • 决策规则:
    • 低/中风险:由客户团队负责人(如张工)自主核验并单人批准。
    • 高风险:涉及数据库改动、权限升级、超卖超出节点余量、副本缩为 0 等,必须平台方技术管理员(Platform Admin)与客户负责人双人批准,普通客户界面明确禁用批准按钮并注明原因。
  • 核心组件:
    1. 改动摘要(文件清单、影响服务、镜像 Digest);
    2. 风险等级评定与依据拆解;
    3. 审批权限说明(明确指出「谁能批准」);
    4. 验证证据链(集成测试退出码、沙箱命令报告);
    5. 醒目的生产「一键回滚」与版本切换按钮。

2. 界面线框与布局 (Wireframes)

2.1 桌面端 (1440px)

+------------------------------------------------------------------------------------------------------------------+
| TopNav: WishForge  / 发布与审批 / REL-20261109-019                                                   [查看发布列表] |
+------------------------------------------------------------------------------------------------------------------+
| PageHeader:                                                                                                      |
| 部署发布确认 · 生产环境 (Production)                                          [当前状态: 待审批 (Awaiting Approval)] |
| 绑定运行: RUN-082 (调整切片超时至 60s) | 目标环境: fanyu-production | 目标镜像: droboticflow/api@sha256:7f9a8c...   |
+------------------------------------------------------------------------------------------------------------------+
| 风险与审批权限决策看板 (Approval Authority Banner):                                                               |
| +--------------------------------------------------------------------------------------------------------------+ |
| | [ShieldAlert] 风险综合评定:中风险 (Medium Risk)                                                            | |
| | 判定依据:修改了网关路由超时配置 (k8s/ingress-nginx.yaml),无数据库 Schema 变更,无权限放大。                 | |
| | 审批权限:【客户负责人】即可独立批准发布                                                                     | |
| | 当前操作员身份:张工 (客户团队负责人) · 具备批准权限                                                          | |
| +--------------------------------------------------------------------------------------------------------------+ |
|                                                                                                                  |
| 主区域分栏栅格 (左右 1:1 或 7:5):                                                                                 |
|                                                                                                                  |
| [左栏]: 改动摘要与制品溯源                                           | [右栏]: 验证证据与审批操作                 |
| +-----------------------------------------------------------------+ | +----------------------------------------+ |
| | 改动明细 (Changeset)                                            | | | 自动化验证证据 (Verification Evidence)   | |
| |-----------------------------------------------------------------| | |----------------------------------------| |
| | • Git 目标基准: dev (877307c) -> 分支 wishforge/slice-timeout   | | | • 单元测试验证: 18 passed, 0 failed        | |
| | • 变更统计: 2 个文件修改,新增 14 行,删除 3 行                  | | | • 验证环境: 沙箱隔离 Pod (seatbelt 容器)   | |
| | • 制品镜像: droboticflow/api:v1.4.2-patch01                     | | | • 证据校验包: SHA-256 (e3b0c44298fc...)   | |
| |   镜像摘要: sha256:7f9a8c12... (已完成完整性签名验证)            | | | • 冒烟测试时长: 1m 15s (退出码: 0)         | |
| |-----------------------------------------------------------------| | +----------------------------------------+ |
| | 变更影响的服务组件:                                             | |                                            |
| | 1. droboticflow-api (滚动更新,副本数 2 -> 2)                   | | [双重确认与批准操作区]                     | |
| | 2. ingress-controller (配置热重载,无中断)                      | | +----------------------------------------+ |
| +-----------------------------------------------------------------+ | | [ ] 我已仔细核对变更摘要与关联证据       | |
|                                                                     | | [ ] 确认已获知当前为生产环境发布         | |
| [历史版本与快速回滚准备]:                                           | |                                          | |
| +-----------------------------------------------------------------+ | | [ 批准并立即部署上线 (Primary) ]        | |
| | 当前运行版本: v1.4.1 (REL-018,发布于 3 天前)                   | | [ 驳回本次发布请求 (Secondary) ]          | |
| | 紧急预案: 如部署后指标异常,可随时点击下方回滚按钮:            | | +----------------------------------------+ |
| | [ 预置回滚至 v1.4.1 按钮 (琥珀黄描边) ]                         | |                                            |
+------------------------------------------------------------------------------------------------------------------+

2.2 移动端 (390px)

+---------------------------------------+
| [< 返回] 发布审批 REL-019             |
+---------------------------------------+
| 生产环境发布确认                      |
| 状态: 待审批 | 评级: [中风险]          |
|---------------------------------------|
| 审批权限提示:                         |
| 客户负责人即可批准。                  |
| 你的身份: 张工 (具备权限)             |
|---------------------------------------|
| 改动摘要:                             |
| • 分支: wishforge/slice-timeout       |
| • 文件: 2 个 (+14 / -3)               |
| • 镜像: ...sha256:7f9a8c              |
| • 影响服务: droboticflow-api (2副本)  |
|---------------------------------------|
| 验证证据:                             |
| • 自动化测试通过 (18 用例, exit 0)    |
| • 完整性校验通过 (SHA-256 匹配)       |
|---------------------------------------|
| [√] 我已核对代码与证据                |
|                                       |
| [ 批准并立即发布 (高亮大按钮) ]       |
| [ 驳回发布请求 ]                      |
|                                       |
| ------------------------------------- |
| 应急保障:                             |
| [ 紧急回滚至上一版本 (v1.4.1) ]       |
+---------------------------------------+

3. 四态定义 (States Definition)

  1. 正常态 (Normal):
    • 明确突出「谁能批准」:若为高风险,卡片显示红框「必须平台方审批」,下方批准按钮禁用,附文案「等待平台方运维介入」;若为低/中风险,允许客户负责人一键勾选复选框并点击「批准」。
    • 回滚按钮常驻在页面底部,次要幽灵/警告样式,防止误触,但紧急时刻 1 秒内可定位。
  2. 加载中态 (Loading):
    • 点击批准后,按钮进入 busy 态(内置 Spinner,文案变为「正在提交控制面部署流水线…」)。
    • 页面顶部浮现渐变进度条。
  3. 空数据态 (Empty):
    • 访问 /releases 且当前无待审批任务时:展示绿色勾选卡片,标题「所有发布均已完成」,副标题「当前环境运行版本与最新审批一致」,附「查看历史发布记录」链接。
  4. 错误态 (Error):
    • 审批提交失败(如:租约过期、代码冲突或权限不足):弹窗或在操作区上方展示固定 ErrorNotice:「发布审批失败:目标环境锁定,已有并发部署正在进行中」,附重试与刷新按钮。

页面 4:集群资源 (Cluster Resources)

1. 业务职责与交互流

  • 定位:客户与平台方透视底层物理算力、服务健康度、存储状态与超卖风险的专业仪表盘。
  • 业务数据实况 (真实基准):
    • 总物理节点:3 台物理/虚拟机:
      • 1 台大节点:56 核 CPU / 220 GiB 内存 / 2 张 GPU (NVIDIA A100)
      • 2 台小节点:8 核 CPU / 31 GiB 内存(合计 16 核 / 62 GiB,无 GPU)
    • 超卖特征:两台小节点严重承载基础设施,Requests 虽未超,但 Limits 合计已达 CPU 178%(严重超卖)、内存 93%(濒临 OOM 危险阈值)。
  • 核心组件:
    1. 顶部总账 (Cluster Overview Ledger):CPU、内存、GPU、存储四大仪表,严格并列展示 5 个数值:
      • 总量 (Total Capacity)
      • 保底已占 (Requests)
      • 最坏情况 (Limits)
      • 实际在用 (Actual Used)
      • 剩余可用 (Available Free)
    2. 节点列表 (Nodes Grid):展示 3 个节点的 CPU/内存/GPU 详细占用,当 Limits > 100% 时,以刺目警示色突出展示超卖倍数(如 1.78x 超卖);
    3. 服务列表 (Services & Workloads):每个服务包含用途说明、副本数、使用率占上限比例、重启与 OOM 次数、实时健康告警;
    4. 存储卷 (Persistent Volumes):存储卷挂载路径、容量、使用率、读写模式;
    5. 快捷入口:「问 Copilot」诊断入口常驻,支持一键将当前集群水位数据作为 Prompt 带入 Copilot。

2. 界面线框与布局 (Wireframes)

2.1 桌面端 (1440px)

+------------------------------------------------------------------------------------------------------------------+
| TopNav: WishForge  / 集群资源监控 (Cluster Infrastructure)                            [问 Copilot 排查资源] [刷新] |
+------------------------------------------------------------------------------------------------------------------+
| PageHeader:                                                                                                      |
| 集群算力与服务总账                                                            [集群状态: 存在超卖告警 (Warning)]  |
| 3 个节点在线 | 2 张 GPU 就绪 | 运行 8 个关键微服务 | 数据基于只读 ServiceAccount 实时采集                         |
+------------------------------------------------------------------------------------------------------------------+
| 顶部四大核心资源总账 (Overview Ledger - 4 列卡片):                                                                |
| +--------------------------------------------------------------------------------------------------------------+ |
| | [CPU 算力总账]         | [内存容量总账]       | [GPU 算力 (专用)]     | [集群共享存储 (NFS/Local)]               | |
| | 总量: 72 核            | 总量: 282 GiB        | 总量: 2 张 (A100)     | 总量: 2.0 TiB                            | |
| | 保底(Req): 38 核 (52%) | 保底(Req): 142 GiB   | 保底(Req): 1 张 (50%) | 实际在用: 840 GiB (41%)                  | |
| | 最坏(Lim): 94 核 (130%)| 最坏(Lim): 224 GiB   | 最坏(Lim): 2 张 (100%)| 剩余可用: 1.16 TiB                       | |
| | 实际在用: 26 核 (36%)  | 实际在用: 98 GiB     | 实际在用: 1 张 (50%)  | 挂载卷数: 6 个 PVC                       | |
| | 剩余空间: 34 核 (空闲) | 剩余空间: 140 GiB    | 剩余空间: 1 张 (空闲) | 状态: 读写正常                           | |
| | [!] 警示: Lim 已超卖   | 运行水位: 正常       | 运行水位: 充足        | 运行水位: 健康                           | |
| +--------------------------------------------------------------------------------------------------------------+ |
|                                                                                                                  |
| 节点明细 (Nodes Status - 突出超卖与瓶颈):                                                                         |
| +--------------------------------------------------------------------------------------------------------------+ |
| | 节点主机名          规格规格       CPU 分配 (Req / Lim / 超卖)   内存分配 (Req / Lim)    GPU   状态与告警     | |
| |--------------------------------------------------------------------------------------------------------------| |
| | node-big-01        56C / 220Gi    22C (39%) / 48C (85%) / 0.85x 90Gi (40%) / 160Gi(72%) 2/2   [√ 健康]        | |
| | node-small-01 (小) 8C / 31Gi      8C (100%) / 23C [178% 超卖!]  26Gi (83%) / 29Gi (93%) 0/0   [! 内存超卖告警] | |
| | node-small-02 (小) 8C / 31Gi      8C (100%) / 23C [178% 超卖!]  26Gi (83%) / 29Gi (93%) 0/0   [! 内存超卖告警] | |
| +--------------------------------------------------------------------------------------------------------------+ |
|                                                                                                                  |
| 服务与负载列表 (Workloads & Pods):                                                                                |
| +--------------------------------------------------------------------------------------------------------------+ |
| | 服务名称             用途说明            副本数  CPU/内存占上限比例      重启/OOM 计数  健康状态   操作        | |
| |--------------------------------------------------------------------------------------------------------------| |
| | droboticflow-api    业务主接口与调度    2 / 2   CPU 12% | 内存 42%      0 / 0          [√ 正常]   [查看日志]  | |
| | droboticflow-worker 异步标注切片计算    2 / 2   CPU 78% | 内存 89%      3 次 / 2 OOM   [! 告警]   [问 Copilot]| |
| | drosync-coordinator 同步协同与心跳      1 / 1   CPU 5%  | 内存 18%      0 / 0          [√ 正常]   [查看日志]  | |
| | headpose-inference  姿态推理模型容器    1 / 1   GPU 80% | 内存 64%      0 / 0          [√ 正常]   [查看指标]  | |
| | mongodb-cluster     业务数据主从实例    1 / 1   只读受控挂载            0 / 0          [√ 只读]   [监控]      | |
| +--------------------------------------------------------------------------------------------------------------+ |
|                                                                                                                  |
| 存储卷与数据资产 (Storage Volumes):                                                                               |
| +--------------------------------------------------------------------------------------------------------------+ |
| | PVC 名称                 挂载服务               挂载路径                 容量大小      使用率      读写模式     | |
| |--------------------------------------------------------------------------------------------------------------| |
| | pvc-video-raw-data       droboticflow-worker    /data/raw-videos         1.0 TiB       45% (健康)  ReadWriteMany| |
| | pvc-model-qwen-cache     headpose-inference     /root/.cache/modelscope  500 GiB       68% (健康)  ReadOnlyMany | |
| | pvc-mongo-storage        mongodb-cluster        /data/db                 200 GiB       28% (健康)  ReadWriteOnce| |
| +--------------------------------------------------------------------------------------------------------------+ |
+------------------------------------------------------------------------------------------------------------------+

2.2 移动端 (390px)

+---------------------------------------+
| [=] 集群资源总账        [问 Copilot]  |
+---------------------------------------+
| 集群容量总览:                         |
| • CPU:  72核 | Req 52% | Lim 130%(超) |
| • 内存: 282Gi| Req 50% | Lim 79%      |
| • GPU:  2张 (A100) | 在用 1 张        |
| • 存储: 2.0TiB | 已用 840GiB (41%)    |
|---------------------------------------|
| 物理节点状态 (3):                     |
| [!] node-small-01 (8C/31Gi)           |
|     CPU Limits: 178% [严重超卖]       |
|     内存 Limits: 93%  [频临 OOM]      |
|                                       |
| [!] node-small-02 (8C/31Gi)           |
|     CPU Limits: 178% [严重超卖]       |
|                                       |
| [√] node-big-01 (56C/220Gi/2GPU)      |
|     运行健康,负载 40%                |
|---------------------------------------|
| 服务异常监控:                         |
| [!] droboticflow-worker               |
|     切片计算 | 副本 2/2               |
|     内存 89% | 重启 3次 (2次 OOM)     |
|     [点击一键诊断此服务]              |
|                                       |
| [√] 其余 7 个微服务运行平稳           |
|---------------------------------------|
| 存储卷概况: 6 个 PVC 全部就绪         |
+---------------------------------------+

3. 四态定义 (States Definition)

  1. 正常态 (Normal):
    • 顶部四个总账卡片整齐排列,清晰列出「总量、Requests、Limits、实际用量、剩余」。
    • 当小节点 Limits 超过 100% 时,字体自动由常规灰黑色转为高饱和橙黄色,超卖倍数标签增加实线边框(如 1.78x 超卖),Hover 弹出轻量 Tooltip 说明「容器极限配置超额,峰值并发下可能触发内核降频或 OOM 驱逐」。
    • OOM 计数大于 0 的服务自动置顶并显示醒目的红点。
  2. 加载中态 (Loading):
    • 四个指标卡片显示 60px 高的灰色骨架块。
    • 节点列表与服务列表显示为 4 行透明度呼吸过渡的表格骨架,防止数据刷新时的卡顿跳动。
  3. 空数据态 (Empty):
    • 仅在未配置只读 ServiceAccount 时发生:屏幕展示盾牌插图,标题「集群资源监控未接入」,副标题「尚未配置集群只读 ServiceAccount 或 Kubeconfig」,下方提供「查看接入文档」按钮。
  4. 错误态 (Error):
    • K8s API 访问受阻或网络超时:保留最后一次成功的缓存数据并在顶部浮起黄色警示条「控制面数据同步延迟(10:25:00 缓存数据)」,右侧放置「立即重连」按钮。

4. 全栈工程师实现顺序与验收标准 (Implementation Guide & Acceptance Criteria)

4.1 推荐落地实现顺序 (Milestones)

[M1: 规范入库与 UI 组件升级] -> [M2: 集群资源监控页] -> [M3: 发布审批流改造] -> [M4: Run 详情与四栏报告] -> [M5: Copilot 面板增强]
  1. Milestone 1:设计系统变量引入与基础组件改造 (2 天)
    • 将 docs/design/tokens.md 中的 CSS 变量注入 apps/web/src/app/globals.css 头部;
    • 升级 apps/web/src/components/ui.tsx:为 Button、EmptyState、Status 补齐对应样式与骨架屏组件 Skeleton;
    • 确保原有页面完全向后兼容,无样式崩塌。
  2. Milestone 2:集群资源页新建 (features/cluster-resources.tsx) (2 天)
    • 纯前端依据本设计稿的文字线框与网格搭建页面骨架;
    • 严格实现「顶部总账五大数值(总量、Req、Lim、用量、剩余)」与「小节点超卖醒目警示」;
    • 接入现有只读 ServiceAccount 聚合接口。
  3. Milestone 3:发布确认页审批逻辑改造 (features/releases.tsx) (2 天)
    • 增加「风险等级与审批权限决策看板」;
    • 依据 risk.ts 实施严格的按钮拦截:高风险仅允许平台方批准,低/中风险开放给客户负责人;
    • 强化生产环境回滚入口。
  4. Milestone 4:Run 详情页四栏报告与时间线重构 (features/runs.tsx) (2.5 天)
    • 重构信息架构:将垂直堆叠改为「左侧交付四栏清单 + 右侧门禁矩阵」;
    • 严格落地「通过项、失败项、待验证项、未做项」四栏布局。
  5. Milestone 5:Copilot 面板结构化卡片与依据链适配 (features/copilot.tsx) (2 天)
    • 引入「置信度不足/依据不足」警示卡片;
    • 代码依据高亮(文件:行号);
    • 一键将诊断结论带入「转成许愿」表单。

4.2 严格验收标准 (Acceptance Criteria)

全栈工程师交付 PR 时,必须按以下四项门槛逐条核对并提供证据:

  1. 双断点严格适配 (1440px & 390px):
    • 桌面端 (1440px 视口):核心内容容器居中或全屏响应,无留白失控或文字过长不易阅读的问题,栅格分栏比例严格符合设计稿。
    • 移动端 (390px 视口):所有表格必须自适应卡片化(Cardify)或优雅折叠,绝对严禁出现页面级横向滚动条(Horizontal Scrollbar);按钮点击热区高度 ≥ 38px。
  2. 四态闭环检查 (4 States Completed):
    • 交付的 4 个核心页面,每个页面都必须包含完整的代码处理路径:
      • 正常态 (Normal):数据渲染整洁,文案遵循最简文案规范;
      • 加载中态 (Loading):必须呈现结构匹配的脉冲骨架屏,拒绝单一全局 Spinner,保证页面加载无剧烈跳动;
      • 空数据态 (Empty):有语义明确的业务图标、简明描述和明确恢复操作入口;
      • 错误态 (Error):提供友好、无黑话的错误提示条与重试/重新连接按钮。
  3. 状态截图归档 (Visual Evidence):
    • 在开发机或测试环境浏览器中,完成 4 个页面 × 2 种宽度(1440、390)× 4 种状态的界面走查与截图留存,按规范归档到 docs/verification/ 目录下备查。
  4. 静态类型与构建检查 (Typecheck & Lint Pass):
    • 运行 npm run typecheck(或 turbo run typecheck)一次性通过,TypeScript 0 error;
    • 运行前端基础单测与构建检查,无 regression 错误。