@huyuan-ai/cli 1.0.0 → 1.0.2

package/vendor/opencli/dist/clis/boss/send.js

@@ -0,0 +1,43 @@
+/**
+ * BOSS直聘 send message — via UI automation on chat page.
+ *
+ * BOSS chat uses MQTT (not HTTP) for messaging, so we must go through the UI
+ * rather than making direct API calls.
+ */
+import { cli, Strategy } from '../../registry.js';
+import { requirePage, navigateToChat, findFriendByUid, clickCandidateInList, typeAndSendMessage, } from './utils.js';
+import { EmptyResultError, SelectorError } from '../../errors.js';
+cli({
+    site: 'boss',
+    name: 'send',
+    description: 'BOSS直聘发送聊天消息',
+    domain: 'www.zhipin.com',
+    strategy: Strategy.COOKIE,
+    navigateBefore: false,
+    browser: true,
+    args: [
+        { name: 'uid', positional: true, required: true, help: 'Encrypted UID of the candidate (from chatlist)' },
+        { name: 'text', required: true, positional: true, help: 'Message text to send' },
+    ],
+    columns: ['status', 'detail'],
+    func: async (page, kwargs) => {
+        requirePage(page);
+        await navigateToChat(page, 3);
+        const friend = await findFriendByUid(page, kwargs.uid, { maxPages: 5 });
+        if (!friend)
+            throw new EmptyResultError('boss candidate search', '请确认 uid 是否正确');
+        const numericUid = friend.uid;
+        const friendName = friend.name || '候选人';
+        const clicked = await clickCandidateInList(page, numericUid);
+        if (!clicked) {
+            throw new SelectorError('聊天列表中的用户', '请确认聊天列表中有此人');
+        }
+        await page.wait({ time: 2 });
+        const sent = await typeAndSendMessage(page, kwargs.text);
+        if (!sent) {
+            throw new SelectorError('消息输入框', '聊天页面 UI 可能已改变');
+        }
+        await page.wait({ time: 1 });
+        return [{ status: '✅ 发送成功', detail: `已向 ${friendName} 发送: ${kwargs.text}` }];
+    },
+});

package/vendor/opencli/dist/clis/boss/stats.d.ts

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

package/vendor/opencli/dist/clis/boss/stats.js

@@ -0,0 +1,65 @@
+/**
+ * BOSS直聘 stats — job statistics overview.
+ */
+import { cli, Strategy } from '../../registry.js';
+import { requirePage, navigateToChat, bossFetch, fetchFriendList, verbose } from './utils.js';
+cli({
+    site: 'boss',
+    name: 'stats',
+    description: 'BOSS直聘职位数据统计',
+    domain: 'www.zhipin.com',
+    strategy: Strategy.COOKIE,
+    navigateBefore: false,
+    browser: true,
+    args: [
+        { name: 'job-id', default: '', help: 'Encrypted job ID (show all if empty)' },
+    ],
+    columns: ['job_name', 'salary', 'city', 'status', 'total_chats', 'encrypt_job_id'],
+    func: async (page, kwargs) => {
+        requirePage(page);
+        verbose('Fetching job statistics...');
+        const filterJobId = kwargs['job-id'] || '';
+        await navigateToChat(page);
+        // Get job list
+        const jobData = await bossFetch(page, 'https://www.zhipin.com/wapi/zpjob/job/chatted/jobList');
+        // Get total chat stats (non-critical, allow failure)
+        const chatStats = await bossFetch(page, 'https://www.zhipin.com/wapi/zpchat/chatHelper/statistics', {
+            allowNonZero: true,
+        });
+        const totalFriends = chatStats.zpData?.totalFriendCount || 0;
+        // Get per-job chat counts from friend list (non-critical)
+        let friendList = [];
+        try {
+            friendList = await fetchFriendList(page);
+        }
+        catch { /* ignore */ }
+        const jobChatCounts = {};
+        for (const f of friendList) {
+            const jobName = f.jobName || 'unknown';
+            jobChatCounts[jobName] = (jobChatCounts[jobName] || 0) + 1;
+        }
+        let jobs = jobData.zpData || [];
+        if (filterJobId) {
+            jobs = jobs.filter((j) => j.encryptJobId === filterJobId);
+        }
+        const results = jobs.map((j) => ({
+            job_name: j.jobName || '',
+            salary: j.salaryDesc || '',
+            city: j.address || '',
+            status: j.jobOnlineStatus === 1 ? '在线' : '已关闭',
+            total_chats: String(jobChatCounts[j.jobName] || 0),
+            encrypt_job_id: j.encryptJobId || '',
+        }));
+        if (!filterJobId && results.length > 0) {
+            results.push({
+                job_name: '--- 总计 ---',
+                salary: '',
+                city: '',
+                status: `${jobs.length} 个职位`,
+                total_chats: String(totalFriends),
+                encrypt_job_id: '',
+            });
+        }
+        return results;
+    },
+});

package/vendor/opencli/dist/clis/boss/utils.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;

package/vendor/opencli/dist/clis/boss/utils.js

