Repository navigation

✨ sctl Browser 第 2 期浏览器数据管理与第 3 期页面自动化 - #5

Merged

CodFrm merged 50 commits into

mainfrom

feat/browser-data-page-automation

Oct 4, 2026

Commits on Sep 29, 2026

📝 新增 sctl Browser 第 3 期 spec
CodFrm
committed
a627187
📝 新增 sctl Browser 第 2 期 spec
CodFrm
committed
ebb3dbe
📝 第 3 期 spec：修正 daemon 接收通知的措辞，与现有断开规则一致
 CodFrm
committed
58f6a0a
✨ 浏览器方法破坏级别闸门：L1 显式确认、新错误码、hasMore 合并与帧上限检查
 CodFrm
committed
2627afa
✨ 阅读列表管理：reading-list 命令、MCP 领域工具机制与 --yes/--limit 辅助
 CodFrm
committed
bc7f955
✨ 书签管理：bookmarks list/search/add/mkdir/move/edit 与 MCP bookmarks 工具
 CodFrm
committed
272bb7e
✨ 协议新增 CDP 中转方法、扩展到 daemon 的通知与页面自动化错误码
 CodFrm
committed
630c2d7
✨ bridge 接收浏览器实例的调试器通知，新增实例消失回调与按实例调用
 CodFrm
committed
1ca0239
✨ 扩展 CDP 中转：debugger 权限、按需附加、事件与断开通知，最低 Chrome 125
CodFrm
committed
e4a99ad
📝 第 2 期 spec：卸载扩展改走审批窗口（探针证实需要用户手势），补充探针结论
 CodFrm
committed
c9e305d
📝 第 3 期 spec：附加期间开启焦点模拟，补充探针结论
 CodFrm
committed
6acb370
✨ 删除书签审批核心：bookmarks.remove（L2）预校验、待审批队列持久化与状态机、offscreen 延后应答与取消/断开转发、bookmarks rm 与 MCP remove
CodFrm
committed
7f9daac
✨ 页面自动化核心：daemon 页面组件、/control/page、sctl page eval|detach 与 page_eval/page_detach，附加后开启焦点模拟，真 Chrome 集成测试
 CodFrm
committed
6e135f4
✨ 标签页与窗口整理：tabs move/pin/mute/reload/duplicate、windows open/close/focus/state 与 MCP tabs_manage
CodFrm
committed
80c719d
✨ 审批窗口 UI：删除书签审批窗口、队列与倒计时、弹窗待批准入口
 CodFrm
committed
2c150ac
Merge branch 'main' into feat/browser-data
CodFrm
committed
e5a5525
Merge branch 'main' into feat/page-automation
CodFrm
committed
de4d2a8
✨ 标签组：groups list/create/add/edit/ungroup、tabs.list 增 groupId 与 MCP tab_groups
CodFrm
committed
68a79e7
✨ 页面快照与元素引用：无障碍树快照（状态、值、链接、文本、可见性过滤、布局容器展开、同进程 iframe），按标签页的引用表随新快照、文档替换、节点移除、断开失效并返回 STALE_REF，--root 引用或严格选择器，1 MiB 上限，sctl page snapshot 与 page_snapshot，真 Chrome 集成测试
 CodFrm
committed
2bad0f0
✨ 历史与浏览数据：history search/visits/rm/clear、browsing-data clear、parseTimeFlag 与 MCP history/browsing_data
CodFrm
committed
5e88901
✨ 跨进程 iframe：附加时开启扁平化自动附加并在用到的子会话上递归开启，快照经子会话展开 OOPIF（含嵌套），无法附加的显示 iframe [unavailable]；子会话分离只作废该 frame 及其嵌套 frame 的引用；eval 带引用时以元素为参数在其所在会话执行；双源 fixture 真 Chrome 集成测试
 CodFrm
committed
17be59a
🐛 page eval 支持元素引用参数，修正附加序列测试夹具与 iframe 说明
 CodFrm
committed
17f5d18
✨ 最近关闭：recent list/restore 与 MCP recently_closed
CodFrm
committed
c08c6fc
📝 最近关闭：补齐文档与类型检查
 CodFrm
