@jackwener/opencli 1.0.6 → 1.1.1

package/dist/runtime.js

@@ -1,3 +1,11 @@
+import { BrowserBridge, CDPBridge } from './browser/index.js';
+/**
+ * Returns the appropriate browser factory based on environment config.
+ * Uses CDPBridge when OPENCLI_CDP_ENDPOINT is set, otherwise BrowserBridge.
+ */
+export function getBrowserFactory() {
+    return (process.env.OPENCLI_CDP_ENDPOINT ? CDPBridge : BrowserBridge);
+}
 export const DEFAULT_BROWSER_CONNECT_TIMEOUT = parseInt(process.env.OPENCLI_BROWSER_CONNECT_TIMEOUT ?? '30', 10);
 export const DEFAULT_BROWSER_COMMAND_TIMEOUT = parseInt(process.env.OPENCLI_BROWSER_COMMAND_TIMEOUT ?? '60', 10);
 export const DEFAULT_BROWSER_EXPLORE_TIMEOUT = parseInt(process.env.OPENCLI_BROWSER_EXPLORE_TIMEOUT ?? '120', 10);

package/dist/serialization.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Serialization and formatting helpers for CLI commands and args.
+ *
+ * Used by the `list` command, Commander --help, and build-manifest.
+ * Separated from registry.ts to keep the registry focused on types + registration.
+ */
+import type { Arg, CliCommand } from './registry.js';
+export type SerializedArg = {
+    name: string;
+    type: string;
+    required: boolean;
+    positional: boolean;
+    choices: string[];
+    default: unknown;
+    help: string;
+};
+/** Stable arg schema — every field is always present (no sparse objects). */
+export declare function serializeArg(a: Arg): SerializedArg;
+/** Full command metadata for structured output (json/yaml). */
+export declare function serializeCommand(cmd: CliCommand): {
+    command: string;
+    site: string;
+    name: string;
+    description: string;
+    strategy: string;
+    browser: boolean;
+    args: SerializedArg[];
+    columns: string[];
+    domain: string | null;
+};
+/** Human-readable arg summary: `<required> [optional]` style. */
+export declare function formatArgSummary(args: Arg[]): string;
+/** Generate the --help appendix showing registry metadata not exposed by Commander. */
+export declare function formatRegistryHelpText(cmd: CliCommand): string;

package/dist/serialization.js

@@ -0,0 +1,63 @@
+/**
+ * Serialization and formatting helpers for CLI commands and args.
+ *
+ * Used by the `list` command, Commander --help, and build-manifest.
+ * Separated from registry.ts to keep the registry focused on types + registration.
+ */
+import { fullName, strategyLabel } from './registry.js';
+/** Stable arg schema — every field is always present (no sparse objects). */
+export function serializeArg(a) {
+    return {
+        name: a.name,
+        type: a.type ?? 'string',
+        required: !!a.required,
+        positional: !!a.positional,
+        choices: a.choices ?? [],
+        default: a.default ?? null,
+        help: a.help ?? '',
+    };
+}
+/** Full command metadata for structured output (json/yaml). */
+export function serializeCommand(cmd) {
+    return {
+        command: fullName(cmd),
+        site: cmd.site,
+        name: cmd.name,
+        description: cmd.description,
+        strategy: strategyLabel(cmd),
+        browser: !!cmd.browser,
+        args: cmd.args.map(serializeArg),
+        columns: cmd.columns ?? [],
+        domain: cmd.domain ?? null,
+    };
+}
+// ── Formatting ──────────────────────────────────────────────────────────────
+/** Human-readable arg summary: `<required> [optional]` style. */
+export function formatArgSummary(args) {
+    return args
+        .map(a => {
+        if (a.positional)
+            return a.required ? `<${a.name}>` : `[${a.name}]`;
+        return a.required ? `--${a.name}` : `[--${a.name}]`;
+    })
+        .join(' ');
+}
+/** Generate the --help appendix showing registry metadata not exposed by Commander. */
+export function formatRegistryHelpText(cmd) {
+    const lines = [];
+    const choicesArgs = cmd.args.filter(a => a.choices?.length);
+    for (const a of choicesArgs) {
+        const prefix = a.positional ? `<${a.name}>` : `--${a.name}`;
+        const def = a.default != null ? `  (default: ${a.default})` : '';
+        lines.push(`  ${prefix}: ${a.choices.join(', ')}${def}`);
+    }
+    const meta = [];
+    meta.push(`Strategy: ${strategyLabel(cmd)}`);
+    meta.push(`Browser: ${cmd.browser ? 'yes' : 'no'}`);
+    if (cmd.domain)
+        meta.push(`Domain: ${cmd.domain}`);
+    lines.push(meta.join(' | '));
+    if (cmd.columns?.length)
+        lines.push(`Output columns: ${cmd.columns.join(', ')}`);
+    return '\n' + lines.join('\n') + '\n';
+}

