@jackwener/opencli 1.0.1 → 1.0.3

package/dist/cli.js

@@ -0,0 +1,197 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { executeCommand } from './engine.js';
+import { fullName, getRegistry, strategyLabel } from './registry.js';
+import { render as renderOutput } from './output.js';
+import { BrowserBridge, CDPBridge } from './browser/index.js';
+import { browserSession, DEFAULT_BROWSER_COMMAND_TIMEOUT, runWithTimeout } from './runtime.js';
+import { PKG_VERSION } from './version.js';
+import { printCompletionScript } from './completion.js';
+import { CliError } from './errors.js';
+export function runCli(BUILTIN_CLIS, USER_CLIS) {
+    const program = new Command();
+    program.name('opencli').description('Make any website your CLI. Zero setup. AI-powered.').version(PKG_VERSION);
+    // ── Built-in commands ──────────────────────────────────────────────────────
+    program.command('list').description('List all available CLI commands').option('-f, --format <fmt>', 'Output format: table, json, yaml, md, csv', 'table').option('--json', 'JSON output (deprecated)')
+        .action((opts) => {
+        const registry = getRegistry();
+        const commands = [...registry.values()].sort((a, b) => fullName(a).localeCompare(fullName(b)));
+        const rows = commands.map(c => ({
+            command: fullName(c),
+            site: c.site,
+            name: c.name,
+            description: c.description,
+            strategy: strategyLabel(c),
+            browser: c.browser,
+            args: c.args.map(a => a.name).join(', '),
+        }));
+        const fmt = opts.json && opts.format === 'table' ? 'json' : opts.format;
+        if (fmt !== 'table') {
+            renderOutput(rows, {
+                fmt,
+                columns: ['command', 'site', 'name', 'description', 'strategy', 'browser', 'args'],
+                title: 'opencli/list',
+                source: 'opencli list',
+            });
+            return;
+        }
+        const sites = new Map();
+        for (const cmd of commands) {
+            const g = sites.get(cmd.site) ?? [];
+            g.push(cmd);
+            sites.set(cmd.site, g);
+        }
+        console.log();
+        console.log(chalk.bold('  opencli') + chalk.dim(' — available commands'));
+        console.log();
+        for (const [site, cmds] of sites) {
+            console.log(chalk.bold.cyan(`  ${site}`));
+            for (const cmd of cmds) {
+                const tag = strategyLabel(cmd) === 'public' ? chalk.green('[public]') : chalk.yellow(`[${strategyLabel(cmd)}]`);
+                console.log(`    ${cmd.name} ${tag}${cmd.description ? chalk.dim(` — ${cmd.description}`) : ''}`);
+            }
+            console.log();
+        }
+        console.log(chalk.dim(`  ${commands.length} commands across ${sites.size} sites`));
+        console.log();
+    });
+    program.command('validate').description('Validate CLI definitions').argument('[target]', 'site or site/name')
+        .action(async (target) => {
+        const { validateClisWithTarget, renderValidationReport } = await import('./validate.js');
+        console.log(renderValidationReport(validateClisWithTarget([BUILTIN_CLIS, USER_CLIS], target)));
+    });
+    program.command('verify').description('Validate + smoke test').argument('[target]').option('--smoke', 'Run smoke tests', false)
+        .action(async (target, opts) => {
+        const { verifyClis, renderVerifyReport } = await import('./verify.js');
+        const r = await verifyClis({ builtinClis: BUILTIN_CLIS, userClis: USER_CLIS, target, smoke: opts.smoke });
+        console.log(renderVerifyReport(r));
+        process.exitCode = r.ok ? 0 : 1;
+    });
+    program.command('explore').alias('probe').description('Explore a website: discover APIs, stores, and recommend strategies').argument('<url>').option('--site <name>').option('--goal <text>').option('--wait <s>', '', '3').option('--auto', 'Enable interactive fuzzing (simulate clicks to trigger lazy APIs)').option('--click <labels>', 'Comma-separated labels to click before fuzzing (e.g. "字幕,CC,评论")')
+        .action(async (url, opts) => { const { exploreUrl, renderExploreSummary } = await import('./explore.js'); const clickLabels = opts.click ? opts.click.split(',').map((s) => s.trim()) : undefined; const BrowserFactory = process.env.OPENCLI_CDP_ENDPOINT ? CDPBridge : BrowserBridge; console.log(renderExploreSummary(await exploreUrl(url, { BrowserFactory: BrowserFactory, site: opts.site, goal: opts.goal, waitSeconds: parseFloat(opts.wait), auto: opts.auto, clickLabels }))); });
+    program.command('synthesize').description('Synthesize CLIs from explore').argument('<target>').option('--top <n>', '', '3')
+        .action(async (target, opts) => { const { synthesizeFromExplore, renderSynthesizeSummary } = await import('./synthesize.js'); console.log(renderSynthesizeSummary(synthesizeFromExplore(target, { top: parseInt(opts.top) }))); });
+    program.command('generate').description('One-shot: explore → synthesize → register').argument('<url>').option('--goal <text>').option('--site <name>')
+        .action(async (url, opts) => { const { generateCliFromUrl, renderGenerateSummary } = await import('./generate.js'); const BrowserFactory = process.env.OPENCLI_CDP_ENDPOINT ? CDPBridge : BrowserBridge; const r = await generateCliFromUrl({ url, BrowserFactory: BrowserFactory, builtinClis: BUILTIN_CLIS, userClis: USER_CLIS, goal: opts.goal, site: opts.site }); console.log(renderGenerateSummary(r)); process.exitCode = r.ok ? 0 : 1; });
+    program.command('cascade').description('Strategy cascade: find simplest working strategy').argument('<url>').option('--site <name>')
+        .action(async (url, opts) => {
+        const { cascadeProbe, renderCascadeResult } = await import('./cascade.js');
+        const BrowserFactory = process.env.OPENCLI_CDP_ENDPOINT ? CDPBridge : BrowserBridge;
+        const result = await browserSession(BrowserFactory, async (page) => {
+            // Navigate to the site first for cookie context
+            try {
+                const siteUrl = new URL(url);
+                await page.goto(`${siteUrl.protocol}//${siteUrl.host}`);
+                await page.wait(2);
+            }
+            catch { }
+            return cascadeProbe(page, url);
+        });
+        console.log(renderCascadeResult(result));
+    });
+    program.command('doctor')
+        .description('Diagnose opencli browser bridge connectivity')
+        .option('--live', 'Test browser connectivity (requires Chrome running)', false)
+        .action(async (opts) => {
+        const { runBrowserDoctor, renderBrowserDoctorReport } = await import('./doctor.js');
+        const report = await runBrowserDoctor({ live: opts.live, cliVersion: PKG_VERSION });
+        console.log(renderBrowserDoctorReport(report));
+    });
+    program.command('setup')
+        .description('Interactive setup: verify browser bridge connectivity')
+        .action(async () => {
+        const { runSetup } = await import('./setup.js');
+        await runSetup({ cliVersion: PKG_VERSION });
+    });
+    program.command('completion')
+        .description('Output shell completion script')
+        .argument('<shell>', 'Shell type: bash, zsh, or fish')
+        .action((shell) => {
+        printCompletionScript(shell);
+    });
+    // ── Dynamic site commands ──────────────────────────────────────────────────
+    const registry = getRegistry();
+    const siteGroups = new Map();
+    for (const [, cmd] of registry) {
+        let siteCmd = siteGroups.get(cmd.site);
+        if (!siteCmd) {
+            siteCmd = program.command(cmd.site).description(`${cmd.site} commands`);
+            siteGroups.set(cmd.site, siteCmd);
+        }
+        const subCmd = siteCmd.command(cmd.name).description(cmd.description);
+        // Register positional args first, then named options
+        const positionalArgs = [];
+        for (const arg of cmd.args) {
+            if (arg.positional) {
+                const bracket = arg.required ? `<${arg.name}>` : `[${arg.name}]`;
+                subCmd.argument(bracket, arg.help ?? '');
+                positionalArgs.push(arg);
+            }
+            else {
+                const flag = arg.required ? `--${arg.name} <value>` : `--${arg.name} [value]`;
+                if (arg.required)
+                    subCmd.requiredOption(flag, arg.help ?? '');
+                else if (arg.default != null)
+                    subCmd.option(flag, arg.help ?? '', String(arg.default));
+                else
+                    subCmd.option(flag, arg.help ?? '');
+            }
+        }
+        subCmd.option('-f, --format <fmt>', 'Output format: table, json, yaml, md, csv', 'table').option('-v, --verbose', 'Debug output', false);
+        subCmd.action(async (...actionArgs) => {
+            // Commander passes positional args first, then options object, then the Command
+            const actionOpts = actionArgs[positionalArgs.length] ?? {};
+            const startTime = Date.now();
+            const kwargs = {};
+            // Collect positional args
+            for (let i = 0; i < positionalArgs.length; i++) {
+                const arg = positionalArgs[i];
+                const v = actionArgs[i];
+                if (v !== undefined)
+                    kwargs[arg.name] = v;
+            }
+            // Collect named options
+            for (const arg of cmd.args) {
+                if (arg.positional)
+                    continue;
+                const camelName = arg.name.replace(/-([a-z])/g, (_m, ch) => ch.toUpperCase());
+                const v = actionOpts[arg.name] ?? actionOpts[camelName];
+                if (v !== undefined)
+                    kwargs[arg.name] = v;
+            }
+            try {
+                if (actionOpts.verbose)
+                    process.env.OPENCLI_VERBOSE = '1';
+                let result;
+                if (cmd.browser) {
+                    const BrowserFactory = process.env.OPENCLI_CDP_ENDPOINT ? CDPBridge : BrowserBridge;
+                    result = await browserSession(BrowserFactory, async (page) => {
+                        return runWithTimeout(executeCommand(cmd, page, kwargs, actionOpts.verbose), { timeout: cmd.timeoutSeconds ?? DEFAULT_BROWSER_COMMAND_TIMEOUT, label: fullName(cmd) });
+                    });
+                }
+                else {
+                    result = await executeCommand(cmd, null, kwargs, actionOpts.verbose);
+                }
+                if (actionOpts.verbose && (!result || (Array.isArray(result) && result.length === 0))) {
+                    console.error(chalk.yellow(`[Verbose] Warning: Command returned an empty result. If the website structural API changed or requires authentication, check the network or update the adapter.`));
+                }
+                renderOutput(result, { fmt: actionOpts.format, columns: cmd.columns, title: `${cmd.site}/${cmd.name}`, elapsed: (Date.now() - startTime) / 1000, source: fullName(cmd) });
+            }
+            catch (err) {
+                if (err instanceof CliError) {
+                    console.error(chalk.red(`Error [${err.code}]: ${err.message}`));
+                    if (err.hint)
+                        console.error(chalk.yellow(`Hint: ${err.hint}`));
+                }
+                else if (actionOpts.verbose && err.stack) {
+                    console.error(chalk.red(err.stack));
+                }
+                else {
+                    console.error(chalk.red(`Error: ${err.message ?? err}`));
+                }
+                process.exitCode = 1;
+            }
+        });
+    }
+    program.parse();
+}

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

