From 5f0b5fdd5cc6e2f3b0bf0963762a755584549acd Mon Sep 17 00:00:00 2001 From: jackwener Date: Mon, 30 Mar 2026 23:00:30 +0800 Subject: [PATCH] refactor(skills): optimize skill structure for better performance MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Split monolithic root SKILL.md (879 lines) into focused modules: - Root SKILL.md: 879 → 120 lines (-86% context consumption) - references/commands.md: extracted full command reference (on-demand) - New skill: adapter-dev (YAML/TS adapter development guide) - New skill: record-workflow (opencli record workflow) - Improved descriptions for cross-project-adapter-migration and review-pr --- .agents/skills/adapter-dev/SKILL.md | 162 ++++ .../cross-project-adapter-migration/SKILL.md | 2 +- .agents/skills/record-workflow/SKILL.md | 109 +++ .agents/skills/review-pr/SKILL.md | 260 ++++++ SKILL.md | 867 ++---------------- references/commands.md | 487 ++++++++++ 6 files changed, 1073 insertions(+), 814 deletions(-) create mode 100644 .agents/skills/adapter-dev/SKILL.md create mode 100644 .agents/skills/record-workflow/SKILL.md create mode 100644 .agents/skills/review-pr/SKILL.md create mode 100644 references/commands.md diff --git a/.agents/skills/adapter-dev/SKILL.md b/.agents/skills/adapter-dev/SKILL.md new file mode 100644 index 00000000..ea1da832 --- /dev/null +++ b/.agents/skills/adapter-dev/SKILL.md @@ -0,0 +1,162 @@ +--- +name: adapter-dev +description: "OpenCLI adapter development guide — creating YAML pipeline or TypeScript adapters for new websites/apps. Use this skill whenever you need to create a new opencli adapter, add a command for a new platform, write a YAML pipeline, write a TypeScript CLI adapter, choose between YAML vs TS, debug pipeline steps, fix adapter issues, or understand opencli's adapter architecture. Triggers on: editing files in src/clis/, creating .yaml or .ts adapter files, 'add command for X', 'create adapter', 'new site', pipeline debugging." +--- + +# Adapter Development Guide + +> 为 opencli 创建新 adapter 的完整指南。涵盖 YAML pipeline 和 TypeScript adapter 两种方式。 + +> [!IMPORTANT] +> **开始前必须阅读 [CLI-EXPLORER.md](../../../CLI-EXPLORER.md)**，它包含 API 发现工作流和认证策略决策树。 +> 快速模式（一个命令）看 [CLI-ONESHOT.md](../../../CLI-ONESHOT.md)。 + +## 选择实现方式 + +| 场景 | 方式 | 原因 | +|------|------|------| +| Read + 简单 API（纯 fetch/select/map） | **YAML pipeline** | 声明式，通常 10-30 行 | +| Read + GraphQL/分页/签名/复杂逻辑 | **TypeScript adapter** | 需要 JS 逻辑 | +| Write 操作（DOM 点击/输入） | **TS + `Strategy.UI`** | UI 自动化 | +| Write + API（直接 POST） | **TS + `Strategy.COOKIE/HEADER`** | API 调用 | + +## 收口规则（必须遵守） + +1. 主参数优先用 positional arg — 不要默认做成 `--query` / `--id` / `--url` +2. 预期中的 adapter 失败优先抛 `CliError` 子类，不要直接 throw 原始 `Error` +3. 新增 adapter 时同步更新 `docs/adapters/index.md`、sidebar、README + +## YAML Pipeline Adapter + +Create `src/clis//.yaml`，自动发现无需手动注册： + +### Cookie 策略（最常见） + +```yaml +site: mysite +name: hot +description: Hot topics +domain: www.mysite.com +strategy: cookie +browser: true + +args: + limit: + type: int + default: 20 + +pipeline: + - navigate: https://www.mysite.com + - evaluate: | + (async () => { + const res = await fetch('/api/hot', { credentials: 'include' }); + const d = await res.json(); + return d.data.items.map(item => ({ + title: item.title, score: item.score, + })); + })() + - map: + rank: ${{ index + 1 }} + title: ${{ item.title }} + score: ${{ item.score }} + - limit: ${{ args.limit }} + +columns: [rank, title, score] +``` + +### Public API 策略（无需 browser） + +```yaml +strategy: public +browser: false + +pipeline: + - fetch: + url: https://api.example.com/hot.json + - select: data.items + - map: + title: ${{ item.title }} + - limit: ${{ args.limit }} +``` + +## TypeScript Adapter + +Create `src/clis//.ts`，同样自动发现（不要手动 import）： + +```typescript +import { cli, Strategy } from '../../registry.js'; + +cli({ + site: 'mysite', + name: 'search', + description: '搜索', + strategy: Strategy.INTERCEPT, + args: [{ name: 'query', required: true, positional: true }], + columns: ['rank', 'title', 'url'], + func: async (page, kwargs) => { + await page.goto('https://www.mysite.com/search'); + await page.installInterceptor('/api/search'); + await page.autoScroll({ times: 3, delayMs: 2000 }); + + const requests = await page.getInterceptedRequests(); + let results = []; + for (const req of requests) { + results.push(...req.data.items); + } + return results.map((item, i) => ({ + rank: i + 1, title: item.title, url: item.url, + })); + }, +}); +``` + +**何时用 TS**：XHR interception (`page.installInterceptor`)、infinite scrolling (`page.autoScroll`)、cookie extraction、GraphQL unwrapping 等复杂逻辑。 + +## Pipeline Steps Reference + +| Step | Description | Example | +|------|-------------|---------| +| `navigate` | Go to URL | `navigate: https://example.com` | +| `fetch` | HTTP request (browser cookies) | `fetch: { url: "...", params: { q: "..." } }` | +| `evaluate` | Run JS in page | `evaluate: \| (async () => { ... })()` | +| `select` | Extract JSON path | `select: data.items` | +| `map` | Map fields | `map: { title: "${{ item.title }}" }` | +| `filter` | Filter items | `filter: item.score > 100` | +| `sort` | Sort items | `sort: { by: score, order: desc }` | +| `limit` | Cap result count | `limit: ${{ args.limit }}` | +| `intercept` | Declarative XHR capture | `intercept: { trigger: "navigate:...", capture: "api/hot" }` | +| `tap` | Store action + XHR capture | `tap: { store: "feed", action: "fetchFeeds", capture: "homefeed" }` | +| `snapshot` | Page accessibility tree | `snapshot: { interactive: true }` | +| `click` | Click element | `click: ${{ ref }}` | +| `type` | Type text | `type: { ref: "@1", text: "hello" }` | +| `wait` | Wait for time/text | `wait: 2` or `wait: { text: "loaded" }` | +| `press` | Press key | `press: Enter` | + +## Template Syntax + +```yaml +${{ args.query }} # 参数引用 +${{ args.limit | default(20) }} # 带默认值 +${{ item.title }} # 当前 item（map/filter 中） +${{ item.data.nested.field }} # 嵌套字段 +${{ index }} # 0-based 索引 +${{ index + 1 }} # 1-based +``` + +## Verification Checklist + +```bash +npx tsc --noEmit # TypeScript 编译检查 +opencli list | grep # 确认命令已注册 +opencli --limit 3 -f json # 实际运行 +opencli --limit 3 -v # verbose 看 pipeline +``` + +## Common Pitfalls + +| 问题 | 原因 | 解决 | +|------|------|------| +| `Target page context` error | evaluate 之前没有 navigate | 加 `navigate:` 步骤 | +| Empty table | evaluate 返回的数据路径错误 | 用 `-v` 查看 pipeline 输出 | +| Cookie 失效 | Chrome 未登录目标网站 | 先在 Chrome 登录 | +| TS adapter 未注册 | 手动 import 了文件 | 删除手动 import，自动发现 | diff --git a/.agents/skills/cross-project-adapter-migration/SKILL.md b/.agents/skills/cross-project-adapter-migration/SKILL.md index 6c025c95..c28fed65 100644 --- a/.agents/skills/cross-project-adapter-migration/SKILL.md +++ b/.agents/skills/cross-project-adapter-migration/SKILL.md @@ -1,6 +1,6 @@ --- name: cross-project-adapter-migration -description: "Cross-project CLI command migration workflow for opencli. Use when importing commands from external CLI projects (python/node) like rdt-cli, twitter-cli, etc. Covers: source analysis → gap matrix → batch migration → README/SKILL.md update." +description: "Cross-project CLI command migration workflow for opencli. Use whenever importing, porting, or migrating commands from external CLI projects (Python/Node/Go) into opencli — e.g. rdt-cli, twitter-cli, or any third-party CLI tool for a platform opencli supports. Covers: source project analysis → feature gap matrix → batch adapter implementation → doc updates. Triggers on: '把 xxx-cli 迁移过来', 'migrate commands from X', '对齐 xxx 功能', 'import from external CLI', 'port X commands', or when expanding opencli support for a platform that already has a third-party CLI." --- # Cross-Project Adapter Migration diff --git a/.agents/skills/record-workflow/SKILL.md b/.agents/skills/record-workflow/SKILL.md new file mode 100644 index 00000000..ddf00168 --- /dev/null +++ b/.agents/skills/record-workflow/SKILL.md @@ -0,0 +1,109 @@ +--- +name: record-workflow +description: "OpenCLI record workflow — capture browser API calls by manually operating a page, then generate YAML adapter candidates. Use this skill when the user mentions 'record', 'opencli record', wants to capture API calls from a webpage, needs to generate adapters from manual browsing, converts captured JSON to YAML/TS adapters, or troubleshoots record output. Also triggers on: editing .opencli/record/ files, 'captured.json', 'candidates/', record debugging." +--- + +# Record Workflow + +> `record` 是为「无法用 `explore` 自动发现」的页面准备的手动录制方案。 +> 适用场景：需要登录操作、复杂交互、SPA 内路由的页面。 + +## 工作原理 + +``` +opencli record + → 打开 automation window 并导航到目标 URL + → 向所有 tab 注入 fetch/XHR 拦截器（幂等，可重复注入） + → 每 2s 轮询：发现新 tab 自动注入，drain 所有 tab 的捕获缓冲区 + → 超时（默认 60s）或按 Enter 停止 + → 分析捕获 JSON：去重 → 评分 → 生成候选 YAML +``` + +**拦截器特性**： +- 同时 patch `window.fetch` 和 `XMLHttpRequest` +- 只捕获 `Content-Type: application/json` 的响应 +- 过滤纯对象少于 2 个 key 的响应（避免 tracking/ping） +- 跨 tab 隔离，幂等注入 + +## 使用步骤 + +```bash +# 1. 启动录制 +opencli record "https://example.com/page" --timeout 120000 + +# 2. 在 automation window 里正常操作页面 +# 打开列表、搜索、点击条目、切换 Tab — 触发网络请求的操作都会被捕获 + +# 3. 按 Enter 停止（或等超时） + +# 4. 查看结果 +cat .opencli/record//captured.json # 原始捕获 +ls .opencli/record//candidates/ # 候选 YAML +``` + +### 命令参数 + +```bash +opencli record # 录制，site name 从域名推断 +opencli record --site mysite # 指定 site name +opencli record --timeout 120000 # 自定义超时（毫秒，默认 60000） +opencli record --poll 1000 # 缩短轮询间隔（毫秒，默认 2000） +opencli record --out .opencli/record/x # 自定义输出目录 +``` + +### 输出结构 + +``` +.opencli/record// +├── captured.json ← 原始捕获数据（url/method/body） +└── candidates/*.yaml ← 高置信度候选适配器（score ≥ 8，有 array 结果） +``` + +## 页面类型与捕获预期 + +| 页面类型 | 预期捕获量 | 说明 | +|---------|-----------|------| +| 列表/搜索页 | 多（5~20+） | 每次搜索/翻页触发新请求 | +| 详情页（只读） | 少（1~5） | 首屏数据一次性返回 | +| SPA 内路由 | 中等 | 路由切换触发新接口，但首屏请求在注入前已发出 | +| 需要登录 | 视操作而定 | 确保 Chrome 已登录目标网站 | + +> **注意**：SSR 页面在导航完成前就发出的请求会被错过。 +> 解决方案：手动触发新请求（搜索、翻页、展开折叠项等）。 + +## 候选 YAML → TS CLI 转换 + +候选 YAML 是起点，复杂场景需要转为 TypeScript： + +**候选 YAML（自动生成）**： +```yaml +site: tae +name: getList +strategy: cookie +browser: true +pipeline: + - navigate: https://... + - evaluate: | + (async () => { + const res = await fetch('/approval/getList.json?procInsId=...', { credentials: 'include' }); + const data = await res.json(); + return (data?.content?.operatorRecords || []).map(item => ({ ... })); + })() +``` + +**转换为 TS**（参考 adapter-dev skill 的模板）： + +转换要点： +1. URL 中的动态 ID 提取为 `args` +2. `captured.json` 里的真实 body 确定正确数据路径 +3. 认证方式：cookie（`credentials: 'include'`），通常不需要额外 header +4. 文件放入 `src/clis//`，`npm run build` 后自动发现 + +## 故障排查 + +| 现象 | 原因 | 解法 | +|------|------|------| +| 捕获 0 条请求 | 拦截器注入失败或页面无 JSON API | `curl localhost:19825/status` 检查 daemon | +| 捕获量少（1~3 条） | 详情页首屏数据已在注入前发出 | 手动操作触发更多请求（搜索/翻页） | +| 候选 YAML 为 0 | 捕获的 JSON 都没有 array 结构 | 直接看 `captured.json` 手写 TS | +| 新 tab 没有被拦截 | 轮询间隔内 tab 已关闭 | 缩短 `--poll 500` | diff --git a/.agents/skills/review-pr/SKILL.md b/.agents/skills/review-pr/SKILL.md new file mode 100644 index 00000000..95a3efb1 --- /dev/null +++ b/.agents/skills/review-pr/SKILL.md @@ -0,0 +1,260 @@ +--- +name: review-pr +description: "Review a GitHub Pull Request end to end inside the opencli project. Use whenever the user mentions 'review PR', 'review this PR', 'check this PR', shares a GitHub PR URL or number, asks to inspect a contributor's branch, wants a worktree-based code review, or says '帮我 review PR', '看一下这个 PR'. Covers: worktree isolation from origin/main, CI check, rebase, code review with P0/P1/P2 severity, direct fixes, and push back to the PR branch." +--- + +# Review PR + +Review a PR in an isolated worktree, rebase it onto `origin/main`, summarize the change, identify issues, fix them, and push directly to the PR branch. + +This skill is intentionally opinionated for `~/code/opencli`: + +- Always start from `origin/main` +- Always use a dedicated worktree +- Always check remote CI with `gh pr checks` +- Always summarize what the PR does before or alongside the review result +- If you find clear issues, fix them directly and push to the PR branch + +## Inputs + +Accept any of these: + +- PR number like `437` +- GitHub URL like `https://github.com/jackwener/opencli/pull/437` +- A vague request like "review this PR" when the active branch or context already identifies the PR + +If the PR number is not obvious, resolve it first before touching git state. + +## Output Contract + +When reporting back to the user, always include: + +1. What the PR does +2. Findings, ordered by severity +3. What you changed, if anything +4. What you ran to verify +5. Whether the branch was pushed + +If no findings remain, say that explicitly and mention any residual risk or CI status. + +## Workflow + +### 1. Inspect PR metadata first + +Run: + +```bash +gh pr view --json number,title,body,author,baseRefName,headRefName,headRepository,headRepositoryOwner,isCrossRepository,mergeable,changedFiles,additions,deletions,url +gh pr diff --name-only +``` + +Capture: + +- PR number +- base branch, expected to be `main` +- head branch +- head owner / repository +- whether this is a fork PR +- changed files + +### 2. Create an isolated review worktree from `origin/main` + +Never review directly in the main worktree. + +Recommended pattern: + +```bash +git fetch origin main +git worktree add /Users/jakevin/code/opencli-pr-review -b pr--review origin/main +``` + +If the path already exists: + +- Reuse it only if it is clearly dedicated to the same PR and clean +- Otherwise remove it first or create a new unique suffix + +### 3. Fetch the PR branch into the worktree + +Prefer avoiding local branch-name conflicts with the contributor branch. + +1. Determine the git remote for the PR head repository. +2. If a matching remote already exists, use it. +3. Otherwise add a temporary remote: + +```bash +git remote add git@github.com:/.git +``` + +Then fetch and check out the PR head into the review branch: + +```bash +git fetch +git checkout -B pr--review FETCH_HEAD +``` + +Alternative fallback: + +```bash +gh pr checkout +``` + +Use the git-fetch flow if `gh pr checkout` fails or collides with an existing local branch/worktree. + +### 4. Check CI before doing local changes + +Run: + +```bash +gh pr checks +``` + +Interpretation: + +- Green checks: continue +- Pending checks: continue, but mention it later +- Red checks: inspect whether the failure is related to the PR or a likely flaky existing test + +If needed, inspect failed logs: + +```bash +gh run view --job --log +``` + +### 5. Rebase onto `origin/main` + +Inside the review worktree: + +```bash +git fetch origin main +git rebase origin/main +``` + +If conflicts appear: + +- Understand both sides before editing +- Prefer preserving both behaviors when compatible +- Continue with: + +```bash +git add +git rebase --continue +``` + +### 6. Understand and summarize the PR + +Before giving findings or making edits, summarize: + +- what user-facing behavior changed +- which files carry the main logic +- whether the PR is a bug fix, refactor, adapter change, or test-only change + +Keep this concise, but concrete. + +### 7. Review for real issues + +Focus on: + +- correctness bugs +- hidden behavior regressions +- `page.evaluate` / browser-context serialization issues +- missing tests for the actual execution path +- bad `rebase` fallout +- type or build regressions + +Severity guide: + +- `P0`: must fix before merge +- `P1`: should fix before merge +- `P2`: nice-to-have or follow-up + +If the user asked to "review", findings come first. + +### 8. Fix directly when the issue is clear + +Unless the user explicitly wants review-only: + +- fix `P0` +- fix `P1` +- fix easy `P2` if they meaningfully reduce risk + +Use `apply_patch` for manual file edits. + +### 9. Verify after edits + +Run the smallest useful set first, then expand as needed: + +```bash +npm run typecheck +npx vitest run +npm test +npm run build +``` + +For PRs touching adapters or browser logic, prefer at least: + +- targeted tests for the changed area +- `npm run typecheck` +- `npm test` if reasonably fast + +If a remote CI failure looked flaky, consider rerunning failed jobs: + +```bash +gh run rerun --failed +gh run watch --exit-status +``` + +### 10. Push directly to the PR branch + +If you rebased or edited the PR branch, push back to the contributor branch. + +Use plain push when possible: + +```bash +git push HEAD: +``` + +If you rebased or rewrote history: + +```bash +git push --force-with-lease HEAD: +``` + +Be explicit about which remote and branch you are updating. + +### 11. Final report structure + +Use this structure: + +```markdown +What it does +- + +Findings +- + +What I changed +- + +Verification +- + +Push status +- +``` + +If there are no remaining code findings but CI is still red, say so clearly and do not describe it as merge-ready yet. + +## Notes specific to opencli + +- The main repo path is `~/code/opencli` +- Prefer review worktree names like `~/code/opencli-pr-review` +- Preserve unrelated worktrees +- Do not work directly on the user's main checkout if a worktree can avoid it +- When you finish, leave the review worktree in a predictable state unless the user asks to delete it + +## Example triggers + +- "review PR #437" +- "看一下这个 PR: https://github.com/jackwener/opencli/pull/437" +- "帮我 review 他的 PR，直接修了 push 上去" +- "基于 main 开个 worktree 看这个 PR" diff --git a/SKILL.md b/SKILL.md index 4b38d7a2..53acc602 100644 --- a/SKILL.md +++ b/SKILL.md @@ -1,9 +1,9 @@ --- name: opencli -description: "OpenCLI — Make any website or Electron App your CLI. Zero risk, AI-powered, reuse Chrome login." -version: 1.5.6 +description: "OpenCLI — Make any website or Electron App your CLI. Use this skill when running opencli commands, looking up command syntax, checking supported platforms, troubleshooting opencli issues, or understanding how opencli works. Covers 50+ websites (Bilibili, Twitter, Reddit, GitHub, 知乎, 小红书, etc.) and desktop apps (Cursor, ChatGPT, Notion, Discord). Trigger on: 'opencli', any platform name + CLI action, 'how do I use opencli for X', command lookup, output format questions." +version: 1.5.5 author: jackwener -tags: [cli, browser, web, chrome-extension, cdp, bilibili, zhihu, twitter, github, v2ex, hackernews, reddit, xiaohongshu, xueqiu, youtube, boss, coupang, yollomi, AI, agent] +tags: [cli, browser, web, chrome-extension, cdp, AI, agent] --- # OpenCLI @@ -12,848 +12,80 @@ tags: [cli, browser, web, chrome-extension, cdp, bilibili, zhihu, twitter, githu > [!CAUTION] > **AI Agent 必读：创建或修改任何适配器之前，你必须先阅读 [CLI-EXPLORER.md](./CLI-EXPLORER.md)！** -> 该文档包含完整的 API 发现工作流（必须使用浏览器探索）、5 级认证策略决策树、平台 SDK 速查表、`tap` 步骤调试流程、分页 API 模板、级联请求模式、以及常见陷阱。 -> **本文件（SKILL.md）仅提供命令参考和简化模板，不足以正确开发适配器。** +> 该文档包含完整的 API 发现工作流、5 级认证策略决策树、平台 SDK 速查表。 +> **本文件仅提供概览和索引，不足以正确开发适配器。** > [!IMPORTANT] -> 创建或修改 adapter 时，再额外遵守 3 条收口规则： -> 1. 主参数优先用 positional arg，不要把 `query` / `id` / `url` 默认做成 `--query` / `--id` / `--url` -> 2. 预期中的 adapter 失败优先抛 `CliError` 子类，不要直接 throw 原始 `Error` -> 3. 新增 adapter 或新增用户可发现命令时，同步更新 adapter docs、`docs/adapters/index.md`、sidebar，以及 README/README.zh-CN 中受影响的入口 +> 创建或修改 adapter 时，遵守 3 条收口规则： +> 1. 主参数优先用 positional arg，不要默认做成 `--query` / `--id` +> 2. 预期中的 adapter 失败优先抛 `CliError` 子类 +> 3. 新增 adapter 时同步更新 docs、`docs/adapters/index.md`、sidebar、README ## Install & Run ```bash -# npm global install (recommended) -npm install -g @jackwener/opencli +npm install -g @jackwener/opencli # npm global install (recommended) opencli -# Or from source -cd ~/code/opencli && npm install -npx tsx src/main.ts +cd ~/code/opencli && npx tsx src/main.ts # from source -# Update to latest -npm update -g @jackwener/opencli +npm update -g @jackwener/opencli # update ``` ## Prerequisites Browser commands require: -1. Chrome browser running **(logged into target sites)** -2. **opencli Browser Bridge** Chrome extension installed (load `extension/` as unpacked in `chrome://extensions`) -3. No further setup needed — the daemon auto-starts on first browser command +1. Chrome running + logged into target sites +2. **opencli Browser Bridge** Chrome extension (load `extension/` as unpacked) +3. Daemon auto-starts on first browser command -> **Note**: You must be logged into the target website in Chrome before running commands. Tabs opened during command execution are auto-closed afterwards. +Public API commands (`hackernews`, `v2ex`, `lobsters` etc.) need no browser. -Public API commands (`hackernews`, `v2ex`) need no browser. +## Commands Overview -## Commands Reference +> **完整命令参考**: 查看 [references/commands.md](./references/commands.md) -### Data Commands +### Supported Platforms (50+) -```bash -# Bilibili (browser) -opencli bilibili hot --limit 10 # B站热门视频 -opencli bilibili search "rust" # 搜索视频 (query positional) -opencli bilibili me # 我的信息 -opencli bilibili favorite # 我的收藏 -opencli bilibili history --limit 20 # 观看历史 -opencli bilibili feed --limit 10 # 动态时间线 -opencli bilibili user-videos --uid 12345 # 用户投稿 -opencli bilibili subtitle --bvid BV1xxx # 获取视频字幕 (支持 --lang zh-CN) -opencli bilibili dynamic --limit 10 # 动态 -opencli bilibili ranking --limit 10 # 排行榜 -opencli bilibili following --limit 20 # 我的关注列表 (支持 --uid 查看他人) - -# 知乎 (browser) -opencli zhihu hot --limit 10 # 知乎热榜 -opencli zhihu search "AI" # 搜索 (query positional) -opencli zhihu question 34816524 # 问题详情和回答 (id positional) - -# 小红书 (browser) -opencli xiaohongshu search "美食" # 搜索笔记 (query positional) -opencli xiaohongshu notifications # 通知（mentions/likes/connections） -opencli xiaohongshu feed --limit 10 # 推荐 Feed -opencli xiaohongshu user xxx # 用户主页 (id positional) -opencli xiaohongshu creator-notes --limit 10 # 创作者笔记列表 -opencli xiaohongshu creator-note-detail --note-id xxx # 笔记详情 -opencli xiaohongshu creator-notes-summary # 笔记数据概览 -opencli xiaohongshu creator-profile # 创作者资料 -opencli xiaohongshu creator-stats # 创作者数据统计 - -# 雪球 Xueqiu (browser) -opencli xueqiu hot-stock --limit 10 # 雪球热门股票榜 -opencli xueqiu stock --symbol SH600519 # 查看股票实时行情 -opencli xueqiu watchlist # 获取自选股/持仓列表 -opencli xueqiu feed # 我的关注 timeline -opencli xueqiu hot --limit 10 # 雪球热榜 -opencli xueqiu search "特斯拉" # 搜索 (query positional) -opencli xueqiu earnings-date SH600519 # 股票财报发布日期 (symbol positional) -opencli xueqiu fund-holdings # 蛋卷基金持仓明细 (支持 --account 过滤) -opencli xueqiu fund-snapshot # 蛋卷基金快照（总资产、子账户、持仓） - -# GitHub (via gh External CLI) -opencli gh repo list # 列出仓库 (passthrough to gh) -opencli gh pr list --limit 5 # PR 列表 -opencli gh issue list # Issue 列表 - -# Twitter/X (browser) -opencli twitter trending --limit 10 # 热门话题 -opencli twitter bookmarks --limit 20 # 获取收藏的书签推文 -opencli twitter search "AI" # 搜索推文 (query positional) -opencli twitter profile elonmusk # 用户资料 -opencli twitter timeline --limit 20 # 时间线 -opencli twitter thread 1234567890 # 推文 thread（原文 + 回复） -opencli twitter article 1891511252174299446 # 推文长文内容 -opencli twitter follow elonmusk # 关注用户 -opencli twitter unfollow elonmusk # 取消关注 -opencli twitter bookmark https://x.com/... # 收藏推文 -opencli twitter unbookmark https://x.com/... # 取消收藏 -opencli twitter post "Hello world" # 发布推文 (text positional) -opencli twitter like https://x.com/... # 点赞推文 (url positional) -opencli twitter reply https://x.com/... "Nice!" # 回复推文 (url + text positional) -opencli twitter delete https://x.com/... # 删除推文 (url positional) -opencli twitter block elonmusk # 屏蔽用户 (username positional) -opencli twitter unblock elonmusk # 取消屏蔽 (username positional) -opencli twitter followers elonmusk # 用户的粉丝列表 (user positional) -opencli twitter following elonmusk # 用户的关注列表 (user positional) -opencli twitter notifications --limit 20 # 通知列表 -opencli twitter hide-reply https://x.com/... # 隐藏回复 (url positional) -opencli twitter download elonmusk # 下载用户媒体 (username positional, 支持 --tweet-url) -opencli twitter accept "群,微信" # 自动接受含关键词的 DM 请求 (query positional) -opencli twitter reply-dm "消息内容" # 批量回复 DM (text positional) - -# Reddit (browser) -opencli reddit hot --limit 10 # 热门帖子 -opencli reddit hot --subreddit programming # 指定子版块 -opencli reddit frontpage --limit 10 # 首页 /r/all -opencli reddit popular --limit 10 # /r/popular 热门 -opencli reddit search "AI" --sort top --time week # 搜索（支持排序+时间过滤） -opencli reddit subreddit rust --sort top --time month # 子版块浏览（支持时间过滤） -opencli reddit read --post-id 1abc123 # 阅读帖子 + 评论 -opencli reddit user spez # 用户资料（karma、注册时间） -opencli reddit user-posts spez # 用户发帖历史 -opencli reddit user-comments spez # 用户评论历史 -opencli reddit upvote --post-id xxx --direction up # 投票（up/down/none） -opencli reddit save --post-id xxx # 收藏帖子 -opencli reddit comment --post-id xxx "Great!" # 发表评论 (text positional) -opencli reddit subscribe --subreddit python # 订阅子版块 -opencli reddit saved --limit 10 # 我的收藏 -opencli reddit upvoted --limit 10 # 我的赞 - -# V2EX (public + browser) -opencli v2ex hot --limit 10 # 热门话题 -opencli v2ex latest --limit 10 # 最新话题 -opencli v2ex topic 1024 # 主题详情 (id positional) -opencli v2ex daily # 每日签到 (browser) -opencli v2ex me # 我的信息 (browser) -opencli v2ex notifications --limit 10 # 通知 (browser) -opencli v2ex node python # 节点话题列表 (name positional) -opencli v2ex nodes --limit 30 # 所有节点列表 -opencli v2ex member username # 用户资料 (username positional) -opencli v2ex user username # 用户发帖列表 (username positional) -opencli v2ex replies 1024 # 主题回复列表 (id positional) - -# Hacker News (public) -opencli hackernews top --limit 10 # Top stories -opencli hackernews new --limit 10 # Newest stories -opencli hackernews best --limit 10 # Best stories -opencli hackernews ask --limit 10 # Ask HN posts -opencli hackernews show --limit 10 # Show HN posts -opencli hackernews jobs --limit 10 # Job postings -opencli hackernews search "rust" # 搜索 (query positional) -opencli hackernews user dang # 用户资料 (username positional) - -# BBC (public) -opencli bbc news --limit 10 # BBC News RSS headlines - -# 微博 (browser) -opencli weibo hot --limit 10 # 微博热搜 - -# BOSS直聘 (browser) -opencli boss search "AI agent" # 搜索职位 (query positional) -opencli boss detail --security-id xxx # 职位详情 -opencli boss recommend --limit 10 # 推荐职位 -opencli boss joblist --limit 10 # 职位列表 -opencli boss greet --security-id xxx # 打招呼 -opencli boss batchgreet --job-id xxx # 批量打招呼 -opencli boss send --uid xxx "消息内容" # 发消息 (text positional) -opencli boss chatlist --limit 10 # 聊天列表 -opencli boss chatmsg --security-id xxx # 聊天记录 -opencli boss invite --security-id xxx # 邀请沟通 -opencli boss mark --security-id xxx # 标记管理 -opencli boss exchange --security-id xxx # 交换联系方式 -opencli boss resume # 简历管理 -opencli boss stats # 数据统计 - -# YouTube (browser) -opencli youtube search "rust" # 搜索视频 (query positional) -opencli youtube video "https://www.youtube.com/watch?v=xxx" # 视频元数据 -opencli youtube transcript "https://www.youtube.com/watch?v=xxx" # 获取视频字幕/转录 -opencli youtube transcript "xxx" --lang zh-Hans --mode raw # 指定语言 + 原始时间戳模式 - -# Yahoo Finance (browser) -opencli yahoo-finance quote --symbol AAPL # 股票行情 - -# Sina Finance -opencli sinafinance news --limit 10 --type 1 # 7x24实时快讯 (0=全部 1=A股 2=宏观 3=公司 4=数据 5=市场 6=国际 7=观点 8=央行 9=其它) - -# Reuters (browser) -opencli reuters search "AI" # 路透社搜索 (query positional) - -# 什么值得买 (browser) -opencli smzdm search "耳机" # 搜索好价 (query positional) - -# 携程 (browser) -opencli ctrip search "三亚" # 搜索目的地 (query positional) - -# Antigravity (Electron/CDP) -opencli antigravity status # 检查 CDP 连接 -opencli antigravity send "hello" # 发送文本到当前 agent 聊天框 -opencli antigravity read # 读取整个聊天记录面板 -opencli antigravity new # 清空聊天、开启新对话 -opencli antigravity dump # 导出 DOM 和快照调试信息 -opencli antigravity extract-code # 自动抽取 AI 回复中的代码块 -opencli antigravity model claude # 切换底层模型 -opencli antigravity watch # 流式监听增量消息 - -# Barchart (browser) -opencli barchart quote --symbol AAPL # 股票行情 -opencli barchart options --symbol AAPL # 期权链 -opencli barchart greeks --symbol AAPL # 期权 Greeks -opencli barchart flow --limit 20 # 异常期权活动 - -# Jike 即刻 (browser) -opencli jike feed --limit 10 # 动态流 -opencli jike search "AI" # 搜索 (query positional) -opencli jike create "内容" # 发布动态 (text positional) -opencli jike like xxx # 点赞 (id positional) -opencli jike comment xxx "评论" # 评论 (id + text positional) -opencli jike repost xxx # 转发 (id positional) -opencli jike notifications # 通知 - -# Linux.do (public + browser) -opencli linux-do hot --limit 10 # 热门话题 -opencli linux-do latest --limit 10 # 最新话题 -opencli linux-do search "rust" # 搜索 (query positional) -opencli linux-do topic 1024 # 主题详情 (id positional) -opencli linux-do categories --limit 20 # 分类列表 (browser) -opencli linux-do category dev 7 # 分类内话题 (slug + id positional, browser) - -# StackOverflow (public) -opencli stackoverflow hot --limit 10 # 热门问题 -opencli stackoverflow search "typescript" # 搜索 (query positional) -opencli stackoverflow bounties --limit 10 # 悬赏问题 - -# WeRead 微信读书 (browser) -opencli weread shelf --limit 10 # 书架 -opencli weread search "AI" # 搜索图书 (query positional) -opencli weread book xxx # 图书详情 (book-id positional) -opencli weread highlights xxx # 划线笔记 (book-id positional) -opencli weread notes xxx # 想法笔记 (book-id positional) -opencli weread ranking --limit 10 # 排行榜 - -# Jimeng 即梦 AI (browser) -opencli jimeng generate --prompt "描述" # AI 生图 -opencli jimeng history --limit 10 # 生成历史 - -# Yollomi yollomi.com (browser — 需在 Chrome 登录 yollomi.com，复用站点 session) -opencli yollomi models --type image # 列出图像模型与积分 -opencli yollomi generate "提示词" --model z-image-turbo # 文生图 -opencli yollomi video "提示词" --model kling-2-1 # 视频 -opencli yollomi upload ./photo.jpg # 上传得 URL，供 img2img / 工具链使用 -opencli yollomi remove-bg # 去背景（免费） -opencli yollomi edit "改成油画风格" # Qwen 图像编辑 -opencli yollomi background # AI 背景生成 (5 credits) -opencli yollomi face-swap --source --target # 换脸 (3 credits) -opencli yollomi object-remover # AI 去除物体 (3 credits) -opencli yollomi restore # AI 修复老照片 (4 credits) -opencli yollomi try-on --person --cloth # 虚拟试衣 (3 credits) -opencli yollomi upscale # AI 超分辨率 (1 credit, 支持 --scale 2/4) - -# Grok (default + explicit web) -opencli grok ask --prompt "问题" # 提问 Grok（兼容默认路径） -opencli grok ask --prompt "问题" --web # 显式 grok.com consumer web UI 路径 - -# HuggingFace (public) -opencli hf top --limit 10 # 热门模型 - -# 超星学习通 (browser) -opencli chaoxing assignments # 作业列表 -opencli chaoxing exams # 考试列表 - -# Douban 豆瓣 (browser) -opencli douban search "三体" # 搜索 (query positional) -opencli douban top250 # 豆瓣 Top 250 -opencli douban subject 1234567 # 条目详情 (id positional) -opencli douban photos 30382501 # 图片列表 / 直链（默认海报） -opencli douban download 30382501 # 下载海报 / 剧照 -opencli douban marks --limit 10 # 我的标记 -opencli douban reviews --limit 10 # 短评 - -# Facebook (browser) -opencli facebook feed --limit 10 # 动态流 -opencli facebook profile username # 用户资料 (id positional) -opencli facebook search "AI" # 搜索 (query positional) -opencli facebook friends # 好友列表 -opencli facebook groups # 群组 -opencli facebook events # 活动 -opencli facebook notifications # 通知 -opencli facebook memories # 回忆 -opencli facebook add-friend username # 添加好友 (id positional) -opencli facebook join-group groupid # 加入群组 (id positional) - -# Instagram (browser) -opencli instagram explore # 探索 -opencli instagram profile username # 用户资料 (id positional) -opencli instagram search "AI" # 搜索 (query positional) -opencli instagram user username # 用户详情 (id positional) -opencli instagram followers username # 粉丝 (id positional) -opencli instagram following username # 关注 (id positional) -opencli instagram follow username # 关注用户 (id positional) -opencli instagram unfollow username # 取消关注 (id positional) -opencli instagram like postid # 点赞 (id positional) -opencli instagram unlike postid # 取消点赞 (id positional) -opencli instagram comment postid "评论" # 评论 (id + text positional) -opencli instagram save postid # 收藏 (id positional) -opencli instagram unsave postid # 取消收藏 (id positional) -opencli instagram saved # 已收藏列表 - -# TikTok (browser) -opencli tiktok explore # 探索 -opencli tiktok search "AI" # 搜索 (query positional) -opencli tiktok profile username # 用户资料 (id positional) -opencli tiktok user username # 用户详情 (id positional) -opencli tiktok following username # 关注列表 (id positional) -opencli tiktok follow username # 关注 (id positional) -opencli tiktok unfollow username # 取消关注 (id positional) -opencli tiktok like videoid # 点赞 (id positional) -opencli tiktok unlike videoid # 取消点赞 (id positional) -opencli tiktok comment videoid "评论" # 评论 (id + text positional) -opencli tiktok save videoid # 收藏 (id positional) -opencli tiktok unsave videoid # 取消收藏 (id positional) -opencli tiktok live # 直播 -opencli tiktok notifications # 通知 -opencli tiktok friends # 朋友 - -# Medium (browser) -opencli medium feed --limit 10 # 动态流 -opencli medium search "AI" # 搜索 (query positional) -opencli medium user username # 用户主页 (id positional) - -# Substack (browser) -opencli substack feed --limit 10 # 订阅动态 -opencli substack search "AI" # 搜索 (query positional) -opencli substack publication name # 出版物详情 (id positional) +| 类型 | 平台 | +|------|------| +| **社交/内容** | Bilibili, 知乎, 小红书, Twitter/X, Reddit, V2EX, Hacker News, 微博, Jike, Linux.do, Medium, Substack, Facebook, Instagram, TikTok, Lobsters, DEV.to | +| **金融** | 雪球 Xueqiu, Yahoo Finance, Sina Finance, Barchart, Bloomberg | +| **工具/阅读** | YouTube, WeRead, arXiv, Wikipedia, Google, StackOverflow, Dictionary, Steam, Apple Podcasts | +| **电商/服务** | BOSS直聘, 携程, 什么值得买, Coupang, 京东, LinkedIn, Pixiv, Douban | +| **AI/生成** | Grok, HuggingFace, Jimeng, Yollomi, 豆包 | +| **通用** | Web (任意网页→Markdown), 微信公众号 | +| **桌面应用** | Cursor, Codex, ChatGPT, ChatWise, Notion, Discord, 豆包 App, Antigravity | -# Sinablog 新浪博客 (browser) -opencli sinablog hot --limit 10 # 热门 -opencli sinablog search "AI" # 搜索 (query positional) -opencli sinablog article url # 文章详情 -opencli sinablog user username # 用户主页 (id positional) - -# Lobsters (public) -opencli lobsters hot --limit 10 # 热门 -opencli lobsters newest --limit 10 # 最新 -opencli lobsters active --limit 10 # 活跃 -opencli lobsters tag rust # 按标签筛选 (tag positional) - -# Google (public) -opencli google news --limit 10 # 新闻 -opencli google search "AI" # 搜索 (query positional) -opencli google suggest "AI" # 搜索建议 (query positional) -opencli google trends # 趋势 - -# DEV.to (public) -opencli devto top --limit 10 # 热门文章 -opencli devto tag javascript --limit 10 # 按标签 (tag positional) -opencli devto user username # 用户文章 (username positional) - -# Steam (public) -opencli steam top-sellers --limit 10 # 热销游戏 - -# Apple Podcasts (public) -opencli apple-podcasts top --limit 10 # 热门播客排行榜 (支持 --country us/cn/gb/jp) -opencli apple-podcasts search "科技" # 搜索播客 (query positional) -opencli apple-podcasts episodes 12345 # 播客剧集列表 (id positional, 用 search 获取 ID) - -# arXiv (public) -opencli arxiv search "attention" # 搜索论文 (query positional) -opencli arxiv paper 1706.03762 # 论文详情 (id positional) - -# Bloomberg (public RSS + browser) -opencli bloomberg main --limit 10 # Bloomberg 首页头条 (RSS) -opencli bloomberg markets --limit 10 # 市场新闻 (RSS) -opencli bloomberg tech --limit 10 # 科技新闻 (RSS) -opencli bloomberg politics --limit 10 # 政治新闻 (RSS) -opencli bloomberg economics --limit 10 # 经济新闻 (RSS) -opencli bloomberg opinions --limit 10 # 观点 (RSS) -opencli bloomberg industries --limit 10 # 行业新闻 (RSS) -opencli bloomberg businessweek --limit 10 # Businessweek (RSS) -opencli bloomberg feeds # 列出所有 RSS feed 别名 -opencli bloomberg news "https://..." # 阅读 Bloomberg 文章全文 (link positional, browser) - -# Coupang 쿠팡 (browser) -opencli coupang search "耳机" # 搜索商品 (query positional, 支持 --filter rocket) -opencli coupang add-to-cart 12345 # 加入购物车 (product-id positional, 或 --url) - -# Dictionary (public) -opencli dictionary search "serendipity" # 单词释义 (word positional) -opencli dictionary synonyms "happy" # 近义词 (word positional) -opencli dictionary examples "ubiquitous" # 例句 (word positional) - -# 豆包 Doubao Web (browser) -opencli doubao status # 检查豆包页面状态 -opencli doubao new # 新建对话 -opencli doubao send "你好" # 发送消息 (text positional) -opencli doubao read # 读取对话记录 -opencli doubao ask "问题" # 一键提问并等回复 (text positional) - -# 京东 JD (browser) -opencli jd item 100291143898 # 商品详情 (sku positional, 含价格/主图/规格) - -# LinkedIn (browser) -opencli linkedin search "AI engineer" # 搜索职位 (query positional, 支持 --location/--company/--remote) -opencli linkedin timeline --limit 20 # 首页动态流 - -# Pixiv (browser) -opencli pixiv ranking --limit 20 # 插画排行榜 (支持 --mode daily/weekly/monthly) -opencli pixiv search "風景" # 搜索插画 (query positional) -opencli pixiv user 12345 # 画师资料 (uid positional) -opencli pixiv illusts 12345 # 画师作品列表 (user-id positional) -opencli pixiv detail 12345 # 插画详情 (id positional) -opencli pixiv download 12345 # 下载插画 (illust-id positional) - -# Web (browser) -opencli web read --url "https://..." # 抓取任意网页并导出为 Markdown - -# 微信公众号 Weixin (browser) -opencli weixin download --url "https://mp.weixin.qq.com/s/xxx" # 下载公众号文章为 Markdown - -# 小宇宙 Xiaoyuzhou (public) -opencli xiaoyuzhou podcast 12345 # 播客资料 (id positional) -opencli xiaoyuzhou podcast-episodes 12345 # 播客剧集列表 (id positional) -opencli xiaoyuzhou episode 12345 # 单集详情 (id positional) - -# Wikipedia (public) -opencli wikipedia search "AI" # 搜索 (query positional) -opencli wikipedia summary "Python" # 摘要 (title positional) -``` - -### Desktop Adapter Commands +### Common Patterns ```bash -# Cursor (desktop — CDP via Electron) -opencli cursor status # 检查连接 -opencli cursor send "message" # 发送消息 -opencli cursor read # 读取回复 -opencli cursor new # 新建对话 -opencli cursor dump # 导出 DOM 调试信息 -opencli cursor composer # Composer 模式 -opencli cursor model claude # 切换模型 -opencli cursor extract-code # 提取代码块 -opencli cursor ask "question" # 一键提问并等回复 -opencli cursor screenshot # 截图 -opencli cursor history # 对话历史 -opencli cursor export # 导出对话 - -# Codex (desktop — headless CLI agent) -opencli codex status # 检查连接 -opencli codex send "message" # 发送消息 -opencli codex read # 读取回复 -opencli codex new # 新建对话 -opencli codex dump # 导出调试信息 -opencli codex extract-diff # 提取 diff -opencli codex model gpt-4 # 切换模型 -opencli codex ask "question" # 一键提问并等回复 -opencli codex screenshot # 截图 -opencli codex history # 对话历史 -opencli codex export # 导出对话 - -# ChatGPT (desktop — macOS AppleScript/CDP) -opencli chatgpt status # 检查应用状态 -opencli chatgpt new # 新建对话 -opencli chatgpt send "message" # 发送消息 -opencli chatgpt read # 读取回复 -opencli chatgpt ask "question" # 一键提问并等回复 - -# ChatWise (desktop — multi-LLM client) -opencli chatwise status # 检查连接 -opencli chatwise new # 新建对话 -opencli chatwise send "message" # 发送消息 -opencli chatwise read # 读取回复 -opencli chatwise ask "question" # 一键提问并等回复 -opencli chatwise model claude # 切换模型 -opencli chatwise history # 对话历史 -opencli chatwise export # 导出对话 -opencli chatwise screenshot # 截图 - -# Notion (desktop — CDP via Electron) -opencli notion status # 检查连接 -opencli notion search "keyword" # 搜索页面 -opencli notion read # 读取当前页面 -opencli notion new # 新建页面 -opencli notion write "content" # 写入内容 -opencli notion sidebar # 侧边栏导航 -opencli notion favorites # 收藏列表 -opencli notion export # 导出 - -# Discord App (desktop — CDP via Electron) -opencli discord-app status # 检查连接 -opencli discord-app send "message" # 发送消息 -opencli discord-app read # 读取消息 -opencli discord-app channels # 频道列表 -opencli discord-app servers # 服务器列表 -opencli discord-app search "keyword" # 搜索 -opencli discord-app members # 成员列表 - -# Doubao App 豆包桌面版 (desktop — CDP via Electron) -opencli doubao-app status # 检查连接 -opencli doubao-app new # 新建对话 -opencli doubao-app send "message" # 发送消息 -opencli doubao-app read # 读取回复 -opencli doubao-app ask "question" # 一键提问并等回复 -opencli doubao-app screenshot # 截图 -opencli doubao-app dump # 导出 DOM 调试信息 +opencli hot --limit 10 # 热门/排行 +opencli search "query" # 搜索 (query positional) +opencli feed --limit 10 # 动态/时间线 +opencli # Write 操作 (follow/like/post etc.) ``` -### Management Commands +### Management ```bash -opencli list # List all commands (including External CLIs) -opencli list --json # JSON output -opencli list -f yaml # YAML output -opencli install # Auto-install an external CLI (e.g., gh, obsidian) -opencli register # Register a local custom CLI for unified discovery -opencli validate # Validate all CLI definitions -opencli validate bilibili # Validate specific site -opencli doctor # Diagnose browser bridge (auto-starts daemon, includes live test) +opencli list # 列出所有命令 +opencli validate # 验证 adapter 定义 +opencli doctor # 诊断 browser bridge +opencli install # 安装 external CLI ``` -### AI Agent Workflow - -```bash -# Deep Explore: network intercept → response analysis → capability inference -opencli explore --site - -# Synthesize: generate evaluate-based YAML pipelines from explore artifacts -opencli synthesize - -# Generate: one-shot explore → synthesize → register -opencli generate --goal "hot" - -# Record: YOU operate the page, opencli captures every API call → YAML candidates -# Opens the URL in automation window, injects fetch/XHR interceptor into ALL tabs, -# polls every 2s, auto-stops after 60s (or press Enter to stop early). -opencli record # 录制，site name 从域名推断 -opencli record --site mysite # 指定 site name -opencli record --timeout 120000 # 自定义超时（毫秒，默认 60000） -opencli record --poll 1000 # 缩短轮询间隔（毫秒，默认 2000） -opencli record --out .opencli/record/x # 自定义输出目录 -# Output: -# .opencli/record//captured.json ← 原始捕获数据（带 url/method/body） -# .opencli/record//candidates/*.yaml ← 高置信度候选适配器（score ≥ 8，有 array 结果） - -# Strategy Cascade: auto-probe PUBLIC → COOKIE → HEADER -opencli cascade - -# Explore with interactive fuzzing (click buttons to trigger lazy APIs) -opencli explore --auto --click "字幕,CC,评论" - -# Validate: validate adapter definitions -opencli validate -``` +### Output Formats -## Output Formats - -All built-in commands support `--format` / `-f` with `table`, `json`, `yaml`, `md`, and `csv`. -The `list` command supports the same formats and also keeps `--json` as a compatibility alias. - -```bash -opencli list -f yaml # YAML command registry -opencli bilibili hot -f table # Default: rich table -opencli bilibili hot -f json # JSON (pipe to jq, feed to AI agent) -opencli bilibili hot -f yaml # YAML (readable structured output) -opencli bilibili hot -f md # Markdown -opencli bilibili hot -f csv # CSV -``` - -## Verbose Mode - -```bash -opencli bilibili hot -v # Show each pipeline step and data flow -``` - -## Record Workflow - -`record` 是为「无法用 `explore` 自动发现」的页面（需要登录操作、复杂交互、SPA 内路由）准备的手动录制方案。 - -### 工作原理 - -``` -opencli record - → 打开 automation window 并导航到目标 URL - → 向所有 tab 注入 fetch/XHR 拦截器（幂等，可重复注入） - → 每 2s 轮询一次：发现新 tab 自动注入，drain 所有 tab 的捕获缓冲区 - → 超时（默认 60s）或按 Enter 停止 - → 分析捕获到的 JSON 请求：去重 → 评分 → 生成候选 YAML -``` - -**拦截器特性**： -- 同时 patch `window.fetch` 和 `XMLHttpRequest` -- 只捕获 `Content-Type: application/json` 的响应 -- 过滤纯对象少于 2 个 key 的响应（避免 tracking/ping） -- 跨 tab 隔离：每个 tab 独立缓冲区，轮询时分别 drain -- 幂等注入：同一 tab 二次注入时先 restore 原始函数再重新 patch，不丢失已捕获数据 - -### 使用步骤 - -```bash -# 1. 启动录制（建议 --timeout 给足操作时间） -opencli record "https://example.com/page" --timeout 120000 - -# 2. 在弹出的 automation window 里正常操作页面： -# - 打开列表、搜索、点击条目、切换 Tab -# - 凡是触发网络请求的操作都会被捕获 - -# 3. 完成操作后按 Enter 停止（或等超时自动停止） - -# 4. 查看结果 -cat .opencli/record//captured.json # 原始捕获 -ls .opencli/record//candidates/ # 候选 YAML -``` - -### 页面类型与捕获预期 - -| 页面类型 | 预期捕获量 | 说明 | -|---------|-----------|------| -| 列表/搜索页 | 多（5~20+） | 每次搜索/翻页都会触发新请求 | -| 详情页（只读） | 少（1~5） | 首屏数据一次性返回，后续操作走 form/redirect | -| SPA 内路由跳转 | 中等 | 路由切换会触发新接口，但首屏请求在注入前已发出 | -| 需要登录的页面 | 视操作而定 | 确保 Chrome 已登录目标网站 | - -> **注意**：如果页面在导航完成前就发出了大部分请求（服务端渲染 / SSR 注水），拦截器会错过这些请求。 -> 解决方案：在页面加载完成后，手动触发能产生新请求的操作（搜索、翻页、切 Tab、展开折叠项等）。 - -### 候选 YAML → TS CLI 转换 - -生成的候选 YAML 是起点，通常需要转换为 TypeScript（尤其是 tae 等内部系统）： - -**候选 YAML 结构**（自动生成）： -```yaml -site: tae -name: getList # 从 URL path 推断的名称 -strategy: cookie -browser: true -pipeline: - - navigate: https://... - - evaluate: | - (async () => { - const res = await fetch('/approval/getList.json?procInsId=...', { credentials: 'include' }); - const data = await res.json(); - return (data?.content?.operatorRecords || []).map(item => ({ ... })); - })() -``` - -**转换为 TS CLI**（参考 `src/clis/tae/add-expense.ts` 风格）： -```typescript -import { cli, Strategy } from '../../registry.js'; - -cli({ - site: 'tae', - name: 'get-approval', - description: '查看报销单审批流程和操作记录', - domain: 'tae.alibaba-inc.com', - strategy: Strategy.COOKIE, - browser: true, - args: [ - { name: 'proc_ins_id', type: 'string', required: true, positional: true, help: '流程实例 ID（procInsId）' }, - ], - columns: ['step', 'operator', 'action', 'time'], - func: async (page, kwargs) => { - await page.goto('https://tae.alibaba-inc.com/expense/pc.html?_authType=SAML'); - await page.wait(2); - const result = await page.evaluate(`(async () => { - const res = await fetch('/approval/getList.json?taskId=&procInsId=${kwargs.proc_ins_id}', { - credentials: 'include' - }); - const data = await res.json(); - return data?.content?.operatorRecords || []; - })()`); - return (result as any[]).map((r, i) => ({ - step: i + 1, - operator: r.operatorName || r.userId, - action: r.operationType, - time: r.operateTime, - })); - }, -}); -``` - -**转换要点**： -1. URL 中的动态 ID（`procInsId`、`taskId` 等）提取为 `args` -2. `captured.json` 里的真实 body 结构用于确定正确的数据路径（如 `content.operatorRecords`） -3. tae 系统统一用 `{ success, content, errorCode, errorMsg }` 外层包裹，取数据要走 `content.*` -4. 认证方式：cookie（`credentials: 'include'`），不需要额外 header -5. 文件放入 `src/clis//`，无需手动注册，`npm run build` 后自动发现 - -### 故障排查 - -| 现象 | 原因 | 解法 | -|------|------|------| -| 捕获 0 条请求 | 拦截器注入失败，或页面无 JSON API | 检查 daemon 是否运行：`curl localhost:19825/status` | -| 捕获量少（1~3 条） | 页面是只读详情页，首屏数据已在注入前发出 | 手动操作触发更多请求（搜索/翻页），或换用列表页 | -| 候选 YAML 为 0 | 捕获到的 JSON 都没有 array 结构 | 直接看 `captured.json` 手写 TS CLI | -| 新开的 tab 没有被拦截 | 轮询间隔内 tab 已关闭 | 缩短 `--poll 500` | -| 二次运行 record 时数据不连续 | 正常，每次 `record` 启动都是新的 automation window | 无需处理 | - -## Creating Adapters - -> [!TIP] -> **快速模式**：如果你只想为一个具体页面生成一个命令，直接看 [CLI-ONESHOT.md](./CLI-ONESHOT.md)。 -> 只需要一个 URL + 一句话描述，4 步搞定。 - -> [!IMPORTANT] -> **完整模式 — 在写任何代码之前，先阅读 [CLI-EXPLORER.md](./CLI-EXPLORER.md)。** -> 它包含：① AI Agent 浏览器探索工作流 ② 认证策略决策树 ③ 平台 SDK（如 Bilibili 的 `apiGet`/`fetchJson`）④ YAML vs TS 选择指南 ⑤ `tap` 步骤调试方法 ⑥ 级联请求模板 ⑦ 常见陷阱表。 -> **下方仅为简化模板参考，直接使用极易踩坑。** - -### YAML Pipeline (declarative, recommended) - -Create `src/clis//.yaml`: - -```yaml -site: mysite -name: hot -description: Hot topics -domain: www.mysite.com -strategy: cookie # public | cookie | header | intercept | ui -browser: true - -args: - limit: - type: int - default: 20 - description: Number of items - -pipeline: - - navigate: https://www.mysite.com - - - evaluate: | - (async () => { - const res = await fetch('/api/hot', { credentials: 'include' }); - const d = await res.json(); - return d.data.items.map(item => ({ - title: item.title, - score: item.score, - })); - })() - - - map: - rank: ${{ index + 1 }} - title: ${{ item.title }} - score: ${{ item.score }} - - - limit: ${{ args.limit }} - -columns: [rank, title, score] -``` - -For public APIs (no browser): - -```yaml -strategy: public -browser: false - -pipeline: - - fetch: - url: https://api.example.com/hot.json - - select: data.items - - map: - title: ${{ item.title }} - - limit: ${{ args.limit }} -``` - -### TypeScript Adapter (programmatic) - -Create `src/clis//.ts`. It will be automatically dynamically loaded (DO NOT manually import it in `index.ts`): - -```typescript -import { cli, Strategy } from '../../registry.js'; - -cli({ - site: 'mysite', - name: 'search', - strategy: Strategy.INTERCEPT, // Or COOKIE - args: [{ name: 'query', required: true, positional: true }], - columns: ['rank', 'title', 'url'], - func: async (page, kwargs) => { - await page.goto('https://www.mysite.com/search'); - - // Inject native XHR/Fetch interceptor hook - await page.installInterceptor('/api/search'); - - // Auto scroll down to trigger lazy loading - await page.autoScroll({ times: 3, delayMs: 2000 }); - - // Retrieve intercepted JSON payloads - const requests = await page.getInterceptedRequests(); - - let results = []; - for (const req of requests) { - results.push(...req.data.items); - } - return results.map((item, i) => ({ - rank: i + 1, title: item.title, url: item.url, - })); - }, -}); -``` - -**When to use TS**: XHR interception (`page.installInterceptor`), infinite scrolling (`page.autoScroll`), cookie extraction, complex data transforms (like GraphQL unwrapping). - -## Pipeline Steps - -| Step | Description | Example | -|------|-------------|---------| -| `navigate` | Go to URL | `navigate: https://example.com` | -| `fetch` | HTTP request (browser cookies) | `fetch: { url: "...", params: { q: "..." } }` | -| `evaluate` | Run JavaScript in page | `evaluate: \| (async () => { ... })()` | -| `select` | Extract JSON path | `select: data.items` | -| `map` | Map fields | `map: { title: "${{ item.title }}" }` | -| `filter` | Filter items | `filter: item.score > 100` | -| `sort` | Sort items | `sort: { by: score, order: desc }` | -| `limit` | Cap result count | `limit: ${{ args.limit }}` | -| `intercept` | Declarative XHR capture | `intercept: { trigger: "navigate:...", capture: "api/hot" }` | -| `tap` | Store action + XHR capture | `tap: { store: "feed", action: "fetchFeeds", capture: "homefeed" }` | -| `snapshot` | Page accessibility tree | `snapshot: { interactive: true }` | -| `click` | Click element | `click: ${{ ref }}` | -| `type` | Type text | `type: { ref: "@1", text: "hello" }` | -| `wait` | Wait for time/text | `wait: 2` or `wait: { text: "loaded" }` | -| `press` | Press key | `press: Enter` | - -## Template Syntax - -```yaml -# Arguments with defaults -${{ args.query }} -${{ args.limit | default(20) }} - -# Current item (in map/filter) -${{ item.title }} -${{ item.data.nested.field }} - -# Index (0-based) -${{ index }} -${{ index + 1 }} -``` +所有命令支持 `--format` / `-f`: `table`(default), `json`, `yaml`, `md`, `csv`。 +加 `-v` 显示 pipeline 每步数据流。 ## 5-Tier Authentication Strategy | Tier | Name | Method | Example | |------|------|--------|---------| | 1 | `public` | No auth, Node.js fetch | Hacker News, V2EX | -| 2 | `cookie` | Browser fetch with `credentials: include` | Bilibili, Zhihu | +| 2 | `cookie` | Browser fetch + `credentials: include` | Bilibili, Zhihu | | 3 | `header` | Custom headers (ct0, Bearer) | Twitter GraphQL | | 4 | `intercept` | XHR interception + store mutation | 小红书 Pinia | | 5 | `ui` | Full UI automation (click/type/scroll) | Last resort | @@ -872,8 +104,17 @@ ${{ index + 1 }} | Issue | Solution | |-------|----------| -| `npx not found` | Install Node.js: `brew install node` | -| `Extension not connected` | 1) Chrome must be open 2) Install opencli Browser Bridge extension | +| `Extension not connected` | Chrome must be open + install Browser Bridge extension | | `Target page context` error | Add `navigate:` step before `evaluate:` in YAML | | Empty table data | Check if evaluate returns correct data path | -| Daemon issues | `curl localhost:19825/status` to check, `curl localhost:19825/logs` for extension logs | +| Daemon issues | `curl localhost:19825/status` to check | + +## Related Skills & Docs + +| 需求 | 去哪里 | +|------|--------| +| 查具体命令语法 | [references/commands.md](./references/commands.md) | +| 开发新 adapter | `.agents/skills/adapter-dev/SKILL.md` + [CLI-EXPLORER.md](./CLI-EXPLORER.md) | +| 使用 record 录制 | `.agents/skills/record-workflow/SKILL.md` | +| 从外部 CLI 迁移 | `.agents/skills/cross-project-adapter-migration/SKILL.md` | +| Review PR | `.agents/skills/review-pr/SKILL.md` | diff --git a/references/commands.md b/references/commands.md new file mode 100644 index 00000000..d678dea7 --- /dev/null +++ b/references/commands.md @@ -0,0 +1,487 @@ +# OpenCLI Commands Reference + +> 完整的命令列表。按平台分类，每个命令包含示例用法。 +> 从 SKILL.md 提取，按需查阅而非全量加载。 + +## Table of Contents + +- [Data Commands](#data-commands) — 社交/内容/金融/工具类网站 +- [Desktop Adapter Commands](#desktop-adapter-commands) — Electron/桌面应用 +- [Management Commands](#management-commands) — list/install/validate/doctor +- [AI Agent Workflow](#ai-agent-workflow) — explore/synthesize/generate/record/cascade + +--- + +## Data Commands + +```bash +# Bilibili (browser) +opencli bilibili hot --limit 10 # B站热门视频 +opencli bilibili search "rust" # 搜索视频 (query positional) +opencli bilibili me # 我的信息 +opencli bilibili favorite # 我的收藏 +opencli bilibili history --limit 20 # 观看历史 +opencli bilibili feed --limit 10 # 动态时间线 +opencli bilibili user-videos --uid 12345 # 用户投稿 +opencli bilibili subtitle --bvid BV1xxx # 获取视频字幕 (支持 --lang zh-CN) +opencli bilibili dynamic --limit 10 # 动态 +opencli bilibili ranking --limit 10 # 排行榜 +opencli bilibili following --limit 20 # 我的关注列表 (支持 --uid 查看他人) + +# 知乎 (browser) +opencli zhihu hot --limit 10 # 知乎热榜 +opencli zhihu search "AI" # 搜索 (query positional) +opencli zhihu question 34816524 # 问题详情和回答 (id positional) + +# 小红书 (browser) +opencli xiaohongshu search "美食" # 搜索笔记 (query positional) +opencli xiaohongshu notifications # 通知（mentions/likes/connections） +opencli xiaohongshu feed --limit 10 # 推荐 Feed +opencli xiaohongshu user xxx # 用户主页 (id positional) +opencli xiaohongshu creator-notes --limit 10 # 创作者笔记列表 +opencli xiaohongshu creator-note-detail --note-id xxx # 笔记详情 +opencli xiaohongshu creator-notes-summary # 笔记数据概览 +opencli xiaohongshu creator-profile # 创作者资料 +opencli xiaohongshu creator-stats # 创作者数据统计 + +# 雪球 Xueqiu (browser) +opencli xueqiu hot-stock --limit 10 # 雪球热门股票榜 +opencli xueqiu stock --symbol SH600519 # 查看股票实时行情 +opencli xueqiu watchlist # 获取自选股/持仓列表 +opencli xueqiu feed # 我的关注 timeline +opencli xueqiu hot --limit 10 # 雪球热榜 +opencli xueqiu search "特斯拉" # 搜索 (query positional) +opencli xueqiu earnings-date SH600519 # 股票财报发布日期 (symbol positional) +opencli xueqiu fund-holdings # 蛋卷基金持仓明细 (支持 --account 过滤) +opencli xueqiu fund-snapshot # 蛋卷基金快照（总资产、子账户、持仓） + +# GitHub (via gh External CLI) +opencli gh repo list # 列出仓库 (passthrough to gh) +opencli gh pr list --limit 5 # PR 列表 +opencli gh issue list # Issue 列表 + +# Twitter/X (browser) +opencli twitter trending --limit 10 # 热门话题 +opencli twitter bookmarks --limit 20 # 获取收藏的书签推文 +opencli twitter search "AI" # 搜索推文 (query positional) +opencli twitter profile elonmusk # 用户资料 +opencli twitter timeline --limit 20 # 时间线 +opencli twitter thread 1234567890 # 推文 thread（原文 + 回复） +opencli twitter article 1891511252174299446 # 推文长文内容 +opencli twitter follow elonmusk # 关注用户 +opencli twitter unfollow elonmusk # 取消关注 +opencli twitter bookmark https://x.com/... # 收藏推文 +opencli twitter unbookmark https://x.com/... # 取消收藏 +opencli twitter post "Hello world" # 发布推文 (text positional) +opencli twitter like https://x.com/... # 点赞推文 (url positional) +opencli twitter reply https://x.com/... "Nice!" # 回复推文 (url + text positional) +opencli twitter delete https://x.com/... # 删除推文 (url positional) +opencli twitter block elonmusk # 屏蔽用户 (username positional) +opencli twitter unblock elonmusk # 取消屏蔽 (username positional) +opencli twitter followers elonmusk # 用户的粉丝列表 (user positional) +opencli twitter following elonmusk # 用户的关注列表 (user positional) +opencli twitter notifications --limit 20 # 通知列表 +opencli twitter hide-reply https://x.com/... # 隐藏回复 (url positional) +opencli twitter download elonmusk # 下载用户媒体 (username positional, 支持 --tweet-url) +opencli twitter accept "群,微信" # 自动接受含关键词的 DM 请求 (query positional) +opencli twitter reply-dm "消息内容" # 批量回复 DM (text positional) + +# Reddit (browser) +opencli reddit hot --limit 10 # 热门帖子 +opencli reddit hot --subreddit programming # 指定子版块 +opencli reddit frontpage --limit 10 # 首页 /r/all +opencli reddit popular --limit 10 # /r/popular 热门 +opencli reddit search "AI" --sort top --time week # 搜索（支持排序+时间过滤） +opencli reddit subreddit rust --sort top --time month # 子版块浏览（支持时间过滤） +opencli reddit read --post-id 1abc123 # 阅读帖子 + 评论 +opencli reddit user spez # 用户资料（karma、注册时间） +opencli reddit user-posts spez # 用户发帖历史 +opencli reddit user-comments spez # 用户评论历史 +opencli reddit upvote --post-id xxx --direction up # 投票（up/down/none） +opencli reddit save --post-id xxx # 收藏帖子 +opencli reddit comment --post-id xxx "Great!" # 发表评论 (text positional) +opencli reddit subscribe --subreddit python # 订阅子版块 +opencli reddit saved --limit 10 # 我的收藏 +opencli reddit upvoted --limit 10 # 我的赞 + +# V2EX (public + browser) +opencli v2ex hot --limit 10 # 热门话题 +opencli v2ex latest --limit 10 # 最新话题 +opencli v2ex topic 1024 # 主题详情 (id positional) +opencli v2ex daily # 每日签到 (browser) +opencli v2ex me # 我的信息 (browser) +opencli v2ex notifications --limit 10 # 通知 (browser) +opencli v2ex node python # 节点话题列表 (name positional) +opencli v2ex nodes --limit 30 # 所有节点列表 +opencli v2ex member username # 用户资料 (username positional) +opencli v2ex user username # 用户发帖列表 (username positional) +opencli v2ex replies 1024 # 主题回复列表 (id positional) + +# Hacker News (public) +opencli hackernews top --limit 10 # Top stories +opencli hackernews new --limit 10 # Newest stories +opencli hackernews best --limit 10 # Best stories +opencli hackernews ask --limit 10 # Ask HN posts +opencli hackernews show --limit 10 # Show HN posts +opencli hackernews jobs --limit 10 # Job postings +opencli hackernews search "rust" # 搜索 (query positional) +opencli hackernews user dang # 用户资料 (username positional) + +# BBC (public) +opencli bbc news --limit 10 # BBC News RSS headlines + +# 微博 (browser) +opencli weibo hot --limit 10 # 微博热搜 + +# BOSS直聘 (browser) +opencli boss search "AI agent" # 搜索职位 (query positional) +opencli boss detail --security-id xxx # 职位详情 +opencli boss recommend --limit 10 # 推荐职位 +opencli boss joblist --limit 10 # 职位列表 +opencli boss greet --security-id xxx # 打招呼 +opencli boss batchgreet --job-id xxx # 批量打招呼 +opencli boss send --uid xxx "消息内容" # 发消息 (text positional) +opencli boss chatlist --limit 10 # 聊天列表 +opencli boss chatmsg --security-id xxx # 聊天记录 +opencli boss invite --security-id xxx # 邀请沟通 +opencli boss mark --security-id xxx # 标记管理 +opencli boss exchange --security-id xxx # 交换联系方式 +opencli boss resume # 简历管理 +opencli boss stats # 数据统计 + +# YouTube (browser) +opencli youtube search "rust" # 搜索视频 (query positional) +opencli youtube video "https://www.youtube.com/watch?v=xxx" # 视频元数据 +opencli youtube transcript "https://www.youtube.com/watch?v=xxx" # 获取视频字幕/转录 +opencli youtube transcript "xxx" --lang zh-Hans --mode raw # 指定语言 + 原始时间戳模式 + +# Yahoo Finance (browser) +opencli yahoo-finance quote --symbol AAPL # 股票行情 + +# Sina Finance +opencli sinafinance news --limit 10 --type 1 # 7x24实时快讯 + +# Reuters (browser) +opencli reuters search "AI" # 路透社搜索 (query positional) + +# 什么值得买 (browser) +opencli smzdm search "耳机" # 搜索好价 (query positional) + +# 携程 (browser) +opencli ctrip search "三亚" # 搜索目的地 (query positional) + +# Antigravity (Electron/CDP) +opencli antigravity status # 检查 CDP 连接 +opencli antigravity send "hello" # 发送文本到当前 agent 聊天框 +opencli antigravity read # 读取整个聊天记录面板 +opencli antigravity new # 清空聊天、开启新对话 +opencli antigravity dump # 导出 DOM 和快照调试信息 +opencli antigravity extract-code # 自动抽取 AI 回复中的代码块 +opencli antigravity model claude # 切换底层模型 +opencli antigravity watch # 流式监听增量消息 + +# Barchart (browser) +opencli barchart quote --symbol AAPL # 股票行情 +opencli barchart options --symbol AAPL # 期权链 +opencli barchart greeks --symbol AAPL # 期权 Greeks +opencli barchart flow --limit 20 # 异常期权活动 + +# Jike 即刻 (browser) +opencli jike feed --limit 10 # 动态流 +opencli jike search "AI" # 搜索 (query positional) +opencli jike create "内容" # 发布动态 (text positional) +opencli jike like xxx # 点赞 (id positional) +opencli jike comment xxx "评论" # 评论 (id + text positional) +opencli jike repost xxx # 转发 (id positional) +opencli jike notifications # 通知 + +# Linux.do (public + browser) +opencli linux-do hot --limit 10 # 热门话题 +opencli linux-do latest --limit 10 # 最新话题 +opencli linux-do search "rust" # 搜索 (query positional) +opencli linux-do topic 1024 # 主题详情 (id positional) +opencli linux-do categories --limit 20 # 分类列表 (browser) +opencli linux-do category dev 7 # 分类内话题 (slug + id positional, browser) + +# StackOverflow (public) +opencli stackoverflow hot --limit 10 # 热门问题 +opencli stackoverflow search "typescript" # 搜索 (query positional) +opencli stackoverflow bounties --limit 10 # 悬赏问题 + +# WeRead 微信读书 (browser) +opencli weread shelf --limit 10 # 书架 +opencli weread search "AI" # 搜索图书 (query positional) +opencli weread book xxx # 图书详情 (book-id positional) +opencli weread highlights xxx # 划线笔记 (book-id positional) +opencli weread notes xxx # 想法笔记 (book-id positional) +opencli weread ranking --limit 10 # 排行榜 + +# Jimeng 即梦 AI (browser) +opencli jimeng generate --prompt "描述" # AI 生图 +opencli jimeng history --limit 10 # 生成历史 + +# Yollomi yollomi.com (browser) +opencli yollomi models --type image # 列出图像模型与积分 +opencli yollomi generate "提示词" --model z-image-turbo # 文生图 +opencli yollomi video "提示词" --model kling-2-1 # 视频 +opencli yollomi upload ./photo.jpg # 上传得 URL +opencli yollomi remove-bg # 去背景（免费） +opencli yollomi edit "改成油画风格" # Qwen 图像编辑 +opencli yollomi background # AI 背景生成 (5 credits) +opencli yollomi face-swap --source --target # 换脸 (3 credits) +opencli yollomi object-remover # AI 去除物体 (3 credits) +opencli yollomi restore # AI 修复老照片 (4 credits) +opencli yollomi try-on --person --cloth # 虚拟试衣 (3 credits) +opencli yollomi upscale # AI 超分辨率 (1 credit) + +# Grok +opencli grok ask --prompt "问题" # 提问 Grok +opencli grok ask --prompt "问题" --web # grok.com consumer web UI 路径 + +# HuggingFace (public) +opencli hf top --limit 10 # 热门模型 + +# 超星学习通 (browser) +opencli chaoxing assignments # 作业列表 +opencli chaoxing exams # 考试列表 + +# Douban 豆瓣 (browser) +opencli douban search "三体" # 搜索 (query positional) +opencli douban top250 # 豆瓣 Top 250 +opencli douban subject 1234567 # 条目详情 (id positional) +opencli douban photos 30382501 # 图片列表 / 直链 +opencli douban download 30382501 # 下载海报 / 剧照 +opencli douban marks --limit 10 # 我的标记 +opencli douban reviews --limit 10 # 短评 + +# Facebook (browser) +opencli facebook feed --limit 10 # 动态流 +opencli facebook profile username # 用户资料 (id positional) +opencli facebook search "AI" # 搜索 (query positional) +opencli facebook friends # 好友列表 +opencli facebook groups # 群组 +opencli facebook events # 活动 +opencli facebook notifications # 通知 +opencli facebook memories # 回忆 +opencli facebook add-friend username # 添加好友 (id positional) +opencli facebook join-group groupid # 加入群组 (id positional) + +# Instagram (browser) +opencli instagram explore # 探索 +opencli instagram profile username # 用户资料 (id positional) +opencli instagram search "AI" # 搜索 (query positional) +opencli instagram user username # 用户详情 (id positional) +opencli instagram followers username # 粉丝 (id positional) +opencli instagram following username # 关注 (id positional) +opencli instagram follow username # 关注用户 (id positional) +opencli instagram unfollow username # 取消关注 (id positional) +opencli instagram like postid # 点赞 (id positional) +opencli instagram unlike postid # 取消点赞 (id positional) +opencli instagram comment postid "评论" # 评论 (id + text positional) +opencli instagram save postid # 收藏 (id positional) +opencli instagram unsave postid # 取消收藏 (id positional) +opencli instagram saved # 已收藏列表 + +# TikTok (browser) +opencli tiktok explore # 探索 +opencli tiktok search "AI" # 搜索 (query positional) +opencli tiktok profile username # 用户资料 (id positional) +opencli tiktok user username # 用户详情 (id positional) +opencli tiktok following username # 关注列表 (id positional) +opencli tiktok follow username # 关注 (id positional) +opencli tiktok unfollow username # 取消关注 (id positional) +opencli tiktok like videoid # 点赞 (id positional) +opencli tiktok unlike videoid # 取消点赞 (id positional) +opencli tiktok comment videoid "评论" # 评论 (id + text positional) +opencli tiktok save videoid # 收藏 (id positional) +opencli tiktok unsave videoid # 取消收藏 (id positional) +opencli tiktok live # 直播 +opencli tiktok notifications # 通知 +opencli tiktok friends # 朋友 + +# Medium (browser) +opencli medium feed --limit 10 # 动态流 +opencli medium search "AI" # 搜索 (query positional) +opencli medium user username # 用户主页 (id positional) + +# Substack (browser) +opencli substack feed --limit 10 # 订阅动态 +opencli substack search "AI" # 搜索 (query positional) +opencli substack publication name # 出版物详情 (id positional) + +# Sinablog 新浪博客 (browser) +opencli sinablog hot --limit 10 # 热门 +opencli sinablog search "AI" # 搜索 (query positional) +opencli sinablog article url # 文章详情 +opencli sinablog user username # 用户主页 (id positional) + +# Lobsters (public) +opencli lobsters hot --limit 10 # 热门 +opencli lobsters newest --limit 10 # 最新 +opencli lobsters active --limit 10 # 活跃 +opencli lobsters tag rust # 按标签筛选 (tag positional) + +# Google (public) +opencli google news --limit 10 # 新闻 +opencli google search "AI" # 搜索 (query positional) +opencli google suggest "AI" # 搜索建议 (query positional) +opencli google trends # 趋势 + +# DEV.to (public) +opencli devto top --limit 10 # 热门文章 +opencli devto tag javascript --limit 10 # 按标签 (tag positional) +opencli devto user username # 用户文章 (username positional) + +# Steam (public) +opencli steam top-sellers --limit 10 # 热销游戏 + +# Apple Podcasts (public) +opencli apple-podcasts top --limit 10 # 热门播客排行榜 (支持 --country) +opencli apple-podcasts search "科技" # 搜索播客 (query positional) +opencli apple-podcasts episodes 12345 # 播客剧集列表 (id positional) + +# arXiv (public) +opencli arxiv search "attention" # 搜索论文 (query positional) +opencli arxiv paper 1706.03762 # 论文详情 (id positional) + +# Bloomberg (public RSS + browser) +opencli bloomberg main --limit 10 # 首页头条 (RSS) +opencli bloomberg markets --limit 10 # 市场新闻 (RSS) +opencli bloomberg tech --limit 10 # 科技新闻 (RSS) +opencli bloomberg politics --limit 10 # 政治新闻 (RSS) +opencli bloomberg feeds # 列出所有 RSS feed 别名 +opencli bloomberg news "https://..." # 阅读文章全文 (link positional, browser) + +# Coupang 쿠팡 (browser) +opencli coupang search "耳机" # 搜索商品 (query positional, 支持 --filter rocket) +opencli coupang add-to-cart 12345 # 加入购物车 (product-id positional) + +# Dictionary (public) +opencli dictionary search "serendipity" # 单词释义 (word positional) +opencli dictionary synonyms "happy" # 近义词 (word positional) +opencli dictionary examples "ubiquitous" # 例句 (word positional) + +# 豆包 Doubao Web (browser) +opencli doubao status # 检查豆包页面状态 +opencli doubao new # 新建对话 +opencli doubao send "你好" # 发送消息 (text positional) +opencli doubao read # 读取对话记录 +opencli doubao ask "问题" # 一键提问并等回复 (text positional) + +# 京东 JD (browser) +opencli jd item 100291143898 # 商品详情 (sku positional) + +# LinkedIn (browser) +opencli linkedin search "AI engineer" # 搜索职位 (query positional) +opencli linkedin timeline --limit 20 # 首页动态流 + +# Pixiv (browser) +opencli pixiv ranking --limit 20 # 插画排行榜 (支持 --mode daily/weekly/monthly) +opencli pixiv search "風景" # 搜索插画 (query positional) +opencli pixiv user 12345 # 画师资料 (uid positional) +opencli pixiv illusts 12345 # 画师作品列表 (user-id positional) +opencli pixiv detail 12345 # 插画详情 (id positional) +opencli pixiv download 12345 # 下载插画 (illust-id positional) + +# Web (browser) +opencli web read --url "https://..." # 抓取任意网页导出为 Markdown + +# 微信公众号 Weixin (browser) +opencli weixin download --url "https://mp.weixin.qq.com/s/xxx" # 下载公众号文章为 Markdown + +# 小宇宙 Xiaoyuzhou (public) +opencli xiaoyuzhou podcast 12345 # 播客资料 (id positional) +opencli xiaoyuzhou podcast-episodes 12345 # 播客剧集列表 (id positional) +opencli xiaoyuzhou episode 12345 # 单集详情 (id positional) + +# Wikipedia (public) +opencli wikipedia search "AI" # 搜索 (query positional) +opencli wikipedia summary "Python" # 摘要 (title positional) +``` + +## Desktop Adapter Commands + +```bash +# Cursor (desktop — CDP via Electron) +opencli cursor status # 检查连接 +opencli cursor send "message" # 发送消息 +opencli cursor read # 读取回复 +opencli cursor new # 新建对话 +opencli cursor dump # 导出 DOM 调试信息 +opencli cursor composer # Composer 模式 +opencli cursor model claude # 切换模型 +opencli cursor extract-code # 提取代码块 +opencli cursor ask "question" # 一键提问并等回复 +opencli cursor screenshot # 截图 +opencli cursor history # 对话历史 +opencli cursor export # 导出对话 + +# Codex (desktop — headless CLI agent) +opencli codex status / send / read / new / dump / extract-diff / model / ask / screenshot / history / export + +# ChatGPT (desktop — macOS AppleScript/CDP) +opencli chatgpt status / new / send / read / ask + +# ChatWise (desktop — multi-LLM client) +opencli chatwise status / new / send / read / ask / model / history / export / screenshot + +# Notion (desktop — CDP via Electron) +opencli notion status / search / read / new / write / sidebar / favorites / export + +# Discord App (desktop — CDP via Electron) +opencli discord-app status / send / read / channels / servers / search / members + +# Doubao App 豆包桌面版 (desktop — CDP via Electron) +opencli doubao-app status / new / send / read / ask / screenshot / dump +``` + +## Management Commands + +```bash +opencli list # List all commands (including External CLIs) +opencli list --json # JSON output +opencli list -f yaml # YAML output +opencli install # Auto-install an external CLI (e.g., gh, obsidian) +opencli register # Register a local custom CLI for unified discovery +opencli validate # Validate all CLI definitions +opencli validate bilibili # Validate specific site +opencli doctor # Diagnose browser bridge (auto-starts daemon, includes live test) +``` + +## AI Agent Workflow + +```bash +# Deep Explore: network intercept → response analysis → capability inference +opencli explore --site + +# Synthesize: generate evaluate-based YAML pipelines from explore artifacts +opencli synthesize + +# Generate: one-shot explore → synthesize → register +opencli generate --goal "hot" + +# Record: YOU operate the page, opencli captures every API call → YAML candidates +opencli record # 录制，site name 从域名推断 +opencli record --site mysite # 指定 site name +opencli record --timeout 120000 # 自定义超时（毫秒） +opencli record --poll 1000 # 缩短轮询间隔 +opencli record --out .opencli/record/x # 自定义输出目录 + +# Strategy Cascade: auto-probe PUBLIC → COOKIE → HEADER +opencli cascade + +# Explore with interactive fuzzing +opencli explore --auto --click "字幕,CC,评论" +``` + +## Output Formats + +All commands support `--format` / `-f`: `table`, `json`, `yaml`, `md`, `csv`. + +```bash +opencli bilibili hot -f json # JSON (pipe to jq, feed to AI agent) +opencli bilibili hot -f yaml # YAML +opencli bilibili hot -f md # Markdown +opencli bilibili hot -f csv # CSV +opencli bilibili hot -v # Verbose: show pipeline step data flow +```