@jackwener/opencli 1.0.6 → 1.1.1

package/dist/clis/boss/exchange.js

@@ -0,0 +1,111 @@
+/**
+ * BOSS直聘 exchange — request phone/wechat exchange with a candidate.
+ *
+ * Uses POST /wapi/zpchat/exchange/request to send an exchange request.
+ */
+import { cli, Strategy } from '../../registry.js';
+cli({
+    site: 'boss',
+    name: 'exchange',
+    description: 'BOSS直聘交换联系方式（请求手机/微信）',
+    domain: 'www.zhipin.com',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        { name: 'uid', required: true, help: 'Encrypted UID of the candidate' },
+        { name: 'type', default: 'phone', choices: ['phone', 'wechat'], help: 'Exchange type: phone or wechat' },
+    ],
+    columns: ['status', 'detail'],
+    func: async (page, kwargs) => {
+        if (!page)
+            throw new Error('Browser page required');
+        const uid = kwargs.uid;
+        const exchangeType = kwargs.type || 'phone';
+        if (process.env.OPENCLI_VERBOSE) {
+            console.error(`[opencli:boss] Requesting ${exchangeType} exchange for ${uid}...`);
+        }
+        await page.goto('https://www.zhipin.com/web/chat/index');
+        await page.wait({ time: 2 });
+        // Find candidate
+        let friend = null;
+        // Check greet list
+        const greetData = 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) => f.encryptUid === uid);
+        }
+        if (!friend) {
+            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) {
+                friend = (friendData.zpData?.friendList || []).find((f) => f.encryptUid === uid);
+            }
+        }
+        if (!friend) {
+            throw new Error('未找到该候选人');
+        }
+        const numericUid = friend.uid;
+        const friendName = friend.name || '候选人';
+        const securityId = friend.securityId || '';
+        // type mapping from JS source: 1=phone, 2=wechat, 4=resume
+        const typeId = exchangeType === 'wechat' ? 2 : 1;
+        // Params from JS: {type, securityId, uniqueId, name}
+        const params = new URLSearchParams({
+            type: String(typeId),
+            securityId: securityId,
+            uniqueId: String(numericUid),
+            name: friendName,
+        });
+        // POST with form-urlencoded (discovered from 336.js bundle)
+        const data = await page.evaluate(`
+      async () => {
+        return new Promise((resolve, reject) => {
+          const xhr = new XMLHttpRequest();
+          xhr.open('POST', 'https://www.zhipin.com/wapi/zpchat/exchange/request', 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})`);
+        }
+        const typeLabel = exchangeType === 'wechat' ? '微信' : '手机号';
+        return [{
+                status: '✅ 交换请求已发送',
+                detail: `已向 ${friendName} 发送${typeLabel}交换请求`,
+            }];
+    },
+});

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

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

package/dist/clis/boss/greet.js

