@jackwener/opencli 1.1.0 → 1.1.1

package/dist/clis/xiaohongshu/creator-note-detail.js

@@ -22,6 +22,7 @@ const NOTE_DETAIL_METRICS = [
     { label: '分享数', section: '互动数据' },
 ];
 const NOTE_DETAIL_METRIC_LABELS = new Set(NOTE_DETAIL_METRICS.map((metric) => metric.label));
+const NOTE_DETAIL_SECTIONS = new Set(NOTE_DETAIL_METRICS.map((metric) => metric.section));
 const NOTE_DETAIL_NOISE_LINES = new Set([
     '切换笔记',
     '笔记诊断',
@@ -75,6 +76,10 @@ function findMetricValue(lines, startIndex) {
     }
     return { value, extra };
 }
+function findPublishedAt(text) {
+    const match = text.match(/\b\d{4}-\d{2}-\d{2} \d{2}:\d{2}\b/);
+    return match?.[0] ?? '';
+}
 export function parseCreatorNoteDetailText(bodyText, noteId) {
     const lines = bodyText
         .split('\n')
@@ -101,6 +106,34 @@ export function parseCreatorNoteDetailText(bodyText, noteId) {
     }
     return rows;
 }
+export function parseCreatorNoteDetailDomData(dom, noteId) {
+    if (!dom)
+        return [];
+    const title = typeof dom.title === 'string' ? dom.title.trim() : '';
+    const infoText = typeof dom.infoText === 'string' ? dom.infoText : '';
+    const sections = Array.isArray(dom.sections) ? dom.sections : [];
+    const rows = [
+        { section: '笔记信息', metric: 'note_id', value: noteId, extra: '' },
+        { section: '笔记信息', metric: 'title', value: title, extra: '' },
+        { section: '笔记信息', metric: 'published_at', value: findPublishedAt(infoText), extra: '' },
+    ];
+    for (const section of sections) {
+        if (!NOTE_DETAIL_SECTIONS.has(section.title))
+            continue;
+        for (const metric of section.metrics) {
+            if (!NOTE_DETAIL_METRIC_LABELS.has(metric.label))
+                continue;
+            rows.push({
+                section: section.title,
+                metric: metric.label,
+                value: metric.value,
+                extra: metric.extra,
+            });
+        }
+    }
+    const hasMetric = rows.some((row) => row.section !== '笔记信息' && row.value);
+    return hasMetric ? rows : [];
+}
 function toPercentString(value) {
     return value == null ? '' : `${value}%`;
 }
@@ -244,11 +277,42 @@ async function captureNoteDetailPayload(page, noteId) {
     }
     return captured > 0 ? payload : null;
 }