committed
57c2c09
✨ 下载：downloads list/start/pause/resume/cancel/erase/delete-file/show 与 MCP downloads
CodFrm
committed
5505448
✨ Cookie：cookies list/get/set/rm/clear（含分区 Cookie）、host_permissions 与 MCP cookies
CodFrm
committed
878d25c
✨ 页面动作核心与 click/hover：引用或选择器目标（严格匹配、0 个时等待、多个 TARGET_AMBIGUOUS），自动等待（挂载、可见、位置稳定、可用、命中测试，超时写明最后未满足的条件与遮挡元素），滚入视口，可信鼠标事件与 --button/--count/--modifiers，点击触发导航等 DOMContentLoaded，报告新开标签页，页面不渲染时 PAGE_HID…
CodFrm
committed
3e198a8
✨ 输入类页面动作：fill（input/textarea/contenteditable，拒绝 checkbox/radio/file）、type、press（Playwright 按键写法）、select（按 value 或文本，缺失 NOT_FOUND）、upload（CLI 解析绝对路径，MCP 要求绝对路径，坏文件 INVALID_REQUEST）、scroll（目标滚入视口或滚轮…
CodFrm
committed
b8fffcc
✨ 扩展管理：extensions list/enable/disable（L1）/uninstall（L2，审批窗口借点击调用 Chrome 卸载并等其确认框）与 MCP extensions
CodFrm
committed
cd543bc
✨ 页面导航与等待：goto/back/forward/reload 按 --wait load|domcontentloaded|networkidle(500 ms 无进行中请求)等待，默认超时 30 秒，结果带主文档 HTTP 状态，网络错误返回 NAVIGATION_FAILED，无历史返回 NOT_FOUND；page wait 支持 --text/--gone/--selecto…
CodFrm
committed
d669004
✨ 页面截图：视口、--full 整页与元素裁剪（含跨域 iframe 内元素），png|jpeg 与 --quality，超单帧上限返回带 jpeg/视口提示的 PAYLOAD_TOO_LARGE，15 秒内无图像返回 PAGE_HIDDEN 而非空白图；sctl page screenshot 写文件并输出路径，page_screenshot 返回 MCP 图片内容
 CodFrm
committed
fbfa5d0
✨ JS 弹框处理：附加时开启 Page 域并跟踪弹框状态，弹框打开期间除 dialog/detach/screenshot 外的页面命令返回 DIALOG_OPEN，执行中的动作立即返回；sctl page dialog accept [--text]|dismiss 与 page_dialog，四种弹框真 Chrome 集成测试
 CodFrm
committed
1257db3
🐛 页面动作结果对齐 spec：eval 与 dialog 带 url/title/navigated，输入类动作与 eval 报告打开的新标签页，networkidle 计入跨进程 iframe 的请求（修复含跨域 iframe 页面永远等不到空闲），page_dialog 支持 activate，文档同步
 CodFrm
committed
b22013c
🐛 页面自动化代码评审修复：测试 Chrome 随测试进程退出（Unix 调试管道生命线），扩展 relay 经 storage.session 在 service worker 重启后接着管理已附加标签页、断开等待进行中的附加，附加钩子完成时命令已结束也断开，fill/select 途中元素离开返回 STALE_REF/NOT_FOUND 而非内部错误，等待条件脚本异常带原文，CLI 错误…
CodFrm
committed
8f2bb82
📝 页面自动化 spec 修订：JS 弹框打开期间 page screenshot 也立即返回 DIALOG_OPEN（真机验证显示弹框阻塞渲染，截图拿不到图像）
CodFrm
committed
57d5d28
🐛 对齐第 2 期 spec：最近关闭改用毫秒并补 hasMore 与会话 ID 列、各领域缺 API 时回 UNSUPPORTED、cookies rm 只删一个、关窗不影响已交给 Chrome 确认框的卸载、恢复 ScriptCat 工具的 progress、confirm:false 回 CONFIRMATION_REQUIRED、等待提示点名浏览器名称，并补齐文档
 CodFrm
committed
739f628

Commits on Oct 2, 2026