feat: add local cdp startup and external association

docs/04-architecture.md

@@ -30,7 +30,7 @@ UI/CLI 不直接操作 `exec.Cmd`、Win32 handle 或数据库。Application 层
 
 `CREATED -> STARTING -> RUNNING -> STOPPING -> EXITED`；启动失败为 `FAILED`，无法确认的外部实例为 `UNKNOWN`。
 
-- Start：规范化路径和参数，先检查 user data dir。未占用时从配置的起始端口选择可用 loopback 端口，注册 pending 后以受控的 `--remote-debugging-address=127.0.0.1` 和 `--remote-debugging-port` 启动，并以 `DevToolsActivePort` 与 `/json/version` 验证实际端点。
+- Start：规范化路径和参数，先检查 user data dir。未占用时从配置的起始端口选择可用 loopback 端口，注册 pending 后以受控的 `--remote-debugging-address=127.0.0.1` 和 `--remote-debugging-port` 启动，并直接请求该已知端口的 `/json/version` 验证实际端点。
 - 外部关联：目录被占用时只检查该目录中的 `DevToolsActivePort` 和其 loopback `/json/version`；端点与浏览器类型均匹配才报告 `EXTERNAL_ASSOCIATED`，不注册、关闭、重启或强制终止该 PID。无法验证时保持 `UNKNOWN`/占用并拒绝启动。
 - Stop：校验身份，优先窗口关闭/浏览器协议，超时后经明确授权强制终止。
 - Force stop：使用实例 Job Object 或已校验进程树，不按名称全局终止。

docs/06-tasks.md

@@ -37,7 +37,7 @@
 | ID | 任务 | 依赖 | 状态 |
 | --- | --- | --- | --- |
 | T-301 | 接入 GUI 启动操作与实例删除确认 | T-204,T-208 | DONE |
-| T-302 | 本地 CDP 启动、外部关联与实例端口展示 | T-102,T-301 | DOING |
+| T-302 | 本地 CDP 启动、外部关联与实例端口展示 | T-102,T-301 | DONE |
 
 ## Backlog
 

docs/current-state.md

@@ -3,12 +3,11 @@
 ## 快照
 
 - 日期：2026-07-25
-- 阶段：Phase 3 真实实例操作（T-302 进行中；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、T-301 已完成
-- UI：Gio 双页 Shell 使用左侧“实例/设置”导航；实例列表固定显示实例名称、浏览器类型、用户数据目录、状态和紧凑启动/删除图标。启动通过异步回调接到 Windows 浏览器启动器，并显示启动中、运行中或失败；删除使用确认弹层，只删除 Chub 实例配置而不删除 User Data Dir。新建和删除实例会保存到本地配置；四个设置路径有独立异步可取消搜索，切换页面后输入和任务状态保留；新建实例表单使用 Label、Windows 原生目录选择器和 Chrome/Edge RadioButton；CLI `list/events` 已可用，`start/stop/restart` 等待 BrowserManager adapter
+- 阶段：Phase 3 真实实例操作（T-302、T-301 已完成；T-201 至 T-208 已完成）
+- 代码：已建立 Go module `chub`、`cmd/chub` 入口、logging 测试基座、浏览器 domain/application 合约、Chrome/Edge 参数/发现模块、启动 registry、Windows 身份/占用检查、loopback CDP 端口分配与端点校验、优雅关闭、Job Object、真实 Chrome/Edge smoke、JSON 配置存储、启动恢复、CLI JSON 合约、应用内事件总线、UI 状态测试和 Windows smoke 脚本，T-001 至 T-003、T-101 至 T-104、T-201 至 T-208、T-301、T-302 已完成
+- UI：Gio 双页 Shell 使用左侧“实例/设置”导航；实例列表固定显示实例名称、浏览器类型、用户数据目录、调试端口、状态和紧凑启动/删除图标，并以外层边框和表头分隔组织。启动通过异步回调接到 Windows 浏览器启动器：未占用目录从已保存的起始端口（空值默认 9666）选择 loopback CDP 端口；同目录外部浏览器只有在 `DevToolsActivePort` 与 CDP 端点可验证时才显示“外部已关联”，且不会接管其生命周期。删除使用确认弹层，只删除 Chub 实例配置而不删除 User Data Dir。新建和删除实例会保存到本地配置；四个设置路径有独立异步可取消搜索，切换页面后输入和任务状态保留；新建实例表单使用 Label、Windows 原生目录选择器和 Chrome/Edge RadioButton；CLI `list/events` 已可用，`start/stop/restart` 等待 BrowserManager adapter
 - 浏览器核心：设计参考来自 `D:\OPC\shop_helm\internal\platform\chrome`，尚未复制或接入本项目
