# 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. 运维权限、账号体系或多角色权限控制