@jackwener/opencli 1.0.5 → 1.1.0

package/src/clis/boss/invite.ts

@@ -0,0 +1,177 @@
+/**
+ * BOSS直聘 invite — send interview invitation to a candidate.
+ *
+ * Uses POST /wapi/zpinterview/boss/interview/invite to send interview invitations.
+ * Address and contact info come from the boss's saved settings.
+ */
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+cli({
+  site: 'boss',
+  name: 'invite',
+  description: 'BOSS直聘发送面试邀请',
+  domain: 'www.zhipin.com',
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [
+    { name: 'uid', required: true, help: 'Encrypted UID of the candidate' },
+    { name: 'time', required: true, help: 'Interview time (e.g. 2025-04-01 14:00)' },
+    { name: 'address', default: '', help: 'Interview address (uses saved address if empty)' },
+    { name: 'contact', default: '', help: 'Contact person name (uses saved contact if empty)' },
+  ],
+  columns: ['status', 'detail'],
+  func: async (page: IPage | null, kwargs) => {
+    if (!page) throw new Error('Browser page required');
+
+    const uid = kwargs.uid;
+    const timeStr = kwargs.time;
+    const address = kwargs.address;
+    const contact = kwargs.contact;
+
+    if (process.env.OPENCLI_VERBOSE) {
+      console.error(`[opencli:boss] Sending interview invitation to ${uid}...`);
+    }
+
+    await page.goto('https://www.zhipin.com/web/chat/index');
+    await page.wait({ time: 2 });
+
+    // Get candidate info
+    let friend: any = null;
+
+    // Check greet list first
+    const greetData: any = await page.evaluate(`
+      async () => {
+        return new Promise((resolve, reject) => {
+          const xhr = new XMLHttpRequest();
+          xhr.open('GET', 'https://www.zhipin.com/wapi/zprelation/friend/greetRecSortList', true);
+          xhr.withCredentials = true;
+          xhr.timeout = 15000;
+          xhr.setRequestHeader('Accept', 'application/json');
+          xhr.onload = () => { try { resolve(JSON.parse(xhr.responseText)); } catch(e) { reject(e); } };
+          xhr.onerror = () => reject(new Error('Network Error'));
+          xhr.send();
+        });
+      }
+    `);
+
+    if (greetData.code === 0) {
+      friend = (greetData.zpData?.friendList || []).find((f: any) => f.encryptUid === uid);
+    }
+
+    if (!friend) {
+      const friendData: any = 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) {
+        friend = (friendData.zpData?.friendList || []).find((f: any) => f.encryptUid === uid);
+      }
+    }
+
+    if (!friend) {
+      throw new Error('未找到该候选人');
+    }
+
+    const numericUid = friend.uid;
+    const friendName = friend.name || '候选人';
+    const securityId = friend.securityId || '';
+    const encJobId = friend.encryptJobId || '';
+
+    // Get saved contact info
+    const contactData: any = await page.evaluate(`
+      async () => {
+        return new Promise((resolve, reject) => {
+          const xhr = new XMLHttpRequest();
+          xhr.open('GET', 'https://www.zhipin.com/wapi/zpinterview/boss/interview/contactInit', true);
+          xhr.withCredentials = true;
+          xhr.timeout = 10000;
+          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();
+        });
+      }
+    `);
+
+    const contactId = contactData.zpData?.contactId || '';
+    const contactName = contact || contactData.zpData?.contactName || '';
+    const contactPhone = contactData.zpData?.contactPhone || '';
+
+    // Get saved address
+    const addressData: any = await page.evaluate(`
+      async () => {
+        return new Promise((resolve, reject) => {
+          const xhr = new XMLHttpRequest();
+          xhr.open('GET', 'https://www.zhipin.com/wapi/zpinterview/boss/interview/listAddress', true);
+          xhr.withCredentials = true;
+          xhr.timeout = 10000;
+          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();
+        });
+      }
+    `);
+
+    const savedAddress = addressData.zpData?.list?.[0] || {};
+    const addressText = address || savedAddress.cityAddressText || savedAddress.addressText || '';
+
+    // Parse interview time
+    const interviewTime = new Date(timeStr).getTime();
+    if (isNaN(interviewTime)) {
+      throw new Error(`时间格式错误: ${timeStr}，请使用格式如 2025-04-01 14:00`);
+    }
+
+    // Send interview invitation
+    const params = new URLSearchParams({
+      uid: String(numericUid),
+      securityId: securityId,
+      encryptJobId: encJobId,
+      interviewTime: String(interviewTime),
+      contactId: contactId,
+      contactName: contactName,
+      contactPhone: contactPhone,
+      address: addressText,
+      interviewType: '1',  // 1 = onsite
+    });
+
+    const data: any = await page.evaluate(`
+      async () => {
+        return new Promise((resolve, reject) => {
+          const xhr = new XMLHttpRequest();
+          xhr.open('POST', 'https://www.zhipin.com/wapi/zpinterview/boss/interview/invite.json', true);
+          xhr.withCredentials = true;
+          xhr.timeout = 15000;
+          xhr.setRequestHeader('Accept', 'application/json');
+          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.onerror = () => reject(new Error('Network Error'));
+          xhr.send(${JSON.stringify(params.toString())});
+        });
+      }
+    `);
+
+    if (data.code !== 0) {
+      if (data.code === 7 || data.code === 37) {
+        throw new Error('Cookie 已过期！请在当前 Chrome 浏览器中重新登录 BOSS 直聘。');
+      }
+      throw new Error(`面试邀请发送失败: ${data.message} (code=${data.code})`);
+    }
+
+    return [{
+      status: '✅ 面试邀请已发送',
+      detail: `已向 ${friendName} 发送面试邀请\n时间: ${timeStr}\n地点: ${addressText}\n联系人: ${contactName}`,
+    }];
+  },
+});

