docs: define executable picker feedback repair

2026-07-27 22:35:59 +08:00
parent 0f25f39480
commit bc35bb0f3d
9 changed files with 61 additions and 5 deletions
@@ -49,6 +49,16 @@ GUI 将优雅停止封装为异步 `InstanceStopper(ctx, InstanceRow) error` ada

 状态刷新、受管进程退出、目录选择和 CDP 页面目标读取必须通过后台 adapter 回到 UI 结果通道；UI frame 不直接做进程、文件或 CDP I/O。受管退出结果至少包含实例 ID、启动代次、受管 PID、退出码和是否为 Chub 请求停止；UI 以实例 ID、代次和 PID 丢弃过期结果。刷新和页面目标读取都不构成外部实例接管授权。

+设置页浏览器 executable 选择使用 platform 文件选择契约；它不发现、启动、关闭或检查浏览器进程：
+
+```go
+type ExecutablePicker interface {
+    ChooseExecutable(ctx context.Context) (string, error)
+}
+```
+
+Windows 实现只返回绝对 `.exe` 路径；用户取消返回可识别的取消错误。UI 在后台调用该契约，并以 `PathField` 和请求代次丢弃过期结果。选择成功才改写对应 Chrome/Edge 字段；同字段的搜索/选择状态和文字反馈必须独立保存，不能依赖页面底部的全局消息。
+
 Windows 通知区域使用仅限 platform 的内部 DTO；Gio shell 不直接调用 Shell API：

 ```go