@jackwener/opencli 1.3.3 → 1.4.1

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: opencli
 description: "OpenCLI — Make any website or Electron App your CLI. Zero risk, AI-powered, reuse Chrome login."
-version: 1.3.1
+version: 1.4.1
 author: jackwener
 tags: [cli, browser, web, chrome-extension, cdp, bilibili, zhihu, twitter, github, v2ex, hackernews, reddit, xiaohongshu, xueqiu, youtube, boss, coupang, yollomi, AI, agent]
 ---
@@ -15,6 +15,12 @@ tags: [cli, browser, web, chrome-extension, cdp, bilibili, zhihu, twitter, githu
 > 该文档包含完整的 API 发现工作流（必须使用浏览器探索）、5 级认证策略决策树、平台 SDK 速查表、`tap` 步骤调试流程、分页 API 模板、级联请求模式、以及常见陷阱。
 > **本文件（SKILL.md）仅提供命令参考和简化模板，不足以正确开发适配器。**
 
+> [!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 中受影响的入口
+
 ## Install & Run
 
 ```bash
@@ -82,6 +88,9 @@ 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)
@@ -100,6 +109,19 @@ 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            # 热门帖子
@@ -126,9 +148,21 @@ 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
@@ -198,11 +232,13 @@ opencli jike comment xxx "评论"           # 评论 (id + text positional)
 opencli jike repost xxx                  # 转发 (id positional)
 opencli jike notifications               # 通知
 
-# Linux.do (public)
+# 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     # 热门问题
@@ -228,6 +264,12 @@ opencli yollomi video "提示词" --model kling-2-1        # 视频
 opencli yollomi upload ./photo.jpg       # 上传得 URL，供 img2img / 工具链使用
 opencli yollomi remove-bg <image-url>    # 去背景（免费）
 opencli yollomi edit <image-url> "改成油画风格"        # Qwen 图像编辑
+opencli yollomi background <image-url>   # AI 背景生成 (5 credits)
+opencli yollomi face-swap --source <url> --target <url>  # 换脸 (3 credits)
+opencli yollomi object-remover <image-url> <mask-url>    # AI 去除物体 (3 credits)
+opencli yollomi restore <image-url>      # AI 修复老照片 (4 credits)
+opencli yollomi try-on --person <url> --cloth <url>      # 虚拟试衣 (3 credits)
+opencli yollomi upscale <image-url>      # AI 超分辨率 (1 credit, 支持 --scale 2/4)
 
 # Grok (default + explicit web)
 opencli grok ask --prompt "问题"         # 提问 Grok（兼容默认路径）
@@ -328,6 +370,69 @@ 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)

package/TESTING.md

@@ -68,6 +68,7 @@ src/
 | `tests/e2e/browser-auth.test.ts` | `bilibili`、`twitter`、`v2ex`、`xueqiu`、`linux-do`、`xiaohongshu` 的需登录命令 graceful failure |
 | `tests/e2e/management.test.ts` | `list`、`validate`、`verify`、`--version`、`--help`、unknown command |
 | `tests/e2e/output-formats.test.ts` | `json` / `yaml` / `csv` / `md` 输出格式校验 |
+| `tests/e2e/plugin-management.test.ts` | `plugin install` / `list` / `update` / `uninstall` 全生命周期 |
 
 ### 烟雾测试（1 个文件）
 

package/chatwise-opencli.ps1

@@ -0,0 +1,82 @@
+[CmdletBinding()]
+param(
+  [Parameter(ValueFromRemainingArguments = $true)]
+  [string[]]$OpenCliArgs
+)
+
+$ErrorActionPreference = 'Stop'
+
+$chatwiseExe = 'C:\Program Files\ChatWise\ChatWise.exe'
+if (-not (Test-Path $chatwiseExe)) {
+  throw "ChatWise executable not found at $chatwiseExe"
+}
+
+$opencli = Get-Command opencli -ErrorAction SilentlyContinue
+if (-not $opencli) {
+  throw 'opencli was not found in PATH'
+}
+
+function Clear-LocalProxyEnv {
+  $vars = 'http_proxy','https_proxy','HTTP_PROXY','HTTPS_PROXY'
+  foreach ($name in $vars) {
+    Set-Item -Path "Env:$name" -Value ''
+  }
+  $noProxy = '127.0.0.1,localhost'
+  Set-Item -Path 'Env:NO_PROXY' -Value $noProxy
+  Set-Item -Path 'Env:no_proxy' -Value $noProxy
+}
+
+function Stop-ChatWiseTree {
+  $candidates = Get-CimInstance Win32_Process |
+    Where-Object { $_.Name -match '^ChatWise\.exe$|^chatwise\.exe$' }
+
+  foreach ($proc in $candidates) {
+    try {
+      Stop-Process -Id $proc.ProcessId -Force -ErrorAction Stop
+    } catch {}
+  }
+
+  Start-Sleep -Seconds 2
+}
+
+function Wait-ChatWiseDebugPort {
+  param(
+    [int]$Port = 9228,
+    [int]$TimeoutSeconds = 20
+  )
+
+  $deadline = (Get-Date).AddSeconds($TimeoutSeconds)
+  while ((Get-Date) -lt $deadline) {
+    try {
+      $resp = Invoke-WebRequest -UseBasicParsing -TimeoutSec 2 -Uri "http://127.0.0.1:$Port/json/version"
+      if ($resp.StatusCode -ge 200 -and $resp.StatusCode -lt 300) {
+        return
+      }
+    } catch {}
+    Start-Sleep -Milliseconds 500
+  }
+
+  throw "ChatWise debugging endpoint did not come up on 127.0.0.1:$Port"
+}
+
+Clear-LocalProxyEnv
+Stop-ChatWiseTree
+
+$proc = Start-Process -FilePath $chatwiseExe -ArgumentList '--remote-debugging-port=9228' -PassThru
+Start-Sleep -Seconds 4
+
+if ($proc.HasExited) {
+  throw "ChatWise exited early with code $($proc.ExitCode)"
+}
+
+Wait-ChatWiseDebugPort
+
+$env:OPENCLI_CDP_ENDPOINT = 'http://127.0.0.1:9228'
+
+if (-not $OpenCliArgs -or $OpenCliArgs.Count -eq 0) {
+  & $opencli.Source 'chatwise' 'status'
+  exit $LASTEXITCODE
+}
+
+& $opencli.Source @OpenCliArgs
+exit $LASTEXITCODE

package/dist/analysis.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Shared API analysis helpers used by both explore.ts and record.ts.
+ *
+ * Extracts common logic for:
+ *   - URL pattern normalization
+ *   - Array path discovery in JSON responses
+ *   - Field role detection
+ *   - Auth indicator inference
+ *   - Capability name inference
+ *   - Strategy inference
+ */
+/** Normalize a full URL into a pattern (replace IDs, strip volatile params). */
+export declare function urlToPattern(url: string): string;
+export interface ArrayDiscovery {
+    path: string;
+    items: unknown[];
+}
+/** Find the best (largest) array of objects in a JSON response body. */
+export declare function findArrayPath(obj: unknown, depth?: number): ArrayDiscovery | null;
+/** Flatten nested object keys up to maxDepth. */
+export declare function flattenFields(obj: unknown, prefix: string, maxDepth: number): string[];
+/** Detect semantic field roles (title, url, author, etc.) from sample fields. */
+export declare function detectFieldRoles(sampleFields: string[]): Record<string, string>;
+/** Infer a CLI capability name from a URL. */
+export declare function inferCapabilityName(url: string, goal?: string): string;
+/** Infer auth strategy from detected indicators. */
+export declare function inferStrategy(authIndicators: string[]): string;
+/** Detect auth indicators from HTTP headers. */
+export declare function detectAuthFromHeaders(headers?: Record<string, string>): string[];
+/** Detect auth indicators from URL and response body (heuristic). */
+export declare function detectAuthFromContent(url: string, body: unknown): string[];
+/** Extract non-volatile query params and classify them. */
+export declare function classifyQueryParams(url: string): {
+    params: string[];
+    hasSearch: boolean;
+    hasPagination: boolean;
+    hasLimit: boolean;
+};

package/dist/analysis.js

@@ -0,0 +1,166 @@
+/**
+ * Shared API analysis helpers used by both explore.ts and record.ts.
+ *
+ * Extracts common logic for:
+ *   - URL pattern normalization
+ *   - Array path discovery in JSON responses
+ *   - Field role detection
+ *   - Auth indicator inference
+ *   - Capability name inference
+ *   - Strategy inference
+ */
+import { VOLATILE_PARAMS, SEARCH_PARAMS, PAGINATION_PARAMS, LIMIT_PARAMS, FIELD_ROLES, } from './constants.js';
+// ── URL pattern normalization ───────────────────────────────────────────────
+/** Normalize a full URL into a pattern (replace IDs, strip volatile params). */
+export function urlToPattern(url) {
+    try {
+        const p = new URL(url);
+        const pathNorm = p.pathname
+            .replace(/\/\d+/g, '/{id}')
+            .replace(/\/[0-9a-fA-F]{8,}/g, '/{hex}')
+            .replace(/\/BV[a-zA-Z0-9]{10}/g, '/{bvid}');
+        const params = [];
+        p.searchParams.forEach((_v, k) => { if (!VOLATILE_PARAMS.has(k))
+            params.push(k); });
+        return `${p.host}${pathNorm}${params.length ? '?' + params.sort().map(k => `${k}={}`).join('&') : ''}`;
+    }
+    catch {
+        return url;
+    }
+}
+/** Find the best (largest) array of objects in a JSON response body. */
+export function findArrayPath(obj, depth = 0) {
+    if (depth > 5 || !obj || typeof obj !== 'object')
+        return null;
+    if (Array.isArray(obj)) {
+        if (obj.length >= 2 && obj.some(i => i && typeof i === 'object' && !Array.isArray(i))) {
+            return { path: '', items: obj };
+        }
+        return null;
+    }
+    let best = null;
+    for (const [key, val] of Object.entries(obj)) {
+        const found = findArrayPath(val, depth + 1);
+        if (found) {
+            const fullPath = found.path ? `${key}.${found.path}` : key;
+            const candidate = { path: fullPath, items: found.items };
+            if (!best || candidate.items.length > best.items.length)
+                best = candidate;
+        }
+    }
+    return best;
+}
+// ── Field flattening & role detection ───────────────────────────────────────
+/** Flatten nested object keys up to maxDepth. */
+export function flattenFields(obj, prefix, maxDepth) {
+    if (maxDepth <= 0 || !obj || typeof obj !== 'object')
+        return [];
+    const names = [];
+    const record = obj;
+    for (const key of Object.keys(record)) {
+        const full = prefix ? `${prefix}.${key}` : key;
+        names.push(full);
+        const val = record[key];
+        if (val && typeof val === 'object' && !Array.isArray(val))
+            names.push(...flattenFields(val, full, maxDepth - 1));
+    }
+    return names;
+}
+/** Detect semantic field roles (title, url, author, etc.) from sample fields. */
+export function detectFieldRoles(sampleFields) {
+    const detectedFields = {};
+    for (const [role, aliases] of Object.entries(FIELD_ROLES)) {
+        for (const f of sampleFields) {
+            if (aliases.includes(f.split('.').pop()?.toLowerCase() ?? '')) {
+                detectedFields[role] = f;
+                break;
+            }
+        }
+    }
+    return detectedFields;
+}
+// ── Capability name inference ───────────────────────────────────────────────
+/** Infer a CLI capability name from a URL. */
+export function inferCapabilityName(url, goal) {
+    if (goal)
+        return goal;
+    const u = url.toLowerCase();
+    if (u.includes('hot') || u.includes('popular') || u.includes('ranking') || u.includes('trending'))
+        return 'hot';
+    if (u.includes('search'))
+        return 'search';
+    if (u.includes('feed') || u.includes('timeline') || u.includes('dynamic'))
+        return 'feed';
+    if (u.includes('comment') || u.includes('reply'))
+        return 'comments';
+    if (u.includes('history'))
+        return 'history';
+    if (u.includes('profile') || u.includes('userinfo') || u.includes('/me'))
+        return 'me';
+    if (u.includes('favorite') || u.includes('collect') || u.includes('bookmark'))
+        return 'favorite';
+    try {
+        const segs = new URL(url).pathname
+            .split('/')
+            .filter(s => s && !s.match(/^\d+$/) && !s.match(/^[0-9a-f]{8,}$/i) && !s.match(/^v\d+$/));
+        if (segs.length)
+            return segs[segs.length - 1].replace(/[^a-z0-9]/gi, '_').toLowerCase();
+    }
+    catch { }
+    return 'data';
+}
+// ── Strategy inference ──────────────────────────────────────────────────────
+/** Infer auth strategy from detected indicators. */
+export function inferStrategy(authIndicators) {
+    if (authIndicators.includes('signature'))
+        return 'intercept';
+    if (authIndicators.includes('bearer') || authIndicators.includes('csrf'))
+        return 'header';
+    return 'cookie';
+}
+// ── Auth indicator detection ────────────────────────────────────────────────
+/** Detect auth indicators from HTTP headers. */
+export function detectAuthFromHeaders(headers) {
+    if (!headers)
+        return [];
+    const indicators = [];
+    const keys = Object.keys(headers).map(k => k.toLowerCase());
+    if (keys.some(k => k === 'authorization'))
+        indicators.push('bearer');
+    if (keys.some(k => k.startsWith('x-csrf') || k.startsWith('x-xsrf')))
+        indicators.push('csrf');
+    if (keys.some(k => k.startsWith('x-s') || k === 'x-t' || k === 'x-s-common'))
+        indicators.push('signature');
+    return indicators;
+}
+/** Detect auth indicators from URL and response body (heuristic). */
+export function detectAuthFromContent(url, body) {
+    const indicators = [];
+    if (body && typeof body === 'object') {
+        const keys = Object.keys(body).map(k => k.toLowerCase());
+        if (keys.some(k => k.includes('sign') || k === 'w_rid' || k.includes('token'))) {
+            indicators.push('signature');
+        }
+    }
+    if (url.includes('/wbi/') || url.includes('w_rid='))
+        indicators.push('signature');
+    if (url.includes('bearer') || url.includes('access_token'))
+        indicators.push('bearer');
+    return indicators;
+}
+// ── Query param classification ──────────────────────────────────────────────
+/** Extract non-volatile query params and classify them. */
+export function classifyQueryParams(url) {
+    const params = [];
+    try {
+        new URL(url).searchParams.forEach((_v, k) => { if (!VOLATILE_PARAMS.has(k))
+            params.push(k); });
+    }
+    catch { }
+    return {
+        params,
+        hasSearch: params.some(p => SEARCH_PARAMS.has(p)),
+        hasPagination: params.some(p => PAGINATION_PARAMS.has(p)),
+        hasLimit: params.some(p => LIMIT_PARAMS.has(p)),
+    };
+}

package/dist/browser/cdp.d.ts

@@ -24,13 +24,9 @@ export declare class CDPBridge {
         workspace?: string;
     }): Promise<IPage>;
     close(): Promise<void>;
-    /** Send a CDP command with timeout guard (P0 fix #4) */
     send(method: string, params?: Record<string, unknown>, timeoutMs?: number): Promise<unknown>;
-    /** Listen for a CDP event */
     on(event: string, handler: (params: unknown) => void): void;
-    /** Remove a CDP event listener */
     off(event: string, handler: (params: unknown) => void): void;
-    /** Wait for a CDP event to fire (one-shot) */
     waitForEvent(event: string, timeoutMs?: number): Promise<unknown>;
 }
 declare function selectCDPTarget(targets: CDPTarget[]): CDPTarget | undefined;