package/src/clis/boss/joblist.ts

@@ -0,0 +1,63 @@
+/**
+ * BOSS直聘 job list — list my published jobs via boss API.
+ *
+ * Uses /wapi/zpjob/job/chatted/jobList to get job list with status info.
+ */
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+cli({
+  site: 'boss',
+  name: 'joblist',
+  description: 'BOSS直聘查看我发布的职位列表',
+  domain: 'www.zhipin.com',
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [],
+  columns: ['job_name', 'salary', 'city', 'status', 'encrypt_job_id'],
+  func: async (page: IPage | null, kwargs) => {
+    if (!page) throw new Error('Browser page required');
+
+    if (process.env.OPENCLI_VERBOSE) {
+      console.error('[opencli:boss] Fetching job list...');
+    }
+
+    await page.goto('https://www.zhipin.com/web/chat/index');
+    await page.wait({ time: 2 });
+
+    const targetUrl = 'https://www.zhipin.com/wapi/zpjob/job/chatted/jobList';
+
+    const data: any = 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.ontimeout = () => reject(new Error('Timeout'));
+          xhr.send();
+        });
+      }
+    `);
+
+    if (data.code !== 0) {
+      if (data.code === 7 || data.code === 37) {
+        throw new Error('Cookie 已过期！请在当前 Chrome 浏览器中重新登录 BOSS 直聘。');
+      }
+      throw new Error(`API error: ${data.message} (code=${data.code})`);
+    }
+
+    const jobs = data.zpData || [];
+
+    return jobs.map((j: any) => ({
+      job_name: j.jobName || '',
+      salary: j.salaryDesc || '',
+      city: j.address || '',
+      status: j.jobOnlineStatus === 1 ? '在线' : '已关闭',
+      encrypt_job_id: j.encryptJobId || '',
+    }));
+  },
+});

package/src/clis/boss/mark.ts

@@ -0,0 +1,155 @@
+/**
+ * BOSS直聘 mark — label/mark a candidate.
+ *
+ * Uses /wapi/zprelation/friend/label/addMark to add a label to a candidate,
+ * and /wapi/zprelation/friend/label/deleteMark to remove one.
+ *
+ * Available labels (from /wapi/zprelation/friend/label/get):
+ *   1=新招呼, 2=沟通中, 3=已约面, 4=已获取简历, 5=已交换电话,
+ *   6=已交换微信, 7=不合适, 8=牛人发起, 11=收藏
+ */
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+const LABEL_MAP: Record<string, number> = {
+  '新招呼': 1, '沟通中': 2, '已约面': 3, '已获取简历': 4,
+  '已交换电话': 5, '已交换微信': 6, '不合适': 7, '牛人发起': 8, '收藏': 11,
+};
+
+cli({
+  site: 'boss',
+  name: 'mark',
+  description: 'BOSS直聘给候选人添加标签',
+  domain: 'www.zhipin.com',
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [
+    { name: 'uid', required: true, help: 'Encrypted UID of the candidate' },
+    { name: 'label', required: true, help: 'Label name (新招呼/沟通中/已约面/已获取简历/已交换电话/已交换微信/不合适/收藏) or label ID' },
+    { name: 'remove', type: 'boolean', default: false, help: 'Remove the label instead of adding' },
+  ],
+  columns: ['status', 'detail'],
+  func: async (page: IPage | null, kwargs) => {
+    if (!page) throw new Error('Browser page required');
+
+    const uid = kwargs.uid;
+    const labelInput = kwargs.label;
+    const remove = kwargs.remove || false;
+
+    // Resolve label to ID
+    let labelId: number;
+    if (LABEL_MAP[labelInput]) {
+      labelId = LABEL_MAP[labelInput];
+    } else if (!isNaN(Number(labelInput))) {
+      labelId = Number(labelInput);
+    } else {
+      // Try partial match
+      const entry = Object.entries(LABEL_MAP).find(([k]) => k.includes(labelInput));
+      if (entry) {
+        labelId = entry[1];
+      } else {
+        throw new Error(`未知标签: ${labelInput}。可用标签: ${Object.keys(LABEL_MAP).join(', ')}`);
+      }
+    }
+
+    if (process.env.OPENCLI_VERBOSE) {
+      console.error(`[opencli:boss] ${remove ? 'Removing' : 'Adding'} label ${labelId} for ${uid}...`);
+    }
+
+    await page.goto('https://www.zhipin.com/web/chat/index');
+    await page.wait({ time: 2 });
+
+    // First get numeric UID from friend list
+    const friendData: any = 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}`);
+    }
+
+    // Find in friend list (check multiple pages)
+    let friend: any = null;
+    let allFriends = friendData.zpData?.friendList || [];
+    friend = allFriends.find((f: any) => f.encryptUid === uid);
+
+    if (!friend) {
+      // Also check greetRecSortList
+      const greetData: any = await page.evaluate(`
+        async () => {
+          return new Promise((resolve, reject) => {
+            const xhr = new XMLHttpRequest();
+            xhr.open('GET', 'https://www.zhipin.com/wapi/zprelation/friend/greetRecSortList', true);
+            xhr.withCredentials = true;
+            xhr.timeout = 15000;
+            xhr.setRequestHeader('Accept', 'application/json');
+            xhr.onload = () => { try { resolve(JSON.parse(xhr.responseText)); } catch(e) { reject(e); } };
+            xhr.onerror = () => reject(new Error('Network Error'));
+            xhr.send();
+          });
+        }
+      `);
+      if (greetData.code === 0) {
+        friend = (greetData.zpData?.friendList || []).find((f: any) => f.encryptUid === uid);
+      }
+    }
+
+    if (!friend) {
+      throw new Error('未找到该候选人');
+    }
+
+    const numericUid = friend.uid;
+    const friendName = friend.name || '候选人';
+    const friendSource = friend.friendSource ?? 0;
+
+    const action = remove ? 'deleteMark' : 'addMark';
+    const targetUrl = `https://www.zhipin.com/wapi/zprelation/friend/label/${action}`;
+
+    // The API uses friendId + friendSource + labelId (discovered from JS bundles)
+    const params = new URLSearchParams({
+      friendId: String(numericUid),
+      friendSource: String(friendSource),
+      labelId: String(labelId),
+    });
+
+    // Try GET first (the N() wrapper in boss JS uses GET with query params)
+    const data: any = await page.evaluate(`
+      async () => {
+        return new Promise((resolve, reject) => {
+          const xhr = new XMLHttpRequest();
+          xhr.open('GET', '${targetUrl}?${params.toString()}', 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(`标签操作失败: ${data.message} (code=${data.code})`);
+    }
+
+    const labelName = Object.entries(LABEL_MAP).find(([, v]) => v === labelId)?.[0] || String(labelId);
+    return [{
+      status: remove ? '✅ 标签已移除' : '✅ 标签已添加',
+      detail: `${friendName}: ${remove ? '移除' : '添加'}标签「${labelName}」`,
+    }];
+  },
+});

package/src/clis/boss/recommend.ts

@@ -0,0 +1,94 @@
+/**
+ * BOSS直聘 recommend — view recommended candidates (新招呼/greet sort list).
+ *
+ * Uses /wapi/zprelation/friend/greetRecSortList to get system-recommended candidates.
+ * These are candidates who have greeted or been recommended by the system.
+ */
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+cli({
+  site: 'boss',
+  name: 'recommend',
+  description: 'BOSS直聘查看推荐候选人（新招呼列表）',
+  domain: 'www.zhipin.com',
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [
+    { name: 'limit', type: 'int', default: 20, help: 'Number of results to return' },
+  ],
+  columns: ['name', 'job_name', 'last_time', 'labels', 'encrypt_uid', 'security_id', 'encrypt_job_id'],
+  func: async (page: IPage | null, kwargs) => {
+    if (!page) throw new Error('Browser page required');
+
+    const limit = kwargs.limit || 20;
+
+    if (process.env.OPENCLI_VERBOSE) {
+      console.error('[opencli:boss] Fetching recommended candidates...');
+    }
+
+    await page.goto('https://www.zhipin.com/web/chat/index');
+    await page.wait({ time: 2 });
+
+    // Get label definitions for mapping
+    const labelData: any = await page.evaluate(`
+      async () => {
+        return new Promise((resolve, reject) => {
+          const xhr = new XMLHttpRequest();
+          xhr.open('GET', 'https://www.zhipin.com/wapi/zprelation/friend/label/get', true);
+          xhr.withCredentials = true;
+          xhr.timeout = 10000;
+          xhr.setRequestHeader('Accept', 'application/json');
+          xhr.onload = () => { try { resolve(JSON.parse(xhr.responseText)); } catch(e) { resolve({}); } };
+          xhr.onerror = () => resolve({});
+          xhr.send();
+        });
+      }
+    `);
+
+    const labelMap: Record<number, string> = {};
+    if (labelData.code === 0 && labelData.zpData?.labels) {
+      for (const l of labelData.zpData.labels) {
+        labelMap[l.labelId] = l.label;
+      }
+    }
+
+    // Get recommended candidates
+    const targetUrl = 'https://www.zhipin.com/wapi/zprelation/friend/greetRecSortList';
+
+    const data: any = 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.ontimeout = () => reject(new Error('Timeout'));
+          xhr.send();
+        });
+      }
+    `);
+
+    if (data.code !== 0) {
+      if (data.code === 7 || data.code === 37) {
+        throw new Error('Cookie 已过期！请在当前 Chrome 浏览器中重新登录 BOSS 直聘。');
+      }
+      throw new Error(`API error: ${data.message} (code=${data.code})`);
+    }
+
+    const friends = (data.zpData?.friendList || []).slice(0, limit);
+
+    return friends.map((f: any) => ({
+      name: f.name || '',
+      job_name: f.jobName || '',
+      last_time: f.lastTime || '',
+      labels: (f.relationLabelList || []).map((id: number) => labelMap[id] || String(id)).join(', '),
+      encrypt_uid: f.encryptUid || '',
+      security_id: f.securityId || '',
+      encrypt_job_id: f.encryptJobId || '',
+    }));
+  },
+});

