docs: define local cdp association task

docs/api.md

@@ -4,7 +4,9 @@ MVP 首先提供本地 Go application service 和 CLI；是否增加 loopback HT
 
 ## 核心类型
 
-代码权威类型位于 `internal/domain/browser.go`：`BrowserKind`、`LaunchSpec`、`InstanceStatus`、`InstanceView`、`BrowserEvent` 和稳定错误码。`LaunchSpec.Normalize()` 负责当前已确定的 browser kind、绝对 user data dir，以及非空时的 http/https URL 校验；空 URL 表示打开浏览器默认页。
+代码权威类型位于 `internal/domain/browser.go`：`BrowserKind`、`LaunchSpec`、`InstanceStatus`、`InstanceView`、`BrowserEvent` 和稳定错误码。`LaunchSpec.Normalize()` 负责 browser kind、绝对 user data dir、受控的 loopback remote debugging port，以及非空时的 http/https URL 校验；空 URL 表示打开浏览器默认页。
+
+`LaunchSpec` 使用已分配的 `RemoteDebugPort`；端口分配不属于 UI，也不允许由 `ExtraArgs` 覆盖。`InstanceView` 返回实际关联端口、PID、占用来源和归属。外部关联只公开经 `DevToolsActivePort` 与 `/json/version` 验证的端口，不公开 CDP WebSocket URL。
 
 ## Application service
 
@@ -22,7 +24,7 @@ type BrowserManager interface {
 
 平台实现通过实例级 `StopProfile(userDataDir, force)` 执行关闭；force 只对已注册并经过身份绑定的实例生效。
 
-参数数组由 `internal/platform/browser.BuildArgs` 生成；Chrome/Edge executable 由同包 `Discoverer.Resolve` 解析。二者都不接收 shell 命令行字符串。
+参数数组由 `internal/platform/browser.BuildArgs` 生成；Chrome/Edge executable 由同包 `Discoverer.Resolve` 解析。二者都不接收 shell 命令行字符串。CDP 端点检测和端口分配均通过 platform port 执行，UI 只消费 DTO 结果。
 
 ## CLI 当前合约
 
@@ -43,7 +45,7 @@ chub events
 | 事件 | 触发 | 负载 |
 | --- | --- | --- |
 | `browser.started` | 新实例完成启动 | InstanceView |
-| `browser.status.changed` | 状态变化 | instance_id、status、pid、error_code |
+| `browser.status.changed` | 状态变化 | instance_id、status、pid、remote_debug_port、ownership、error_code |
 | `browser.exited` | 进程退出 | instance_id、exit_code |
 
 事件禁止携带密码、Cookie、Token、完整代理认证信息或原始系统堆栈。