@jackwener/opencli 1.1.1 → 1.2.0

package/dist/cli.js

@@ -210,6 +210,72 @@ export function runCli(BUILTIN_CLIS, USER_CLIS) {
         .action((shell) => {
         printCompletionScript(shell);
     });
+    // ── Plugin management ──────────────────────────────────────────────────────
+    const pluginCmd = program.command('plugin').description('Manage opencli plugins');
+    pluginCmd
+        .command('install')
+        .description('Install a plugin from GitHub')
+        .argument('<source>', 'Plugin source (e.g. github:user/repo)')
+        .action(async (source) => {
+        const { installPlugin } = await import('./plugin.js');
+        try {
+            const name = installPlugin(source);
+            console.log(chalk.green(`✅ Plugin "${name}" installed successfully.`));
+            console.log(chalk.dim(`   Restart opencli to use the new commands.`));
+        }
+        catch (err) {
+            console.error(chalk.red(`Error: ${err.message}`));
+            process.exitCode = 1;
+        }
+    });
+    pluginCmd
+        .command('uninstall')
+        .description('Uninstall a plugin')
+        .argument('<name>', 'Plugin name')
+        .action(async (name) => {
+        const { uninstallPlugin } = await import('./plugin.js');
+        try {
+            uninstallPlugin(name);
+            console.log(chalk.green(`✅ Plugin "${name}" uninstalled.`));
+        }
+        catch (err) {
+            console.error(chalk.red(`Error: ${err.message}`));
+            process.exitCode = 1;
+        }
+    });
+    pluginCmd
+        .command('list')
+        .description('List installed plugins')
+        .option('-f, --format <fmt>', 'Output format: table, json', 'table')
+        .action(async (opts) => {
+        const { listPlugins } = await import('./plugin.js');
+        const plugins = listPlugins();
+        if (plugins.length === 0) {
+            console.log(chalk.dim('  No plugins installed.'));
+            console.log(chalk.dim(`  Install one with: opencli plugin install github:user/repo`));
+            return;
+        }
+        if (opts.format === 'json') {
+            renderOutput(plugins, {
+                fmt: 'json',
+                columns: ['name', 'commands', 'source'],
+                title: 'opencli/plugins',
+                source: 'opencli plugin list',
+            });
+            return;
+        }
+        console.log();
+        console.log(chalk.bold('  Installed plugins'));
+        console.log();
+        for (const p of plugins) {
+            const cmds = p.commands.length > 0 ? chalk.dim(` (${p.commands.join(', ')})`) : '';
+            const src = p.source ? chalk.dim(` ← ${p.source}`) : '';
+            console.log(`  ${chalk.cyan(p.name)}${cmds}${src}`);
+        }
+        console.log();
+        console.log(chalk.dim(`  ${plugins.length} plugin(s) installed`));
+        console.log();
+    });
     // ── External CLIs ─────────────────────────────────────────────────────────
     const externalClis = loadExternalClis();
     program

package/dist/clis/barchart/greeks.js

@@ -11,7 +11,7 @@ cli({
     domain: 'www.barchart.com',
     strategy: Strategy.COOKIE,
     args: [
-        { name: 'symbol', required: true, help: 'Stock ticker (e.g. AAPL)' },
+        { name: 'symbol', required: true, positional: true, help: 'Stock ticker (e.g. AAPL)' },
         { name: 'expiration', type: 'str', help: 'Expiration date (YYYY-MM-DD). Defaults to the nearest available expiration.' },
         { name: 'limit', type: 'int', default: 10, help: 'Number of near-the-money strikes per type' },
     ],

package/dist/clis/barchart/options.js

@@ -10,7 +10,7 @@ cli({
     domain: 'www.barchart.com',
     strategy: Strategy.COOKIE,
     args: [
-        { name: 'symbol', required: true, help: 'Stock ticker (e.g. AAPL)' },
+        { name: 'symbol', required: true, positional: true, help: 'Stock ticker (e.g. AAPL)' },
         { name: 'type', type: 'str', default: 'Call', help: 'Option type: Call or Put', choices: ['Call', 'Put'] },
         { name: 'limit', type: 'int', default: 20, help: 'Max number of strikes to return' },
     ],

package/dist/clis/barchart/quote.js

@@ -10,7 +10,7 @@ cli({
     domain: 'www.barchart.com',
     strategy: Strategy.COOKIE,
     args: [
-        { name: 'symbol', required: true, help: 'Stock ticker (e.g. AAPL, MSFT, TSLA)' },
+        { name: 'symbol', required: true, positional: true, help: 'Stock ticker (e.g. AAPL, MSFT, TSLA)' },
     ],
     columns: [
         'symbol', 'name', 'price', 'change', 'changePct',

package/dist/clis/bilibili/download.js

@@ -19,7 +19,7 @@ cli({
     domain: 'www.bilibili.com',
     strategy: Strategy.COOKIE,
     args: [
-        { name: 'bvid', required: true, help: 'Video BV ID (e.g., BV1xxx)' },
+        { name: 'bvid', required: true, positional: true, help: 'Video BV ID (e.g., BV1xxx)' },
         { name: 'output', default: './bilibili-downloads', help: 'Output directory' },
         { name: 'quality', default: 'best', help: 'Video quality (best, 1080p, 720p, 480p)' },
     ],

package/dist/clis/bilibili/following.js

@@ -6,7 +6,7 @@ cli({
     description: '获取 Bilibili 用户的关注列表',
     strategy: Strategy.COOKIE,
     args: [
-        { name: 'uid', required: false, help: '目标用户 ID（默认为当前登录用户）' },
+        { name: 'uid', positional: true, required: false, help: '目标用户 ID（默认为当前登录用户）' },
         { name: 'page', type: 'int', required: false, default: 1, help: '页码' },
         { name: 'limit', type: 'int', required: false, default: 50, help: '每页数量 (最大 50)' },
     ],

package/dist/clis/bilibili/subtitle.js

@@ -6,7 +6,7 @@ cli({
     description: '获取 Bilibili 视频的字幕',
     strategy: Strategy.COOKIE,
     args: [
-        { name: 'bvid', required: true },
+        { name: 'bvid', required: true, positional: true },
         { name: 'lang', required: false, help: '字幕语言代码 (如 zh-CN, en-US, ai-zh)，默认取第一个' },
     ],
     columns: ['index', 'from', 'to', 'content'],

package/dist/clis/bilibili/user-videos.js

@@ -7,7 +7,7 @@ cli({
     domain: 'www.bilibili.com',
     strategy: Strategy.COOKIE,
     args: [
-        { name: 'uid', required: true, help: 'User UID or username' },
+        { name: 'uid', required: true, positional: true, help: 'User UID or username' },
         { name: 'limit', type: 'int', default: 20, help: 'Number of results' },
         { name: 'order', default: 'pubdate', help: 'Sort: pubdate, click, stow' },
         { name: 'page', type: 'int', default: 1, help: 'Page number' },

package/dist/clis/boss/batchgreet.js

@@ -1,16 +1,15 @@
 /**
  * BOSS直聘 batchgreet — batch greet recommended candidates.
- *
- * Combines recommend (greetRecSortList) + greet (UI automation).
- * Sends greeting messages to multiple candidates sequentially.
  */
 import { cli, Strategy } from '../../registry.js';
+import { requirePage, navigateToChat, fetchRecommendList, clickCandidateInList, typeAndSendMessage, verbose, } from './common.js';
 cli({
     site: 'boss',
     name: 'batchgreet',
     description: 'BOSS直聘批量向推荐候选人发送招呼',
     domain: 'www.zhipin.com',
     strategy: Strategy.COOKIE,
+    navigateBefore: false,
     browser: true,
     args: [
         { name: 'job-id', default: '', help: 'Filter by encrypted job ID (greet all jobs if empty)' },
@@ -19,38 +18,13 @@ cli({
     ],
     columns: ['name', 'status', 'detail'],
     func: async (page, kwargs) => {
-        if (!page)
-            throw new Error('Browser page required');
+        requirePage(page);
         const filterJobId = kwargs['job-id'] || '';
         const limit = kwargs.limit || 5;
         const text = kwargs.text || '你好，请问您对这个职位感兴趣吗？';
-        if (process.env.OPENCLI_VERBOSE) {
-            console.error(`[opencli:boss] Batch greeting up to ${limit} candidates...`);
-        }
-        await page.goto('https://www.zhipin.com/web/chat/index');
-        await page.wait({ time: 3 });
-        // Get recommended candidates
-        const listData = await page.evaluate(`
-      async () => {
-        return new Promise((resolve, reject) => {
-          const xhr = new XMLHttpRequest();
-          xhr.open('GET', 'https://www.zhipin.com/wapi/zprelation/friend/greetRecSortList', true);
-          xhr.withCredentials = true;
-          xhr.timeout = 15000;
-          xhr.setRequestHeader('Accept', 'application/json');
-          xhr.onload = () => { try { resolve(JSON.parse(xhr.responseText)); } catch(e) { reject(e); } };
-          xhr.onerror = () => reject(new Error('Network Error'));
-          xhr.send();
-        });
-      }
-    `);
-        if (listData.code !== 0) {
-            if (listData.code === 7 || listData.code === 37) {
-                throw new Error('Cookie 已过期！请在当前 Chrome 浏览器中重新登录 BOSS 直聘。');
-            }
-            throw new Error(`获取推荐列表失败: ${listData.message}`);
-        }
-        let candidates = listData.zpData?.friendList || [];
+        verbose(`Batch greeting up to ${limit} candidates...`);
+        await navigateToChat(page, 3);
+        let candidates = await fetchRecommendList(page);
         if (filterJobId) {
             candidates = candidates.filter((f) => f.encryptJobId === filterJobId);
         }
@@ -63,78 +37,17 @@ cli({
             const numericUid = candidate.uid;
             const friendName = candidate.name || '候选人';
             try {
-                // Click on candidate
-                const clicked = await page.evaluate(`
-          async () => {
-            const item = document.querySelector('#_${numericUid}-0') || document.querySelector('[id^="_${numericUid}"]');
-            if (item) {
-              item.click();
-              return { clicked: true };
-            }
-            const items = document.querySelectorAll('.geek-item');
-            for (const el of items) {
-              if (el.id && el.id.startsWith('_${numericUid}')) {
-                el.click();
-                return { clicked: true };
-              }
-            }
-            return { clicked: false };
-          }
-        `);
-                if (!clicked.clicked) {
+                const clicked = await clickCandidateInList(page, numericUid);
+                if (!clicked) {
                     results.push({ name: friendName, status: '❌ 跳过', detail: '在聊天列表中未找到' });
                     continue;
                 }
                 await page.wait({ time: 2 });
-                // Type message
-                const typed = await page.evaluate(`
-          async () => {
-            const selectors = [
-              '.chat-editor [contenteditable="true"]',
-              '.chat-input [contenteditable="true"]',
-              '[contenteditable="true"]',
-              'textarea',
-            ];
-            for (const sel of selectors) {
-              const el = document.querySelector(sel);
-              if (el && el.offsetParent !== null) {
-                el.focus();
-                if (el.tagName === 'TEXTAREA' || el.tagName === 'INPUT') {
-                  el.value = ${JSON.stringify(text)};
-                  el.dispatchEvent(new Event('input', { bubbles: true }));
-                } else {
-                  el.textContent = '';
-                  el.focus();
-                  document.execCommand('insertText', false, ${JSON.stringify(text)});
-                  el.dispatchEvent(new Event('input', { bubbles: true }));
-                }
-                return { found: true };
-              }
-            }
-            return { found: false };
-          }
-        `);
-                if (!typed.found) {
+                const sent = await typeAndSendMessage(page, text);
+                if (!sent) {
                     results.push({ name: friendName, status: '❌ 失败', detail: '找不到消息输入框' });
                     continue;
                 }
-                await page.wait({ time: 0.5 });
-                // Click send
-                const sent = await page.evaluate(`
-          async () => {
-            const btn = document.querySelector('.conversation-editor .submit') 
-                     || document.querySelector('.submit-content .submit')
-                     || document.querySelector('.conversation-operate .submit');
-            if (btn) {
-              btn.click();
-              return { clicked: true };
-            }
-            return { clicked: false };
-          }
-        `);
-                if (!sent.clicked) {
-                    await page.pressKey('Enter');
-                }
                 await page.wait({ time: 1.5 });
                 results.push({ name: friendName, status: '✅ 已发送', detail: text });
             }

package/dist/clis/boss/chatlist.js

@@ -1,10 +1,12 @@
 import { cli, Strategy } from '../../registry.js';
+import { requirePage, navigateToChat, fetchFriendList } from './common.js';
 cli({
     site: 'boss',
     name: 'chatlist',
     description: 'BOSS直聘查看聊天列表（招聘端）',
     domain: 'www.zhipin.com',
     strategy: Strategy.COOKIE,
+    navigateBefore: false,
     browser: true,
     args: [
         { name: 'page', type: 'int', default: 1, help: 'Page number' },
@@ -13,32 +15,13 @@ cli({
     ],
     columns: ['name', 'job', 'last_msg', 'last_time', 'uid', 'security_id'],
     func: async (page, kwargs) => {
-        if (!page)
-            throw new Error('Browser page required');
-        await page.goto('https://www.zhipin.com/web/chat/index');
-        await page.wait({ time: 2 });
-        const jobId = kwargs['job-id'] || '0';
-        const pageNum = kwargs.page || 1;
-        const limit = kwargs.limit || 20;
-        const targetUrl = `https://www.zhipin.com/wapi/zprelation/friend/getBossFriendListV2.json?page=${pageNum}&status=0&jobId=${jobId}`;
-        const data = await page.evaluate(`
-      async () => {
-        return new Promise((resolve, reject) => {
-          const xhr = new XMLHttpRequest();
-          xhr.open('GET', '${targetUrl}', true);
-          xhr.withCredentials = true;
-          xhr.timeout = 15000;
-          xhr.setRequestHeader('Accept', 'application/json');
-          xhr.onload = () => { try { resolve(JSON.parse(xhr.responseText)); } catch(e) { reject(new Error('JSON parse failed')); } };
-          xhr.onerror = () => reject(new Error('Network Error'));
-          xhr.send();
+        requirePage(page);
+        await navigateToChat(page);
+        const friends = await fetchFriendList(page, {
+            pageNum: kwargs.page || 1,
+            jobId: kwargs['job-id'] || '0',
         });
-      }
-    `);
-        if (data.code !== 0)
-            throw new Error(`API error: ${data.message} (code=${data.code})`);
-        const friends = (data.zpData?.friendList || []).slice(0, limit);
-        return friends.map((f) => ({
+        return friends.slice(0, kwargs.limit || 20).map((f) => ({
             name: f.name || '',
             job: f.jobName || '',
             last_msg: f.lastMessageInfo?.text || '',

package/dist/clis/boss/chatmsg.js

@@ -1,63 +1,32 @@
 import { cli, Strategy } from '../../registry.js';
+import { requirePage, navigateToChat, bossFetch, findFriendByUid } from './common.js';
 cli({
     site: 'boss',
     name: 'chatmsg',
     description: 'BOSS直聘查看与候选人的聊天消息',
     domain: 'www.zhipin.com',
     strategy: Strategy.COOKIE,
+    navigateBefore: false,
     browser: true,
     args: [
-        { name: 'uid', required: true, help: 'Encrypted UID (from chatlist)' },
+        { name: 'uid', required: true, positional: true, help: 'Encrypted UID (from chatlist)' },
         { name: 'page', type: 'int', default: 1, help: 'Page number' },
     ],
     columns: ['from', 'type', 'text', 'time'],
     func: async (page, kwargs) => {
-        if (!page)
-            throw new Error('Browser page required');
-        await page.goto('https://www.zhipin.com/web/chat/index');
-        await page.wait({ time: 2 });
-        const uid = kwargs.uid;
-        const friendData = await page.evaluate(`
-      async () => {
-        return new Promise((resolve, reject) => {
-          const xhr = new XMLHttpRequest();
-          xhr.open('GET', 'https://www.zhipin.com/wapi/zprelation/friend/getBossFriendListV2.json?page=1&status=0&jobId=0', true);
-          xhr.withCredentials = true;
-          xhr.timeout = 15000;
-          xhr.setRequestHeader('Accept', 'application/json');
-          xhr.onload = () => { try { resolve(JSON.parse(xhr.responseText)); } catch(e) { reject(e); } };
-          xhr.onerror = () => reject(new Error('Network Error'));
-          xhr.send();
-        });
-      }
-    `);
-        if (friendData.code !== 0)
-            throw new Error('获取好友列表失败');
-        const friend = (friendData.zpData?.friendList || []).find((f) => f.encryptUid === uid);
+        requirePage(page);
+        await navigateToChat(page);
+        const friend = await findFriendByUid(page, kwargs.uid);
         if (!friend)
             throw new Error('未找到该候选人');
         const gid = friend.uid;
         const securityId = encodeURIComponent(friend.securityId);
         const msgUrl = `https://www.zhipin.com/wapi/zpchat/boss/historyMsg?gid=${gid}&securityId=${securityId}&page=${kwargs.page}&c=20&src=0`;
-        const msgData = await page.evaluate(`
-      async () => {
-        return new Promise((resolve, reject) => {
-          const xhr = new XMLHttpRequest();
-          xhr.open('GET', '${msgUrl}', true);
-          xhr.withCredentials = true;
-          xhr.timeout = 15000;
-          xhr.setRequestHeader('Accept', 'application/json');
-          xhr.onload = () => { try { resolve(JSON.parse(xhr.responseText)); } catch(e) { resolve({raw: xhr.responseText.substring(0,500)}); } };
-          xhr.onerror = () => reject(new Error('Network Error'));
-          xhr.send();
-        });
-      }
-    `);
-        if (msgData.raw)
-            throw new Error('Non-JSON: ' + msgData.raw);
-        if (msgData.code !== 0)
-            throw new Error('API error: ' + (msgData.message || msgData.code));
-        const TYPE_MAP = { 1: '文本', 2: '图片', 3: '招呼', 4: '简历', 5: '系统', 6: '名片', 7: '语音', 8: '视频', 9: '表情' };
+        const msgData = await bossFetch(page, msgUrl);
+        const TYPE_MAP = {
+            1: '文本', 2: '图片', 3: '招呼', 4: '简历', 5: '系统',
+            6: '名片', 7: '语音', 8: '视频', 9: '表情',
+        };
         const messages = msgData.zpData?.messages || msgData.zpData?.historyMsgList || [];
         return messages.map((m) => {
             const fromObj = m.from || {};

package/dist/clis/boss/common.d.ts

@@ -0,0 +1,92 @@
+/**
+ * BOSS直聘 common utilities — shared logic for all boss adapters.
+ *
+ * Consolidates:
+ * - Page navigation with cookie context
+ * - XHR-based API calls (GET/POST) with automatic login state detection
+ * - Cookie expiry error codes (code 7, 37)
+ * - Verbose logging
+ */
+import type { IPage } from '../../types.js';
+export interface BossApiResponse {
+    code: number;
+    message?: string;
+    zpData?: any;
+    [key: string]: any;
+}
+export interface FetchOptions {
+    /** HTTP method, defaults to 'GET' */
+    method?: 'GET' | 'POST';
+    /** POST body (will be sent as application/x-www-form-urlencoded) */
+    body?: string;
+    /** XHR timeout in ms, defaults to 15000 */
+    timeout?: number;
+    /** If true, don't throw on non-zero code — return the raw response */
+    allowNonZero?: boolean;
+}
+/**
+ * Assert that page is available (non-null).
+ */
+export declare function requirePage(page: IPage | null): asserts page is IPage;
+/**
+ * Navigate to BOSS chat page and wait for it to settle.
+ * This establishes the cookie context needed for subsequent API calls.
+ */
+export declare function navigateToChat(page: IPage, waitSeconds?: number): Promise<void>;
+/**
+ * Navigate to a custom BOSS page (for search/detail that use different pages).
+ */
+export declare function navigateTo(page: IPage, url: string, waitSeconds?: number): Promise<void>;
+/**
+ * Check if an API response indicates cookie expiry and throw a clear error.
+ * Call this after every BOSS API response with a non-zero code.
+ */
+export declare function checkAuth(data: BossApiResponse): void;
+/**
+ * Throw if the API response is not code 0.
+ * Checks for cookie expiry first, then throws with the provided message.
+ */
+export declare function assertOk(data: BossApiResponse, errorPrefix?: string): void;
+/**
+ * Make a credentialed XHR request via page.evaluate().
+ *
+ * This is the single XHR template — no more copy-pasting the same 15-line
+ * XMLHttpRequest boilerplate across every adapter.
+ *
+ * @returns Parsed JSON response
+ * @throws On network error, timeout, JSON parse failure, or cookie expiry
+ */
+export declare function bossFetch(page: IPage, url: string, opts?: FetchOptions): Promise<BossApiResponse>;
+/**
+ * Fetch the boss friend (chat) list.
+ */
+export declare function fetchFriendList(page: IPage, opts?: {
+    pageNum?: number;
+    jobId?: string;
+}): Promise<any[]>;
+/**
+ * Fetch the recommended candidates (greetRecSortList).
+ */
+export declare function fetchRecommendList(page: IPage): Promise<any[]>;
+/**
+ * Find a friend by encryptUid, searching through friend list and optionally greet list.
+ * Returns null if not found.
+ */
+export declare function findFriendByUid(page: IPage, encryptUid: string, opts?: {
+    maxPages?: number;
+    checkGreetList?: boolean;
+}): Promise<any | null>;
+/**
+ * Click on a candidate in the chat list by their numeric UID.
+ * @returns true if clicked, false if not found
+ */
+export declare function clickCandidateInList(page: IPage, numericUid: string | number): Promise<boolean>;
+/**
+ * Type a message into the chat editor and send it.
+ * @returns true if sent successfully
+ */
+export declare function typeAndSendMessage(page: IPage, text: string): Promise<boolean>;
+/**
+ * Verbose log helper — prints when OPENCLI_VERBOSE or DEBUG=opencli is set.
+ */
+export declare function verbose(msg: string): void;