-- 当前任务：T-302 正在为托管实例接入 loopback CDP 端口分配、同目录外部浏览器的只读关联、实例列表端口字段和设置中的远程调试起始端口；外部关联不接管进程生命周期。
-- blocker：无；T-302 完成后可继续接入关闭、重启、退出状态回传和 CLI BrowserManager adapter。
+- blocker：无；下一步可接入关闭、重启、退出状态回传和 CLI BrowserManager adapter。
 
 ## 当前目录
 

docs/tasks/T-302.md

@@ -3,7 +3,7 @@ id: T-302
 title: 本地 CDP 启动、外部关联与实例端口展示
 phase: 3
 deps: [T-102, T-301]
-status: DOING
+status: DONE
 created: 2026-07-25
 owner: codex
 ---
@@ -17,7 +17,7 @@ Chub 需要为新启动的 Chrome/Edge 分配仅限 loopback 的 remote debuggin
 ## 方案与边界
 
 - `LaunchSpec` 将 remote debugging port 作为受控领域字段；`BuildArgs` 固定生成 `--remote-debugging-address=127.0.0.1` 和 `--remote-debugging-port=<port>`，额外参数继续不得覆盖。
-- 平台端从保存的起始端口开始，在最多 100 个端口范围中探测可用候选；启动后等待 `DevToolsActivePort` 并请求 loopback `/json/version`，只有验证成功才把该端口写入运行时结果。端口探测与浏览器绑定之间存在竞争时，不自动杀死或重复启动浏览器。
+- 平台端从保存的起始端口开始，在最多 100 个端口范围中探测可用候选；启动后直接请求该已知 loopback 端口的 `/json/version`，只有验证成功才把该端口写入运行时结果。端口探测与浏览器绑定之间存在竞争时，不自动杀死或重复启动浏览器。
 - 启动前先合并 Chub launcher registry 与 Windows 外部 profile inspector 结果。目录被外部占用时，只读取该目录的 `DevToolsActivePort`，不扫描全系统 Chrome/Edge 进程或端口。
 - 外部端点验证失败、端口文件过期、权限不足或浏览器类型不匹配时，保守报告外部/未知占用并拒绝启动；不得借此接管外部 PID。
 - Gio 设置增加带 Label 和帮助文本的“远程调试起始端口”数字输入；空值在保存时归一化为 `9666`，有效值为 `1024` 至 `65535`。
@@ -36,8 +36,8 @@ Chub 需要为新启动的 Chrome/Edge 分配仅限 loopback 的 remote debuggin
 
 ## 执行记录
 
-- 状态：DOING
-- 变更：已建立需求、架构、API、交互、原型和任务契约；待实现。
-- 验证：文档待实现验证。
+- 状态：DONE
+- 变更：`LaunchSpec` 新增受控 remote debugging port 并固定生成 loopback 参数；设置持久化并恢复起始端口（空值/旧配置默认 9666）；新增端口递增、`DevToolsActivePort` 解析和 `/json/version` 浏览器类型校验。GUI 启动链路会拒绝未验证的外部占用、关联可验证的外部实例、展示 PID/端口/来源，并将端口作为列表边框内的独立字段。真实 smoke 以已知端口校验 Chrome/Edge CDP，并在任意失败路径按 profile 清理测试进程。
+- 验证：`gofmt`、`go test ./...`、`go vet ./...`、`go build -o build/chub.exe ./cmd/chub`、`scripts/smoke-browser.ps1`（真实 Chrome/Edge loopback CDP）和 `scripts/smoke-windows.ps1` 均通过。
 - 阻塞：无。
-- 残余风险：Chrome 默认用户目录可能忽略 remote debugging 开关；端口预探测存在不可消除的短暂竞争，最终以端点验证为准。
+- 残余风险：Chrome 默认用户目录可能忽略 remote debugging 开关；端口预探测存在不可消除的短暂竞争，最终以端点验证为准。外部浏览器未留下 `DevToolsActivePort` 时，Chub 不会猜测或扫描端口以避免把其他 profile 的 CDP 端点错误关联，只报告外部占用。