cdp_hub/docs/08-interaction-checklist.md

交互清单

ID	页面/组件	交互	状态覆盖	优先级
IX-001	实例列表	新建、启动、刷新、查看详情	加载、空、托管运行、外部已关联、外部占用、退出、失败	P0
IX-002	启动表单	浏览器类型、路径、user data dir、URL、参数校验	默认、校验错误、提交中、成功	P0
IX-003	实例详情	优雅关闭、强制终止、重启	运行中、关闭中、超时确认、权限错误	P0
IX-004	占用提示	查看 PID/来源和关联端口并重试	外部已关联、被占用、身份未知、已释放	P0
IX-005	设置	默认路径、日志、数据目录和远程调试起始端口	保存成功、路径无效、端口无效、权限拒绝	P1
IX-006	本地 CDP 启动	从起始端口分配、校验端点、展示实际端口	分配中、已关联、端口冲突、端点失效、外部不接管	P1
IX-007	实例刷新与编辑	F5/刷新、双击/Enter/编辑图标、目录选择、保存/取消/Escape	空闲、刷新中、部分失败、字段错误、脏表单、只读运行态、保存成功	P1
IX-008	代理设置与选择器	完整地址下拉选择、新增/更新、删除确认；创建/编辑实例选择代理	空列表、无代理、格式错误、重复地址、删除取消、被引用删除、保存成功	P1
IX-009	实例主启停操作	主操作、编辑、删除的固定顺序与间距；启动图标、停止图标、外部重新检测	已退出、启动中、托管运行、停止中、失败恢复、外部关联	P1
IX-010	受管浏览器退出提示	受管根进程退出后的状态恢复、提示队列和焦点回归	意外退出、Chub 请求停止、多个同时退出、过期事件、编辑/确认弹层打开、应用关闭	P1

通用规则

• 异步操作不阻塞窗口线程，提交中禁用重复按钮。
• 危险操作说明影响范围，默认焦点在取消；Escape 可取消。
• 进程状态同时使用文字、图标和颜色，不只用颜色表达。
• 关闭完成后焦点回到实例行；失败时保留表单和用户输入。
• 验证 960x640、600x500、100%–200% 缩放、键盘、深色和高对比度回退。
• 不依赖悬停或触控手势完成关键任务。
• 实例列表使用外层边框、文字状态和图标区分归属；端口为空时显示“—”，外部关联时操作区不显示关闭或重启。
• 刷新和编辑是独立命令：刷新为只读状态检查，编辑只保存配置；两者均不接管外部实例。F5 与刷新按钮共用一个去重命令。
• 双击不是唯一入口：单击只选择行，Enter 和编辑图标打开对话框。打开后焦点位于名称，关闭后返回调用行；有未保存编辑时 Escape 先请求确认。
• 代理选择器必须提供“无代理”和完整地址项，能用键盘选择；设置页默认输入为空，选择项回填地址。删除前先确认完整地址；有引用时保持当前选择、输入与实例选择不变。
• 实例主操作根据归属和状态切换启动、停止、重新检测或禁用，并固定排在编辑和删除之前。停止中禁止重复请求；停止失败恢复原状态并保留焦点。外部关联不显示停止入口；行内图标间距与命中区必须避免误操作。
• 受管浏览器意外退出是当前会话的异步状态提示，不是用户确认决策：状态先更新为“已退出”，再显示可关闭信息弹层；弹层只含“知道了”，Escape/Enter 均可关闭，关闭后焦点回到对应启动入口。多个退出合并到一个提示；已有编辑、未保存确认或删除确认弹层时排队，不能丢弃输入或叠加模态层。Chub 发起停止、外部实例、代次/PID 不匹配和应用退出取消监控时均不提示。