@agentrhq/webcmd 0.1.1 → 0.2.0

package/clis/chaoxing/exams.js

@@ -1,75 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { getCourses, initSession, enterCourse, getTabIframeUrl, parseExamsFromDom, sleep, } from './utils.js';
-cli({
-    site: 'chaoxing',
-    name: 'exams',
-    access: 'read',
-    description: '学习通考试列表',
-    domain: 'mooc2-ans.chaoxing.com',
-    strategy: Strategy.COOKIE,
-    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: '最大返回数量' },
-        { name: 'timeout', type: 'int', required: false, default: 90, help: 'Max seconds for the overall command (default: 90)' },
-    ],
-    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/clis/chaoxing/utils.js

@@ -1,223 +0,0 @@
-/**
- * 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.
- */
-// ── Utilities ────────────────────────────────────────────────────────
-/** Sleep for given milliseconds (anti-scraping delay). */
-export function sleep(ms) {
-    return new Promise(resolve => setTimeout(resolve, ms));
-}
-/** Execute a credentialed fetch in the browser context, returning JSON or text. */
-export async function fetchChaoxing(page, url) {
-    const urlJs = JSON.stringify(url);
-    return page.evaluate(`
-    async () => {
-      const res = await fetch(${urlJs}, { credentials: "include" });
-      const text = await res.text();
-      try { return JSON.parse(text); } catch {}
-      return text;
-    }
-  `);
-}
-/** Format a timestamp (seconds or milliseconds or date string) to YYYY-MM-DD HH:mm. */
-export function formatTimestamp(ts) {
-    if (ts == null || ts === '' || ts === 0)
-        return '';
-    if (typeof ts === 'string' && !/^\d+$/.test(ts.trim()))
-        return ts.trim();
-    const num = Number(ts);
-    if (Number.isNaN(num) || num <= 0)
-        return String(ts);
-    const millis = num > 1e12 ? num : num * 1000;
-    const d = new Date(millis);
-    if (Number.isNaN(d.getTime()))
-        return String(ts);
-    const yyyy = d.getFullYear();
-    const mm = String(d.getMonth() + 1).padStart(2, '0');
-    const dd = String(d.getDate()).padStart(2, '0');
-    const hh = String(d.getHours()).padStart(2, '0');
-    const mi = String(d.getMinutes()).padStart(2, '0');
-    return `${yyyy}-${mm}-${dd} ${hh}:${mi}`;
-}
-/** Map numeric work status to Chinese label. */
-export function workStatusLabel(status) {
-    if (status == null || status === '')
-        return '未知';
-    const s = Number(status);
-    if (s === 0)
-        return '未交';
-    if (s === 1)
-        return '已交';
-    if (s === 2)
-        return '已批阅';
-    const str = String(status).trim();
-    return str || '未知';
-}
-/** Fetch enrolled course list via backclazzdata JSON API. */
-export async function getCourses(page) {
-    const resp = await fetchChaoxing(page, 'https://mooc1-api.chaoxing.com/mycourse/backclazzdata?view=json&rss=1');
-    if (!resp || typeof resp !== 'object')
-        return [];
-    const channelList = resp.channelList ?? [];
-    const courses = [];
-    for (const channel of channelList) {
-        const content = channel?.content;
-        if (!content)
-            continue;
-        const courseData = content.course?.data;
-        if (!Array.isArray(courseData))
-            continue;
-        for (const c of courseData) {
-            courses.push({
-                courseId: String(c.id ?? ''),
-                classId: String(content.id ?? ''),
-                cpi: String(channel.cpi ?? ''),
-                title: String(c.name ?? ''),
-            });
-        }
-    }
-    return courses;
-}
-// ── Session & course entry ───────────────────────────────────────────
-/** Navigate to the interaction page to establish a Chaoxing session. */
-export async function initSession(page) {
-    await page.goto('https://mooc2-ans.chaoxing.com/mooc2-ans/visit/interaction');
-}
-/**
- * Enter a course via stucoursemiddle redirect (establishes course session + enc).
- * After this call the browser is on the course page.
- */
-export async function enterCourse(page, course) {
-    const url = `https://mooc1.chaoxing.com/visit/stucoursemiddle` +
-        `?courseid=${course.courseId}&clazzid=${course.classId}&cpi=${course.cpi}&ismooc2=1&v=2`;
-    await page.goto(url);
-}
-/**
- * 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 async function getTabIframeUrl(page, tabName) {
-    const nameJs = JSON.stringify(tabName);
-    const result = await page.evaluate(`
-    async () => {
-      const tabs = document.querySelectorAll('a[data-url]');
-      let target = null;
-      for (const tab of tabs) {
-        if ((tab.innerText || '').trim() === ${nameJs}) { target = tab; break; }
-      }
-      if (!target) return '';
-      target.click();
-      await new Promise(r => setTimeout(r, 2000));
-      const iframe = document.getElementById('frame_content-hd') || document.querySelector('iframe');
-      return iframe?.src || '';
-    }
-  `);
-    return typeof result === 'string' ? result : '';
-}
-/**
- * Parse assignments from the current page DOM (the 作业列表 page).
- * The page uses `.ulDiv li` items with status/deadline/score info.
- */
-export async function parseAssignmentsFromDom(page, courseName) {
-    const raw = await page.evaluate(`
-    (() => {
-      const items = [];
-      // Each assignment is a li or div block; try multiple selectors
-      const blocks = document.querySelectorAll('.ulDiv li, .work-list-item, .listContent > div, ul > li');
-      for (const block of blocks) {
-        const text = (block.innerText || '').trim();
-        if (!text || text.length < 3) continue;
-        // Skip filter buttons and headers
-        if (/^(全部|已完成|未完成|筛选)$/.test(text)) continue;
-        items.push(text);
-      }
-      // Fallback: split body text by common patterns
-      if (items.length === 0) {
-        const body = (document.body?.innerText || '').trim();
-        return [body];
-      }
-      return items;
-    })()
-  `) ?? [];
-    const rows = [];
-    for (const text of raw) {
-        if (typeof text !== 'string' || text.length < 3)
-            continue;
-        // Skip noise
-        if (/^(全部|已完成|未完成|筛选|暂无|提交的作业将经过)/.test(text))
-            continue;
-        const lines = text.split('\n').map((l) => l.trim()).filter(Boolean);
-        if (!lines.length)
-            continue;
-        // First meaningful line is the title
-        const title = lines[0].replace(/\s+/g, ' ').trim();
-        if (!title || /^(全部|已完成|未完成|筛选)$/.test(title))
-            continue;
-        // Extract status: 未交 / 待批阅 / 已完成 / 已批阅
-        const statusMatch = text.match(/(未交|待批阅|已完成|已批阅)/);
-        const status = statusMatch?.[1] ?? '';
-        // Extract deadline: "剩余XXX" or date pattern
-        const remainMatch = text.match(/(剩余[\d天小时分钟秒]+)/);
-        const dateMatch = text.match(/(\d{4}[-/.]\d{1,2}[-/.]\d{1,2}(?:\s+\d{1,2}:\d{2})?)/);
-        const deadline = remainMatch?.[1] ?? dateMatch?.[1] ?? '';
-        // Extract score (exclude "分钟")
-        const scoreMatch = text.match(/(\d+(?:\.\d+)?)\s*分(?!钟)/);
-        const score = scoreMatch?.[1] ?? '';
-        rows.push({ course: courseName, title, deadline, status, score });
-    }
-    return rows;
-}
-/** Parse exams from the current page DOM (the 考试列表 page). */
-export async function parseExamsFromDom(page, courseName) {
-    const raw = await page.evaluate(`
-    (() => {
-      const items = [];
-      const blocks = document.querySelectorAll('.ulDiv li, .exam-list-item, .listContent > div, ul > li');
-      for (const block of blocks) {
-        const text = (block.innerText || '').trim();
-        if (!text || text.length < 3) continue;
-        if (/^(全部|已完成|未完成|筛选|暂无)$/.test(text)) continue;
-        items.push(text);
-      }
-      if (items.length === 0) {
-        const body = (document.body?.innerText || '').trim();
-        return [body];
-      }
-      return items;
-    })()
-  `) ?? [];
-    // Check for "暂无考试"
-    if (raw.length === 1 && typeof raw[0] === 'string' && raw[0].includes('暂无考试')) {
-        return [];
-    }
-    const rows = [];
-    for (const text of raw) {
-        if (typeof text !== 'string' || text.length < 3)
-            continue;
-        if (/^(全部|已完成|未完成|筛选|暂无)/.test(text))
-            continue;
-        const lines = text.split('\n').map((l) => l.trim()).filter(Boolean);
-        if (!lines.length)
-            continue;
-        const title = lines[0].replace(/\s+/g, ' ').trim();
-        if (!title || /^(全部|已完成|未完成|筛选)$/.test(title))
-            continue;
-        // Extract dates
-        const dates = text.match(/\d{4}[-/.]\d{1,2}[-/.]\d{1,2}\s+\d{1,2}:\d{2}/g) ?? [];
-        const start = dates[0] ?? '';
-        const end = dates[1] ?? '';
-        // Status
-        const statusMatch = text.match(/(未开始|进行中|已结束|已完成|未交|待批阅)/);
-        let status = statusMatch?.[1] ?? '';
-        if (!status && text.includes('剩余'))
-            status = '进行中';
-        // Score (exclude "分钟")
-        const scoreMatch = text.match(/(\d+(?:\.\d+)?)\s*分(?!钟)/);
-        const score = scoreMatch?.[1] ?? '';
-        rows.push({ course: courseName, title, start, end, status, score });
-    }
-    return rows;
-}

