前端开发

前端结构

当前主要维护的新前端位于 web-console-dx/。

建议按下面的边界理解：

• src/api/ 后端接口访问层
• src/components/ 页面和展示组件
• src/stores/ 全局状态
• src/types/ 类型定义

聊天页右侧运行态约束

聊天页右侧的实时画面和执行进度，必须满足下面这些规则。

只能有一个运行态控制器

• 只允许页面层统一拉取和合并运行态
• 展示组件不能自己开 SSE、自己轮询、自己推断 task 或 session
• 当前唯一控制器是 web-console-dx/src/components/chat/chat_page.rs

UI 语义必须显式建模

不要再用 Option<String> 同时表达：

• Auto
• 没有值
• 未绑定

这类状态后续应收敛成显式枚举，例如：

enum SessionSelection {
    Auto,
    Explicit(String),
}

主链路先稳定，再加兜底

右侧数据优先顺序应该是：

1. session list
2. session snapshot
3. task status
4. task observations

不要一开始就堆多条并行兜底链路，否则问题会非常难定位。

前端改动前的最小检查项

每次修改聊天页右侧，至少确认：

1. Auto 模式行为是否明确
2. 新发送任务后是否绑定到当前 session
3. 执行中是否能同时显示 frame + steps
4. 执行完成后是否能显示最终状态
5. 刷新页面后是否还能恢复最近运行态