cdp_hub/docs/tasks/T-307.md

id, title, phase, deps, status, created, owner

id	title	phase	deps	status	created	owner
T-307	受管浏览器意外退出监控与状态提示	3	T-101 T-305 T-306	DOING	2026-07-25	codex

需求与背景

当前刷新操作可以检查已保存实例的状态，但 Chub 已启动的浏览器被用户手动关闭、崩溃或被外部结束后，GUI 不会立即反馈。用户需要知道对应 Chrome/Edge 已退出，并能安全地重新启动它；这一能力不得变成扫描或接管外部浏览器的通道。

方案与边界

• 仅在当前 Chub 应用会话中，为成功启动并注册的 Chrome/Edge 根进程建立一个后台 Wait 监控；每个实例最多一个监控 goroutine。外部已关联、外部占用、未知占用和应用启动前已存在的进程均不监控、不提示。
• 退出结果必须携带稳定实例 ID、启动代次、受管 PID、退出码和 expectedStop 标记。UI 只接受仍与当前运行时记录完全匹配的结果，忽略删除、重启或再次启动后的迟到结果。
• 监控到意外退出时，先将实例运行时状态改为“已退出”并清空 PID、端口和归属，再排队显示信息提示。提示使用事实性文案“检测到‘实例名’的 Chrome/Edge 已退出”，不声称能区分手动关闭、崩溃或任务管理器结束；说明配置与 User Data Dir 未被删除。
• 提示只有“知道了”操作，Enter/Escape 都可关闭；关闭后焦点返回对应实例的启动按钮。多个实例同时退出时合并显示，已有编辑、未保存确认或删除确认弹层时延后显示，不能叠加或夺走用户输入。
• Chub 请求的优雅停止属于预期退出：停止结果与退出监控只产生一次最终状态，不显示意外退出提示。应用关闭时取消 UI 订阅/提示发布，但不能杀死浏览器；Wait 取消也不能隐式关闭进程。
• 运行时 PID、端口、退出码、启动代次和提示队列都不写入实例配置；日志和事件不含代理认证或浏览器私密数据。

验收要点

• 成功启动的受管 Chrome/Edge 进程意外结束后，不经 F5 就在合理时间内将对应实例改为“已退出”，启动操作恢复可用；外部状态与其他实例不变。
• 退出提示含实例名称、浏览器类型和“配置、User Data Dir 未删除”的恢复说明；关闭、Escape、Enter 后焦点回到该实例启动按钮。多个退出合并为一个提示。
• 主动停止不弹意外退出提示；停止失败、启动失败、外部关联、PID/代次不匹配、已删除实例、重启前一代退出和窗口关闭后的迟到事件均不改变新状态或弹窗。
• 监控、CDP/进程等待和结果发送均在后台；UI Frame 仅消费通道结果。没有按进程名枚举、终止或接管 Chrome/Edge 的逻辑。
• 覆盖受管退出、预期停止、重复/过期退出、启动后快速退出、多个退出、提示关闭/焦点恢复和应用关闭取消；gofmt、go test ./...、go vet ./...、go build -o build/chub.exe ./cmd/chub、scripts/smoke-browser.ps1 与 scripts/smoke-windows.ps1 通过。

执行记录

• 状态：DOING
• 变更：待实现。
• 验证：待执行。
• 阻塞：无。