package/clis/chaoxing/utils.test.js

@@ -1,45 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { formatTimestamp, workStatusLabel } from './utils.js';
-function localDatePrefixFromMillis(ts) {
-    const d = new Date(ts);
-    const yyyy = d.getFullYear();
-    const mm = String(d.getMonth() + 1).padStart(2, '0');
-    const dd = String(d.getDate()).padStart(2, '0');
-    return `${yyyy}-${mm}-${dd}`;
-}
-describe('formatTimestamp', () => {
-    it('formats millisecond timestamp', () => {
-        const ts = new Date('2026-01-15T00:30:00Z').getTime();
-        const result = formatTimestamp(ts);
-        expect(result).toMatch(new RegExp(`^${localDatePrefixFromMillis(ts)}\\s`));
-    });
-    it('formats second timestamp', () => {
-        const millis = new Date('2026-06-01T12:00:00Z').getTime();
-        const ts = Math.floor(millis / 1000);
-        const result = formatTimestamp(ts);
-        expect(result).toMatch(new RegExp(`^${localDatePrefixFromMillis(millis)}\\s`));
-    });
-    it('returns empty for null/undefined/0', () => {
-        expect(formatTimestamp(null)).toBe('');
-        expect(formatTimestamp(undefined)).toBe('');
-        expect(formatTimestamp(0)).toBe('');
-        expect(formatTimestamp('')).toBe('');
-    });
-    it('passes through readable date strings', () => {
-        expect(formatTimestamp('2026-03-20 23:59')).toBe('2026-03-20 23:59');
-    });
-});
-describe('workStatusLabel', () => {
-    it('maps numeric status codes', () => {
-        expect(workStatusLabel(0)).toBe('未交');
-        expect(workStatusLabel(1)).toBe('已交');
-        expect(workStatusLabel(2)).toBe('已批阅');
-    });
-    it('passes through string status', () => {
-        expect(workStatusLabel('已交')).toBe('已交');
-    });
-    it('returns 未知 for empty/null', () => {
-        expect(workStatusLabel(null)).toBe('未知');
-        expect(workStatusLabel('')).toBe('未知');
-    });
-});

