zxfccmm4/obsidian-opencode-knowledge/opencli-oneshot

opencli browser open <目标 URL>
opencli browser wait time 3
opencli browser network

opencli browser network --detail <N>     # 查看第 N 条请求的完整响应体

# Tier 2 (Cookie)
opencli browser eval "fetch('/api/endpoint', { credentials: 'include' }).then(r => r.json())"
 
# Tier 2.5 (localStorage Bearer)
opencli browser eval "(async () => {
  const token = localStorage.getItem('access_token');
  const res = await fetch('https://api.example.com/endpoint', {
    headers: { 'Authorization': 'Bearer ' + token },
    credentials: 'include'
  });
  return res.json();
})()"

// clis/<site>/<name>.js
import { cli, Strategy } from '@jackwener/opencli/registry';
cli({
  site: 'mysite',
  name: 'mycommand',
  description: '一句话描述',
  domain: 'www.example.com',
  strategy: Strategy.COOKIE,
  browser: true,
  args: [{ name: 'limit', type: 'int', default: 20 }],
  columns: ['rank', 'title', 'value'],
  func: async (page, kwargs) => {
    await page.goto('https://www.example.com/target-page');
    const data = await page.evaluate(`(async () => {
      const res = await fetch('/api/target', { credentials: 'include' });
      const d = await res.json();
      return (d.data?.items || []).map(item => ({
        title: item.title,
        value: item.value,
      }));
    })()`);
    return (data as any[]).slice(0, kwargs.limit).map((item, i) => ({
      rank: i + 1,
      title: item.title || '',
      value: item.value || '',
    }));
  },
});

fetch(url) 直接能拿到？                        → Tier 1: public   (browser: false)
fetch(url, {credentials:'include'})？          → Tier 2: cookie
localStorage 有 token + Bearer header 能拿到？  → Tier 2.5: localStorage Bearer
加 CSRF/Bearer header 后拿到？                 → Tier 3: header
都不行，但页面自己能请求成功？                    → Tier 4: intercept

# Repo 贡献
npm run build
opencli list | grep mysite
opencli mysite mycommand --limit 3 -v
 
# 私人 adapter
opencli browser verify <site>/<name>