docs: define instance list columns task

2026-07-22 16:19:56 +08:00
parent dbbb5c0e98
commit c11a64f931
3 changed files with 38 additions and 1 deletions
@@ -0,0 +1,36 @@
+---
+id: T-208
+title: 固化实例列表字段与启动操作列
+phase: 2
+deps: [T-201]
+status: TODO
+created: 2026-07-22
+owner: codex
+---
+
+## 需求与背景
+
+实例页必须让用户在同一行中直接看到启动和管理浏览器所需的最小信息，当前列表缺少明确的用户数据目录字段和表头契约。
+
+## 方案与边界
+
+- Gio 实例列表使用固定五列：实例名称、浏览器类型、用户数据目录、状态、启动。
+- `InstanceRow` 增加稳定 ID 和 User Data Dir；恢复实例与新建实例均填充该字段。
+- 启动按钮按实例 ID 持有独立 Clickable，不能复用单一按钮状态或依赖列表索引。
+- 当前 BrowserManager 尚未接入时，点击启动只提供明确的非阻塞反馈，不伪造浏览器已启动；真正启动逻辑属于 application adapter。
+- 列表不引入行选择、多选或排序，保持当前 MVP 范围；状态仍使用文字和颜色共同表达。
+
+## 验收要点
+
+- 每行和表头都按“实例名称、浏览器类型、用户数据目录、状态、启动”顺序显示。
+- User Data Dir 从配置恢复和新建表单传入。
+- 启动按钮拥有逐行独立状态并有可见反馈。
+- `go test ./...`、`go vet ./...`、Windows 构建通过。
+
+## 执行记录
+
+- 状态：TODO
+- 变更：已建立列表字段和操作列契约。
+- 验证：待实现。
+- 阻塞：无。
+- 残余风险：真实启动仍需要 BrowserManager application adapter。