package/src/clis/boss/stats.ts

@@ -0,0 +1,130 @@
+/**
+ * BOSS直聘 stats — job statistics overview.
+ *
+ * Uses /wapi/zpchat/chatHelper/statistics for total friend count,
+ * and /wapi/zpjob/job/chatted/jobList for per-job info.
+ * Since BOSS doesn't expose detailed per-job stats via API,
+ * we show what's available: job status, chat info, and total stats.
+ */
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+cli({
+  site: 'boss',
+  name: 'stats',
+  description: 'BOSS直聘职位数据统计',
+  domain: 'www.zhipin.com',
+  strategy: Strategy.COOKIE,
+  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: IPage | null, kwargs) => {
+    if (!page) throw new Error('Browser page required');
+
+    const filterJobId = kwargs.job_id || '';
+
+    if (process.env.OPENCLI_VERBOSE) {
+      console.error('[opencli:boss] Fetching job statistics...');
+    }
+
+    await page.goto('https://www.zhipin.com/web/chat/index');
+    await page.wait({ time: 2 });
+
+    // Get job list
+    const jobData: any = await page.evaluate(`
+      async () => {
+        return new Promise((resolve, reject) => {
+          const xhr = new XMLHttpRequest();
+          xhr.open('GET', 'https://www.zhipin.com/wapi/zpjob/job/chatted/jobList', 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.ontimeout = () => reject(new Error('Timeout'));
+          xhr.send();
+        });
+      }
+    `);
+
+    if (jobData.code !== 0) {
+      if (jobData.code === 7 || jobData.code === 37) {
+        throw new Error('Cookie 已过期！请在当前 Chrome 浏览器中重新登录 BOSS 直聘。');
+      }
+      throw new Error(`API error: ${jobData.message} (code=${jobData.code})`);
+    }
+
+    // Get total chat stats
+    const chatStats: any = await page.evaluate(`
+      async () => {
+        return new Promise((resolve, reject) => {
+          const xhr = new XMLHttpRequest();
+          xhr.open('GET', 'https://www.zhipin.com/wapi/zpchat/chatHelper/statistics', true);
+          xhr.withCredentials = true;
+          xhr.timeout = 10000;
+          xhr.setRequestHeader('Accept', 'application/json');
+          xhr.onload = () => { try { resolve(JSON.parse(xhr.responseText)); } catch(e) { resolve({}); } };
+          xhr.onerror = () => resolve({});
+          xhr.send();
+        });
+      }
+    `);
+
+    const totalFriends = chatStats.zpData?.totalFriendCount || 0;
+
+    // Get per-job chat counts from friend list
+    const friendData: any = 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) { resolve({}); } };
+          xhr.onerror = () => resolve({});
+          xhr.send();
+        });
+      }
+    `);
+
+    // Count chats per job
+    const jobChatCounts: Record<string, number> = {};
+    if (friendData.code === 0) {
+      for (const f of (friendData.zpData?.friendList || [])) {
+        const jobName = f.jobName || 'unknown';
+        jobChatCounts[jobName] = (jobChatCounts[jobName] || 0) + 1;
+      }
+    }
+
+    let jobs = jobData.zpData || [];
+    if (filterJobId) {
+      jobs = jobs.filter((j: any) => j.encryptJobId === filterJobId);
+    }
+
+    const results = jobs.map((j: any) => ({
+      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 || '',
+    }));
+
+    // Add summary row
+    if (!filterJobId && results.length > 0) {
+      results.push({
+        job_name: '--- 总计 ---',
+        salary: '',
+        city: '',
+        status: `${jobs.length} 个职位`,
+        total_chats: String(totalFriends),
+        encrypt_job_id: '',
+      });
+    }
+
+    return results;
+  },
+});

package/src/clis/chaoxing/README.md

@@ -2,35 +2,13 @@
 
 View your Chaoxing assignments and exams from the terminal by reusing your Chrome login session.
 
-## Prerequisites
-
-1. Chrome must be running and already logged into Chaoxing (`i.chaoxing.com`).
-2. The opencli Browser Bridge extension must be installed.
+📖 **Full documentation**: See commands and usage below.
 
 ## Commands
 
 | Command | Description |
 |---------|-------------|
 | `opencli chaoxing assignments` | List assignments across all courses |
-| `opencli chaoxing assignments --course "数学"` | Filter by course name (fuzzy match) |
-| `opencli chaoxing assignments --status pending` | Filter: `all` / `pending` / `submitted` / `graded` |
 | `opencli chaoxing exams` | List exams across all courses |
-| `opencli chaoxing exams --course "数学"` | Filter by course name |
-| `opencli chaoxing exams --status upcoming` | Filter: `all` / `upcoming` / `ongoing` / `finished` |
-
-## How It Works
-
-Chaoxing has no flat API for listing assignments/exams. The adapter follows the same
-flow a student would in the browser:
-
-1. Establish session via the interaction page
-2. Fetch enrolled course list (`backclazzdata` JSON API)
-3. Enter each course via `stucoursemiddle` redirect (obtains session `enc`)
-4. Click the 作业/考试 tab and capture the iframe URL
-5. Navigate to that URL and parse the DOM
-
-## Limitations
 
-- Requires `--course` filter for practical use (scanning all 40+ courses is slow)
-- Does not submit homework or exams
-- If Chaoxing changes page structure, the DOM parser may need updates
+Supports `--course` and `--status` filters. Requires Chrome logged into `i.chaoxing.com` with Browser Bridge extension installed.