claw/docs/superpowers/plans/2026-04-18-scene-generator-ops-console-plan.md

Scene Generator Ops Console Plan

Status: Draft
Date: 2026-04-18
Author: Codex
Upstream Spec: 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
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. 运维权限、账号体系或多角色权限控制