41 KiB
41 KiB
WishForge 核心页面线框与交互规范 (Page Designs)
文档版本:1.0.0
设计目标:依据《界面文案规范》(参考 droboticflowcopy-guidelines.md最简文案原则)与《设计规范与令牌》(docs/design/tokens.md),为 WishForge 四个核心关键页面提供像素级落地的文字线框、网格布局、断点自适应(桌面 1440px / 移动端 390px)与四态闭环定义(正常、加载中、空数据、错误)。
页面 1:问题诊断 (Copilot 面板)
1. 业务职责与交互流
- 定位:客户定位生产与测试环境异常的首要入口。通过输入日志片段或现象描述,Copilot 结合只读只取脱敏日志、集群事件与项目 Wiki 进行推理诊断。
- 核心组件:
- 诊断对话流(流式输出、免责置信度标注);
- 引用依据(精准到
文件:行号或 Wiki 条目外链); - 「依据不足 / 不确定」的警戒警示框与免责说明;
- 一键「转成许愿 (Create Wish)」带入上下文的快捷表单;
- 关联的集群实时资源告警卡片(如 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)
- 正常态 (Normal):
- 气泡区分清晰:用户提问居右(中性浅灰底),Copilot 回答居左(纯白底 + 1px Slate-200 边框 + 左侧 3px Teal-700 标记线)。
- 「依据确凿」:展示绿色微标及可点击的代码/Wiki锚点。
- 「不确定」:展示黄红警戒卡片,前景色 Amber-700,底色 Amber-50,明确标示知识库盲区与人工核实建议。
- 加载中态 (Loading):
- 输入框发送按钮变为
LoaderCircle (spin)态,禁用输入。 - 对话流尾部追加 Copilot 思考气泡:展示骨架波纹(3 行渐变骨架条,脉冲呼吸动效),附最简文案「正在检索 Wiki 规则与集群事件…」。
- 输入框发送按钮变为
- 空数据态 (Empty):
- 首次进入或清空对话后,主屏居中展示微图标
Bot,主标题「输入现象或日志开始诊断」,副标题「已挂载当前项目 Wiki 与集群只读监控」。 - 下方提供 3 个快速排查建议胶囊按钮(如:「切片任务超时排查」、「查看今日 OOMKilled Pod」、「检查网关 Ingress 状态」)。
- 首次进入或清空对话后,主屏居中展示微图标
- 错误态 (Error):
- 若调用 API 超时或 Token 耗尽:气泡内渲染红色弱底警示栏「暂时无法完成诊断推演 (网络连接超时)」,提供单动作按钮「重新生成」。
页面 2:许愿进度 (Run 详情)
1. 业务职责与交互流
- 定位:客户跟踪单一许愿从「意图澄清 -> 独立沙箱编码 -> 自动化验证 -> 门禁检查 -> 交付报告」全生命周期的核心看板。
- 核心组件:
- 顶部 Header:目标 (Goal)、分支 (Branch)、触发人、执行器(如 Claude Code)、实时状态;
- 阶段时间线 (Timeline):串联意图澄清、沙箱运行、自动化验证、代码审查、待确认;
- 风险等级徽标 (Risk Level Badge):动态计算并醒目标注 Low / Medium / High;
- 门禁结果矩阵 (Gates Grid):展示 G1 新鲜度门、G2 验证门、G3 基线门、G4 风险分级门等通过情况;
- 交付报告四栏 (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)
- 正常态 (Normal):
- 风险徽标根据级别渲染专属样式:低风险(绿色小盾牌)、中风险(橙黄盾牌)、高风险(刺目红盾牌 + 加粗实线)。
- 四栏报告以卡片矩阵展示,分类明确,不可折叠隐藏重要未做/待验证项。
- 加载中态 (Loading):
- 顶部 Header 显示 2 条骨架条。
- 时间线与四栏报告区域渲染 4 块
wf-pulse灰色占位方块,保持高度 320px,防止内容跳动。
- 空数据态 (Empty):
- 任务刚创建尚未进入执行队列时:时间线第一步高亮,下方四栏报告区域展示空卡片,文案「执行器准备中,等待沙箱启动与分支检出…」。
- 错误态 (Error):
- 若 G2 验证失败或命令超时(退出码 124):时间线第 3 步标记红叉
(X),四栏报告「失败项」置顶并展开红色终端日志框,展示最近 50 行错误输出与一键「向 Copilot 发起修复」快捷按钮。
- 若 G2 验证失败或命令超时(退出码 124):时间线第 3 步标记红叉
页面 3:发布确认 (Release Review & Approval)
1. 业务职责与交互流
- 定位:变更投入运行环境(测试/生产)前的最后一道安全门。
- 决策规则:
- 低/中风险:由客户团队负责人(如张工)自主核验并单人批准。
- 高风险:涉及数据库改动、权限升级、超卖超出节点余量、副本缩为 0 等,必须平台方技术管理员(Platform Admin)与客户负责人双人批准,普通客户界面明确禁用批准按钮并注明原因。
- 核心组件:
- 改动摘要(文件清单、影响服务、镜像 Digest);
- 风险等级评定与依据拆解;
- 审批权限说明(明确指出「谁能批准」);
- 验证证据链(集成测试退出码、沙箱命令报告);
- 醒目的生产「一键回滚」与版本切换按钮。
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)
- 正常态 (Normal):
- 明确突出「谁能批准」:若为高风险,卡片显示红框「必须平台方审批」,下方批准按钮禁用,附文案「等待平台方运维介入」;若为低/中风险,允许客户负责人一键勾选复选框并点击「批准」。
- 回滚按钮常驻在页面底部,次要幽灵/警告样式,防止误触,但紧急时刻 1 秒内可定位。
- 加载中态 (Loading):
- 点击批准后,按钮进入
busy态(内置 Spinner,文案变为「正在提交控制面部署流水线…」)。 - 页面顶部浮现渐变进度条。
- 点击批准后,按钮进入
- 空数据态 (Empty):
- 访问
/releases且当前无待审批任务时:展示绿色勾选卡片,标题「所有发布均已完成」,副标题「当前环境运行版本与最新审批一致」,附「查看历史发布记录」链接。
- 访问
- 错误态 (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)
- 1 台大节点:
- 超卖特征:两台小节点严重承载基础设施,Requests 虽未超,但 Limits 合计已达 CPU 178%(严重超卖)、内存 93%(濒临 OOM 危险阈值)。
- 总物理节点:3 台物理/虚拟机:
- 核心组件:
- 顶部总账 (Cluster Overview Ledger):CPU、内存、GPU、存储四大仪表,严格并列展示 5 个数值:
总量 (Total Capacity)保底已占 (Requests)最坏情况 (Limits)实际在用 (Actual Used)剩余可用 (Available Free)
- 节点列表 (Nodes Grid):展示 3 个节点的 CPU/内存/GPU 详细占用,当 Limits > 100% 时,以刺目警示色突出展示超卖倍数(如 1.78x 超卖);
- 服务列表 (Services & Workloads):每个服务包含用途说明、副本数、使用率占上限比例、重启与 OOM 次数、实时健康告警;
- 存储卷 (Persistent Volumes):存储卷挂载路径、容量、使用率、读写模式;
- 快捷入口:「问 Copilot」诊断入口常驻,支持一键将当前集群水位数据作为 Prompt 带入 Copilot。
- 顶部总账 (Cluster Overview Ledger):CPU、内存、GPU、存储四大仪表,严格并列展示 5 个数值:
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)
- 正常态 (Normal):
- 顶部四个总账卡片整齐排列,清晰列出「总量、Requests、Limits、实际用量、剩余」。
- 当小节点 Limits 超过 100% 时,字体自动由常规灰黑色转为高饱和橙黄色,超卖倍数标签增加实线边框(如
1.78x 超卖),Hover 弹出轻量 Tooltip 说明「容器极限配置超额,峰值并发下可能触发内核降频或 OOM 驱逐」。 - OOM 计数大于 0 的服务自动置顶并显示醒目的红点。
- 加载中态 (Loading):
- 四个指标卡片显示 60px 高的灰色骨架块。
- 节点列表与服务列表显示为 4 行透明度呼吸过渡的表格骨架,防止数据刷新时的卡顿跳动。
- 空数据态 (Empty):
- 仅在未配置只读 ServiceAccount 时发生:屏幕展示盾牌插图,标题「集群资源监控未接入」,副标题「尚未配置集群只读 ServiceAccount 或 Kubeconfig」,下方提供「查看接入文档」按钮。
- 错误态 (Error):
- K8s API 访问受阻或网络超时:保留最后一次成功的缓存数据并在顶部浮起黄色警示条「控制面数据同步延迟(10:25:00 缓存数据)」,右侧放置「立即重连」按钮。
4. 全栈工程师实现顺序与验收标准 (Implementation Guide & Acceptance Criteria)
4.1 推荐落地实现顺序 (Milestones)
[M1: 规范入库与 UI 组件升级] -> [M2: 集群资源监控页] -> [M3: 发布审批流改造] -> [M4: Run 详情与四栏报告] -> [M5: Copilot 面板增强]
- Milestone 1:设计系统变量引入与基础组件改造 (2 天)
- 将
docs/design/tokens.md中的 CSS 变量注入apps/web/src/app/globals.css头部; - 升级
apps/web/src/components/ui.tsx:为Button、EmptyState、Status补齐对应样式与骨架屏组件Skeleton; - 确保原有页面完全向后兼容,无样式崩塌。
- 将
- Milestone 2:集群资源页新建 (
features/cluster-resources.tsx) (2 天)- 纯前端依据本设计稿的文字线框与网格搭建页面骨架;
- 严格实现「顶部总账五大数值(总量、Req、Lim、用量、剩余)」与「小节点超卖醒目警示」;
- 接入现有只读 ServiceAccount 聚合接口。
- Milestone 3:发布确认页审批逻辑改造 (
features/releases.tsx) (2 天)- 增加「风险等级与审批权限决策看板」;
- 依据
risk.ts实施严格的按钮拦截:高风险仅允许平台方批准,低/中风险开放给客户负责人; - 强化生产环境回滚入口。
- Milestone 4:Run 详情页四栏报告与时间线重构 (
features/runs.tsx) (2.5 天)- 重构信息架构:将垂直堆叠改为「左侧交付四栏清单 + 右侧门禁矩阵」;
- 严格落地「通过项、失败项、待验证项、未做项」四栏布局。
- Milestone 5:Copilot 面板结构化卡片与依据链适配 (
features/copilot.tsx) (2 天)- 引入「置信度不足/依据不足」警示卡片;
- 代码依据高亮(
文件:行号); - 一键将诊断结论带入「转成许愿」表单。
4.2 严格验收标准 (Acceptance Criteria)
全栈工程师交付 PR 时,必须按以下四项门槛逐条核对并提供证据:
- 双断点严格适配 (1440px & 390px):
- 桌面端 (1440px 视口):核心内容容器居中或全屏响应,无留白失控或文字过长不易阅读的问题,栅格分栏比例严格符合设计稿。
- 移动端 (390px 视口):所有表格必须自适应卡片化(Cardify)或优雅折叠,绝对严禁出现页面级横向滚动条(Horizontal Scrollbar);按钮点击热区高度 ≥ 38px。
- 四态闭环检查 (4 States Completed):
- 交付的 4 个核心页面,每个页面都必须包含完整的代码处理路径:
- 正常态 (Normal):数据渲染整洁,文案遵循最简文案规范;
- 加载中态 (Loading):必须呈现结构匹配的脉冲骨架屏,拒绝单一全局 Spinner,保证页面加载无剧烈跳动;
- 空数据态 (Empty):有语义明确的业务图标、简明描述和明确恢复操作入口;
- 错误态 (Error):提供友好、无黑话的错误提示条与重试/重新连接按钮。
- 交付的 4 个核心页面,每个页面都必须包含完整的代码处理路径:
- 状态截图归档 (Visual Evidence):
- 在开发机或测试环境浏览器中,完成 4 个页面 × 2 种宽度(1440、390)× 4 种状态的界面走查与截图留存,按规范归档到
docs/verification/目录下备查。
- 在开发机或测试环境浏览器中,完成 4 个页面 × 2 种宽度(1440、390)× 4 种状态的界面走查与截图留存,按规范归档到
- 静态类型与构建检查 (Typecheck & Lint Pass):
- 运行
npm run typecheck(或turbo run typecheck)一次性通过,TypeScript 0 error; - 运行前端基础单测与构建检查,无 regression 错误。
- 运行