browser: 面板失联(无 ack)后 browser_open/tabs 均不可用,降级 headless 路径自相矛盾 #19

已关闭
由 fourbroad 于 2026-11-22 10:31:41 +08:00创建 · 1 评论
所有者

现象(today-portal PR#34 会话实测,2026-11-22)

desktop pane 心跳掉线后:

  1. browser_navigate / browser_tabs list 均 10s 无 ack,报 pane-unreachable(预期内)
  2. 错误指引说「call browser_open once 可 re-bind」——但 browser_open(默认 pane 面)也报 no-browser-surface,45s 等待后仍失败
  3. 唯一逃生路径是 browser_open surface:"headless" 显式开无头页,但随后的 browser_evaluate 仍钉在 pane 路由报 pane-unreachable——还须再调一次 browser_pane_release 才真正落到无头面

问题

  • 指引与实际能力矛盾:提示「retry browser_open」但 pane 面 open 在无心跳时必然失败
  • surface 面切换不一致:headless 面已显式打开,后续读写却仍路由到 pane,需要用户授权语义的 browser_pane_release 才完成切换——两步之间状态悬空

建议

pane 无 ack 且 browser_open 也失败时:

  • 错误指引改为「显式 surface:"headless" 打开 + browser_pane_release 解绑」的完整序列,或
  • browser_open surface:"headless" 成功后自动把会话读写路由一并切到 headless(带 surface flip 披露),省掉显式 release 的悬空态

影响

面板掉线时验证流程卡壳 3-4 次重试,且无 ack 错误信息重复冗长(同一段指引复读三遍)。

## 现象(today-portal PR#34 会话实测,2026-11-22) desktop pane 心跳掉线后: 1. `browser_navigate` / `browser_tabs list` 均 10s 无 ack,报 pane-unreachable(预期内) 2. 错误指引说「call browser_open once 可 re-bind」——但 `browser_open`(默认 pane 面)也报 no-browser-surface,45s 等待后仍失败 3. 唯一逃生路径是 `browser_open surface:"headless"` 显式开无头页,但随后的 `browser_evaluate` 仍钉在 pane 路由报 pane-unreachable——还须再调一次 `browser_pane_release` 才真正落到无头面 ## 问题 - 指引与实际能力矛盾:提示「retry browser_open」但 pane 面 open 在无心跳时必然失败 - surface 面切换不一致:headless 面已显式打开,后续读写却仍路由到 pane,需要用户授权语义的 `browser_pane_release` 才完成切换——两步之间状态悬空 ## 建议 pane 无 ack 且 `browser_open` 也失败时: - 错误指引改为「显式 `surface:"headless"` 打开 + `browser_pane_release` 解绑」的完整序列,或 - `browser_open surface:"headless"` 成功后自动把会话读写路由一并切到 headless(带 surface flip 披露),省掉显式 release 的悬空态 ## 影响 面板掉线时验证流程卡壳 3-4 次重试,且无 ack 错误信息重复冗长(同一段指引复读三遍)。
作者
所有者

已修复并合并:内部跟踪 #7559(Kind/Bug),PR Octopus/octopus#7566,合并提交 5f1399462。三个症状逐一处理:

  1. 指引矛盾:browser_open 的三条 no-browser-surface 腿(transport / CLI / grace 耗尽)现统一携带完整逃生序列——显式 surface:"headless" 打开 + browser_pane_release 解绑一步说清(含「release 对未 bound 会话是 no-op」),不再只教「retry browser_open shortly」死循环。
  2. 悬空态:browser_open surface:"headless" 成功且会话仍 pane-bound 时,输出显式披露「still bound…后续读写仍路由 pane,直到 browser_pane_release」+ release 杠杆。未采纳自动翻面(你的建议 2):sticky binding 是冻结契约 browser-tool-surface-v1 §selector 的用户同意语义(#5265/#5817 两次事故根因都是 agent 单方面移动会话上下文),自动翻面会绕过同意门——已留作后续 Feature 讨论方向(如果你希望推进,可以在本仓开 Feature 票讨论带披露的半自动切换语义)。
  3. 复读三遍:guest-dead notice 的 option(1) 已教 browser_open newTab: true,移除了复读的 recovery 尾部;≥3 连拒升级段按契约 v2.3 保留 release 第二次点名。每个杠杆现在恰出现一次。

验证:回归测试 9 条(修复前 6 fail → 修复后 9 pass);browser 面 530+ 测试全绿;S 档 9 维代码评审 PASS;verify DoD 4/4 PASS(基线差集分诊无回归)。随下个版本发布后生效。

已修复并合并:内部跟踪 #7559(Kind/Bug),PR Octopus/octopus#7566,合并提交 5f1399462。三个症状逐一处理: 1. **指引矛盾**:`browser_open` 的三条 no-browser-surface 腿(transport / CLI / grace 耗尽)现统一携带完整逃生序列——显式 `surface:"headless"` 打开 + `browser_pane_release` 解绑一步说清(含「release 对未 bound 会话是 no-op」),不再只教「retry browser_open shortly」死循环。 2. **悬空态**:`browser_open surface:"headless"` 成功且会话仍 pane-bound 时,输出显式披露「still bound…后续读写仍路由 pane,直到 browser_pane_release」+ release 杠杆。**未采纳自动翻面**(你的建议 2):sticky binding 是冻结契约 browser-tool-surface-v1 §selector 的用户同意语义(#5265/#5817 两次事故根因都是 agent 单方面移动会话上下文),自动翻面会绕过同意门——已留作后续 Feature 讨论方向(如果你希望推进,可以在本仓开 Feature 票讨论带披露的半自动切换语义)。 3. **复读三遍**:guest-dead notice 的 option(1) 已教 `browser_open newTab: true`,移除了复读的 recovery 尾部;≥3 连拒升级段按契约 v2.3 保留 release 第二次点名。每个杠杆现在恰出现一次。 验证:回归测试 9 条(修复前 6 fail → 修复后 9 pass);browser 面 530+ 测试全绿;S 档 9 维代码评审 PASS;verify DoD 4/4 PASS(基线差集分诊无回归)。随下个版本发布后生效。
登录 并参与到对话中。
未选择标签
1 名参与者
通知
截止日期
未设置截止日期。
依赖工单

未设置依赖工单。

引用:Octopus/release#19