Repository navigation
sctl v0.2.0
相较 v0.1.0,这次更新把 sctl 从 ScriptCat 脚本管理工具扩展为浏览器控制工具:通过命令行、MCP 或 Playwright / Puppeteer,操作你已经在使用、保留登录状态的浏览器。
新增 sctl Browser 扩展
- 支持同时配对多个浏览器实例,按名称或实例 ID 选择目标。
- 管理标签页、窗口和标签组:打开、关闭、移动、固定、静音、刷新、复制等。
- 管理书签、阅读列表、历史记录、最近关闭、下载、Cookie、浏览数据和已安装扩展。
- ScriptCat 继续负责用户脚本管理;sctl Browser 负责浏览器控制。两种扩展按需安装,分别配对。
页面自动化与调试
- 无障碍快照与元素引用,支持点击、悬停、填写、键盘输入、选择、上传、滚动、导航、等待、截图和执行 JavaScript。
- 支持在后台标签页执行操作,无须切换当前标签页;支持跨域 iframe 的快照及基于元素引用的操作。
- 读取控制台消息、未捕获异常和网络请求,可查看请求与响应的头部、正文及耗时。
sctl cdp send可发送原始 Chrome DevTools Protocol 命令。sctl cdp endpoint提供兼容 PlaywrightconnectOverCDP和 Puppeteerconnect的连接入口,复用浏览器现有登录状态;兼容范围与限制见命令行参考。
安装与文档
- 新增 macOS / Linux 和 Windows 一键安装脚本,下载发布包并校验 SHA-256。
- 提供 macOS、Linux、Windows 的 x86_64 / arm64 二进制包,以及独立的 sctl Browser 扩展包。
- 新增命令行 Agent Skill,可让 Agent 直接使用 CLI。
- 重整中英文 README,将详细命令行为移入 CLI 参考,补充 MCP 工具参考与接入说明。
使用与安全提示
- sctl Browser 需要 Chrome 125+ 或兼容版本的 Chromium 浏览器。下载
sctl-browser-extension-0.2.0.zip后解压,在扩展管理页启用开发者模式,以“加载已解压的扩展程序”方式安装。 - 保持
sctl serve运行,再用sctl connect生成一次性配对码;每个扩展单独配对。用sctl browsers检查 sctl Browser 连接,用sctl status检查 ScriptCat 连接。 - ScriptCat 脚本操作继续受扩展自身的策略与确认界面控制。浏览器控制、页面自动化、调试与原始 CDP 通常立即执行,不逐次请求人工批准;删除书签和卸载扩展需要人工批准,部分破坏性命令需要
--yes。 - Cookie 值及网络请求头、正文可能包含敏感信息,不会自动脱敏。CDP 连接地址本身包含访问凭据,请勿公开或写入共享日志。
- 详细说明见威胁模型。
快速开始(中文) · CLI 参考 · MCP 接入与工具参考
完整变更记录:v0.1.0...v0.2.0