@@ -0,0 +1 @@
+export {};

package/dist/clis/boss/chatlist.js

@@ -0,0 +1,50 @@
+import { cli, Strategy } from '../../registry.js';
+cli({
+    site: 'boss',
+    name: 'chatlist',
+    description: 'BOSS直聘查看聊天列表（招聘端）',
+    domain: 'www.zhipin.com',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        { name: 'page', type: 'int', default: 1, help: 'Page number' },
+        { name: 'limit', type: 'int', default: 20, help: 'Number of results' },
+        { name: 'job_id', default: '0', help: 'Filter by job ID (0=all)' },
+    ],
+    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();
+        });
+      }
+    `);
+        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) => ({
+            name: f.name || '',
+            job: f.jobName || '',
+            last_msg: f.lastMessageInfo?.text || '',
+            last_time: f.lastTime || '',
+            uid: f.encryptUid || '',
+            security_id: f.securityId || '',
+        }));
+    },
+});

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

@@ -0,0 +1 @@
+export {};

package/dist/clis/boss/chatmsg.js

@@ -0,0 +1,73 @@
+import { cli, Strategy } from '../../registry.js';
+cli({
+    site: 'boss',
+    name: 'chatmsg',
+    description: 'BOSS直聘查看与候选人的聊天消息',
+    domain: 'www.zhipin.com',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        { name: 'uid', required: 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);
+        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 messages = msgData.zpData?.messages || msgData.zpData?.historyMsgList || [];
+        return messages.map((m) => {
+            const fromObj = m.from || {};
+            const isSelf = typeof fromObj === 'object' ? fromObj.uid !== friend.uid : false;
+            return {
+                from: isSelf ? '我' : (typeof fromObj === 'object' ? fromObj.name : friend.name),
+                type: TYPE_MAP[m.type] || '其他(' + m.type + ')',
+                text: m.text || m.body?.text || '',
+                time: m.time ? new Date(m.time).toLocaleString('zh-CN') : '',
+            };
+        });
+    },
+});

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

@@ -0,0 +1 @@
+export {};

package/dist/clis/boss/send.js

@@ -0,0 +1,176 @@
+/**
+ * BOSS直聘 send message — via UI automation on chat page.
+ *
+ * Flow: navigate to chat → click on user in list → type in editor → send.
+ * BOSS chat uses MQTT (not HTTP) for messaging, so we must go through the UI.
+ */
+import { cli, Strategy } from '../../registry.js';
+cli({
+    site: 'boss',
+    name: 'send',
+    description: 'BOSS直聘发送聊天消息',
+    domain: 'www.zhipin.com',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        { name: 'uid', required: true, help: 'Encrypted UID of the candidate (from chatlist)' },
+        { name: 'text', required: true, help: 'Message text to send' },
+    ],
+    columns: ['status', 'detail'],
+    func: async (page, kwargs) => {
+        if (!page)
+            throw new Error('Browser page required');
+        const uid = kwargs.uid;
+        const text = kwargs.text;
+        // Step 1: Navigate to chat page
+        await page.goto('https://www.zhipin.com/web/chat/index');
+        await page.wait({ time: 3 });
+        // Step 2: Find friend in list to get their numeric uid, then click
+        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) {
+            if (friendData.code === 7 || friendData.code === 37) {
+                throw new Error('Cookie 已过期！请在当前 Chrome 浏览器中重新登录 BOSS 直聘。');
+            }
+            throw new Error('获取好友列表失败: ' + (friendData.message || friendData.code));
+        }
+        let target = null;
+        const allFriends = friendData.zpData?.friendList || [];
+        target = allFriends.find((f) => f.encryptUid === uid);
+        if (!target) {
+            for (let p = 2; p <= 5; p++) {
+                const moreUrl = `https://www.zhipin.com/wapi/zprelation/friend/getBossFriendListV2.json?page=${p}&status=0&jobId=0`;
+                const moreData = await page.evaluate(`
+          async () => {
+            return new Promise((resolve, reject) => {
+              const xhr = new XMLHttpRequest();
+              xhr.open('GET', '${moreUrl}', 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 (moreData.code === 0) {
+                    const list = moreData.zpData?.friendList || [];
+                    target = list.find((f) => f.encryptUid === uid);
+                    if (target)
+                        break;
+                    if (list.length === 0)
+                        break;
+                }
+            }
+        }
+        if (!target)
+            throw new Error('未找到该候选人，请确认 uid 是否正确');
+        const numericUid = target.uid;
+        const friendName = target.name || '候选人';
+        // Step 3: Click on the user in the chat list to open conversation
+        const clicked = await page.evaluate(`
+      async () => {
+        // The geek-item has id like _748787762-0
+        const item = document.querySelector('#_${numericUid}-0') || document.querySelector('[id^="_${numericUid}"]');
+        if (item) {
+          item.click();
+          return { clicked: true, id: item.id };
+        }
+        // Fallback: try clicking by iterating geek items
+        const items = document.querySelectorAll('.geek-item');
+        for (const el of items) {
+          if (el.id && el.id.startsWith('_${numericUid}')) {
+            el.click();
+            return { clicked: true, id: el.id };
+          }
+        }
+        return { clicked: false };
+      }
+    `);
+        if (!clicked.clicked) {
+            throw new Error('无法在聊天列表中找到该用户，请确认聊天列表中有此人');
+        }
+        // Step 4: Wait for the conversation to load and input area to appear
+        await page.wait({ time: 2 });
+        // Step 5: Find the message editor and type
+        const typed = await page.evaluate(`
+      async () => {
+        // Look for the chat editor - BOSS uses contenteditable div or textarea
+        const selectors = [
+          '.chat-editor [contenteditable="true"]',
+          '.chat-input [contenteditable="true"]',
+          '.message-editor [contenteditable="true"]',
+          '.chat-conversation [contenteditable="true"]',
+          '[contenteditable="true"]',
+          '.chat-editor textarea',
+          '.chat-input textarea',
+          '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 }));
+              el.dispatchEvent(new Event('change', { bubbles: true }));
+            } else {
+              // contenteditable
+              el.textContent = '';
+              el.focus();
+              document.execCommand('insertText', false, ${JSON.stringify(text)});
+              el.dispatchEvent(new Event('input', { bubbles: true }));
+            }
+            
+            return { found: true, selector: sel, tag: el.tagName };
+          }
+        }
+        
+        // Debug: list all visible elements in chat-conversation
+        const conv = document.querySelector('.chat-conversation');
+        const allEls = conv ? Array.from(conv.querySelectorAll('*')).filter(e => e.offsetParent !== null).map(e => e.tagName + '.' + (e.className?.substring?.(0, 50) || '')).slice(0, 30) : [];
+        
+        return { found: false, visibleElements: allEls };
+      }
+    `);
+        if (!typed.found) {
+            throw new Error('找不到消息输入框。可能的元素: ' + JSON.stringify(typed.visibleElements || []));
+        }
+        await page.wait({ time: 0.5 });
+        // Step 6: Click the send button (Enter key doesn't trigger send on BOSS)
+        const sent = await page.evaluate(`
+      async () => {
+        // The send button is .submit inside .submit-content
+        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) {
+            // Fallback: try Enter key
+            await page.pressKey('Enter');
+        }
+        await page.wait({ time: 1 });
+        return [{ status: '✅ 发送成功', detail: `已向 ${friendName} 发送: ${text}` }];
+    },
+});