+async function captureNoteDetailDomData(page) {
+    const result = await page.evaluate(`() => {
+    const norm = (value) => (value || '').trim();
+    const sections = Array.from(document.querySelectorAll('.shell-container')).map((container) => {
+      const containerText = norm(container.innerText);
+      const title = containerText.startsWith('互动数据')
+        ? '互动数据'
+        : containerText.includes('基础数据')
+          ? '基础数据'
+          : '';
+      const metrics = Array.from(container.querySelectorAll('.block-container.block')).map((block) => ({
+        label: norm(block.querySelector('.des')?.innerText),
+        value: norm(block.querySelector('.content')?.innerText),
+        extra: norm(block.querySelector('.text-with-fans')?.innerText),
+      })).filter((metric) => metric.label && metric.value);
+      return { title, metrics };
+    }).filter((section) => section.title && section.metrics.length > 0);
+
+    return {
+      title: norm(document.querySelector('.note-title')?.innerText),
+      infoText: norm(document.querySelector('.note-info-content')?.innerText),
+      sections,
+    };
+  }`);
+    if (!result || typeof result !== 'object')
+        return null;
+    return result;
+}
 export async function fetchCreatorNoteDetailRows(page, noteId) {
     await page.goto(`https://creator.xiaohongshu.com/statistics/note-detail?noteId=${encodeURIComponent(noteId)}`);
-    await page.wait(4);
-    const bodyText = await page.evaluate('() => document.body.innerText');
-    const rows = parseCreatorNoteDetailText(typeof bodyText === 'string' ? bodyText : '', noteId);
+    const domData = await captureNoteDetailDomData(page).catch(() => null);
+    let rows = parseCreatorNoteDetailDomData(domData, noteId);
+    if (rows.length === 0) {
+        const bodyText = await page.evaluate('() => document.body.innerText');
+        rows = parseCreatorNoteDetailText(typeof bodyText === 'string' ? bodyText : '', noteId);
+    }
     const apiPayload = await captureNoteDetailPayload(page, noteId).catch(() => null);
     appendTrendRows(rows, apiPayload ?? undefined);
     appendAudienceRows(rows, apiPayload ?? undefined);
@@ -262,11 +326,11 @@ cli({
     strategy: Strategy.COOKIE,
     browser: true,
     args: [
-        { name: 'note_id', type: 'string', required: true, help: 'Note ID (from creator-notes or note-detail page URL)' },
+        { name: 'note-id', type: 'string', required: true, help: 'Note ID (from creator-notes or note-detail page URL)' },
     ],
     columns: ['section', 'metric', 'value', 'extra'],
     func: async (page, kwargs) => {
-        const noteId = kwargs.note_id;
+        const noteId = kwargs['note-id'];
         const rows = await fetchCreatorNoteDetailRows(page, noteId);
         const hasCoreMetric = rows.some((row) => row.section !== '笔记信息' && row.value);
         if (!hasCoreMetric) {

package/dist/clis/xiaohongshu/creator-note-detail.test.js

@@ -1,11 +1,16 @@
 import { describe, expect, it, vi } from 'vitest';
 import { getRegistry } from '../../registry.js';
-import { appendAudienceRows, appendTrendRows, parseCreatorNoteDetailText } from './creator-note-detail.js';
+import { appendAudienceRows, appendTrendRows, parseCreatorNoteDetailDomData, parseCreatorNoteDetailText } from './creator-note-detail.js';
 import './creator-note-detail.js';
 function createPageMock(evaluateResult) {
+    const evaluate = Array.isArray(evaluateResult)
+        ? vi.fn()
+            .mockResolvedValueOnce(evaluateResult[0])
+            .mockResolvedValue(evaluateResult[evaluateResult.length - 1])
+        : vi.fn().mockResolvedValue(evaluateResult);
     return {
         goto: vi.fn().mockResolvedValue(undefined),
-        evaluate: vi.fn().mockResolvedValue(evaluateResult),
+        evaluate,
         snapshot: vi.fn().mockResolvedValue(undefined),
         click: vi.fn().mockResolvedValue(undefined),
         typeText: vi.fn().mockResolvedValue(undefined),
@@ -88,6 +93,46 @@ describe('xiaohongshu creator-note-detail', () => {
             { section: '互动数据', metric: '分享数', value: '6', extra: '粉丝占比 0%' },
         ]);
     });
+    it('parses structured note detail dom data into rows', () => {
+        expect(parseCreatorNoteDetailDomData({
+            title: '神雕侠侣战力金字塔',
+            infoText: '神雕侠侣战力金字塔\n#武侠\n2025-12-04 19:45\n切换笔记',
+            sections: [
+                {
+                    title: '基础数据',
+                    metrics: [
+                        { label: '曝光数', value: '898204', extra: '粉丝占比 0.5%' },
+                        { label: '观看数', value: '148284', extra: '粉丝占比 0.6%' },
+                        { label: '封面点击率', value: '17.1%', extra: '粉丝 19.1%' },
+                        { label: '平均观看时长', value: '30.1秒', extra: '粉丝 17.7秒' },
+                        { label: '涨粉数', value: '101', extra: '' },
+                    ],
+                },
+                {
+                    title: '互动数据',
+                    metrics: [
+                        { label: '点赞数', value: '2280', extra: '粉丝占比 3.6%' },
+                        { label: '评论数', value: '319', extra: '粉丝占比 9.4%' },
+                        { label: '收藏数', value: '466', extra: '粉丝占比 9.4%' },
+                        { label: '分享数', value: '33', extra: '粉丝占比 17.7%' },
+                    ],
+                },
+            ],
+        }, '693155fc000000000d03b42c')).toEqual([
+            { section: '笔记信息', metric: 'note_id', value: '693155fc000000000d03b42c', extra: '' },
+            { section: '笔记信息', metric: 'title', value: '神雕侠侣战力金字塔', extra: '' },
+            { section: '笔记信息', metric: 'published_at', value: '2025-12-04 19:45', extra: '' },
+            { section: '基础数据', metric: '曝光数', value: '898204', extra: '粉丝占比 0.5%' },
+            { section: '基础数据', metric: '观看数', value: '148284', extra: '粉丝占比 0.6%' },
+            { section: '基础数据', metric: '封面点击率', value: '17.1%', extra: '粉丝 19.1%' },
+            { section: '基础数据', metric: '平均观看时长', value: '30.1秒', extra: '粉丝 17.7秒' },
+            { section: '基础数据', metric: '涨粉数', value: '101', extra: '' },
+            { section: '互动数据', metric: '点赞数', value: '2280', extra: '粉丝占比 3.6%' },
+            { section: '互动数据', metric: '评论数', value: '319', extra: '粉丝占比 9.4%' },
+            { section: '互动数据', metric: '收藏数', value: '466', extra: '粉丝占比 9.4%' },
+            { section: '互动数据', metric: '分享数', value: '33', extra: '粉丝占比 17.7%' },
+        ]);
+    });
     it('appends audience source and portrait rows from API payloads', () => {
         const rows = appendAudienceRows([], {
             audienceSource: {
@@ -161,38 +206,40 @@ describe('xiaohongshu creator-note-detail', () => {
     it('navigates to the note detail page and returns parsed rows', async () => {
         const cmd = getRegistry().get('xiaohongshu/creator-note-detail');
         expect(cmd?.func).toBeTypeOf('function');
-        const page = createPageMock(`笔记数据详情
-示例笔记
-2026-03-19 12:00
-曝光数
-100
-粉丝占比 10%
-观看数
-50
-粉丝占比 20%
-封面点击率
-12%
-粉丝 11%
-平均观看时长
-30秒
-粉丝 31秒
-涨粉数
-2
-点赞数
-8
-粉丝占比 25%
-评论数
-1
-粉丝占比 0%
-收藏数
-3
-粉丝占比 50%
-分享数
-0
-粉丝占比 0%`);
-        const result = await cmd.func(page, { note_id: 'demo-note-id' });
+        const page = createPageMock([
+            {
+                title: '示例笔记',
+                infoText: '示例笔记\n2026-03-19 12:00\n切换笔记',
+                sections: [
+                    {
+                        title: '基础数据',
+                        metrics: [
+                            { label: '曝光数', value: '100', extra: '粉丝占比 10%' },
+                            { label: '观看数', value: '50', extra: '粉丝占比 20%' },
+                            { label: '封面点击率', value: '12%', extra: '粉丝 11%' },
+                            { label: '平均观看时长', value: '30秒', extra: '粉丝 31秒' },
+                            { label: '涨粉数', value: '2', extra: '' },
+                        ],
+                    },
+                    {
+                        title: '互动数据',
+                        metrics: [
+                            { label: '点赞数', value: '8', extra: '粉丝占比 25%' },
+                            { label: '评论数', value: '1', extra: '粉丝占比 0%' },
+                            { label: '收藏数', value: '3', extra: '粉丝占比 50%' },
+                            { label: '分享数', value: '0', extra: '粉丝占比 0%' },
+                        ],
+                    },
+                ],
+            },
+            null,
+            null,
+            null,
+            null,
+        ]);
+        const result = await cmd.func(page, { 'note-id': 'demo-note-id' });
         expect(page.goto.mock.calls[0][0]).toBe('https://creator.xiaohongshu.com/statistics/note-detail?noteId=demo-note-id');
-        expect(page.evaluate.mock.calls[0][0]).toBe('() => document.body.innerText');
+        expect(page.evaluate.mock.calls[0][0]).toContain("document.querySelector('.note-title')");
         expect(result).toEqual([
             { section: '笔记信息', metric: 'note_id', value: 'demo-note-id', extra: '' },
             { section: '笔记信息', metric: 'title', value: '示例笔记', extra: '' },

package/dist/clis/xiaohongshu/creator-notes.js

@@ -59,9 +59,9 @@ export function parseCreatorNotesText(bodyText) {
             title,
             date: dateMatch[1],
             views: metrics[0] ?? 0,
-            likes: metrics[1] ?? 0,
-            collects: metrics[2] ?? 0,
-            comments: metrics[3] ?? 0,
+            likes: metrics[2] ?? 0,
+            collects: metrics[3] ?? 0,
+            comments: metrics[1] ?? 0,
             url: '',
         });
         i = cursor - 1;
@@ -80,6 +80,18 @@ export function parseCreatorNoteIdsFromHtml(bodyHtml) {
     }
     return ids;
 }
+function mapDomCards(cards) {
+    return cards.map((card) => ({
+        id: card.id,
+        title: card.title,
+        date: card.date,
+        views: card.metrics[0] ?? 0,
+        likes: card.metrics[2] ?? 0,
+        collects: card.metrics[3] ?? 0,
+        comments: card.metrics[1] ?? 0,
+        url: buildNoteDetailUrl(card.id),
+    }));
+}
 function mapAnalyzeItems(items) {
     return (items ?? []).map((item) => ({
         id: item.id ?? '',
@@ -97,7 +109,6 @@ async function fetchCreatorNotesByApi(page, limit) {
     const maxPages = Math.max(1, Math.ceil(limit / pageSize));
     const notes = [];
     await page.goto(`https://creator.xiaohongshu.com/statistics/data-analysis?type=0&page_size=${pageSize}&page_num=1`);
-    await page.wait(4);
     for (let pageNum = 1; pageNum <= maxPages && notes.length < limit; pageNum++) {
         const apiPath = `${NOTE_ANALYZE_API_PATH}?type=0&page_size=${pageSize}&page_num=${pageNum}`;
         const fetched = await page.evaluate(`
@@ -139,9 +150,28 @@ export async function fetchCreatorNotes(page, limit) {
     let notes = await fetchCreatorNotesByApi(page, limit);
     if (notes.length === 0) {
         await page.goto('https://creator.xiaohongshu.com/new/note-manager');
-        await page.wait(4);
         const maxPageDowns = Math.max(0, Math.ceil(limit / 10) + 1);
         for (let i = 0; i <= maxPageDowns; i++) {
+            const domCards = await page.evaluate(`() => {
+        const noteIdRe = /"noteId":"([0-9a-f]{24})"/;
+        return Array.from(document.querySelectorAll('div.note[data-impression], div.note')).map((card) => {
+          const impression = card.getAttribute('data-impression') || '';
+          const id = impression.match(noteIdRe)?.[1] || '';
+          const title = (card.querySelector('.title, .raw')?.innerText || '').trim();
+          const dateText = (card.querySelector('.time_status, .time')?.innerText || '').trim();
+          const date = dateText.replace(/^发布于\\s*/, '');
+          const metrics = Array.from(card.querySelectorAll('.icon_list .icon'))
+            .map((el) => parseInt((el.innerText || '').trim(), 10))
+            .filter((value) => Number.isFinite(value));
+          return { id, title, date, metrics };
+        });
+      }`);
+            const parsedDomNotes = mapDomCards(Array.isArray(domCards) ? domCards : []).filter((note) => note.title && note.date);
+            if (parsedDomNotes.length > 0) {
+                notes = parsedDomNotes;
+            }
+            if (notes.length >= limit || (notes.length > 0 && i === 0))
+                break;
             const body = await page.evaluate('() => ({ text: document.body.innerText, html: document.body.innerHTML })');
             const bodyText = typeof body?.text === 'string' ? body.text : '';
             const bodyHtml = typeof body?.html === 'string' ? body.html : '';

package/dist/clis/xiaohongshu/creator-notes.test.js

@@ -64,9 +64,9 @@ describe('xiaohongshu creator-notes', () => {
                 title: '神雕侠侣战力金字塔',
                 date: '2025年12月04日 19:45',
                 views: 148208,
-                likes: 324,
-                collects: 2279,
-                comments: 465,
+                likes: 2279,
+                collects: 465,
+                comments: 324,
                 url: '',
             },
             {
@@ -107,13 +107,42 @@ describe('xiaohongshu creator-notes', () => {
                 title: '示例笔记',
                 date: '2026年03月19日 12:00',
                 views: 10,
-                likes: 2,
-                collects: 3,
-                comments: 4,
+                likes: 3,
+                collects: 4,
+                comments: 2,
                 url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=69ba940500000000200384db',
             },
         ]);
     });
+    it('prefers note card dom data when the analyze api is unavailable', async () => {
+        const cmd = getRegistry().get('xiaohongshu/creator-notes');
+        expect(cmd?.func).toBeTypeOf('function');
+        const page = createPageMock([
+            undefined,
+            [
+                {
+                    id: '693155fc000000000d03b42c',
+                    title: '神雕侠侣战力金字塔',
+                    date: '2025年12月04日 19:45',
+                    metrics: [148284, 319, 2280, 466, 33],
+                },
+            ],
+        ]);
+        const result = await cmd.func(page, { limit: 1 });
+        expect(result).toEqual([
+            {
+                rank: 1,
+                id: '693155fc000000000d03b42c',
+                title: '神雕侠侣战力金字塔',
+                date: '2025年12月04日 19:45',
+                views: 148284,
+                likes: 2280,
+                collects: 466,
+                comments: 319,
+                url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=693155fc000000000d03b42c',
+            },
+        ]);
+    });
     it('prefers the creator analyze API and preserves note ids', async () => {
         const cmd = getRegistry().get('xiaohongshu/creator-notes');
         expect(cmd?.func).toBeTypeOf('function');

package/dist/clis/xiaohongshu/creator-profile.js

@@ -19,7 +19,6 @@ cli({
     columns: ['field', 'value'],
     func: async (page, _kwargs) => {
         await page.goto('https://creator.xiaohongshu.com/new/home');
-        await page.wait(3);
         const data = await page.evaluate(`
       async () => {
         try {

package/dist/clis/xiaohongshu/creator-stats.js

@@ -29,7 +29,6 @@ cli({
         const period = kwargs.period || 'seven';
         // Navigate to creator center for cookie context
         await page.goto('https://creator.xiaohongshu.com/new/home');
-        await page.wait(3);
         const data = await page.evaluate(`
       async () => {
         try {

package/dist/clis/xiaohongshu/download.js

@@ -16,16 +16,15 @@ cli({
     domain: 'www.xiaohongshu.com',
     strategy: Strategy.COOKIE,
     args: [
-        { name: 'note_id', required: true, help: 'Note ID (from URL)' },
+        { name: 'note-id', required: true, help: 'Note ID (from URL)' },
         { name: 'output', default: './xiaohongshu-downloads', help: 'Output directory' },
     ],
     columns: ['index', 'type', 'status', 'size'],
     func: async (page, kwargs) => {
-        const noteId = kwargs.note_id;
+        const noteId = kwargs['note-id'];
         const output = kwargs.output;
         // Navigate to note page
         await page.goto(`https://www.xiaohongshu.com/explore/${noteId}`);
-        await page.wait(3);
         // Extract note info and media URLs
         const data = await page.evaluate(`
       (() => {

package/dist/clis/xiaohongshu/feed.yaml

@@ -15,7 +15,6 @@ columns: [title, author, likes, type, url]
 
 pipeline:
   - navigate: https://www.xiaohongshu.com/explore
-  - wait: 3
   - tap:
       store: feed
       action: fetchFeeds

package/dist/clis/xiaohongshu/notifications.yaml

@@ -19,7 +19,6 @@ columns: [rank, user, action, content, note, time]
 
 pipeline:
   - navigate: https://www.xiaohongshu.com/notification
-  - wait: 3
   - tap:
       store: notification
       action: getNotification

package/dist/clis/xiaohongshu/search.js

@@ -13,12 +13,12 @@ cli({
     domain: 'www.xiaohongshu.com',
     strategy: Strategy.COOKIE,
     args: [
-        { name: 'keyword', required: true, help: 'Search keyword' },
+        { name: 'query', required: true, positional: true, help: 'Search keyword' },
         { name: 'limit', type: 'int', default: 20, help: 'Number of results' },
     ],
     columns: ['rank', 'title', 'author', 'likes'],
     func: async (page, kwargs) => {
-        const keyword = encodeURIComponent(kwargs.keyword);
+        const keyword = encodeURIComponent(kwargs.query);
         await page.goto(`https://www.xiaohongshu.com/search_result?keyword=${keyword}&source=web_search_result_notes`);
         await page.wait(3);
         // Scroll a couple of times to load more results

package/dist/clis/xiaohongshu/user.js

@@ -27,7 +27,7 @@ cli({
     strategy: Strategy.COOKIE,
     browser: true,
     args: [
-        { name: 'id', type: 'string', required: true, help: 'User id or profile URL' },
+        { name: 'id', type: 'string', required: true, positional: true, help: 'User id or profile URL' },
         { name: 'limit', type: 'int', default: 15, help: 'Number of notes to return' },
     ],
     columns: ['id', 'title', 'type', 'likes', 'url'],
@@ -35,7 +35,6 @@ cli({
         const userId = normalizeXhsUserId(String(kwargs.id));
         const limit = Math.max(1, Number(kwargs.limit ?? 15));
         await page.goto(`https://www.xiaohongshu.com/user/profile/${userId}`);
-        await page.wait(3);
         let snapshot = await readUserSnapshot(page);
         let results = extractXhsUserNotes(snapshot ?? {}, userId);
         let previousCount = results.length;

package/dist/clis/yahoo-finance/quote.js

@@ -16,7 +16,6 @@ cli({
     func: async (page, kwargs) => {
         const symbol = kwargs.symbol.toUpperCase().trim();
         await page.goto(`https://finance.yahoo.com/quote/${encodeURIComponent(symbol)}/`);
-        await page.wait(3);
         const data = await page.evaluate(`
       (async () => {
         const sym = '${symbol}';

package/dist/clis/youtube/search.js

@@ -10,7 +10,7 @@ cli({
     domain: 'www.youtube.com',
     strategy: Strategy.COOKIE,
     args: [
-        { name: 'query', required: true, help: 'Search query' },
+        { name: 'query', required: true, positional: true, help: 'Search query' },
         { name: 'limit', type: 'int', default: 20, help: 'Max results (max 50)' },
     ],
     columns: ['rank', 'title', 'channel', 'views', 'duration', 'url'],

package/dist/clis/youtube/transcript.js

@@ -19,7 +19,7 @@ cli({
     domain: 'www.youtube.com',
     strategy: Strategy.COOKIE,
     args: [
-        { name: 'url', required: true, help: 'YouTube video URL or video ID' },
+        { name: 'url', required: true, positional: true, help: 'YouTube video URL or video ID' },
         { name: 'lang', required: false, help: 'Language code (e.g. en, zh-Hans). Omit to auto-select' },
         { name: 'mode', required: false, default: 'grouped', help: 'Output mode: grouped (readable paragraphs) or raw (every segment)' },
     ],

package/dist/clis/youtube/video.js

@@ -10,7 +10,7 @@ cli({
     domain: 'www.youtube.com',
     strategy: Strategy.COOKIE,
     args: [
-        { name: 'url', required: true, help: 'YouTube video URL or video ID' },
+        { name: 'url', required: true, positional: true, help: 'YouTube video URL or video ID' },
     ],
     columns: ['field', 'value'],
     func: async (page, kwargs) => {

package/dist/clis/zhihu/download.js

@@ -72,7 +72,7 @@ cli({
     domain: 'zhuanlan.zhihu.com',
     strategy: Strategy.COOKIE,
     args: [
-        { name: 'url', required: true, help: 'Article URL (zhuanlan.zhihu.com/p/xxx)' },
+        { name: 'url', required: true, positional: true, help: 'Article URL (zhuanlan.zhihu.com/p/xxx)' },
         { name: 'output', default: './zhihu-articles', help: 'Output directory' },
         { name: 'download-images', type: 'boolean', default: false, help: 'Download images locally' },
     ],
@@ -83,7 +83,6 @@ cli({
         const downloadImages = kwargs['download-images'];
         // Navigate to article page
         await page.goto(url);
-        await page.wait(3);
         // Extract article content
         const data = await page.evaluate(`
       (() => {

package/dist/clis/zhihu/question.js

@@ -6,7 +6,7 @@ cli({
     domain: 'www.zhihu.com',
     strategy: Strategy.COOKIE,
     args: [
-        { name: 'id', required: true, help: 'Question ID (numeric)' },
+        { name: 'id', required: true, positional: true, help: 'Question ID (numeric)' },
         { name: 'limit', type: 'int', default: 5, help: 'Number of answers' },
     ],
     columns: ['rank', 'author', 'votes', 'content'],

package/dist/clis/zhihu/search.yaml

@@ -4,10 +4,11 @@ description: 知乎搜索
 domain: www.zhihu.com
 
 args:
-  keyword:
+  query:
+    positional: true
     type: str
     required: true
-    description: Search keyword
+    description: Search query
   limit:
     type: int
     default: 10
@@ -19,7 +20,7 @@ pipeline:
   - evaluate: |
       (async () => {
         const strip = (html) => (html || '').replace(/<[^>]+>/g, '').replace(/&nbsp;/g, ' ').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&amp;/g, '&').replace(/<em>/g, '').replace(/<\/em>/g, '').trim();
-        const keyword = ${{ args.keyword | json }};
+        const keyword = ${{ args.query | json }};
         const limit = ${{ args.limit }};
         const res = await fetch('https://www.zhihu.com/api/v4/search_v3?q=' + encodeURIComponent(keyword) + '&t=general&offset=0&limit=' + limit, {
           credentials: 'include'

package/dist/commanderAdapter.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Commander adapter: bridges Registry commands to Commander subcommands.
+ *
+ * This is a THIN adapter — it only handles:
+ * 1. Commander arg/option registration
+ * 2. Collecting kwargs from Commander's action args
+ * 3. Calling executeCommand (which handles browser sessions, validation, etc.)
+ * 4. Rendering output and errors
+ *
+ * All execution logic lives in execution.ts.
+ */
+import { Command } from 'commander';
+import { type CliCommand } from './registry.js';
+/**
+ * Register a single CliCommand as a Commander subcommand.
+ */
+export declare function registerCommandToProgram(siteCmd: Command, cmd: CliCommand): void;
+/**
+ * Register all commands from the registry onto a Commander program.
+ */
+export declare function registerAllCommands(program: Command, siteGroups: Map<string, Command>): void;