@jackwener/opencli 1.7.7 → 1.7.9

package/clis/36kr/news.js

@@ -12,7 +12,7 @@ cli({
         { name: 'limit', type: 'int', default: 20, help: 'Number of articles (max 50)' },
     ],
     columns: ['rank', 'title', 'summary', 'date', 'url'],
-    func: async (_page, kwargs) => {
+    func: async (kwargs) => {
         const count = Math.min(kwargs.limit || 20, 50);
         const resp = await fetch('https://www.36kr.com/feed', {
             headers: { 'User-Agent': 'Mozilla/5.0 (compatible; opencli/1.0)' },

package/clis/amazon/discussion.js

@@ -1,6 +1,6 @@
-import { CommandExecutionError } from '@jackwener/opencli/errors';
+import { AuthRequiredError, CommandExecutionError } from '@jackwener/opencli/errors';
 import { cli, Strategy } from '@jackwener/opencli/registry';
-import { buildDiscussionUrl, buildProvenance, cleanText, extractAsin, normalizeProductUrl, parseRatingValue, parseReviewCount, trimRatingPrefix, uniqueNonEmpty, assertUsableState, gotoAndReadState, } from './shared.js';
+import { buildProductUrl, buildDiscussionUrl, buildProvenance, cleanText, extractAsin, normalizeProductUrl, parseRatingValue, parseReviewCount, trimRatingPrefix, uniqueNonEmpty, assertUsableState, gotoAndReadState, } from './shared.js';
 function normalizeDiscussionPayload(payload) {
     const sourceUrl = cleanText(payload.href) || buildDiscussionUrl(payload.href ?? '');
     const asin = extractAsin(payload.href ?? '') ?? null;
@@ -28,10 +28,16 @@ function normalizeDiscussionPayload(payload) {
         })),
     };
 }
-async function readDiscussionPayload(page, input, limit) {
-    const url = buildDiscussionUrl(input);
-    const state = await gotoAndReadState(page, url, 2500, 'discussion');
-    assertUsableState(state, 'discussion');
+function hasDiscussionSummary(payload) {
+    return Boolean(cleanText(payload.average_rating_text) || cleanText(payload.total_review_count_text));
+}
+function isSignInState(state) {
+    const href = cleanText(state.href).toLowerCase();
+    const title = cleanText(state.title).toLowerCase();
+    return href.includes('/ap/signin')
+        || title.includes('amazon sign-in');
+}
+async function readCurrentDiscussionPayload(page, limit) {
     return await page.evaluate(`
     (() => ({
       href: window.location.href,
@@ -53,6 +59,29 @@ async function readDiscussionPayload(page, input, limit) {
     }))()
   `);
 }
+async function readDiscussionPayload(page, input, limit) {
+    const reviewUrl = buildDiscussionUrl(input);
+    const reviewState = await gotoAndReadState(page, reviewUrl, 2500, 'discussion');
+    assertUsableState(reviewState, 'discussion');
+    const reviewPayload = await readCurrentDiscussionPayload(page, limit);
+    if (hasDiscussionSummary(reviewPayload)) {
+        return reviewPayload;
+    }
+    const productUrl = buildProductUrl(input);
+    const productState = await gotoAndReadState(page, productUrl, 2500, 'discussion');
+    assertUsableState(productState, 'discussion');
+    if (isSignInState(reviewState) && isSignInState(productState)) {
+        throw new AuthRequiredError('amazon.com', 'Amazon review discussion requires an active signed-in Amazon session in the shared Chrome profile.');
+    }
+    const productPayload = await readCurrentDiscussionPayload(page, limit);
+    if (hasDiscussionSummary(productPayload)) {
+        return productPayload;
+    }
+    if (isSignInState(reviewState)) {
+        throw new CommandExecutionError('amazon review page redirected to sign-in and product page fallback did not expose review summary', 'Open the product page in Chrome, verify reviews are visible, and retry.');
+    }
+    return reviewPayload;
+}
 cli({
     site: 'amazon',
     name: 'discussion',
@@ -88,4 +117,6 @@ cli({
 });
 export const __test__ = {
     normalizeDiscussionPayload,
+    hasDiscussionSummary,
+    isSignInState,
 };

package/clis/amazon/discussion.test.js

@@ -1,36 +1,151 @@
-import { describe, expect, it } from 'vitest';
+import { describe, expect, it, vi } from 'vitest';
+import { AuthRequiredError } from '@jackwener/opencli/errors';
+import { getRegistry } from '@jackwener/opencli/registry';
 import { __test__ } from './discussion.js';
+import './discussion.js';
+
+function createPageMock(evaluateResults) {
+  const evaluate = vi.fn();
+  for (const result of evaluateResults) {
+    evaluate.mockResolvedValueOnce(result);
+  }
+  return {
+    goto: vi.fn().mockResolvedValue(undefined),
+    wait: vi.fn().mockResolvedValue(undefined),
+    evaluate,
+    snapshot: vi.fn().mockResolvedValue(undefined),
+    click: vi.fn().mockResolvedValue(undefined),
+    typeText: vi.fn().mockResolvedValue(undefined),
+    pressKey: vi.fn().mockResolvedValue(undefined),
+    scrollTo: vi.fn().mockResolvedValue(undefined),
+    getFormState: vi.fn().mockResolvedValue({ forms: [], orphanFields: [] }),
+    tabs: vi.fn().mockResolvedValue([]),
+    selectTab: vi.fn().mockResolvedValue(undefined),
+    networkRequests: vi.fn().mockResolvedValue([]),
+    consoleMessages: vi.fn().mockResolvedValue([]),
+    scroll: vi.fn().mockResolvedValue(undefined),
+    autoScroll: vi.fn().mockResolvedValue(undefined),
+    installInterceptor: vi.fn().mockResolvedValue(undefined),
+    getInterceptedRequests: vi.fn().mockResolvedValue([]),
+    getCookies: vi.fn().mockResolvedValue([]),
+    screenshot: vi.fn().mockResolvedValue(''),
+    waitForCapture: vi.fn().mockResolvedValue(undefined),
+  };
+}
+
 describe('amazon discussion normalization', () => {
-    it('normalizes review summary and sample reviews', () => {
-        const result = __test__.normalizeDiscussionPayload({
-            href: 'https://www.amazon.com/product-reviews/B0FJS72893',
-            average_rating_text: '3.9 out of 5',
-            total_review_count_text: '27 global ratings',
-            qa_links: [],
-            review_samples: [
-                {
-                    title: '5.0 out of 5 stars Great value and quality',
-                    rating_text: '5.0 out of 5 stars',
-                    author: 'GTreader2',
-                    date_text: 'Reviewed in the United States on February 21, 2026',
-                    body: 'Small but mighty.',
-                    verified: true,
-                },
-            ],
-        });
-        expect(result.asin).toBe('B0FJS72893');
-        expect(result.average_rating_value).toBe(3.9);
-        expect(result.total_review_count).toBe(27);
-        expect(result.review_samples).toEqual([
-            {
-                title: 'Great value and quality',
-                rating_text: '5.0 out of 5 stars',
-                rating_value: 5,
-                author: 'GTreader2',
-                date_text: 'Reviewed in the United States on February 21, 2026',
-                body: 'Small but mighty.',
-                verified_purchase: true,
-            },
-        ]);
+  it('normalizes review summary and sample reviews', () => {
+    const result = __test__.normalizeDiscussionPayload({
+      href: 'https://www.amazon.com/product-reviews/B0FJS72893',
+      average_rating_text: '3.9 out of 5',
+      total_review_count_text: '27 global ratings',
+      qa_links: [],
+      review_samples: [
+        {
+          title: '5.0 out of 5 stars Great value and quality',
+          rating_text: '5.0 out of 5 stars',
+          author: 'GTreader2',
+          date_text: 'Reviewed in the United States on February 21, 2026',
+          body: 'Small but mighty.',
+          verified: true,
+        },
+      ],
     });
+
+    expect(result.asin).toBe('B0FJS72893');
+    expect(result.average_rating_value).toBe(3.9);
+    expect(result.total_review_count).toBe(27);
+    expect(result.review_samples).toEqual([
+      {
+        title: 'Great value and quality',
+        rating_text: '5.0 out of 5 stars',
+        rating_value: 5,
+        author: 'GTreader2',
+        date_text: 'Reviewed in the United States on February 21, 2026',
+        body: 'Small but mighty.',
+        verified_purchase: true,
+      },
+    ]);
+  });
+
+  it('falls back to the product page when the review page redirects to sign-in', async () => {
+    const command = getRegistry().get('amazon/discussion');
+    const page = createPageMock([
+      {
+        href: 'https://www.amazon.com/ap/signin?openid.return_to=https%3A%2F%2Fwww.amazon.com%2Fproduct-reviews%2FB09HKN2ZRT',
+        title: 'Amazon Sign-In',
+        body_text: 'Sign in Create account',
+      },
+      {
+        href: 'https://www.amazon.com/ap/signin?openid.return_to=https%3A%2F%2Fwww.amazon.com%2Fproduct-reviews%2FB09HKN2ZRT',
+        average_rating_text: '',
+        total_review_count_text: '',
+        review_samples: [],
+      },
+      {
+        href: 'https://www.amazon.com/dp/B09HKN2ZRT',
+        title: 'Amazon.com: Example product',
+        body_text: 'Hello, zejia-wu Reviews',
+      },
+      {
+        href: 'https://www.amazon.com/dp/B09HKN2ZRT',
+        average_rating_text: '4.4 out of 5',
+        total_review_count_text: '349 global ratings',
+        review_samples: [
+          {
+            title: '5.0 out of 5 stars Perfect for the office',
+            rating_text: '5.0 out of 5 stars',
+            author: 'Ken',
+            date_text: 'Reviewed in the United States on March 19, 2026',
+            body: 'Good for the office, no complaints.',
+            verified: true,
+          },
+        ],
+      },
+    ]);
+
+    const result = await command.func(page, { input: 'B09HKN2ZRT', limit: 1 });
+
+    expect(page.goto.mock.calls.map((call) => call[0])).toEqual([
+      'https://www.amazon.com/product-reviews/B09HKN2ZRT',
+      'https://www.amazon.com/dp/B09HKN2ZRT',
+    ]);
+    expect(result).toEqual([
+      expect.objectContaining({
+        asin: 'B09HKN2ZRT',
+        discussion_url: 'https://www.amazon.com/dp/B09HKN2ZRT',
+        average_rating_value: 4.4,
+        total_review_count: 349,
+      }),
+    ]);
+  });
+
+  it('throws AuthRequiredError when both review and product pages are gated', async () => {
+    const command = getRegistry().get('amazon/discussion');
+    const authState = {
+      href: 'https://www.amazon.com/ap/signin?openid.return_to=https%3A%2F%2Fwww.amazon.com%2Fproduct-reviews%2FB09HKN2ZRT',
+      title: 'Amazon Sign-In',
+      body_text: 'Sign in Create account',
+    };
+    const page = createPageMock([
+      authState,
+      {
+        href: authState.href,
+        average_rating_text: '',
+        total_review_count_text: '',
+        review_samples: [],
+      },
+      authState,
+    ]);
+
+    await expect(command.func(page, { input: 'B09HKN2ZRT', limit: 1 })).rejects.toBeInstanceOf(AuthRequiredError);
+  });
+
+  it('does not treat a public product page with sign-in copy as a gated page', () => {
+    expect(__test__.isSignInState({
+      href: 'https://www.amazon.com/dp/B09HKN2ZRT',
+      title: 'Amazon.com: Example product',
+      body_text: 'Hello, sign in Account & Lists Create account',
+    })).toBe(false);
+  });
 });

package/clis/apple-podcasts/commands.test.js

@@ -24,7 +24,7 @@ describe('apple-podcasts search command', () => {
             }),
         });
         vi.stubGlobal('fetch', fetchMock);
-        const result = await cmd.func(null, {
+        const result = await cmd.func({
             query: 'machine learning',
             keyword: 'sports',
             limit: 5,
@@ -60,7 +60,7 @@ describe('apple-podcasts top command', () => {
             }),
         });
         vi.stubGlobal('fetch', fetchMock);
-        await cmd.func(null, { country: 'US', limit: 1 });
+        await cmd.func({ country: 'US', limit: 1 });
         const [, options] = fetchMock.mock.calls[0] ?? [];
         expect(options).toBeDefined();
         expect(options.signal).toBeDefined();
@@ -81,7 +81,7 @@ describe('apple-podcasts top command', () => {
             }),
         });
         vi.stubGlobal('fetch', fetchMock);
-        const result = await cmd.func(null, { country: 'US', limit: 2 });
+        const result = await cmd.func({ country: 'US', limit: 2 });
         expect(fetchMock).toHaveBeenCalledWith('https://rss.marketingtools.apple.com/api/v2/us/podcasts/top/2/podcasts.json', expect.objectContaining({
             signal: expect.any(Object),
         }));
@@ -94,6 +94,6 @@ describe('apple-podcasts top command', () => {
         const cmd = getRegistry().get('apple-podcasts/top');
         expect(cmd?.func).toBeTypeOf('function');
         vi.stubGlobal('fetch', vi.fn().mockRejectedValue(new Error('socket hang up')));
-        await expect(cmd.func(null, { country: 'us', limit: 3 })).rejects.toThrow('Unable to reach Apple Podcasts charts for US');
+        await expect(cmd.func({ country: 'us', limit: 3 })).rejects.toThrow('Unable to reach Apple Podcasts charts for US');
     });
 });

package/clis/apple-podcasts/episodes.js

@@ -12,7 +12,7 @@ cli({
         { name: 'limit', type: 'int', default: 15, help: 'Max episodes to show' },
     ],
     columns: ['title', 'duration', 'date'],
-    func: async (_page, args) => {
+    func: async (args) => {
         const limit = Math.max(1, Math.min(Number(args.limit), 200));
         // results[0] is the podcast itself; the rest are episodes
         const data = await itunesFetch(`/lookup?id=${args.id}&entity=podcastEpisode&limit=${limit + 1}`);

package/clis/apple-podcasts/search.js

@@ -12,7 +12,7 @@ cli({
         { name: 'limit', type: 'int', default: 10, help: 'Max results' },
     ],
     columns: ['id', 'title', 'author', 'episodes', 'genre', 'url'],
-    func: async (_page, args) => {
+    func: async (args) => {
         const term = encodeURIComponent(args.query);
         const limit = Math.max(1, Math.min(Number(args.limit), 25));
         const data = await itunesFetch(`/search?term=${term}&media=podcast&limit=${limit}`);

package/clis/apple-podcasts/top.js

@@ -14,7 +14,7 @@ cli({
         { name: 'country', default: 'us', help: 'Country code (e.g. us, cn, gb, jp)' },
     ],
     columns: ['rank', 'title', 'author', 'id'],
-    func: async (_page, args) => {
+    func: async (args) => {
         const limit = Math.max(1, Math.min(Number(args.limit), 100));
         const country = String(args.country || 'us').trim().toLowerCase();
         const url = `${CHARTS_URL}/${country}/podcasts/top/${limit}/podcasts.json`;

package/clis/arxiv/paper.js

@@ -11,7 +11,7 @@ cli({
         { name: 'id', positional: true, required: true, help: 'arXiv paper ID (e.g. 1706.03762)' },
     ],
     columns: ['id', 'title', 'authors', 'published', 'abstract', 'url'],
-    func: async (_page, args) => {
+    func: async (args) => {
         const xml = await arxivFetch(`id_list=${encodeURIComponent(args.id)}`);
         const entries = parseEntries(xml);
         if (!entries.length)

package/clis/arxiv/search.js

@@ -12,7 +12,7 @@ cli({
         { name: 'limit', type: 'int', default: 10, help: 'Max results (max 25)' },
     ],
     columns: ['id', 'title', 'authors', 'published', 'url'],
-    func: async (_page, args) => {
+    func: async (args) => {
         const limit = Math.max(1, Math.min(Number(args.limit), 25));
         const query = encodeURIComponent(`all:${args.query}`);
         const xml = await arxivFetch(`search_query=${query}&max_results=${limit}&sortBy=relevance`);

package/clis/band/mentions.js

@@ -1,4 +1,4 @@
-import { AuthRequiredError, EmptyResultError, SelectorError } from '@jackwener/opencli/errors';
+import { AuthRequiredError, EmptyResultError, selectorError } from '@jackwener/opencli/errors';
 import { cli, Strategy } from '@jackwener/opencli/registry';
 /**
  * band mentions — Show Band notifications where you were @mentioned.
@@ -52,7 +52,7 @@ cli({
             await page.wait(0.5);
         }
         if (!bellReady) {
-            throw new SelectorError('button._btnWidgetIcon', 'Notification bell not found. The Band.us UI may have changed.');
+            throw selectorError('button._btnWidgetIcon', 'Notification bell not found. The Band.us UI may have changed.');
         }
         // Poll until a capture containing result_data.news arrives, up to maxSecs seconds.
         // getInterceptedRequests() clears the array on each call, so captures are accumulated
@@ -80,7 +80,7 @@ cli({
       return true;
     }`);
         if (!bellClicked) {
-            throw new SelectorError('button._btnWidgetIcon', 'Notification bell disappeared before click. The Band.us UI may have changed.');
+            throw selectorError('button._btnWidgetIcon', 'Notification bell disappeared before click. The Band.us UI may have changed.');
         }
         const requests = await waitForOneCapture();
         // Find the get_news response (has result_data.news); get_news_count responses do not.

package/clis/bbc/news.js

@@ -12,7 +12,7 @@ cli({
         { name: 'limit', type: 'int', default: 20, help: 'Number of headlines (max 50)' },
     ],
     columns: ['rank', 'title', 'description', 'url'],
-    func: async (page, kwargs) => {
+    func: async (kwargs) => {
         const count = Math.min(kwargs.limit || 20, 50);
         const resp = await fetch('https://feeds.bbci.co.uk/news/rss.xml');
         if (!resp.ok)

package/clis/bilibili/subtitle.js

@@ -1,5 +1,5 @@
 import { cli, Strategy } from '@jackwener/opencli/registry';
-import { AuthRequiredError, CommandExecutionError, EmptyResultError, SelectorError } from '@jackwener/opencli/errors';
+import { AuthRequiredError, CommandExecutionError, EmptyResultError, selectorError } from '@jackwener/opencli/errors';
 import { apiGet, resolveBvid } from './utils.js';
 cli({
     site: 'bilibili',
@@ -23,7 +23,7 @@ cli({
       return state?.videoData?.cid;
     })()`);
         if (!cid) {
-            throw new SelectorError('videoData.cid', '无法在页面中提取到当前视频的 CID，请检查页面是否正常加载。');
+            throw selectorError('videoData.cid', '无法在页面中提取到当前视频的 CID，请检查页面是否正常加载。');
         }
         // 3. 在 Node 端使用 apiGet 获取带 Wbi 签名的字幕列表
         // 之前纯靠 evaluate 里的 fetch 会失败，因为 B 站 /wbi/ 开头的接口强校验 w_rid，未签名直接被风控返回 403 HTML

package/clis/bloomberg/businessweek.js

@@ -11,7 +11,7 @@ cli({
         { name: 'limit', type: 'int', default: 1, help: 'Number of feed items to return (max 20)' },
     ],
     columns: ['title', 'summary', 'link', 'mediaLinks'],
-    func: async (_page, kwargs) => {
+    func: async (kwargs) => {
         return fetchBloombergFeed('businessweek', kwargs.limit ?? 1);
     },
 });

package/clis/bloomberg/economics.js

@@ -11,7 +11,7 @@ cli({
         { name: 'limit', type: 'int', default: 1, help: 'Number of feed items to return (max 20)' },
     ],
     columns: ['title', 'summary', 'link', 'mediaLinks'],
-    func: async (_page, kwargs) => {
+    func: async (kwargs) => {
         return fetchBloombergFeed('economics', kwargs.limit ?? 1);
     },
 });

package/clis/bloomberg/industries.js

@@ -11,7 +11,7 @@ cli({
         { name: 'limit', type: 'int', default: 1, help: 'Number of feed items to return (max 20)' },
     ],
     columns: ['title', 'summary', 'link', 'mediaLinks'],
-    func: async (_page, kwargs) => {
+    func: async (kwargs) => {
         return fetchBloombergFeed('industries', kwargs.limit ?? 1);
     },
 });

package/clis/bloomberg/main.js

@@ -11,7 +11,7 @@ cli({
         { name: 'limit', type: 'int', default: 1, help: 'Number of feed items to return (max 20)' },
     ],
     columns: ['title', 'summary', 'link', 'mediaLinks'],
-    func: async (_page, kwargs) => {
+    func: async (kwargs) => {
         return fetchBloombergFeed('main', kwargs.limit ?? 1);
     },
 });

package/clis/bloomberg/markets.js

@@ -11,7 +11,7 @@ cli({
         { name: 'limit', type: 'int', default: 1, help: 'Number of feed items to return (max 20)' },
     ],
     columns: ['title', 'summary', 'link', 'mediaLinks'],
-    func: async (_page, kwargs) => {
+    func: async (kwargs) => {
         return fetchBloombergFeed('markets', kwargs.limit ?? 1);
     },
 });

package/clis/bloomberg/opinions.js

@@ -11,7 +11,7 @@ cli({
         { name: 'limit', type: 'int', default: 1, help: 'Number of feed items to return (max 20)' },
     ],
     columns: ['title', 'summary', 'link', 'mediaLinks'],
-    func: async (_page, kwargs) => {
+    func: async (kwargs) => {
         return fetchBloombergFeed('opinions', kwargs.limit ?? 1);
     },
 });

package/clis/bloomberg/politics.js

@@ -11,7 +11,7 @@ cli({
         { name: 'limit', type: 'int', default: 1, help: 'Number of feed items to return (max 20)' },
     ],
     columns: ['title', 'summary', 'link', 'mediaLinks'],
-    func: async (_page, kwargs) => {
+    func: async (kwargs) => {
         return fetchBloombergFeed('politics', kwargs.limit ?? 1);
     },
 });

package/clis/bloomberg/tech.js

@@ -11,7 +11,7 @@ cli({
         { name: 'limit', type: 'int', default: 1, help: 'Number of feed items to return (max 20)' },
     ],
     columns: ['title', 'summary', 'link', 'mediaLinks'],
-    func: async (_page, kwargs) => {
+    func: async (kwargs) => {
         return fetchBloombergFeed('tech', kwargs.limit ?? 1);
     },
 });

package/clis/boss/search.js

@@ -2,6 +2,7 @@
  * BOSS直聘 job search — browser cookie API.
  */
 import { cli, Strategy } from '@jackwener/opencli/registry';
+import { ArgumentError } from '@jackwener/opencli/errors';
 import { requirePage, navigateTo, bossFetch, verbose } from './utils.js';
 /** City name → BOSS Zhipin city code mapping */
 const CITY_CODES = {
@@ -22,8 +23,16 @@ const CITY_CODES = {
     '香港': '101320100',
 };
 const EXP_MAP = {
-    '不限': '0', '在校/应届': '108', '应届': '108', '1年以内': '101',
-    '1-3年': '102', '3-5年': '103', '5-10年': '104', '10年以上': '105',
+    '不限': '0',
+    '在校/应届': '108',
+    '在校生': '108', '在校': '108',
+    '应届生': '102', '应届': '102',
+    '经验不限': '101',
+    '1年以内': '103',
+    '1-3年': '104',
+    '3-5年': '105',
+    '5-10年': '106',
+    '10年以上': '107',
 };
 const DEGREE_MAP = {
     '不限': '0', '初中及以下': '209', '中专/中技': '208', '高中': '206',
@@ -38,6 +47,10 @@ const INDUSTRY_MAP = {
     '人工智能': '100901', '大数据': '100902', '金融': '100101',
     '教育培训': '100200', '医疗健康': '100300',
 };
+const JOB_TYPE_MAP = {
+    '不限': '0', '全职': '1901', '实习': '1902', '兼职': '1903',
+};
+const JOB_TYPE_CODES = new Set(Object.values(JOB_TYPE_MAP));
 function resolveCity(input) {
     if (!input)
         return '101010100';
@@ -62,35 +75,54 @@ function resolveMap(input, map) {
     }
     return input;
 }
+function resolveJobType(input) {
+    if (!input)
+        return '';
+    if (JOB_TYPE_MAP[input] !== undefined)
+        return JOB_TYPE_MAP[input];
+    if (JOB_TYPE_CODES.has(input))
+        return input;
+    throw new ArgumentError(`Invalid jobType: ${input}`, 'Use one of: 全职, 兼职, 实习, 不限');
+}
+function formatBossOnline(value) {
+    if (value === true)
+        return 'Y';
+    if (value === false)
+        return 'N';
+    return '';
+}
 cli({
     site: 'boss',
     name: 'search',
-    description: 'BOSS直聘搜索职位',
+    description: 'BOSS直聘搜索职位（不带关键词时返回为你推荐职位）',
     domain: 'www.zhipin.com',
     strategy: Strategy.COOKIE,
     navigateBefore: false,
     browser: true,
     args: [
-        { name: 'query', required: true, positional: true, help: 'Search keyword (e.g. AI agent, 前端)' },
+        { name: 'query', positional: true, help: 'Search keyword (optional, empty = recommended jobs)' },
         { name: 'city', default: '北京', help: 'City name or code (e.g. 杭州, 上海, 101010100)' },
-        { name: 'experience', default: '', help: 'Experience: 应届/1年以内/1-3年/3-5年/5-10年/10年以上' },
+        { name: 'experience', default: '', help: 'Experience: 在校生(实习)/应届生(校招)/经验不限/1年以内/1-3年/3-5年/5-10年/10年以上' },
         { name: 'degree', default: '', help: 'Degree: 大专/本科/硕士/博士' },
         { name: 'salary', default: '', help: 'Salary: 3K以下/3-5K/5-10K/10-15K/15-20K/20-30K/30-50K/50K以上' },
         { name: 'industry', default: '', help: 'Industry code or name (e.g. 100020, 互联网)' },
+        { name: 'jobType', default: '', help: 'Job type: 全职/兼职/实习（不传=不限，混合校招与实习）' },
         { name: 'page', type: 'int', default: 1, help: 'Page number' },
         { name: 'limit', type: 'int', default: 15, help: 'Number of results' },
     ],
-    columns: ['name', 'salary', 'company', 'area', 'experience', 'degree', 'skills', 'boss', 'security_id', 'url'],
+    columns: ['name', 'salary', 'company', 'area', 'experience', 'degree', 'skills', 'boss', 'bossOnline', 'security_id', 'url'],
     func: async (page, kwargs) => {
         requirePage(page);
+        const query = String(kwargs.query ?? '').trim();
         const cityCode = resolveCity(kwargs.city);
         verbose('Navigating to set referrer context...');
-        await navigateTo(page, `https://www.zhipin.com/web/geek/job?query=${encodeURIComponent(kwargs.query)}&city=${cityCode}`);
+        await navigateTo(page, `https://www.zhipin.com/web/geek/job?query=${encodeURIComponent(query)}&city=${cityCode}`);
         await new Promise(r => setTimeout(r, 1000));
         const expVal = resolveMap(kwargs.experience, EXP_MAP);
         const degreeVal = resolveMap(kwargs.degree, DEGREE_MAP);
         const salaryVal = resolveMap(kwargs.salary, SALARY_MAP);
         const industryVal = resolveMap(kwargs.industry, INDUSTRY_MAP);
+        const jobTypeVal = resolveJobType(kwargs.jobType);
         const limit = kwargs.limit || 15;
         let currentPage = kwargs.page || 1;
         let allJobs = [];
@@ -101,7 +133,7 @@ cli({
             }
             const qs = new URLSearchParams({
                 scene: '1',
-                query: kwargs.query,
+                query,
                 city: cityCode,
                 page: String(currentPage),
                 pageSize: '15',
@@ -114,6 +146,8 @@ cli({
                 qs.set('salary', salaryVal);
             if (industryVal)
                 qs.set('industry', industryVal);
+            if (jobTypeVal)
+                qs.set('jobType', jobTypeVal);
             const targetUrl = `https://www.zhipin.com/wapi/zpgeek/search/joblist.json?${qs.toString()}`;
             verbose(`Fetching page ${currentPage}... (current jobs: ${allJobs.length})`);
             const data = await bossFetch(page, targetUrl);
@@ -135,6 +169,7 @@ cli({
                     degree: j.jobDegree,
                     skills: (j.skills || []).join(','),
                     boss: j.bossName + ' · ' + j.bossTitle,
+                    bossOnline: formatBossOnline(j.bossOnline),
                     security_id: j.securityId || '',
                     url: 'https://www.zhipin.com/job_detail/' + j.encryptJobId + '.html',
                 });
@@ -153,3 +188,9 @@ cli({
         return allJobs;
     },
 });
+export const __test__ = {
+    EXP_MAP,
+    resolveMap,
+    resolveJobType,
+    formatBossOnline,
+};