用户看得见的那一页(desktop pane)上跑战役时,为了查请求清单、处理 confirm/prompt(含 accept)、或导出 PDF,不得被迫切到 isolated-headless。
PDF 若短期做不到双腿,必须工具面显式披露「仅 headless」并提供一键换面路径——不得静默成功在另一张看不见的页上。与 #5817 纪律一致:bound + pane 不可达时写路由结构化阻断,绝不静默落 headless。
可回看的 Epic Page:Pane 对称性 Epic:同页战役不必翻 headless
锚点:octopus main @ cadbbbb56
octopus
@ cadbbbb56
内置浏览器是双后端:有桌面绑定时优先同页 pane(Electron webview + CDP),否则 headless-driver.ts(内嵌 Playwright Chromium)。对齐目标是 @playwright/mcp 工具面(browser-tools-parity-ledger.md),不是完整 Playwright Test API。
headless-driver.ts
@playwright/mcp
browser-tools-parity-ledger.md
叶表 HEADLESS_ONLY_BROWSER_TOOL_IDS(packages/octopus/src/tool/browser-ids.ts)当前含:browser_pdf_save、browser_handle_dialog、browser_network_requests、browser_network_request、browser_highlight、browser_generate_locator。本 epic 只收前四项中与同页战役直接相关的 network / dialog / PDF;highlight / generate_locator 不绑。
HEADLESS_ONLY_BROWSER_TOOL_IDS
packages/octopus/src/tool/browser-ids.ts
browser_pdf_save
browser_handle_dialog
browser_network_requests
browser_network_request
browser_highlight
browser_generate_locator
HEADLESS_ONLY
browser_drop
browser_run_code_unsafe
newContext
browser_tabs
_request
page.pdf()
扩展既有 guest-network-cdp.ts(#5902 / #5826)采集 → browser_network_* 去 headlessOnly。CDP attach 失败结构化拒绝,不静默空列表。
guest-network-cdp.ts
browser_network_*
guest-dialog.ts 策略 + pending/handle;禁止 guard 与 handle 双答。默认仍 auto-dismiss;accept 必经 act 门。
guest-dialog.ts
推荐先 spike A;不可行再退 B。禁止 bound+pane-live 时静默在 headless 生成「看起来成功」的 PDF。
defineActTool
packages/octopus/contracts/browser-tools-parity-ledger.md
packages/octopus/contracts/browser-tool-surface-v1.md
packages/octopus/contracts/browser-act-surface-v1.md
packages/desktop/src/main/guest-dialog.ts
packages/desktop/src/main/guest-network-cdp.ts
packages/octopus/src/browser/headless-driver.ts
【票面刷新注记 — 2026-11-11 代码取证,octopus main】
本 Epic 的 P0 三件套经本轮新鲜代码证据核实均已双腿落地,票面锚定已 stale(锚点 cadbbbb56 时期的 HEADLESS_ONLY 清单已过时):
packages/octopus/src/tool/browser-network-requests.txt:1-5
browser-handle-dialog.txt:1-5
browser-pdf-save.txt:1-5
当前 HEADLESS_ONLY_BROWSER_TOOL_IDS 仅剩 browser_permissions / browser_devices(browser-ids.ts:123-152)。
browser_permissions
browser_devices
browser-ids.ts:123-152
后续 parity 工作已转至主仓 octopus #7086(browser parity 三期:跨腿黄金一致性套件 + browser_drop / hide_highlight 缺口收口;其中 browser_drop 即本票 E-4 排除项的实证立项)。建议本票按剩余未完成项重核范围或关闭。
收口: P0 三件套(network_requests/request、handle_dialog、pdf_save)经 2026-11-11 代码取证均已双腿落地(见票面刷新注记);后续 parity 缺口已在主仓 #7086 立项并于 2026-11-12 关闭交付。本票按剩余项重核=无未决 P0,关闭。via 2026-11-13 清理战役。
未设置依赖工单。
该备注对被屏蔽的用户不可见。
北极星验收
用户看得见的那一页(desktop pane)上跑战役时,为了查请求清单、处理 confirm/prompt(含 accept)、或导出 PDF,不得被迫切到 isolated-headless。
PDF 若短期做不到双腿,必须工具面显式披露「仅 headless」并提供一键换面路径——不得静默成功在另一张看不见的页上。与 #5817 纪律一致:bound + pane 不可达时写路由结构化阻断,绝不静默落 headless。
可回看的 Epic Page:Pane 对称性 Epic:同页战役不必翻 headless
锚点:
octopusmain@ cadbbbb56背景
内置浏览器是双后端:有桌面绑定时优先同页 pane(Electron webview + CDP),否则
headless-driver.ts(内嵌 Playwright Chromium)。对齐目标是@playwright/mcp工具面(browser-tools-parity-ledger.md),不是完整 Playwright Test API。叶表
HEADLESS_ONLY_BROWSER_TOOL_IDS(packages/octopus/src/tool/browser-ids.ts)当前含:browser_pdf_save、browser_handle_dialog、browser_network_requests、browser_network_request、browser_highlight、browser_generate_locator。本 epic 只收前四项中与同页战役直接相关的 network / dialog / PDF;highlight / generate_locator 不绑。目标
HEADLESS_ONLY叶表与 registry lock,零漂移非目标
browser_drop;E-6browser_run_code_unsafenewContext、完整 device catalogbrowser_highlight/browser_generate_locatorpane 腿browser_tabsaction=new 恒 headlessP0 范围
browser_network_requests/_requestbrowser_handle_dialogbrowser_pdf_savepage.pdf()P0-a Network
扩展既有
guest-network-cdp.ts(#5902 / #5826)采集 →browser_network_*去 headlessOnly。CDP attach 失败结构化拒绝,不静默空列表。P0-b Dialog
guest-dialog.ts策略 + pending/handle;禁止 guard 与 handle 双答。默认仍 auto-dismiss;accept 必经 act 门。P0-c PDF
推荐先 spike A;不可行再退 B。禁止 bound+pane-live 时静默在 headless 生成「看起来成功」的 PDF。
建议拆 PR
验收清单
HEADLESS_ONLY叶表与defineActTool/ registry lock 一致证据锚点
packages/octopus/contracts/browser-tools-parity-ledger.mdpackages/octopus/contracts/browser-tool-surface-v1.mdpackages/octopus/contracts/browser-act-surface-v1.mdpackages/octopus/src/tool/browser-ids.tspackages/desktop/src/main/guest-dialog.tspackages/desktop/src/main/guest-network-cdp.tspackages/octopus/src/browser/headless-driver.ts【票面刷新注记 — 2026-11-11 代码取证,octopus main】
本 Epic 的 P0 三件套经本轮新鲜代码证据核实均已双腿落地,票面锚定已 stale(锚点 cadbbbb56 时期的 HEADLESS_ONLY 清单已过时):
browser_network_requests/_request:dual-backend 已落地(pane 腿读 CDP Network ring)—packages/octopus/src/tool/browser-network-requests.txt:1-5browser_handle_dialog:dual-backend 已落地(pane 腿 CDP 处理当前对话框,mode handle 走 act consent)—browser-handle-dialog.txt:1-5browser_pdf_save:dual-leg 已落地(pane 腿 CDP MHTML + 离线渲染 + printToPDF,产物落 downloads 面板)—browser-pdf-save.txt:1-5(#6515 N-03)当前
HEADLESS_ONLY_BROWSER_TOOL_IDS仅剩browser_permissions/browser_devices(browser-ids.ts:123-152)。后续 parity 工作已转至主仓 octopus #7086(browser parity 三期:跨腿黄金一致性套件 + browser_drop / hide_highlight 缺口收口;其中 browser_drop 即本票 E-4 排除项的实证立项)。建议本票按剩余未完成项重核范围或关闭。
收口: P0 三件套(network_requests/request、handle_dialog、pdf_save)经 2026-11-11 代码取证均已双腿落地(见票面刷新注记);后续 parity 缺口已在主仓 #7086 立项并于 2026-11-12 关闭交付。本票按剩余项重核=无未决 P0,关闭。via 2026-11-13 清理战役。