package/dist/clis/chaoxing/assignments.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/chaoxing/assignments.js

@@ -0,0 +1,74 @@
+import { cli, Strategy } from '../../registry.js';
+import { getCourses, initSession, enterCourse, getTabIframeUrl, parseAssignmentsFromDom, sleep, } from '../../chaoxing.js';
+cli({
+    site: 'chaoxing',
+    name: 'assignments',
+    description: '学习通作业列表',
+    domain: 'mooc2-ans.chaoxing.com',
+    strategy: Strategy.COOKIE,
+    timeoutSeconds: 90,
+    args: [
+        { name: 'course', type: 'string', help: '按课程名过滤（模糊匹配）' },
+        {
+            name: 'status',
+            type: 'string',
+            default: 'all',
+            choices: ['all', 'pending', 'submitted', 'graded'],
+            help: '按状态过滤',
+        },
+        { name: 'limit', type: 'int', default: 20, help: '最大返回数量' },
+    ],
+    columns: ['rank', 'course', 'title', 'deadline', 'status', 'score'],
+    func: async (page, kwargs) => {
+        const { course: courseFilter, status: statusFilter = 'all', limit = 20 } = kwargs;
+        // 1. Establish session
+        await initSession(page);
+        // 2. Get courses
+        const courses = await getCourses(page);
+        if (!courses.length)
+            throw new Error('未获取到课程列表，请确认已登录学习通');
+        const filtered = courseFilter
+            ? courses.filter(c => c.title.includes(courseFilter))
+            : courses;
+        if (courseFilter && !filtered.length) {
+            throw new Error(`未找到匹配「${courseFilter}」的课程`);
+        }
+        // 3. Per-course: enter → click 作业 tab → navigate to iframe → parse
+        const allRows = [];
+        for (const c of filtered) {
+            try {
+                await enterCourse(page, c);
+                const iframeUrl = await getTabIframeUrl(page, '作业');
+                if (!iframeUrl)
+                    continue;
+                await page.goto(iframeUrl);
+                await page.wait(2);
+                const rows = await parseAssignmentsFromDom(page, c.title);
+                allRows.push(...rows);
+            }
+            catch {
+                // Single course failure: skip, continue
+            }
+            if (filtered.length > 1)
+                await sleep(600);
+        }
+        // 4. Sort: pending first, then by deadline
+        allRows.sort((a, b) => {
+            const order = (s) => s === '未交' ? 0 : s === '待批阅' ? 1 : s === '已完成' ? 2 : s === '已批阅' ? 3 : 4;
+            return order(a.status) - order(b.status);
+        });
+        // 5. Filter by status
+        const statusMap = {
+            pending: ['未交'],
+            submitted: ['待批阅', '已完成'],
+            graded: ['已批阅'],
+        };
+        const finalRows = statusFilter === 'all'
+            ? allRows
+            : allRows.filter(r => statusMap[statusFilter]?.includes(r.status));
+        return finalRows.slice(0, Number(limit)).map((item, i) => ({
+            rank: i + 1,
+            ...item,
+        }));
+    },
+});

