Skip to content

v0.2.0

Latest

Choose a tag to compare

@github-actions github-actions released this 17 Oct 03:18

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 提供兼容 Playwright connectOverCDP 和 Puppeteer connect 的连接入口,复用浏览器现有登录状态;兼容范围与限制见命令行参考。

安装与文档

  • 新增 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