imjszhang/js-eyes/js-browser-ops-skill

const { BrowserAutomation } = require('./lib/js-eyes-client');
const { readPage, readPages, clickElement, fillForm, scrollPage, cleanupTabSession } = require('./lib/api');
const browser = new BrowserAutomation('ws://localhost:18080');
// 纯读取默认会关闭自开标签，返回 tabId: null。
// 后续还要 click/fill 时必须 keepOpen，并禁用缓存以取得 live tabId。
const page = await readPage(browser, {
  url: 'https://example.com/article',
  format: 'markdown',
  noCache: true,
  keepOpen: true,
});
// 点击元素
await clickElement(browser, {
  tabId: page.tabId,
  selector: 'button.submit',
});
// 填写表单
await fillForm(browser, {
  tabId: page.tabId,
  selector: 'input[name="email"]',
  value: 'user@example.com',
  clearFirst: true,
});
// 滚动到底部
await scrollPage(browser, {
  tabId: page.tabId,
  target: 'bottom',
});
await cleanupTabSession(browser);
const pages = await readPages(browser, {
  urls: ['https://a.example/1', 'https://b.example/2'],
  format: 'markdown',
  concurrency: 3,
  perHostMinIntervalMs: 1000,
  perHostConcurrency: 1,
  timeoutMs: 30000,
  totalTimeoutMs: 180000,
  signal,
});

{
  "ok": false,
  "error": {
    "code": "blocked_by_site",
    "message": "...",
    "retryable": true,
    "retryAfterMs": 30000,
    "host": "example.com",
    "details": {}
  }
}

# 读取网页内容（默认读完关标签）
node skills/js-browser-ops-skill/index.js read "https://example.com/article" --format markdown --pretty
node skills/js-browser-ops-skill/index.js read "https://example.com/article" --keep-open --no-cache --json
 
# 批量读取（文件或 stdin，一行一个 URL）
node skills/js-browser-ops-skill/index.js read-pages --file urls.txt --json --concurrency 3
cat urls.txt | node skills/js-browser-ops-skill/index.js read-pages --stdin --json
 
# 默认 fail-closed。会话临时授权：--auto-allow-domain 或 JS_EYES_AUTO_ALLOW_DOMAIN=1
# 持久写盘需显式 --persist-allow-domain，热加载失败不会打开页面
node skills/js-browser-ops-skill/index.js read "https://other-site.example/article" --auto-allow-domain
 
# DOM 交互
node skills/js-browser-ops-skill/index.js interact click --tab-id 123 --selector "button.submit"
node skills/js-browser-ops-skill/index.js interact fill --tab-id 123 --selector "input[name=q]" --value "hello" --clear-first
node skills/js-browser-ops-skill/index.js interact wait --tab-id 123 --selector ".results" --timeout 10 --visible
node skills/js-browser-ops-skill/index.js interact scroll --tab-id 123 --target bottom

# click + 视觉反馈 + jsonl 落盘
node index.js interact click --tab-id 123 --selector "button.submit" \
  --visual-trace /tmp/click.jsonl --visual-ms 600
 
# read 通用网页 + 视觉反馈
node index.js read "https://example.com" --visual-trace /tmp/read.jsonl --pretty
 
# 关闭视觉（CI / 静默模式）
node index.js interact click --tab-id 123 --selector "..." --no-visual

skills/js-browser-ops-skill/
├── SKILL.md                  # 技能描述（本文件）
├── CHANGELOG.md              # 版本记录
├── package.json
├── skill.definition.js       # CLI 与 V2 入口共享的工具声明
├── index.js                  # CLI 入口
├── cli/index.js              # CLI 封装
├── bridges/
│   └── _visual-browser.js    # 站点 anchor resolver（CSS/XPath/text/url）
├── lib/
│   ├── api.js                # 业务 API（withVisual 包装）
│   ├── skillError.js         # 结构化错误契约 toSkillError
│   ├── batchRead.js          # readPages 并发 / 限流调度
│   ├── browserUtils.js       # browser_read_page 正文提取脚本模板
│   ├── visualHint.js         # 6 工具的 hint + buildSummary
│   ├── cliVisualFlags.js     # CLI 视觉旋钮解析
│   ├── runtimeConfig.js      # 配置合并
│   └── runContext.js          # Recording 上下文
└── scripts/
    ├── browser-read.js       # 读取命令
    ├── browser-read-pages.js # 批量读取
    └── browser-interact.js   # 交互命令