@@ -0,0 +1,223 @@
+// ── Constants ───────────────────────────────────────────────────────────────
+const BOSS_DOMAIN = 'www.zhipin.com';
+const CHAT_URL = `https://${BOSS_DOMAIN}/web/chat/index`;
+const COOKIE_EXPIRED_CODES = new Set([7, 37]);
+const COOKIE_EXPIRED_MSG = 'Cookie 已过期！请在当前 Chrome 浏览器中重新登录 BOSS 直聘。';
+const DEFAULT_TIMEOUT = 15_000;
+// ── Core helpers ────────────────────────────────────────────────────────────
+/**
+ * Assert that page is available (non-null).
+ */
+export function requirePage(page) {
+    if (!page)
+        throw new Error('Browser page required');
+}
+/**
+ * Navigate to BOSS chat page and wait for it to settle.
+ * This establishes the cookie context needed for subsequent API calls.
+ */
+export async function navigateToChat(page, waitSeconds = 2) {
+    await page.goto(CHAT_URL);
+    await page.wait({ time: waitSeconds });
+}
+/**
+ * Navigate to a custom BOSS page (for search/detail that use different pages).
+ */
+export async function navigateTo(page, url, waitSeconds = 1) {
+    await page.goto(url);
+    await page.wait({ time: waitSeconds });
+}
+/**
+ * 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 function checkAuth(data) {
+    if (COOKIE_EXPIRED_CODES.has(data.code)) {
+        throw new Error(COOKIE_EXPIRED_MSG);
+    }
+}
+/**
+ * Throw if the API response is not code 0.
+ * Checks for cookie expiry first, then throws with the provided message.
+ */
+export function assertOk(data, errorPrefix) {
+    if (data.code === 0)
+        return;
+    checkAuth(data);
+    const prefix = errorPrefix ? `${errorPrefix}: ` : '';
+    throw new Error(`${prefix}${data.message || 'Unknown error'} (code=${data.code})`);
+}
+/**
+ * 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 async function bossFetch(page, url, opts = {}) {
+    const method = opts.method ?? 'GET';
+    const timeout = opts.timeout ?? DEFAULT_TIMEOUT;
+    const body = opts.body ?? null;
+    // Build the evaluate script. We use JSON.stringify for safe interpolation.
+    const script = `
+    async () => {
+      return new Promise((resolve, reject) => {
+        const xhr = new XMLHttpRequest();
+        xhr.open(${JSON.stringify(method)}, ${JSON.stringify(url)}, true);
+        xhr.withCredentials = true;
+        xhr.timeout = ${timeout};
+        xhr.setRequestHeader('Accept', 'application/json');
+        ${method === 'POST' ? `xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');` : ''}
+        xhr.onload = () => {
+          try { resolve(JSON.parse(xhr.responseText)); }
+          catch(e) { reject(new Error('JSON parse failed: ' + xhr.responseText.substring(0, 200))); }
+        };
+        xhr.onerror = () => reject(new Error('Network Error'));
+        xhr.ontimeout = () => reject(new Error('Timeout'));
+        xhr.send(${body ? JSON.stringify(body) : 'null'});
+      });
+    }
+  `;
+    const data = await page.evaluate(script);
+    // Auto-check auth unless caller opts out
+    if (!opts.allowNonZero && data.code !== 0) {
+        assertOk(data);
+    }
+    return data;
+}
+// ── Convenience helpers ─────────────────────────────────────────────────────
+/**
+ * Fetch the boss friend (chat) list.
+ */
+export async function fetchFriendList(page, opts = {}) {
+    const pageNum = opts.pageNum ?? 1;
+    const jobId = opts.jobId ?? '0';
+    const url = `https://${BOSS_DOMAIN}/wapi/zprelation/friend/getBossFriendListV2.json?page=${pageNum}&status=0&jobId=${jobId}`;
+    const data = await bossFetch(page, url);
+    return data.zpData?.friendList || [];
+}
+/**
+ * Fetch the recommended candidates (greetRecSortList).
+ */
+export async function fetchRecommendList(page) {
+    const url = `https://${BOSS_DOMAIN}/wapi/zprelation/friend/greetRecSortList`;
+    const data = await bossFetch(page, url);
+    return data.zpData?.friendList || [];
+}
+/**
+ * Find a friend by encryptUid, searching through friend list and optionally greet list.
+ * Returns null if not found.
+ */
+export async function findFriendByUid(page, encryptUid, opts = {}) {
+    const maxPages = opts.maxPages ?? 1;
+    const checkGreetList = opts.checkGreetList ?? false;
+    // Search friend list pages
+    for (let p = 1; p <= maxPages; p++) {
+        const friends = await fetchFriendList(page, { pageNum: p });
+        const found = friends.find((f) => f.encryptUid === encryptUid);
+        if (found)
+            return found;
+        if (friends.length === 0)
+            break;
+    }
+    // Optionally check greet list
+    if (checkGreetList) {
+        const greetList = await fetchRecommendList(page);
+        const found = greetList.find((f) => f.encryptUid === encryptUid);
+        if (found)
+            return found;
+    }
+    return null;
+}
+// ── UI automation helpers ───────────────────────────────────────────────────
+/**
+ * Click on a candidate in the chat list by their numeric UID.
+ * @returns true if clicked, false if not found
+ */
+export async function clickCandidateInList(page, numericUid) {
+    const uid = String(numericUid).replace(/[^0-9]/g, ''); // sanitize to digits only
+    const result = await page.evaluate(`
+    async () => {
+      const uid = ${JSON.stringify(uid)};
+      const item = document.querySelector('#_' + uid + '-0') || document.querySelector('[id^="_' + uid + '"]');
+      if (item) {
+        item.click();
+        return { clicked: true };
+      }
+      const items = document.querySelectorAll('.geek-item');
+      for (const el of items) {
+        if (el.id && el.id.startsWith('_' + uid)) {
+          el.click();
+          return { clicked: true };
+        }
+      }
+      return { clicked: false };
+    }
+  `);
+    return result.clicked;
+}
+/**
+ * Type a message into the chat editor and send it.
+ * @returns true if sent successfully
+ */
+export async function typeAndSendMessage(page, text) {
+    const typed = await page.evaluate(`
+    async () => {
+      const selectors = [
+        '.chat-editor [contenteditable="true"]',
+        '.chat-input [contenteditable="true"]',
+        '.message-editor [contenteditable="true"]',
+        '.chat-conversation [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)
+        return false;
+    await page.wait({ time: 0.5 });
+    // Click send button
+    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');
+    }
+    return true;
+}
+/**
+ * Verbose log helper — prints when OPENCLI_VERBOSE or DEBUG=opencli is set.
+ */
+export function verbose(msg) {
+    if (process.env.OPENCLI_VERBOSE || process.env.DEBUG?.includes('opencli')) {
+        console.error(`[opencli:boss] ${msg}`);
+    }
+}

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

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

package/vendor/opencli/dist/clis/chaoxing/assignments.js

@@ -0,0 +1,75 @@
+import { cli, Strategy } from '../../registry.js';
+import { AuthRequiredError } from '../../errors.js';
+import { getCourses, initSession, enterCourse, getTabIframeUrl, parseAssignmentsFromDom, sleep, } from './utils.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 AuthRequiredError('mooc2-ans.chaoxing.com', '未获取到课程列表');
+        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/vendor/opencli/dist/clis/chaoxing/exams.d.ts

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

package/vendor/opencli/dist/clis/chaoxing/exams.js

@@ -0,0 +1,74 @@
+import { cli, Strategy } from '../../registry.js';
+import { getCourses, initSession, enterCourse, getTabIframeUrl, parseExamsFromDom, sleep, } from './utils.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,
+        }));
+    },
+});

package/vendor/opencli/dist/clis/chaoxing/utils.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Chaoxing (学习通) shared helpers.
+ *
+ * Flow: initSession → getCourses → enterCourse → getTabIframeUrl → navigate → parse DOM
+ * Chaoxing has no flat "list all assignments" API; data is behind session-gated
+ * course pages loaded as iframes.
+ */
+import type { IPage } from '../../types.js';
+/** Sleep for given milliseconds (anti-scraping delay). */
+export declare function sleep(ms: number): Promise<void>;
+/** Execute a credentialed fetch in the browser context, returning JSON or text. */
+export declare function fetchChaoxing(page: IPage, url: string): Promise<any>;
+/** Format a timestamp (seconds or milliseconds or date string) to YYYY-MM-DD HH:mm. */
+export declare function formatTimestamp(ts: unknown): string;
+/** Map numeric work status to Chinese label. */
+export declare function workStatusLabel(status: unknown): string;
+export interface ChaoxingCourse {
+    courseId: string;
+    classId: string;
+    cpi: string;
+    title: string;
+}
+/** Fetch enrolled course list via backclazzdata JSON API. */
+export declare function getCourses(page: IPage): Promise<ChaoxingCourse[]>;
+/** Navigate to the interaction page to establish a Chaoxing session. */
+export declare function initSession(page: IPage): Promise<void>;
+/**
+ * Enter a course via stucoursemiddle redirect (establishes course session + enc).
+ * After this call the browser is on the course page.
+ */
+export declare function enterCourse(page: IPage, course: ChaoxingCourse): Promise<void>;
+/**
+ * On the course page, click a tab (作业 / 考试) and return the iframe src
+ * that gets loaded. Returns empty string if the tab is not found.
+ */
+export declare function getTabIframeUrl(page: IPage, tabName: string): Promise<string>;
+export interface AssignmentRow {
+    course: string;
+    title: string;
+    deadline: string;
+    status: string;
+    score: string;
+}
+/**
+ * Parse assignments from the current page DOM (the 作业列表 page).
+ * The page uses `.ulDiv li` items with status/deadline/score info.
+ */
+export declare function parseAssignmentsFromDom(page: IPage, courseName: string): Promise<AssignmentRow[]>;
+export interface ExamRow {
+    course: string;
+    title: string;
+    start: string;
+    end: string;
+    status: string;
+    score: string;
+}
+/** Parse exams from the current page DOM (the 考试列表 page). */
+export declare function parseExamsFromDom(page: IPage, courseName: string): Promise<ExamRow[]>;