用途:在本机已登录的真实 Chrome 上操作或验收网页(含测试自己的站、E2E、截图)、读取登录后台、抓取无 API 的数据、填表,以及排查 doctor、会话与 adapter 故障。公开文本优先用 curl 或公开 API;需要登录态、截图、E2E、填表或浏览器实测时才使用。
主要能力:提供 160+ 站点 adapter,用 opencli list、opencli list -f json、opencli <site> --help 查询现有能力;策略分为 PUBLIC(纯 HTTP)、COOKIE(复用 Chrome 登录态)、INTERCEPT、UI、LOCAL。现场驱动用 opencli browser <session> open/state/click/wait/screenshot/extract/close 等命令,state 返回带编号快照。
必要用法:先运行 opencli doctor 诊断浏览器桥。会话名即标签页所有权,一个会话一个标签页,禁止 tab new/tab select,禁止硬编码会话名,必须在 finally 中显式 close;cleanup 仅主线可用。窗口模式含 background(须显式指定)、active、foreground、isolated、dedicated(扩展 1.5.x 起默认,不抢焦点)。最小闭环示例:opencli browser site-acceptance open http://localhost:3000 --window dedicated;随后 state、screenshot、close。验收脚本:node scripts/accept.mjs --url http://localhost:3000/ --widths 1440,390 --out /tmp/site-accept。
限制:不需要浏览器时不要加 --window,PUBLIC/LOCAL 命令会报 unknown option。跑通后应沉淀为参数化脚本,交付报告需含「沉淀的脚本」一节。配额站需固定站点会话名并加锁,禁止并行采集。会话名不得以 3~6 位数字结尾;Bash tool 中不要用 $$。
注意:本 Skill 面向 yan-labs/OpenCLI fork,与上游有差异;扩展版本要求等细节以 opencli doctor 输出与参考资料为准。文中部分窗口网格、relayout 行为属待合并特性,需启用对应构建后使用;其余功能、收费、价格与支持平台等信息暂未提供。