package/clis/cnki/search.js

@@ -1,61 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { clampInt, requireNonEmptyQuery } from '../_shared/common.js';
-cli({
-    site: 'cnki',
-    name: 'search',
-    access: 'read',
-    description: '中国知网论文搜索（海外版）',
-    domain: 'oversea.cnki.net',
-    strategy: Strategy.COOKIE,
-    args: [
-        { name: 'query', positional: true, required: true, help: '搜索关键词' },
-        { name: 'limit', type: 'int', default: 10, help: '返回结果数量 (max 20)' },
-    ],
-    columns: ['rank', 'title', 'authors', 'journal', 'date', 'url'],
-    navigateBefore: false,
-    func: async (page, kwargs) => {
-        const limit = clampInt(kwargs.limit, 10, 1, 20);
-        const query = requireNonEmptyQuery(kwargs.query);
-        await page.goto(`https://oversea.cnki.net/kns/search?dbcode=CFLS&kw=${encodeURIComponent(query)}&korder=SU`);
-        await page.wait(8);
-        const data = await page.evaluate(`
-      (async () => {
-        const normalize = v => (v || '').replace(/\\s+/g, ' ').trim();
-        for (let i = 0; i < 40; i++) {
-          if (document.querySelector('.result-table-list tbody tr, #gridTable tbody tr')) break;
-          await new Promise(r => setTimeout(r, 500));
-        }
-        const rows = document.querySelectorAll('.result-table-list tbody tr, #gridTable tbody tr');
-        const results = [];
-        for (const row of rows) {
-          const tds = row.querySelectorAll('td');
-          if (tds.length < 5) continue;
-
-          const nameCell = row.querySelector('td.name') || tds[2];
-          const titleEl = nameCell?.querySelector('a');
-          const title = normalize(titleEl?.textContent).replace(/免费$/, '');
-          if (!title) continue;
-
-          let url = titleEl?.getAttribute('href') || '';
-          if (url && !url.startsWith('http')) url = 'https://oversea.cnki.net' + url;
-
-          const authorCell = row.querySelector('td.author') || tds[3];
-          const journalCell = row.querySelector('td.source') || tds[4];
-          const dateCell = row.querySelector('td.date') || tds[5];
-
-          results.push({
-            rank: results.length + 1,
-            title,
-            authors: normalize(authorCell?.textContent),
-            journal: normalize(journalCell?.textContent),
-            date: normalize(dateCell?.textContent),
-            url,
-          });
-          if (results.length >= ${limit}) break;
-        }
-        return results;
-      })()
-    `);
-        return Array.isArray(data) ? data : [];
-    },
-});

