docs: define managed browser exit monitoring

This commit is contained in:
QiuSW
2026-07-25 18:07:57 +08:00
parent 826bc5ce39
commit f5b5e95223
9 changed files with 90 additions and 7 deletions
+2 -2
View File
@@ -30,7 +30,7 @@ GUI 将优雅停止封装为异步 `InstanceStopper(ctx, InstanceRow) error` ada
参数数组由 `internal/platform/browser.BuildArgs` 生成;Chrome/Edge executable 由同包 `Discoverer.Resolve` 解析。二者都不接收 shell 命令行字符串。CDP 端点检测和端口分配均通过 platform port 执行,UI 只消费 DTO 结果。
状态刷新和目录选择必须通过后台 adapter 回到 UI 结果通道;UI frame 不直接做进程、文件或 CDP I/O。刷新不构成外部实例接管授权。
状态刷新、受管进程退出和目录选择必须通过后台 adapter 回到 UI 结果通道;UI frame 不直接做进程、文件或 CDP I/O。受管退出结果至少包含实例 ID、启动代次、受管 PID、退出码和是否为 Chub 请求停止;UI 以实例 ID、代次和 PID 丢弃过期结果。刷新不构成外部实例接管授权。
## CLI 当前合约
@@ -52,7 +52,7 @@ chub events
| --- | --- | --- |
| `browser.started` | 新实例完成启动 | InstanceView |
| `browser.status.changed` | 状态变化 | instance_id、status、pid、remote_debug_port、ownership、error_code |
| `browser.exited` | 进程退出 | instance_id、exit_code |
| `browser.exited` | Chub 当前会话受管根进程退出 | instance_id、launch_generation、pid、exit_code、expected_stop |
事件禁止携带密码、Cookie、Token、完整代理认证信息或原始系统堆栈。