Files
cdp_hub/docs/08-interaction-checklist.md
T

2.9 KiB
Raw Blame History

交互清单

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

通用规则

  • 异步操作不阻塞窗口线程,提交中禁用重复按钮。
  • 危险操作说明影响范围,默认焦点在取消;Escape 可取消。
  • 进程状态同时使用文字、图标和颜色,不只用颜色表达。
  • 关闭完成后焦点回到实例行;失败时保留表单和用户输入。
  • 验证 960x640、600x500、100%–200% 缩放、键盘、深色和高对比度回退。
  • 不依赖悬停或触控手势完成关键任务。
  • 实例列表使用外层边框、文字状态和图标区分归属;端口为空时显示“—”,外部关联时操作区不显示关闭或重启。
  • 刷新和编辑是独立命令:刷新为只读状态检查,编辑只保存配置;两者均不接管外部实例。F5 与刷新按钮共用一个去重命令。
  • 双击不是唯一入口:单击只选择行,Enter 和编辑图标打开对话框。打开后焦点位于名称,关闭后返回调用行;有未保存编辑时 Escape 先请求确认。
  • 代理选择器必须提供“无代理”和命名项,能用键盘选择;代理端点只展示已校验的无认证 scheme://host:port,删除有引用的项时保持当前表单与实例选择不变。
  • 实例主操作根据归属和状态切换启动、停止、重新检测或禁用。停止中禁止重复请求;停止失败恢复原状态并保留焦点。外部关联不显示停止入口。