package/dist/clis/chaoxing/exams.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/chaoxing/exams.js

@@ -0,0 +1,74 @@
+import { cli, Strategy } from '../../registry.js';
+import { getCourses, initSession, enterCourse, getTabIframeUrl, parseExamsFromDom, sleep, } from '../../chaoxing.js';
+cli({
+    site: 'chaoxing',
+    name: 'exams',
+    description: '学习通考试列表',
+    domain: 'mooc2-ans.chaoxing.com',
+    strategy: Strategy.COOKIE,
+    timeoutSeconds: 90,
+    args: [
+        { name: 'course', type: 'string', help: '按课程名过滤（模糊匹配）' },
+        {
+            name: 'status',
+            type: 'string',
+            default: 'all',
+            choices: ['all', 'upcoming', 'ongoing', 'finished'],
+            help: '按状态过滤',
+        },
+        { name: 'limit', type: 'int', default: 20, help: '最大返回数量' },
+    ],
+    columns: ['rank', 'course', 'title', 'start', 'end', 'status', 'score'],
+    func: async (page, kwargs) => {
+        const { course: courseFilter, status: statusFilter = 'all', limit = 20 } = kwargs;
+        // 1. Establish session
+        await initSession(page);
+        // 2. Get courses
+        const courses = await getCourses(page);
+        if (!courses.length)
+            throw new Error('未获取到课程列表，请确认已登录学习通');
+        const filtered = courseFilter
+            ? courses.filter(c => c.title.includes(courseFilter))
+            : courses;
+        if (courseFilter && !filtered.length) {
+            throw new Error(`未找到匹配「${courseFilter}」的课程`);
+        }
+        // 3. Per-course: enter → click 考试 tab → navigate to iframe → parse
+        const allRows = [];
+        for (const c of filtered) {
+            try {
+                await enterCourse(page, c);
+                const iframeUrl = await getTabIframeUrl(page, '考试');
+                if (!iframeUrl)
+                    continue;
+                await page.goto(iframeUrl);
+                await page.wait(2);
+                const rows = await parseExamsFromDom(page, c.title);
+                allRows.push(...rows);
+            }
+            catch {
+                // Single course failure: skip, continue
+            }
+            if (filtered.length > 1)
+                await sleep(600);
+        }
+        // 4. Sort: upcoming first
+        allRows.sort((a, b) => {
+            const order = (s) => s === '未开始' ? 0 : s === '进行中' ? 1 : s === '已结束' ? 2 : s === '已完成' ? 3 : 4;
+            return order(a.status) - order(b.status);
+        });
+        // 5. Filter by status
+        const statusMap = {
+            upcoming: ['未开始'],
+            ongoing: ['进行中'],
+            finished: ['已结束', '已完成'],
+        };
+        const finalRows = statusFilter === 'all'
+            ? allRows
+            : allRows.filter(r => statusMap[statusFilter]?.includes(r.status));
+        return finalRows.slice(0, Number(limit)).map((item, i) => ({
+            rank: i + 1,
+            ...item,
+        }));
+    },
+});