cdp_hub/docs/tasks/T-002.md

id, title, phase, deps, status, created, owner

id	title	phase	deps	status	created	owner
T-002	固化浏览器领域、启动配置、实例状态和事件合约	0	T-001	DONE	2026-07-22	codex

需求与背景

UI 原型和 API 文档需要稳定的 Go 类型，后续平台适配不能自行定义浏览器类型、状态和错误语义。

方案与边界

• internal/domain/browser.go 定义浏览器类型、启动配置、实例视图、状态、事件和稳定错误码。
• LaunchSpec.Normalize() 只做基础安全校验：浏览器类型、绝对 user data dir、无 userinfo 的 http/https URL和字段规范化。
• internal/application/browser_manager.go 定义 BrowserManager、进程启动、进程身份、profile 检查和事件端口。
• 本任务不启动真实浏览器，不实现 Windows API 和实例 registry。

验收要点

• go test ./... 通过。
• go vet ./... 通过。
• 非法浏览器类型、相对 user data dir、非 http/https URL 和 URL userinfo 被拒绝。
• 业务层不依赖 os/exec 或 Windows handle。

执行记录

• 状态：DONE
• 变更：新增 domain/application 浏览器合约、Normalize 校验和回归测试，API 文档指向代码权威类型。
• 验证：gofmt、go test ./...、go vet ./... 均通过。
• 阻塞：无。
• 残余风险：代理 URL 和额外参数的完整校验留给 T-003。