@@ -0,0 +1,175 @@
+/**
+ * BOSS直聘 greet — send greeting to a new candidate (initiate chat).
+ *
+ * This is different from send.ts which messages existing contacts.
+ * For new candidates (from recommend list), we navigate to their chat page
+ * and use UI automation to send the greeting message.
+ *
+ * The greetRecSortList provides candidates who have applied or been recommended.
+ * We click on them in the list and send a greeting.
+ */
+import { cli, Strategy } from '../../registry.js';
+cli({
+    site: 'boss',
+    name: 'greet',
+    description: 'BOSS直聘向新候选人发送招呼（开始聊天）',
+    domain: 'www.zhipin.com',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        { name: 'uid', required: true, help: 'Encrypted UID of the candidate (from recommend)' },
+        { name: 'security-id', required: true, help: 'Security ID of the candidate' },
+        { name: 'job-id', required: true, help: 'Encrypted job ID' },
+        { name: 'text', default: '', help: 'Custom greeting message (uses default template if empty)' },
+    ],
+    columns: ['status', 'detail'],
+    func: async (page, kwargs) => {
+        if (!page)
+            throw new Error('Browser page required');
+        const uid = kwargs.uid;
+        const securityId = kwargs['security-id'];
+        const jobId = kwargs['job-id'];
+        const text = kwargs.text;
+        if (process.env.OPENCLI_VERBOSE) {
+            console.error(`[opencli:boss] Greeting candidate ${uid}...`);
+        }
+        // Navigate to chat page
+        await page.goto('https://www.zhipin.com/web/chat/index');
+        await page.wait({ time: 3 });
+        // Find the candidate in the greet list by encryptUid
+        const listData = 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 (listData.code !== 0) {
+            if (listData.code === 7 || listData.code === 37) {
+                throw new Error('Cookie 已过期！请在当前 Chrome 浏览器中重新登录 BOSS 直聘。');
+            }
+            throw new Error(`获取候选人列表失败: ${listData.message}`);
+        }
+        // Also check the regular friend list
+        let target = null;
+        const greetList = listData.zpData?.friendList || [];
+        target = greetList.find((f) => f.encryptUid === uid);
+        let numericUid = null;
+        let friendName = '候选人';
+        if (target) {
+            numericUid = target.uid;
+            friendName = target.name || friendName;
+        }
+        if (!numericUid) {
+            // Try to find in friend list
+            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) {
+                const allFriends = friendData.zpData?.friendList || [];
+                const found = allFriends.find((f) => f.encryptUid === uid);
+                if (found) {
+                    numericUid = found.uid;
+                    friendName = found.name || friendName;
+                }
+            }
+        }
+        if (!numericUid) {
+            throw new Error('未找到该候选人，请确认 uid 是否正确（可从 recommend 命令获取）');
+        }
+        // Click on the candidate in the 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, id: item.id };
+        }
+        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('无法在聊天列表中找到该用户，候选人可能不在当前列表中');
+        }
+        await page.wait({ time: 2 });
+        // Type the message
+        const msgText = 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(msgText)};
+              el.dispatchEvent(new Event('input', { bubbles: true }));
+            } else {
+              el.textContent = '';
+              el.focus();
+              document.execCommand('insertText', false, ${JSON.stringify(msgText)});
+              el.dispatchEvent(new Event('input', { bubbles: true }));
+            }
+            return { found: true, selector: sel };
+          }
+        }
+        return { found: false };
+      }
+    `);
+        if (!typed.found) {
+            throw new Error('找不到消息输入框');
+        }
+        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');
+        }
+        await page.wait({ time: 1 });
+        return [{ status: '✅ 招呼已发送', detail: `已向 ${friendName} 发送: ${msgText}` }];
+    },
+});

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

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

package/dist/clis/boss/invite.js

@@ -0,0 +1,158 @@
+/**
+ * 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';
+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, 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 = null;
+        // Check greet list first
+        const greetData = 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) => f.encryptUid === uid);
+        }
+        if (!friend) {
+            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) {
+                friend = (friendData.zpData?.friendList || []).find((f) => 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 = 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 = 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 = 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/dist/clis/boss/joblist.d.ts

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

package/dist/clis/boss/joblist.js

@@ -0,0 +1,55 @@
+/**
+ * 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';
+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, 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 = 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) => ({
+            job_name: j.jobName || '',
+            salary: j.salaryDesc || '',
+            city: j.address || '',
+            status: j.jobOnlineStatus === 1 ? '在线' : '已关闭',
+            encrypt_job_id: j.encryptJobId || '',
+        }));
+    },
+});

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

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

package/dist/clis/boss/mark.js

@@ -0,0 +1,141 @@
+/**
+ * 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';
+const LABEL_MAP = {
+    '新招呼': 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, 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;
+        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 = 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 = null;
+        let allFriends = friendData.zpData?.friendList || [];
+        friend = allFriends.find((f) => f.encryptUid === uid);
+        if (!friend) {
+            // Also check greetRecSortList
+            const greetData = 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) => 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 = 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/dist/clis/boss/recommend.d.ts

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