package/dist/types.d.ts

@@ -5,7 +5,10 @@
  * instead of `any` for browser interactions.
  */
 export interface IPage {
-    goto(url: string): Promise<void>;
+    goto(url: string, options?: {
+        waitUntil?: 'load' | 'none';
+        settleMs?: number;
+    }): Promise<void>;
     evaluate(js: string): Promise<any>;
     getCookies(opts?: {
         domain?: string;

package/docs/.vitepress/config.mts

@@ -1,7 +1,7 @@
 import { defineConfig } from 'vitepress'
 
 export default defineConfig({
-  base: '/opencli/',
+  base: '/docs/',
   title: 'OpenCLI',
   description: 'Make any website or Electron App your CLI — AI-powered, account-safe, self-healing.',
 
@@ -54,12 +54,19 @@ export default defineConfig({
                 { text: 'YouTube', link: '/adapters/browser/youtube' },
                 { text: 'Xueqiu', link: '/adapters/browser/xueqiu' },
                 { text: 'V2EX', link: '/adapters/browser/v2ex' },
+                { text: 'Bloomberg', link: '/adapters/browser/bloomberg' },
                 { text: 'LinkedIn', link: '/adapters/browser/linkedin' },
                 { text: 'Coupang', link: '/adapters/browser/coupang' },
                 { text: 'BOSS Zhipin', link: '/adapters/browser/boss' },
                 { text: 'Ctrip', link: '/adapters/browser/ctrip' },
                 { text: 'Reuters', link: '/adapters/browser/reuters' },
                 { text: 'SMZDM', link: '/adapters/browser/smzdm' },
+                { text: 'Jike', link: '/adapters/browser/jike' },
+                { text: 'Jimeng', link: '/adapters/browser/jimeng' },
+                { text: 'LINUX DO', link: '/adapters/browser/linux-do' },
+                { text: 'Chaoxing', link: '/adapters/browser/chaoxing' },
+                { text: 'Grok', link: '/adapters/browser/grok' },
+                { text: 'WeRead', link: '/adapters/browser/weread' },
               ],
             },
             {
@@ -72,6 +79,12 @@ export default defineConfig({
                 { text: 'Apple Podcasts', link: '/adapters/browser/apple-podcasts' },
                 { text: 'Xiaoyuzhou', link: '/adapters/browser/xiaoyuzhou' },
                 { text: 'Yahoo Finance', link: '/adapters/browser/yahoo-finance' },
+                { text: 'arXiv', link: '/adapters/browser/arxiv' },
+                { text: 'Barchart', link: '/adapters/browser/barchart' },
+                { text: 'Hugging Face', link: '/adapters/browser/hf' },
+                { text: 'Sina Finance', link: '/adapters/browser/sinafinance' },
+                { text: 'Stack Overflow', link: '/adapters/browser/stackoverflow' },
+                { text: 'Wikipedia', link: '/adapters/browser/wikipedia' },
               ],
             },
             {
@@ -137,7 +150,6 @@ export default defineConfig({
                 { text: '快速开始', link: '/zh/guide/getting-started' },
                 { text: '安装', link: '/zh/guide/installation' },
                 { text: 'Browser Bridge', link: '/zh/guide/browser-bridge' },
-                { text: '问题排查', link: '/zh/guide/troubleshooting' },
               ],
             },
           ],
@@ -154,7 +166,6 @@ export default defineConfig({
               text: '开发者指南',
               items: [
                 { text: '贡献指南', link: '/zh/developer/contributing' },
-                { text: '测试', link: '/zh/developer/testing' },
               ],
             },
           ],

package/docs/adapters/browser/arxiv.md

@@ -0,0 +1,27 @@
+# arXiv
+
+**Mode**: 🌐 Public · **Domain**: `arxiv.org`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli arxiv search` | Search arXiv papers |
+| `opencli arxiv paper` | Get arXiv paper details by ID |
+
+## Usage Examples
+
+```bash
+# Search for papers
+opencli arxiv search "transformer attention" --limit 10
+
+# Get paper details by arXiv ID
+opencli arxiv paper 2301.00001
+
+# JSON output
+opencli arxiv search "LLM" -f json
+```
+
+## Prerequisites
+
+- No browser required — uses public arXiv API

package/docs/adapters/browser/barchart.md

@@ -0,0 +1,32 @@
+# Barchart
+
+**Mode**: 🌐 Public · **Domain**: `barchart.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli barchart quote` | Stock quote with price, volume, and key metrics |
+| `opencli barchart options` | Options chain with greeks, IV, volume, and open interest |
+| `opencli barchart greeks` | Options greeks overview (IV, delta, gamma, theta, vega) |
+| `opencli barchart flow` | Unusual options activity / options flow |
+
+## Usage Examples
+
+```bash
+# Get stock quote
+opencli barchart quote --symbol AAPL
+
+# View options chain
+opencli barchart options --symbol TSLA
+
+# Options greeks overview
+opencli barchart greeks --symbol NVDA
+
+# Unusual options flow
+opencli barchart flow --limit 20 -f json
+```
+
+## Prerequisites
+
+- No browser required — uses public API

package/docs/adapters/browser/bloomberg.md

@@ -0,0 +1,70 @@
+# Bloomberg
+
+**Mode**: 🌐 / 🔐 Mixed · **Domains**: `feeds.bloomberg.com`, `www.bloomberg.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli bloomberg main` | Bloomberg homepage top stories from RSS |
+| `opencli bloomberg markets` | Bloomberg Markets top stories from RSS |
+| `opencli bloomberg economics` | Bloomberg Economics top stories from RSS |
+| `opencli bloomberg industries` | Bloomberg Industries top stories from RSS |
+| `opencli bloomberg tech` | Bloomberg Tech top stories from RSS |
+| `opencli bloomberg politics` | Bloomberg Politics top stories from RSS |
+| `opencli bloomberg businessweek` | Bloomberg Businessweek top stories from RSS |
+| `opencli bloomberg opinions` | Bloomberg Opinion top stories from RSS |
+| `opencli bloomberg feeds` | List the RSS feed aliases used by the adapter |
+| `opencli bloomberg news <link>` | Read a standard Bloomberg story/article page and return title, summary, media links, and article text |
+
+## What works today
+
+- RSS-backed listing commands work without a browser:
+  - `main`
+  - `markets`
+  - `economics`
+  - `industries`
+  - `tech`
+  - `politics`
+  - `businessweek`
+  - `opinions`
+  - `feeds`
+- `bloomberg news` works on standard Bloomberg story/article pages that expose `#__NEXT_DATA__` and are accessible to your current Chrome session.
+
+## Current limitations
+
+- Audio pages and some other non-standard Bloomberg URLs may fail.
+- Some Bloomberg pages can return bot-protection or access-gated responses instead of article data.
+- This adapter is for data retrieval/extraction only. It does **not** bypass Bloomberg paywall, login, entitlement, or other access checks.
+
+## Usage Examples
+
+```bash
+# List supported RSS feed aliases
+opencli bloomberg feeds
+
+# Fetch Bloomberg homepage headlines
+opencli bloomberg main --limit 5
+
+# Fetch a section feed as JSON
+opencli bloomberg tech --limit 3 -f json
+
+# Read a standard article page
+opencli bloomberg news https://www.bloomberg.com/news/articles/2026-03-19/example -f json
+
+# Relative article paths also work
+opencli bloomberg news /news/articles/2026-03-19/example
+```
+
+## Prerequisites
+
+- RSS commands do not require Chrome.
+- `bloomberg news` requires:
+  - Chrome running
+  - a Chrome session that can already access the target Bloomberg article page
+  - the [Browser Bridge extension](/guide/browser-bridge)
+
+## Notes
+
+- RSS commands support `--limit` with a maximum of 20 items.
+- If `bloomberg news` fails on a page from RSS, try a different standard story/article link first; not every Bloomberg URL in feeds is a normal article page.

package/docs/adapters/browser/chaoxing.md

@@ -0,0 +1,39 @@
+# 超星学习通 (Chaoxing)
+
+**Mode**: 🔐 Browser · **Domain**: `mooc2-ans.chaoxing.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli chaoxing assignments` | 学习通作业列表 |
+| `opencli chaoxing exams` | 学习通考试列表 |
+
+## Usage Examples
+
+```bash
+# List all assignments
+opencli chaoxing assignments --limit 20
+
+# Filter exams by course name
+opencli chaoxing exams --course "高等数学"
+
+# Filter exams by status
+opencli chaoxing exams --status ongoing
+
+# JSON output
+opencli chaoxing assignments -f json
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `--course` | Filter by course name (fuzzy match) |
+| `--status` | Filter by status: `all`, `upcoming`, `ongoing`, `finished` |
+| `--limit` | Max number of results (default: 20) |
+
+## Prerequisites
+
+- Chrome running and **logged into** mooc2-ans.chaoxing.com
+- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/grok.md

@@ -0,0 +1,35 @@
+# Grok
+
+**Mode**: 🔐 Browser · **Domain**: `grok.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli grok ask` | Send a message to Grok and get response |
+
+## Usage Examples
+
+```bash
+# Ask Grok a question
+opencli grok ask --prompt "Explain quantum computing in simple terms"
+
+# Start a new chat session
+opencli grok ask --prompt "Hello" --new
+
+# Set custom timeout (default: 120s)
+opencli grok ask --prompt "Write a long essay" --timeout 180
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `--prompt` | The message to send (required) |
+| `--timeout` | Wait timeout in seconds (default: 120) |
+| `--new` | Start a new chat session (default: false) |
+
+## Prerequisites
+
+- Chrome running and **logged into** grok.com
+- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/hf.md

@@ -0,0 +1,42 @@
+# Hugging Face
+
+**Mode**: 🌐 Public · **Domain**: `huggingface.co`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli hf top` | Top upvoted Hugging Face papers |
+
+## Usage Examples
+
+```bash
+# Today's top papers
+opencli hf top --limit 10
+
+# All papers (no limit)
+opencli hf top --all
+
+# Specific date
+opencli hf top --date 2025-03-01
+
+# Weekly/monthly top papers
+opencli hf top --period weekly
+opencli hf top --period monthly
+
+# JSON output
+opencli hf top -f json
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `--limit` | Number of papers (default: 20) |
+| `--all` | Return all papers, ignoring limit |
+| `--date` | Date in `YYYY-MM-DD` format (defaults to most recent) |
+| `--period` | Time period: `daily`, `weekly`, or `monthly` (default: daily) |
+
+## Prerequisites
+
+- No browser required — uses public Hugging Face API

package/docs/adapters/browser/jike.md

@@ -0,0 +1,45 @@
+# 即刻 (Jike)
+
+**Mode**: 🔐 Browser · **Domain**: `web.okjike.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli jike feed` | 即刻首页动态流 |
+| `opencli jike search` | 搜索即刻帖子 |
+| `opencli jike post` | 帖子详情及评论 |
+| `opencli jike topic` | 话题详情 |
+| `opencli jike user` | 用户资料 |
+| `opencli jike create` | 发布即刻动态 |
+| `opencli jike comment` | 评论即刻帖子 |
+| `opencli jike like` | 点赞即刻帖子 |
+| `opencli jike repost` | 转发即刻帖子 |
+| `opencli jike notifications` | 即刻通知 |
+
+## Usage Examples
+
+```bash
+# View feed
+opencli jike feed --limit 10
+
+# Search posts
+opencli jike search "AI" --limit 20
+
+# View post details and comments
+opencli jike post <post-id>
+
+# Create a new post
+opencli jike create --content "Hello Jike!"
+
+# Like a post
+opencli jike like <post-id>
+
+# JSON output
+opencli jike feed -f json
+```
+
+## Prerequisites
+
+- Chrome running and **logged into** web.okjike.com
+- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/jimeng.md

@@ -0,0 +1,39 @@
+# 即梦AI (Jimeng)
+
+**Mode**: 🔐 Browser · **Domain**: `jimeng.jianying.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli jimeng generate` | 即梦AI 文生图 — 输入 prompt 生成图片 |
+| `opencli jimeng history` | 查看生成历史 |
+
+## Usage Examples
+
+```bash
+# Generate an image
+opencli jimeng generate --prompt "一只在星空下的猫"
+
+# Use a specific model
+opencli jimeng generate --prompt "cyberpunk city" --model high_aes_general_v50
+
+# Set custom wait timeout
+opencli jimeng generate --prompt "sunset landscape" --wait 60
+
+# View generation history
+opencli jimeng history --limit 10
+```
+
+### Options (generate)
+
+| Option | Description |
+|--------|-------------|
+| `--prompt` | Image description prompt (required) |
+| `--model` | Model: `high_aes_general_v50` (5.0 Lite), `high_aes_general_v42` (4.6), `high_aes_general_v40` (4.0) |
+| `--wait` | Wait seconds for generation (default: 40) |
+
+## Prerequisites
+
+- Chrome running and **logged into** jimeng.jianying.com
+- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/linux-do.md

@@ -0,0 +1,45 @@
+# LINUX DO
+
+**Mode**: 🔐 Browser · **Domain**: `linux.do`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli linux-do hot` | 热门话题 |
+| `opencli linux-do latest` | 最新话题 |
+| `opencli linux-do categories` | 板块列表 |
+| `opencli linux-do category` | 板块话题 |
+| `opencli linux-do search` | 搜索话题 |
+| `opencli linux-do topic` | 话题详情 |
+
+## Usage Examples
+
+```bash
+# Hot topics this week
+opencli linux-do hot --limit 20
+
+# Hot topics by period
+opencli linux-do hot --period daily
+opencli linux-do hot --period monthly
+
+# Latest topics
+opencli linux-do latest --limit 10
+
+# List all categories
+opencli linux-do categories
+
+# Search topics
+opencli linux-do search "NixOS"
+
+# View topic details
+opencli linux-do topic 12345
+
+# JSON output
+opencli linux-do hot -f json
+```
+
+## Prerequisites
+
+- Chrome running and **logged into** linux.do
+- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/sinafinance.md

@@ -0,0 +1,35 @@
+# 新浪财经 (Sina Finance)
+
+**Mode**: 🌐 Public · **Domain**: `finance.sina.com.cn`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli sinafinance news` | 新浪财经 7×24 小时实时快讯 |
+
+## Usage Examples
+
+```bash
+# Latest financial news
+opencli sinafinance news --limit 20
+
+# Filter by type
+opencli sinafinance news --type 1   # A股
+opencli sinafinance news --type 2   # 宏观
+opencli sinafinance news --type 6   # 国际
+
+# JSON output
+opencli sinafinance news -f json
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `--limit` | Max results, up to 50 (default: 20) |
+| `--type` | News type: `0`=全部, `1`=A股, `2`=宏观, `3`=公司, `4`=数据, `5`=市场, `6`=国际, `7`=观点, `8`=央行, `9`=其它 |
+
+## Prerequisites
+
+- No browser required — uses public API

package/docs/adapters/browser/stackoverflow.md

@@ -0,0 +1,35 @@
+# Stack Overflow
+
+**Mode**: 🌐 Public · **Domain**: `stackoverflow.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli stackoverflow hot` | Hot questions |
+| `opencli stackoverflow search` | Search questions |
+| `opencli stackoverflow bounties` | Questions with active bounties |
+| `opencli stackoverflow unanswered` | Unanswered questions |
+
+## Usage Examples
+
+```bash
+# Hot questions
+opencli stackoverflow hot --limit 10
+
+# Search questions
+opencli stackoverflow search "async await" --limit 20
+
+# Active bounties
+opencli stackoverflow bounties --limit 10
+
+# Unanswered questions
+opencli stackoverflow unanswered --limit 10
+
+# JSON output
+opencli stackoverflow hot -f json
+```
+
+## Prerequisites
+
+- No browser required — uses public Stack Exchange API

package/docs/adapters/browser/steam.md

@@ -0,0 +1,26 @@
+# Steam
+
+**Mode**: 🌐 Public · **Domain**: `store.steampowered.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli steam top-sellers` | Top selling games on Steam |
+
+## Usage Examples
+
+```bash
+# Quick start
+opencli steam top-sellers
+
+# Limit results
+opencli steam top-sellers --limit 5
+
+# JSON output
+opencli steam top-sellers -f json
+```
+
+## Prerequisites
+
+- No login required (public API)

package/docs/adapters/browser/twitter.md

@@ -24,6 +24,9 @@
 | `opencli twitter unfollow` | |
 | `opencli twitter bookmark` | |
 | `opencli twitter unbookmark` | |
+| `opencli twitter block` | |
+| `opencli twitter unblock` | |
+| `opencli twitter hide-reply` | |
 | `opencli twitter download` | |
 | `opencli twitter accept` | |
 | `opencli twitter reply-dm` | |