2026-07-22 14:51:11 +08:00
|
|
|
# 架构设计
|
|
|
|
|
|
|
|
|
|
```text
|
|
|
|
|
Gio UI / CLI
|
|
|
|
|
↓ DTO + commands
|
|
|
|
|
Application BrowserManager
|
|
|
|
|
↓ ports
|
|
|
|
|
Platform Windows
|
|
|
|
|
├─ executable discovery
|
|
|
|
|
├─ launcher
|
|
|
|
|
├─ process identity / query
|
|
|
|
|
├─ graceful close / force kill
|
|
|
|
|
├─ Job Object
|
|
|
|
|
└─ profile occupancy inspector
|
2026-07-25 15:36:23 +08:00
|
|
|
├─ loopback CDP endpoint inspector
|
2026-07-25 16:21:38 +08:00
|
|
|
├─ remote-debug port allocator
|
|
|
|
|
└─ instance status refresher
|
2026-07-22 14:51:11 +08:00
|
|
|
↓
|
|
|
|
|
Chrome / Edge processes
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
UI/CLI 不直接操作 `exec.Cmd`、Win32 handle 或数据库。Application 层维护实例状态和授权边界；Platform 层只提供系统能力。
|
|
|
|
|
|
|
|
|
|
## 实例身份
|
|
|
|
|
|
2026-07-25 15:36:23 +08:00
|
|
|
每个实例至少记录 `instance_id`、browser kind、executable、root PID、user data dir、profile directory、非敏感参数摘要、关联的 loopback CDP 端口、归属（托管或外部关联）、创建时间、状态和退出码。
|
2026-07-22 14:51:11 +08:00
|
|
|
|
|
|
|
|
进程身份校验至少比较 PID 存活、executable、命令行中的规范化 `--user-data-dir` 和注册记录。无法确认身份时只能报告 UNKNOWN，不允许关闭。
|
|
|
|
|
|
|
|
|
|
## 生命周期
|
|
|
|
|
|
|
|
|
|
`CREATED -> STARTING -> RUNNING -> STOPPING -> EXITED`；启动失败为 `FAILED`，无法确认的外部实例为 `UNKNOWN`。
|
|
|
|
|
|
2026-07-25 15:53:31 +08:00
|
|
|
- Start：规范化路径和参数，先检查 user data dir。未占用时从配置的起始端口选择可用 loopback 端口，注册 pending 后以受控的 `--remote-debugging-address=127.0.0.1` 和 `--remote-debugging-port` 启动，并直接请求该已知端口的 `/json/version` 验证实际端点。
|
2026-07-25 15:36:23 +08:00
|
|
|
- 外部关联：目录被占用时只检查该目录中的 `DevToolsActivePort` 和其 loopback `/json/version`；端点与浏览器类型均匹配才报告 `EXTERNAL_ASSOCIATED`，不注册、关闭、重启或强制终止该 PID。无法验证时保持 `UNKNOWN`/占用并拒绝启动。
|
2026-07-22 14:51:11 +08:00
|
|
|
- Stop：校验身份，优先窗口关闭/浏览器协议，超时后经明确授权强制终止。
|
|
|
|
|
- Force stop：使用实例 Job Object 或已校验进程树，不按名称全局终止。
|
|
|
|
|
- Restart：旧实例退出或完成超时处理后重新执行同一配置。
|
|
|
|
|
- App shutdown：取消监控，不默认终止用户浏览器。
|
2026-07-25 16:21:38 +08:00
|
|
|
- Refresh：以 UI 传入的保存实例快照为范围，在后台读取 Chub registry、对应 profile 占用证据与已知 loopback CDP 端点，返回状态 DTO。刷新不按浏览器进程名或端口范围枚举；结果以实例 ID 与快照版本关联，UI 丢弃已删除或已编辑行的过期结果。
|
|
|
|
|
- Edit：UI 只提交可持久化的实例配置 DTO；运行时 PID、关联端口、占用来源和状态由刷新/启动结果返回，不作为编辑表单保存字段。编辑时保留未公开的非敏感启动选项，活跃或外部关联实例的身份约束字段保持只读。
|
2026-07-22 14:51:11 +08:00
|
|
|
|
2026-07-25 15:36:23 +08:00
|
|
|
Chrome 和 Edge 共用大部分 Chromium 参数，但 executable 默认路径、进程名称和安装方式不同，通过 `BrowserDefinition` 封装差异。CDP 端点只绑定 `127.0.0.1`；端口号和 `/json/version` 是诊断数据，WebSocket URL 不进入持久化、事件或普通 UI 文案。
|
2026-07-22 14:51:11 +08:00
|
|
|
|
|
|
|
|
## 风险
|
|
|
|
|
|
|
|
|
|
Chromium 可能复用已有进程；浏览器是多进程架构；管理员权限进程可能无法查询；强制终止可能损坏 profile；CDP 端口开放到非 loopback 会形成控制风险，MVP 默认关闭。
|
