docs: define gui instance operations task

2026-07-22 16:53:23 +08:00
parent d4c5a89e2b
commit 46578c8743
3 changed files with 45 additions and 2 deletions
@@ -32,6 +32,12 @@
 | T-207 | 接入新建实例的 Windows 目录选择器 | T-206 | DONE |
 | T-208 | 固化实例列表字段与启动操作列 | T-201 | DONE |

+## Phase 3：真实实例操作
+
+| ID | 任务 | 依赖 | 状态 |
+| --- | --- | --- | --- |
+| T-301 | 接入 GUI 启动操作与实例删除确认 | T-204,T-208 | DOING |
+
 ## Backlog

 CDP tab/window 管理、导入导出启动配置、进程资源监控、多用户权限和远程主机管理。
@@ -3,11 +3,11 @@
 ## 快照

 - 日期：2026-07-22
- 阶段：Phase 2 产品外壳（T-201 至 T-208 已完成）
+- 阶段：Phase 3 真实实例操作（T-301 进行中；T-201 至 T-208 已完成）
 - 代码：已建立 Go module `chub`、`cmd/chub` 入口、logging 测试基座、浏览器 domain/application 合约、Chrome/Edge 参数/发现模块、启动 registry、Windows 身份/占用检查、优雅关闭、Job Object、真实 Chrome/Edge smoke、JSON 配置存储、启动恢复、CLI JSON 合约、应用内事件总线、UI 状态测试和 Windows smoke 脚本，T-001 至 T-003、T-101 至 T-104、T-201 至 T-208 已完成
 - UI：Gio 双页 Shell 使用左侧“实例/设置”导航；实例列表固定显示实例名称、浏览器类型、用户数据目录、状态和启动；四个设置路径有独立异步可取消搜索，切换页面后输入和任务状态保留；新建实例表单使用 Label、Windows 原生目录选择器和 Chrome/Edge RadioButton；CLI `list/events` 已可用，`start/stop/restart` 等待 BrowserManager adapter
 - 浏览器核心：设计参考来自 `D:\OPC\shop_helm\internal\platform\chrome`，尚未复制或接入本项目
- blocker：无；下一步可进入 BrowserManager application adapter，以及设置页路径选择器和真实 UI 操作接线。
+- blocker：无；T-301 正在接入 GUI 的真实启动操作、实例配置同步和删除确认。

 ## 当前目录

@@ -0,0 +1,37 @@
+---
+id: T-301
+title: 接入 GUI 启动操作与实例删除确认
+phase: 3
+deps: [T-204, T-208]
+status: DOING
+created: 2026-07-22
+owner: codex
+---
+
+## 需求与背景
+
+实例列表的启动图标当前只显示“等待 BrowserManager 接入”的反馈，未调用浏览器启动器；删除图标会立即移除记录，用户无法确认操作对象和影响。
+
+## 方案与边界
+
+- Gio Shell 定义异步实例启动回调，点击后将该行置为“启动中”，结果回到 UI 线程后显示“运行中”或“启动失败”；重复点击同一行不重复发起启动。
+- 组合根（`cmd/chub`）使用已验证的 `browser.NewOSLauncher`、浏览器发现器和当前设置中的可执行文件构造 `LaunchSpec`；UI 不直接执行 I/O 或 `exec`。
+- 启动 URL 保持可选：为空时不附加 URL 参数，让浏览器打开默认页。
+- 删除先显示窗口级确认弹层，明确实例名称和“不会删除 User Data Dir”；取消不改变记录，确认后才移除并持久化实例配置。
+- 本任务只接入启动与实例配置删除，不实现关闭、重启、外部进程接管或 CLI BrowserManager adapter。
+
+## 验收要点
+
+- 启动 Chrome/Edge 时浏览器进程实际被启动，UI 显示启动中、运行中或可恢复的失败信息。
+- 同一实例启动中再次点击不会创建第二个启动请求。
+- 删除弹层提供“取消”和“删除”；取消保留记录，确认后只删除 Chub 实例配置，保留 User Data Dir。
+- 新建和删除实例都会同步到本地配置。
+- `go test ./...`、`go vet ./...`、Windows build/smoke 通过。
+
+## 执行记录
+
+- 状态：DOING
+- 变更：待实施。
+- 验证：待实施。
+- 阻塞：无。
+- 残余风险：实际浏览器启动将受本机可执行文件、目录权限和 profile 占用状态影响。