@jackwener/opencli 1.0.1 → 1.0.4

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/resume.d.ts

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

package/dist/clis/boss/resume.js

@@ -0,0 +1,249 @@
+/**
+ * BOSS直聘 resume — view candidate resume/profile via chat page UI scraping (boss side).
+ *
+ * Flow: navigate to chat page → click on candidate → scrape the right panel info.
+ * The chat page loads candidate basic info, work experience, and education
+ * in the right panel when a candidate is selected.
+ *
+ * HTML structure (right panel):
+ *  .base-info-single-detial → name, gender, age, experience, degree
+ *  .experience-content.time-list → time ranges (icon-base-info-work / icon-base-info-edu)
+ *  .experience-content.detail-list → details (company·position / school·major·degree)
+ *  .position-content → job being discussed + expectation
+ */
+import { cli, Strategy } from '../../registry.js';
+cli({
+    site: 'boss',
+    name: 'resume',
+    description: 'BOSS直聘查看候选人简历（招聘端）',
+    domain: 'www.zhipin.com',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        { name: 'uid', required: true, help: 'Encrypted UID of the candidate (from chatlist)' },
+    ],
+    columns: [
+        'name', 'gender', 'age', 'experience', 'degree', 'active_time',
+        'work_history', 'education',
+        'job_chatting', 'expect',
+    ],
+    func: async (page, kwargs) => {
+        if (!page)
+            throw new Error('Browser page required');
+        const uid = kwargs.uid;
+        // Step 1: Navigate to chat page
+        await page.goto('https://www.zhipin.com/web/chat/index');
+        await page.wait({ time: 3 });
+        // Step 2: Get friend list to find candidate's numeric 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) {
+            if (friendData.code === 7 || friendData.code === 37) {
+                throw new Error('Cookie 已过期！请在当前 Chrome 浏览器中重新登录 BOSS 直聘。');
+            }
+            throw new Error('获取好友列表失败: ' + (friendData.message || friendData.code));
+        }
+        let friend = null;
+        const allFriends = friendData.zpData?.friendList || [];
+        friend = allFriends.find((f) => f.encryptUid === uid);
+        if (!friend) {
+            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 || [];
+                    friend = list.find((f) => f.encryptUid === uid);
+                    if (friend)
+                        break;
+                    if (list.length === 0)
+                        break;
+                }
+            }
+        }
+        if (!friend)
+            throw new Error('未找到该候选人，请确认 uid 是否正确');
+        const numericUid = friend.uid;
+        // Step 3: Click on candidate in chat list
+        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) {
+            throw new Error('无法在聊天列表中找到该用户，请确认聊天列表中有此人');
+        }
+        // Step 4: Wait for right panel to load
+        await page.wait({ time: 2 });
+        // Step 5: Scrape the right panel
+        const resumeInfo = await page.evaluate(`
+      (() => {
+        const container = document.querySelector('.base-info-single-container') || document.querySelector('.base-info-content');
+        if (!container) return { error: 'no container found' };
+
+        // === Basic Info ===
+        const nameEl = container.querySelector('.base-name');
+        const name = nameEl ? nameEl.textContent.trim() : '';
+
+        // Gender
+        let gender = '';
+        const detailDiv = container.querySelector('.base-info-single-detial');
+        if (detailDiv) {
+          const uses = detailDiv.querySelectorAll('use');
+          for (const u of uses) {
+            const href = u.getAttribute('xlink:href') || u.getAttribute('href') || '';
+            if (href.includes('icon-men')) { gender = '男'; break; }
+            if (href.includes('icon-women')) { gender = '女'; break; }
+          }
+        }
+
+        // Active time
+        const activeEl = container.querySelector('.active-time');
+        const activeTime = activeEl ? activeEl.textContent.trim() : '';
+
+        // Age, experience, degree — direct child divs of .base-info-single-detial
+        let age = '', experience = '', degree = '';
+        if (detailDiv) {
+          for (const el of detailDiv.children) {
+            if (el.classList.contains('name-contet') || el.classList.contains('high-light-orange') ||
+                el.classList.contains('resume-btn-content') || el.classList.contains('label-remark-content') ||
+                el.classList.contains('base-info-item')) continue;
+            const text = el.textContent.trim();
+            if (!text) continue;
+            if (text.match(/\\d+岁/)) age = text;
+            else if (text.match(/年|经验|应届/)) experience = text;
+            else if (['博士', '硕士', '本科', '大专', '高中', '中专', '中技', '初中'].some(d => text.includes(d))) degree = text;
+          }
+        }
+
+        // === Work & Education ===
+        // Structure: two .experience-content divs
+        //   1. .time-list → <li> items with icon (work/edu) and time span
+        //   2. .detail-list → <li> items with icon (work/edu) and detail text
+        // Each <li> has a <use> with xlink:href "#icon-base-info-work" or "#icon-base-info-edu"
+
+        const workTimes = [];
+        const eduTimes = [];
+        const workDetails = [];
+        const eduDetails = [];
+
+        const timeList = container.querySelector('.experience-content.time-list');
+        if (timeList) {
+          const lis = timeList.querySelectorAll('li');
+          for (const li of lis) {
+            const useEl = li.querySelector('use');
+            const href = useEl ? (useEl.getAttribute('xlink:href') || useEl.getAttribute('href') || '') : '';
+            const timeSpan = li.querySelector('.time');
+            const timeText = timeSpan ? timeSpan.textContent.trim() : li.textContent.trim();
+            if (href.includes('base-info-edu')) {
+              eduTimes.push(timeText);
+            } else {
+              workTimes.push(timeText);
+            }
+          }
+        }
+
+        const detailList = container.querySelector('.experience-content.detail-list');
+        if (detailList) {
+          const lis = detailList.querySelectorAll('li');
+          for (const li of lis) {
+            const useEl = li.querySelector('use');
+            const href = useEl ? (useEl.getAttribute('xlink:href') || useEl.getAttribute('href') || '') : '';
+            const valueSpan = li.querySelector('.value');
+            const valueText = valueSpan ? valueSpan.textContent.trim() : li.textContent.trim();
+            if (href.includes('base-info-edu')) {
+              eduDetails.push(valueText);
+            } else {
+              workDetails.push(valueText);
+            }
+          }
+        }
+
+        // Combine times and details
+        const workHistory = [];
+        for (let i = 0; i < Math.max(workTimes.length, workDetails.length); i++) {
+          const parts = [];
+          if (workTimes[i]) parts.push(workTimes[i]);
+          if (workDetails[i]) parts.push(workDetails[i]);
+          if (parts.length) workHistory.push(parts.join('  '));
+        }
+
+        const education = [];
+        for (let i = 0; i < Math.max(eduTimes.length, eduDetails.length); i++) {
+          const parts = [];
+          if (eduTimes[i]) parts.push(eduTimes[i]);
+          if (eduDetails[i]) parts.push(eduDetails[i]);
+          if (parts.length) education.push(parts.join('  '));
+        }
+
+        // === Job Chatting & Expect ===
+        const positionContent = container.querySelector('.position-content');
+        let jobChatting = '', expect = '';
+        if (positionContent) {
+          const posNameEl = positionContent.querySelector('.position-name');
+          if (posNameEl) jobChatting = posNameEl.textContent.trim();
+
+          const expectEl = positionContent.querySelector('.position-item.expect .value');
+          if (expectEl) expect = expectEl.textContent.trim();
+        }
+
+        return {
+          name, gender, age, experience, degree, activeTime,
+          workHistory, education,
+          jobChatting, expect,
+        };
+      })()
+    `);
+        if (resumeInfo.error) {
+            throw new Error('无法获取简历面板: ' + resumeInfo.error);
+        }
+        return [{
+                name: resumeInfo.name || friend.name || '',
+                gender: resumeInfo.gender || '',
+                age: resumeInfo.age || '',
+                experience: resumeInfo.experience || '',
+                degree: resumeInfo.degree || '',
+                active_time: resumeInfo.activeTime || '',
+                work_history: (resumeInfo.workHistory || []).join('\\n') || '(未获取到)',
+                education: (resumeInfo.education || []).join('\\n') || '(未获取到)',
+                job_chatting: resumeInfo.jobChatting || '',
+                expect: resumeInfo.expect || '',
+            }];
+    },
+});

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,
+        }));
+    },
+});