@jackwener/opencli 1.5.0 → 1.5.1

package/dist/browser/cdp.js

@@ -135,6 +135,7 @@ export class CDPBridge {
 class CDPPage {
     bridge;
     _pageEnabled = false;
+    _lastUrl = null;
     constructor(bridge) {
         this.bridge = bridge;
     }
@@ -146,6 +147,7 @@ class CDPPage {
         const loadPromise = this.bridge.waitForEvent('Page.loadEventFired', 30_000).catch(() => { });
         await this.bridge.send('Page.navigate', { url });
         await loadPromise;
+        this._lastUrl = url;
         if (options?.waitUntil !== 'none') {
             const maxMs = options?.settleMs ?? 1000;
             await this.evaluate(waitForDomStableJs(maxMs, Math.min(500, maxMs)));
@@ -251,6 +253,9 @@ class CDPPage {
     async consoleMessages(_level) {
         return [];
     }
+    async getCurrentUrl() {
+        return this._lastUrl;
+    }
     async installInterceptor(pattern) {
         const { generateInterceptorJs } = await import('../interceptor.js');
         await this.evaluate(generateInterceptorJs(JSON.stringify(pattern), {

package/dist/browser/page.d.ts

@@ -18,6 +18,8 @@ export declare class Page implements IPage {
     constructor(workspace?: string);
     /** Active tab ID, set after navigate and used in all subsequent commands */
     private _tabId;
+    /** Last navigated URL, tracked in-memory to avoid extra round-trips */
+    private _lastUrl;
     /** Helper: spread workspace into command params */
     private _wsOpt;
     /** Helper: spread workspace + tabId into command params */
@@ -26,6 +28,7 @@ export declare class Page implements IPage {
         waitUntil?: 'load' | 'none';
         settleMs?: number;
     }): Promise<void>;
+    getCurrentUrl(): Promise<string | null>;
     /** Close the automation window in the extension */
     closeWindow(): Promise<void>;
     evaluate(js: string): Promise<unknown>;

package/dist/browser/page.js

@@ -26,6 +26,8 @@ export class Page {
     }
     /** Active tab ID, set after navigate and used in all subsequent commands */
     _tabId;
+    /** Last navigated URL, tracked in-memory to avoid extra round-trips */
+    _lastUrl = null;
     /** Helper: spread workspace into command params */
     _wsOpt() {
         return { workspace: this.workspace };
@@ -42,10 +44,11 @@ export class Page {
             url,
             ...this._cmdOpts(),
         });
-        // Remember the tabId for subsequent exec calls
+        // Remember the tabId and URL for subsequent calls
         if (result?.tabId) {
             this._tabId = result.tabId;
         }
+        this._lastUrl = url;
         // Inject stealth anti-detection patches (guard flag prevents double-injection).
         try {
             await sendCommand('exec', {
@@ -66,6 +69,9 @@ export class Page {
             });
         }
     }
+    async getCurrentUrl() {
+        return this._lastUrl;
+    }
     /** Close the automation window in the extension */
     async closeWindow() {
         try {
@@ -163,6 +169,23 @@ export class Page {
     }
     async wait(options) {
         if (typeof options === 'number') {
+            if (options >= 1) {
+                // For waits >= 1s, use DOM-stable check: return early when the page
+                // stops mutating, with the original wait time as the hard cap.
+                // This turns e.g. `page.wait(5)` from a fixed 5s sleep into
+                // "wait until DOM is stable, max 5s" — often completing in <1s.
+                try {
+                    const maxMs = options * 1000;
+                    await sendCommand('exec', {
+                        code: waitForDomStableJs(maxMs, Math.min(500, maxMs)),
+                        ...this._cmdOpts(),
+                    });
+                    return;
+                }
+                catch {
+                    // Fallback: fixed sleep (e.g. if page has no DOM yet)
+                }
+            }
             await new Promise(resolve => setTimeout(resolve, options * 1000));
             return;
         }

package/dist/cli-manifest.json

@@ -1311,6 +1311,464 @@
       "mediaLinks"
     ]
   },
+  {
+    "site": "bluesky",
+    "name": "feeds",
+    "description": "Popular Bluesky feed generators",
+    "domain": "public.api.bsky.app",
+    "strategy": "public",
+    "browser": false,
+    "args": [
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 20,
+        "required": false,
+        "positional": false,
+        "help": "Number of feeds"
+      }
+    ],
+    "columns": [
+      "rank",
+      "name",
+      "likes",
+      "creator",
+      "description"
+    ],
+    "pipeline": [
+      {
+        "fetch": {
+          "url": "https://public.api.bsky.app/xrpc/app.bsky.unspecced.getPopularFeedGenerators?limit=${{ args.limit }}"
+        }
+      },
+      {
+        "select": "feeds"
+      },
+      {
+        "map": {
+          "rank": "${{ index + 1 }}",
+          "name": "${{ item.displayName }}",
+          "likes": "${{ item.likeCount }}",
+          "creator": "${{ item.creator.handle }}",
+          "description": "${{ item.description }}"
+        }
+      },
+      {
+        "limit": "${{ args.limit }}"
+      }
+    ],
+    "type": "yaml"
+  },
+  {
+    "site": "bluesky",
+    "name": "followers",
+    "description": "List followers of a Bluesky user",
+    "domain": "public.api.bsky.app",
+    "strategy": "public",
+    "browser": false,
+    "args": [
+      {
+        "name": "handle",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Bluesky handle"
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 20,
+        "required": false,
+        "positional": false,
+        "help": "Number of followers"
+      }
+    ],
+    "columns": [
+      "rank",
+      "handle",
+      "name",
+      "description"
+    ],
+    "pipeline": [
+      {
+        "fetch": {
+          "url": "https://public.api.bsky.app/xrpc/app.bsky.graph.getFollowers?actor=${{ args.handle }}&limit=${{ args.limit }}"
+        }
+      },
+      {
+        "select": "followers"
+      },
+      {
+        "map": {
+          "rank": "${{ index + 1 }}",
+          "handle": "${{ item.handle }}",
+          "name": "${{ item.displayName }}",
+          "description": "${{ item.description }}"
+        }
+      },
+      {
+        "limit": "${{ args.limit }}"
+      }
+    ],
+    "type": "yaml"
+  },
+  {
+    "site": "bluesky",
+    "name": "following",
+    "description": "List accounts a Bluesky user is following",
+    "domain": "public.api.bsky.app",
+    "strategy": "public",
+    "browser": false,
+    "args": [
+      {
+        "name": "handle",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Bluesky handle"
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 20,
+        "required": false,
+        "positional": false,
+        "help": "Number of accounts"
+      }
+    ],
+    "columns": [
+      "rank",
+      "handle",
+      "name",
+      "description"
+    ],
+    "pipeline": [
+      {
+        "fetch": {
+          "url": "https://public.api.bsky.app/xrpc/app.bsky.graph.getFollows?actor=${{ args.handle }}&limit=${{ args.limit }}"
+        }
+      },
+      {
+        "select": "follows"
+      },
+      {
+        "map": {
+          "rank": "${{ index + 1 }}",
+          "handle": "${{ item.handle }}",
+          "name": "${{ item.displayName }}",
+          "description": "${{ item.description }}"
+        }
+      },
+      {
+        "limit": "${{ args.limit }}"
+      }
+    ],
+    "type": "yaml"
+  },
+  {
+    "site": "bluesky",
+    "name": "profile",
+    "description": "Get Bluesky user profile info",
+    "domain": "public.api.bsky.app",
+    "strategy": "public",
+    "browser": false,
+    "args": [
+      {
+        "name": "handle",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Bluesky handle (e.g. bsky.app, jay.bsky.team)"
+      }
+    ],
+    "columns": [
+      "handle",
+      "name",
+      "followers",
+      "following",
+      "posts",
+      "description"
+    ],
+    "pipeline": [
+      {
+        "fetch": {
+          "url": "https://public.api.bsky.app/xrpc/app.bsky.actor.getProfile?actor=${{ args.handle }}"
+        }
+      },
+      {
+        "map": {
+          "handle": "${{ item.handle }}",
+          "name": "${{ item.displayName }}",
+          "followers": "${{ item.followersCount }}",
+          "following": "${{ item.followsCount }}",
+          "posts": "${{ item.postsCount }}",
+          "description": "${{ item.description }}"
+        }
+      }
+    ],
+    "type": "yaml"
+  },
+  {
+    "site": "bluesky",
+    "name": "search",
+    "description": "Search Bluesky users",
+    "domain": "public.api.bsky.app",
+    "strategy": "public",
+    "browser": false,
+    "args": [
+      {
+        "name": "query",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Search query"
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 10,
+        "required": false,
+        "positional": false,
+        "help": "Number of results"
+      }
+    ],
+    "columns": [
+      "rank",
+      "handle",
+      "name",
+      "followers",
+      "description"
+    ],
+    "pipeline": [
+      {
+        "fetch": {
+          "url": "https://public.api.bsky.app/xrpc/app.bsky.actor.searchActors?q=${{ args.query }}&limit=${{ args.limit }}"
+        }
+      },
+      {
+        "select": "actors"
+      },
+      {
+        "map": {
+          "rank": "${{ index + 1 }}",
+          "handle": "${{ item.handle }}",
+          "name": "${{ item.displayName }}",
+          "followers": "${{ item.followersCount }}",
+          "description": "${{ item.description }}"
+        }
+      },
+      {
+        "limit": "${{ args.limit }}"
+      }
+    ],
+    "type": "yaml"
+  },
+  {
+    "site": "bluesky",
+    "name": "starter-packs",
+    "description": "Get starter packs created by a Bluesky user",
+    "domain": "public.api.bsky.app",
+    "strategy": "public",
+    "browser": false,
+    "args": [
+      {
+        "name": "handle",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Bluesky handle"
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 10,
+        "required": false,
+        "positional": false,
+        "help": "Number of starter packs"
+      }
+    ],
+    "columns": [
+      "rank",
+      "name",
+      "description",
+      "members",
+      "joins"
+    ],
+    "pipeline": [
+      {
+        "fetch": {
+          "url": "https://public.api.bsky.app/xrpc/app.bsky.graph.getActorStarterPacks?actor=${{ args.handle }}&limit=${{ args.limit }}"
+        }
+      },
+      {
+        "select": "starterPacks"
+      },
+      {
+        "map": {
+          "rank": "${{ index + 1 }}",
+          "name": "${{ item.record.name }}",
+          "description": "${{ item.record.description }}",
+          "members": "${{ item.listItemCount }}",
+          "joins": "${{ item.joinedAllTimeCount }}"
+        }
+      },
+      {
+        "limit": "${{ args.limit }}"
+      }
+    ],
+    "type": "yaml"
+  },
+  {
+    "site": "bluesky",
+    "name": "thread",
+    "description": "Get a Bluesky post thread with replies",
+    "domain": "public.api.bsky.app",
+    "strategy": "public",
+    "browser": false,
+    "args": [
+      {
+        "name": "uri",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Post AT URI (at://did:.../app.bsky.feed.post/...) or bsky.app URL"
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 20,
+        "required": false,
+        "positional": false,
+        "help": "Number of replies"
+      }
+    ],
+    "columns": [
+      "author",
+      "text",
+      "likes",
+      "reposts",
+      "replies_count"
+    ],
+    "pipeline": [
+      {
+        "fetch": {
+          "url": "https://public.api.bsky.app/xrpc/app.bsky.feed.getPostThread?uri=${{ args.uri }}&depth=2"
+        }
+      },
+      {
+        "select": "thread"
+      },
+      {
+        "map": {
+          "author": "${{ item.post.author.handle }}",
+          "text": "${{ item.post.record.text }}",
+          "likes": "${{ item.post.likeCount }}",
+          "reposts": "${{ item.post.repostCount }}",
+          "replies_count": "${{ item.post.replyCount }}"
+        }
+      }
+    ],
+    "type": "yaml"
+  },
+  {
+    "site": "bluesky",
+    "name": "trending",
+    "description": "Trending topics on Bluesky",
+    "domain": "public.api.bsky.app",
+    "strategy": "public",
+    "browser": false,
+    "args": [
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 20,
+        "required": false,
+        "positional": false,
+        "help": "Number of topics"
+      }
+    ],
+    "columns": [
+      "rank",
+      "topic",
+      "link"
+    ],
+    "pipeline": [
+      {
+        "fetch": {
+          "url": "https://public.api.bsky.app/xrpc/app.bsky.unspecced.getTrendingTopics"
+        }
+      },
+      {
+        "select": "topics"
+      },
+      {
+        "map": {
+          "rank": "${{ index + 1 }}",
+          "topic": "${{ item.topic }}",
+          "link": "${{ item.link }}"
+        }
+      },
+      {
+        "limit": "${{ args.limit }}"
+      }
+    ],
+    "type": "yaml"
+  },
+  {
+    "site": "bluesky",
+    "name": "user",
+    "description": "Get recent posts from a Bluesky user",
+    "domain": "public.api.bsky.app",
+    "strategy": "public",
+    "browser": false,
+    "args": [
+      {
+        "name": "handle",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Bluesky handle (e.g. bsky.app)"
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 20,
+        "required": false,
+        "positional": false,
+        "help": "Number of posts"
+      }
+    ],
+    "columns": [
+      "rank",
+      "text",
+      "likes",
+      "reposts",
+      "replies"
+    ],
+    "pipeline": [
+      {
+        "fetch": {
+          "url": "https://public.api.bsky.app/xrpc/app.bsky.feed.getAuthorFeed?actor=${{ args.handle }}&limit=${{ args.limit }}"
+        }
+      },
+      {
+        "select": "feed"
+      },
+      {
+        "map": {
+          "rank": "${{ index + 1 }}",
+          "text": "${{ item.post.record.text }}",
+          "likes": "${{ item.post.likeCount }}",
+          "reposts": "${{ item.post.repostCount }}",
+          "replies": "${{ item.post.replyCount }}"
+        }
+      },
+      {
+        "limit": "${{ args.limit }}"
+      }
+    ],
+    "type": "yaml"
+  },
   {
     "site": "boss",
     "name": "batchgreet",
@@ -10442,7 +10900,7 @@
     "description": "V2EX 热门话题",
     "domain": "www.v2ex.com",
     "strategy": "public",
-    "browser": false,
+    "browser": true,
     "args": [
       {
         "name": "limit",
@@ -10460,9 +10918,10 @@
     ],
     "pipeline": [
       {
-        "fetch": {
-          "url": "https://www.v2ex.com/api/topics/hot.json"
-        }
+        "navigate": "https://www.v2ex.com/"
+      },
+      {
+        "evaluate": "(async () => {\n  const response = await fetch('/api/topics/hot.json', {\n    credentials: 'include',\n    headers: {\n      accept: 'application/json, text/plain, */*',\n      'x-requested-with': 'XMLHttpRequest',\n    },\n  });\n  if (!response.ok) {\n    throw new Error(`V2EX hot API request failed: ${response.status}`);\n  }\n  return await response.json();\n})()\n"
       },
       {
         "map": {
@@ -11801,7 +12260,7 @@
       {
         "name": "images",
         "type": "str",
-        "required": false,
+        "required": true,
         "help": "图片路径，逗号分隔，最多9张 (jpg/png/gif/webp)"
       },
       {
@@ -11856,6 +12315,7 @@
       "title",
       "author",
       "likes",
+      "published_at",
       "url"
     ]
   },

package/dist/cli.js

@@ -69,9 +69,10 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
         for (const [site, cmds] of sites) {
             console.log(chalk.bold.cyan(`  ${site}`));
             for (const cmd of cmds) {
-                const tag = strategyLabel(cmd) === 'public'
+                const label = strategyLabel(cmd);
+                const tag = label === 'public'
                     ? chalk.green('[public]')
-                    : chalk.yellow(`[${strategyLabel(cmd)}]`);
+                    : chalk.yellow(`[${label}]`);
                 console.log(`    ${cmd.name} ${tag}${cmd.description ? chalk.dim(` — ${cmd.description}`) : ''}`);
             }
             console.log();
@@ -228,7 +229,7 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
     const pluginCmd = program.command('plugin').description('Manage opencli plugins');
     pluginCmd
         .command('install')
-        .description('Install a plugin from GitHub')
+        .description('Install a plugin from a git repository')
         .argument('<source>', 'Plugin source (e.g. github:user/repo)')
         .action(async (source) => {
         const { installPlugin } = await import('./plugin.js');
@@ -380,6 +381,36 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
         console.log(chalk.dim(`  ${plugins.length} plugin(s) installed`));
         console.log();
     });
+    pluginCmd
+        .command('create')
+        .description('Create a new plugin scaffold')
+        .argument('<name>', 'Plugin name (lowercase, hyphens allowed)')
+        .option('-d, --dir <path>', 'Output directory (default: ./<name>)')
+        .option('--description <text>', 'Plugin description')
+        .action(async (name, opts) => {
+        const { createPluginScaffold } = await import('./plugin-scaffold.js');
+        try {
+            const result = createPluginScaffold(name, {
+                dir: opts.dir,
+                description: opts.description,
+            });
+            console.log(chalk.green(`✅ Plugin scaffold created at ${result.dir}`));
+            console.log();
+            console.log(chalk.bold('  Files created:'));
+            for (const f of result.files) {
+                console.log(`    ${chalk.cyan(f)}`);
+            }
+            console.log();
+            console.log(chalk.dim('  Next steps:'));
+            console.log(chalk.dim(`    cd ${result.dir}`));
+            console.log(chalk.dim(`    opencli plugin install file://${result.dir}`));
+            console.log(chalk.dim(`    opencli ${name} hello`));
+        }
+        catch (err) {
+            console.error(chalk.red(`Error: ${getErrorMessage(err)}`));
+            process.exitCode = 1;
+        }
+    });
     // ── External CLIs ─────────────────────────────────────────────────────────
     const externalClis = loadExternalClis();
     program

package/dist/clis/bluesky/feeds.yaml

@@ -0,0 +1,29 @@
+site: bluesky
+name: feeds
+description: Popular Bluesky feed generators
+domain: public.api.bsky.app
+strategy: public
+browser: false
+
+args:
+  limit:
+    type: int
+    default: 20
+    description: Number of feeds
+
+pipeline:
+  - fetch:
+      url: https://public.api.bsky.app/xrpc/app.bsky.unspecced.getPopularFeedGenerators?limit=${{ args.limit }}
+
+  - select: feeds
+
+  - map:
+      rank: ${{ index + 1 }}
+      name: ${{ item.displayName }}
+      likes: ${{ item.likeCount }}
+      creator: ${{ item.creator.handle }}
+      description: ${{ item.description }}
+
+  - limit: ${{ args.limit }}
+
+columns: [rank, name, likes, creator, description]