package/clis/cnki/search.test.js

@@ -1,18 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import './search.js';
-describe('cnki search command', () => {
-    const command = getRegistry().get('cnki/search');
-    it('registers the command', () => {
-        expect(command).toBeDefined();
-        expect(command.site).toBe('cnki');
-        expect(command.name).toBe('search');
-    });
-    it('rejects empty queries before browser navigation', async () => {
-        const page = { goto: async () => undefined };
-        await expect(command.func(page, { query: '   ' })).rejects.toMatchObject({
-            name: 'ArgumentError',
-            code: 'ARGUMENT',
-        });
-    });
-});

package/clis/ctrip/auth.js

@@ -1,50 +0,0 @@
-import { AuthRequiredError, CommandExecutionError } from '@agentrhq/webcmd/errors';
-import { registerSiteAuthCommands } from '../_shared/site-auth.js';
-
-async function hasCtripLoginUid(page) {
-  const cookies = await page.getCookies({ url: 'https://www.ctrip.com' });
-  const loginUid = cookies.find(c => c.name === 'login_uid');
-  return Boolean(loginUid && loginUid.value);
-}
-
-async function verifyCtripIdentity(page) {
-  if (!await hasCtripLoginUid(page)) {
-    throw new AuthRequiredError('ctrip.com', 'Ctrip login_uid cookie missing — anonymous');
-  }
-  await page.goto('https://my.ctrip.com/myinfo/MyInfoIndex.aspx');
-  await page.wait(2);
-  const cookies = await page.getCookies({ url: 'https://www.ctrip.com' });
-  const cookieMap = Object.fromEntries(cookies.map(c => [c.name, c.value]));
-  const loginUid = cookieMap['login_uid'] || '';
-  if (!loginUid) {
-    throw new AuthRequiredError('ctrip.com', 'Ctrip login_uid cookie absent after navigation');
-  }
-  const aheadRaw = cookieMap['AHeadUserInfo'] || '';
-  const params = new URLSearchParams(aheadRaw);
-  const userNameRaw = params.get('UserName') || '';
-  let userName = '';
-  if (userNameRaw) {
-    try {
-      userName = decodeURIComponent(userNameRaw);
-    } catch {
-      userName = userNameRaw;
-    }
-  }
-  const vipGrade = params.get('VipGrade') || '';
-  return { user_id: loginUid, name: userName, vip_grade: vipGrade };
-}
-
-registerSiteAuthCommands({
-  site: 'ctrip',
-  domain: 'ctrip.com',
-  loginUrl: 'https://passport.ctrip.com/user/login',
-  columns: ['user_id', 'name', 'vip_grade'],
-  quickCheck: hasCtripLoginUid,
-  verify: verifyCtripIdentity,
-  poll: async (page) => {
-    if (!await hasCtripLoginUid(page)) {
-      throw new AuthRequiredError('ctrip.com', 'Waiting for Ctrip login_uid cookie');
-    }
-    return verifyCtripIdentity(page);
-  },
-});