238 lines
7.2 KiB
Markdown
238 lines
7.2 KiB
Markdown
# Scene Generator Ops Console Plan
|
||
|
||
> **Status:** Draft
|
||
> **Date:** 2026-04-18
|
||
> **Author:** Codex
|
||
> **Upstream Spec:** [2026-04-18-scene-generator-ops-console-design.md](D:/data/ideaSpace/rust/sgClaw/claw-new/docs/superpowers/specs/2026-04-18-scene-generator-ops-console-design.md)
|
||
|
||
## Plan Intent
|
||
|
||
本计划用于将 scene generator 页面从“开发调试控制台”收敛为“面向运维的场景 Skill 生成工作台”，并把上游 `spec` 中已经明确的信息架构、中文化、显隐分层和交互流程拆解为可执行的实施步骤。
|
||
|
||
本计划只覆盖前端页面层与页面交互层的收敛，不扩展到 scene generator 后端分析逻辑或生成协议改造。
|
||
|
||
## Scope Guardrails
|
||
|
||
本计划执行过程中，以下边界保持不变：
|
||
|
||
1. 不修改 scene generator 后端接口协议
|
||
2. 不重写分析算法或 Skill 生成逻辑
|
||
3. 不删除现有调试信息，只调整默认显隐与展示层次
|
||
4. 不把本计划扩展成新的前端设计系统建设
|
||
|
||
## Primary Outcome
|
||
|
||
本计划的直接目标是让运维人员不需要理解 `Scene IR`、`workflowArchetype`、`requestTemplate` 等底层术语，也能完成：
|
||
|
||
1. 选择场景目录
|
||
2. 启动分析
|
||
3. 判断是否可生成
|
||
4. 启动生成
|
||
5. 查看结果目录或失败原因
|
||
|
||
## Workstreams
|
||
|
||
本计划拆分为四条工作流：
|
||
|
||
1. `WS1` 信息架构与页面分层收敛
|
||
2. `WS2` 中文化与业务态映射
|
||
3. `WS3` 日志、结果与风险摘要收敛
|
||
4. `WS4` 调试信息折叠与双层体验收口
|
||
|
||
## Phase Overview
|
||
|
||
计划按五个阶段推进：
|
||
|
||
1. Phase 0：冻结页面目标与口径
|
||
2. Phase 1：完成信息架构重组
|
||
3. Phase 2：完成中文化和业务态映射
|
||
4. Phase 3：完成日志与结果区收敛
|
||
5. Phase 4：完成调试层折叠和整体验收
|
||
|
||
## Phase 0：冻结页面目标与口径
|
||
|
||
### Objective
|
||
|
||
先冻结该页面服务对象、默认使用模式、主状态表达与一级/二级/三级信息边界，避免实施过程中一边改布局一边改定位。
|
||
|
||
### Tasks
|
||
|
||
1. 固化页面角色定义：运维执行者优先，开发 / 调试者次级
|
||
2. 固化页面定位：运维工作台，而不是开发调试台
|
||
3. 固化默认模式：默认运维模式，技术详情折叠
|
||
4. 固化一级/二级/三级信息边界
|
||
5. 固化状态表达、场景类型映射和可执行性映射口径
|
||
|
||
### Deliverables
|
||
|
||
1. 页面角色说明
|
||
2. 信息层级边界说明
|
||
3. 状态与场景类型映射表
|
||
4. 显隐策略说明
|
||
|
||
### Exit Criteria
|
||
|
||
1. 页面默认服务对象不再摇摆
|
||
2. 一级信息与技术详情边界不再摇摆
|
||
3. 中文状态和类型映射口径冻结
|
||
|
||
## Phase 1：完成信息架构重组
|
||
|
||
### Objective
|
||
|
||
将当前“配置区 + 分析区 + 生成日志 + 技术字段混排”的页面结构，重组为运维可理解的工作台结构。
|
||
|
||
### Tasks
|
||
|
||
1. 重组顶部总览区
|
||
2. 重组左侧主操作区
|
||
3. 重组右侧结果摘要区
|
||
4. 重组底部执行过程区
|
||
5. 预留技术详情区并默认折叠
|
||
|
||
### Required Sections
|
||
|
||
首屏结构固定为：
|
||
|
||
1. 顶部总览区
|
||
2. 左侧主操作区
|
||
3. 右侧结果摘要区
|
||
4. 底部执行过程区
|
||
5. 技术详情区
|
||
|
||
### Deliverables
|
||
|
||
1. 页面区块结构实现
|
||
2. 区块标题与区块顺序实现
|
||
3. 一级流程的视觉主路径
|
||
|
||
### Acceptance Criteria
|
||
|
||
1. 首屏不再同时暴露大量技术细节
|
||
2. 运维默认流程可以按“选择目录 -> 分析 -> 生成 -> 查看结果”完成
|
||
3. 页面结构从“调试面板”转为“工作台”
|
||
|
||
## Phase 2：完成中文化和业务态映射
|
||
|
||
### Objective
|
||
|
||
将当前页面的大量英文标题、按钮和技术术语替换为面向运维的中文表述，并将底层技术状态映射为业务可读状态。
|
||
|
||
### Tasks
|
||
|
||
1. 替换页面标题、副标题和区块标题
|
||
2. 替换按钮文案和输入框占位文案
|
||
3. 替换日志标签文案
|
||
4. 建立 `Readiness` 中文映射
|
||
5. 建立 archetype 中文映射
|
||
|
||
### Required Mappings
|
||
|
||
最小映射集合包括：
|
||
|
||
1. `Readiness A/B/C -> 可直接生成 / 可生成但需确认 / 暂不建议生成`
|
||
2. `single_request_table -> 单页报表`
|
||
3. `multi_mode_request -> 多模式报表`
|
||
4. `paginated_enrichment -> 分页明细`
|
||
5. `page_state_eval -> 页面检测`
|
||
|
||
### Deliverables
|
||
|
||
1. 中文标题与按钮实现
|
||
2. 中文状态映射实现
|
||
3. 中文场景类型映射实现
|
||
4. 中文风险与结果文案实现
|
||
|
||
### Acceptance Criteria
|
||
|
||
1. 首屏不再出现大面积未翻译英文
|
||
2. 运维可直接理解主要状态和场景类型
|
||
3. 技术术语不再作为首页主文案
|
||
|
||
## Phase 3：完成日志与结果区收敛
|
||
|
||
### Objective
|
||
|
||
让页面日志和结果区优先服务“执行与排障”，而不是原始流式调试输出。
|
||
|
||
### Tasks
|
||
|
||
1. 将 `Generation Log` 改为 `执行过程`
|
||
2. 将 `status / log / complete / error` 标签中文化
|
||
3. 将原始流日志优先收敛为中文摘要日志
|
||
4. 完善 `生成结果` 区的成功/失败状态展示
|
||
5. 强化输出目录和结果文件入口
|
||
|
||
### Deliverables
|
||
|
||
1. 中文摘要日志
|
||
2. 生成结果卡片
|
||
3. 失败原因摘要
|
||
4. 输出目录入口
|
||
|
||
### Acceptance Criteria
|
||
|
||
1. 运维无需阅读底层 SSE 技术消息也能理解执行过程
|
||
2. 成功时能快速找到结果目录
|
||
3. 失败时能快速看到中文失败原因
|
||
|
||
## Phase 4：完成调试层折叠和整体验收
|
||
|
||
### Objective
|
||
|
||
保留开发与排障能力，但让其默认下沉为调试层，不干扰运维首屏使用。
|
||
|
||
### Tasks
|
||
|
||
1. 将 `Scene IR`、`requestTemplate`、`evidence`、`workflow steps` 等收入口技术详情区
|
||
2. 将 `scene-id`、`scene-kind`、`targetUrl override`、`workflow archetype override` 收入口高级设置
|
||
3. 校验默认显隐逻辑
|
||
4. 校验运维模式与调试模式体验边界
|
||
5. 完成最终页面口径验收
|
||
|
||
### Deliverables
|
||
|
||
1. 高级设置折叠区
|
||
2. 技术详情折叠区
|
||
3. 最终页面显隐策略实现
|
||
|
||
### Acceptance Criteria
|
||
|
||
1. 运维首页只承载状态摘要、操作与结果
|
||
2. 开发调试仍可通过折叠区查看完整技术信息
|
||
3. 不再出现“默认首屏就是技术调试面板”的体验
|
||
|
||
## File-Level Planning Targets
|
||
|
||
本计划后续实施至少覆盖以下资产：
|
||
|
||
1. [sg_scene_generator.html](D:/data/ideaSpace/rust/sgClaw/claw-new/frontend/scene-generator/sg_scene_generator.html)
|
||
2. 与页面展示文案和显隐逻辑相关的前端脚本
|
||
3. 与页面标题、区块结构和状态映射相关的前端样式与渲染逻辑
|
||
|
||
## Completion Criteria
|
||
|
||
本计划完成的标志为：
|
||
|
||
1. 页面默认形态已从“开发调试控制台”转为“运维工作台”
|
||
2. 首屏已完成中文化和业务态映射
|
||
3. 运维默认流程可在首屏完成，不依赖技术详情区
|
||
4. 调试信息仍保留，但不再默认淹没首页
|
||
5. 失败原因、风险提示和结果目录对运维可直接理解
|
||
|
||
## Risks and Control Points
|
||
|
||
1. 若只改文案不改信息架构，页面仍会保持臃肿
|
||
2. 若只隐藏字段不重做结果摘要，运维仍无法快速判断是否可生成
|
||
3. 若过度删除技术信息，会削弱开发与排障效率
|
||
4. 若状态映射不统一，页面会出现中文标题下仍夹杂底层技术语义的割裂感
|
||
|
||
## Out of Plan
|
||
|
||
以下事项不属于本计划直接交付范围：
|
||
|
||
1. scene generator 后端分析逻辑重构
|
||
2. Skill 生成协议变更
|
||
3. 页面服务端接口新增
|
||
4. 运维权限、账号体系或多角色权限控制
|