@jackwener/opencli 1.1.1 → 1.2.0

package/dist/clis/twitter/download.d.ts

@@ -2,7 +2,7 @@
  * Twitter/X download — download images and videos from tweets.
  *
  * Usage:
- *   opencli twitter download --username elonmusk --limit 10 --output ./twitter
+ *   opencli twitter download elonmusk --limit 10 --output ./twitter
  *   opencli twitter download --tweet-url https://x.com/xxx/status/123 --output ./twitter
  */
 export {};

package/dist/clis/twitter/download.js

@@ -2,7 +2,7 @@
  * Twitter/X download — download images and videos from tweets.
  *
  * Usage:
- *   opencli twitter download --username elonmusk --limit 10 --output ./twitter
+ *   opencli twitter download elonmusk --limit 10 --output ./twitter
  *   opencli twitter download --tweet-url https://x.com/xxx/status/123 --output ./twitter
  */
 import * as fs from 'node:fs';
@@ -17,7 +17,7 @@ cli({
     domain: 'x.com',
     strategy: Strategy.COOKIE,
     args: [
-        { name: 'username', help: 'Twitter username (downloads from media tab)' },
+        { name: 'username', positional: true, help: 'Twitter username (downloads from media tab)' },
         { name: 'tweet-url', help: 'Single tweet URL to download' },
         { name: 'limit', type: 'int', default: 10, help: 'Number of tweets to scan' },
         { name: 'output', default: './twitter-downloads', help: 'Output directory' },
@@ -33,7 +33,7 @@ cli({
                     index: 0,
                     type: '-',
                     status: 'failed',
-                    size: 'Must provide --username or --tweet-url',
+                    size: 'Must provide a username or --tweet-url',
                 }];
         }
         // Navigate to the appropriate page

package/dist/clis/twitter/followers.js

@@ -7,7 +7,7 @@ cli({
     strategy: Strategy.INTERCEPT,
     browser: true,
     args: [
-        { name: 'user', type: 'string', required: false },
+        { name: 'user', positional: true, type: 'string', required: false },
         { name: 'limit', type: 'int', default: 50 },
     ],
     columns: ['screen_name', 'name', 'bio', 'followers'],

package/dist/clis/twitter/following.js

@@ -7,7 +7,7 @@ cli({
     strategy: Strategy.INTERCEPT,
     browser: true,
     args: [
-        { name: 'user', type: 'string', required: false },
+        { name: 'user', positional: true, type: 'string', required: false },
         { name: 'limit', type: 'int', default: 50 },
     ],
     columns: ['screen_name', 'name', 'bio', 'followers'],

package/dist/clis/twitter/thread.js

@@ -97,7 +97,7 @@ cli({
     strategy: Strategy.COOKIE,
     browser: true,
     args: [
-        { name: 'tweet-id', type: 'string', required: true },
+        { name: 'tweet-id', positional: true, type: 'string', required: true },
         { name: 'limit', type: 'int', default: 50 },
     ],
     columns: ['id', 'author', 'text', 'likes', 'retweets', 'url'],

package/dist/clis/twitter/timeline.d.ts

@@ -1 +1,24 @@
+type TimelineType = 'for-you' | 'following';
+interface TimelineTweet {
+    id: string;
+    author: string;
+    text: string;
+    likes: number;
+    retweets: number;
+    replies: number;
+    views: number;
+    created_at: string;
+    url: string;
+}
+declare function buildTimelineVariables(type: TimelineType, count: number, cursor?: string | null): Record<string, unknown>;
+declare function buildHomeTimelineUrl(queryId: string, endpoint: string, vars: Record<string, unknown>): string;
+declare function parseHomeTimeline(data: any, seen: Set<string>): {
+    tweets: TimelineTweet[];
+    nextCursor: string | null;
+};
+export declare const __test__: {
+    buildTimelineVariables: typeof buildTimelineVariables;
+    buildHomeTimelineUrl: typeof buildHomeTimelineUrl;
+    parseHomeTimeline: typeof parseHomeTimeline;
+};
 export {};

package/dist/clis/twitter/timeline.js

@@ -2,6 +2,12 @@ import { cli, Strategy } from '../../registry.js';
 // ── Twitter GraphQL constants ──────────────────────────────────────────
 const BEARER_TOKEN = 'AAAAAAAAAAAAAAAAAAAAANRILgAAAAAAnNwIzUejRCOuH5E6I8xnZz4puTs%3D1Zv7ttfk8LF81IUq16cHjhLTvJu4FA33AGWWjCpTnA';
 const HOME_TIMELINE_QUERY_ID = 'c-CzHF1LboFilMpsx4ZCrQ';
+const HOME_LATEST_TIMELINE_QUERY_ID = 'BKB7oi212Fi7kQtCBGE4zA';
+// Endpoint config: for-you uses GET HomeTimeline, following uses POST HomeLatestTimeline
+const TIMELINE_ENDPOINTS = {
+    'for-you': { endpoint: 'HomeTimeline', method: 'GET', fallbackQueryId: HOME_TIMELINE_QUERY_ID },
+    following: { endpoint: 'HomeLatestTimeline', method: 'POST', fallbackQueryId: HOME_LATEST_TIMELINE_QUERY_ID },
+};
 const FEATURES = {
     rweb_video_screen_enabled: false,
     profile_label_improvements_pcf_label_in_post_enabled: true,
@@ -35,19 +41,25 @@ const FEATURES = {
     responsive_web_grok_image_annotation_enabled: true,
     responsive_web_enhance_cards_enabled: false,
 };
-function buildHomeTimelineUrl(count, cursor) {
+function buildTimelineVariables(type, count, cursor) {
     const vars = {
         count,
         includePromotedContent: false,
         latestControlAvailable: true,
         requestContext: 'launch',
-        withCommunity: true,
     };
+    if (type === 'for-you')
+        vars.withCommunity = true;
+    if (type === 'following')
+        vars.seenTweetIds = [];
     if (cursor)
         vars.cursor = cursor;
-    return `/i/api/graphql/${HOME_TIMELINE_QUERY_ID}/HomeTimeline`
-        + `?variables=${encodeURIComponent(JSON.stringify(vars))}`
-        + `&features=${encodeURIComponent(JSON.stringify(FEATURES))}`;
+    return vars;
+}
+function buildHomeTimelineUrl(queryId, endpoint, vars) {
+    return (`/i/api/graphql/${queryId}/${endpoint}` +
+        `?variables=${encodeURIComponent(JSON.stringify(vars))}` +
+        `&features=${encodeURIComponent(JSON.stringify(FEATURES))}`);
 }
 function extractTweet(result, seen) {
     if (!result)
@@ -76,6 +88,7 @@ function extractTweet(result, seen) {
 function parseHomeTimeline(data, seen) {
     const tweets = [];
     let nextCursor = null;
+    // Both HomeTimeline and HomeLatestTimeline share the same response envelope
     const instructions = data?.data?.home?.home_timeline_urt?.instructions || [];
     for (const inst of instructions) {
         for (const entry of inst.entries || []) {
@@ -120,16 +133,24 @@ function parseHomeTimeline(data, seen) {
 cli({
     site: 'twitter',
     name: 'timeline',
-    description: 'Fetch Twitter Home Timeline',
+    description: 'Fetch Twitter timeline (for-you or following)',
     domain: 'x.com',
     strategy: Strategy.COOKIE,
     browser: true,
     args: [
+        {
+            name: 'type',
+            default: 'for-you',
+            choices: ['for-you', 'following'],
+            help: 'Timeline type: for-you (algorithmic) or following (chronological)',
+        },
         { name: 'limit', type: 'int', default: 20 },
     ],
     columns: ['id', 'author', 'text', 'likes', 'retweets', 'replies', 'views', 'created_at', 'url'],
     func: async (page, kwargs) => {
         const limit = kwargs.limit || 20;
+        const timelineType = kwargs.type === 'following' ? 'following' : 'for-you';
+        const { endpoint, method, fallbackQueryId } = TIMELINE_ENDPOINTS[timelineType];
         // Navigate to x.com for cookie context
         await page.goto('https://x.com');
         await page.wait(3);
@@ -139,21 +160,23 @@ cli({
     }`);
         if (!ct0)
             throw new Error('Not logged into x.com (no ct0 cookie)');
-        // Dynamically resolve queryId
-        const queryId = await page.evaluate(`async () => {
+        // Dynamically resolve queryId for the selected endpoint
+        const resolved = await page.evaluate(`async () => {
       try {
         const ghResp = await fetch('https://raw.githubusercontent.com/fa0311/twitter-openapi/refs/heads/main/src/config/placeholder.json');
         if (ghResp.ok) {
           const data = await ghResp.json();
-          const entry = data['HomeTimeline'];
+          const entry = data['${endpoint}'];
           if (entry && entry.queryId) return entry.queryId;
         }
       } catch {}
       return null;
-    }`) || HOME_TIMELINE_QUERY_ID;
+    }`);
+        // Validate queryId format to prevent injection from untrusted upstream
+        const queryId = typeof resolved === 'string' && /^[A-Za-z0-9_-]+$/.test(resolved) ? resolved : fallbackQueryId;
         // Build auth headers
         const headers = JSON.stringify({
-            'Authorization': `Bearer ${decodeURIComponent(BEARER_TOKEN)}`,
+            Authorization: `Bearer ${decodeURIComponent(BEARER_TOKEN)}`,
             'X-Csrf-Token': ct0,
             'X-Twitter-Auth-Type': 'OAuth2Session',
             'X-Twitter-Active-User': 'yes',
@@ -164,10 +187,10 @@ cli({
         let cursor = null;
         for (let i = 0; i < 5 && allTweets.length < limit; i++) {
             const fetchCount = Math.min(40, limit - allTweets.length + 5); // over-fetch slightly for promoted filtering
-            const apiUrl = buildHomeTimelineUrl(fetchCount, cursor)
-                .replace(HOME_TIMELINE_QUERY_ID, queryId);
+            const variables = buildTimelineVariables(timelineType, fetchCount, cursor);
+            const apiUrl = buildHomeTimelineUrl(queryId, endpoint, variables);
             const data = await page.evaluate(`async () => {
-        const r = await fetch("${apiUrl}", { headers: ${headers}, credentials: 'include' });
+        const r = await fetch("${apiUrl}", { method: "${method}", headers: ${headers}, credentials: 'include' });
         return r.ok ? await r.json() : { error: r.status };
       }`);
             if (data?.error) {
@@ -184,3 +207,8 @@ cli({
         return allTweets.slice(0, limit);
     },
 });
+export const __test__ = {
+    buildTimelineVariables,
+    buildHomeTimelineUrl,
+    parseHomeTimeline,
+};

package/dist/clis/twitter/timeline.test.d.ts

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

package/dist/clis/twitter/timeline.test.js

@@ -0,0 +1,102 @@
+import { describe, expect, it } from 'vitest';
+import { __test__ } from './timeline.js';
+describe('twitter timeline helpers', () => {
+    it('builds for-you variables with withCommunity', () => {
+        expect(__test__.buildTimelineVariables('for-you', 20)).toEqual({
+            count: 20,
+            includePromotedContent: false,
+            latestControlAvailable: true,
+            requestContext: 'launch',
+            withCommunity: true,
+        });
+    });
+    it('builds following variables with seenTweetIds instead of withCommunity', () => {
+        expect(__test__.buildTimelineVariables('following', 20, 'cursor-1')).toEqual({
+            count: 20,
+            includePromotedContent: false,
+            latestControlAvailable: true,
+            requestContext: 'launch',
+            seenTweetIds: [],
+            cursor: 'cursor-1',
+        });
+    });
+    it('encodes variables into timeline url', () => {
+        const url = __test__.buildHomeTimelineUrl('query123', 'HomeLatestTimeline', {
+            count: 20,
+            seenTweetIds: [],
+        });
+        expect(url).toContain('/i/api/graphql/query123/HomeLatestTimeline');
+        expect(url).toContain('variables=');
+        expect(url).toContain('features=');
+        expect(decodeURIComponent(url)).toContain('"seenTweetIds":[]');
+    });
+    it('parses tweets and bottom cursor from home timeline payload', () => {
+        const payload = {
+            data: {
+                home: {
+                    home_timeline_urt: {
+                        instructions: [
+                            {
+                                entries: [
+                                    {
+                                        entryId: 'tweet-1',
+                                        content: {
+                                            itemContent: {
+                                                tweet_results: {
+                                                    result: {
+                                                        rest_id: '1',
+                                                        legacy: {
+                                                            full_text: 'hello',
+                                                            favorite_count: 3,
+                                                            retweet_count: 2,
+                                                            reply_count: 1,
+                                                            created_at: 'now',
+                                                        },
+                                                        core: {
+                                                            user_results: {
+                                                                result: {
+                                                                    legacy: {
+                                                                        screen_name: 'alice',
+                                                                    },
+                                                                },
+                                                            },
+                                                        },
+                                                        views: {
+                                                            count: '9',
+                                                        },
+                                                    },
+                                                },
+                                            },
+                                        },
+                                    },
+                                    {
+                                        entryId: 'cursor-bottom-1',
+                                        content: {
+                                            entryType: 'TimelineTimelineCursor',
+                                            cursorType: 'Bottom',
+                                            value: 'cursor-next',
+                                        },
+                                    },
+                                ],
+                            },
+                        ],
+                    },
+                },
+            },
+        };
+        const result = __test__.parseHomeTimeline(payload, new Set());
+        expect(result.nextCursor).toBe('cursor-next');
+        expect(result.tweets).toHaveLength(1);
+        expect(result.tweets[0]).toMatchObject({
+            id: '1',
+            author: 'alice',
+            text: 'hello',
+            likes: 3,
+            retweets: 2,
+            replies: 1,
+            views: 9,
+            created_at: 'now',
+            url: 'https://x.com/alice/status/1',
+        });
+    });
+});

package/dist/clis/wikipedia/random.d.ts

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

package/dist/clis/wikipedia/random.js

@@ -0,0 +1,19 @@
+import { CliError } from '../../errors.js';
+import { cli, Strategy } from '../../registry.js';
+import { formatSummaryRow, wikiFetch } from './utils.js';
+cli({
+    site: 'wikipedia',
+    name: 'random',
+    description: 'Get a random Wikipedia article',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [{ name: 'lang', default: 'en', help: 'Language code (e.g. en, zh, ja)' }],
+    columns: ['title', 'description', 'extract', 'url'],
+    func: async (_page, args) => {
+        const lang = args.lang || 'en';
+        const data = (await wikiFetch(lang, '/api/rest_v1/page/random/summary'));
+        if (!data?.title)
+            throw new CliError('NOT_FOUND', 'No random article returned', 'Try again');
+        return [formatSummaryRow(data, lang)];
+    },
+});

package/dist/clis/wikipedia/search.js

@@ -1,5 +1,5 @@
-import { cli, Strategy } from '../../registry.js';
 import { CliError } from '../../errors.js';
+import { cli, Strategy } from '../../registry.js';
 import { wikiFetch } from './utils.js';
 cli({
     site: 'wikipedia',
@@ -16,8 +16,8 @@ cli({
     func: async (_page, args) => {
         const limit = Math.max(1, Math.min(Number(args.limit), 50));
         const lang = args.lang || 'en';
-        const q = encodeURIComponent(args.keyword);
-        const data = await wikiFetch(lang, `/w/api.php?action=query&list=search&srsearch=${q}&srlimit=${limit}&format=json&utf8=1`);
+        const q = encodeURIComponent(args.query);
+        const data = (await wikiFetch(lang, `/w/api.php?action=query&list=search&srsearch=${q}&srlimit=${limit}&format=json&utf8=1`));
         const results = data?.query?.search;
         if (!results?.length)
             throw new CliError('NOT_FOUND', 'No articles found', 'Try a different keyword');

package/dist/clis/wikipedia/summary.js

@@ -1,6 +1,6 @@
-import { cli, Strategy } from '../../registry.js';
 import { CliError } from '../../errors.js';
-import { wikiFetch } from './utils.js';
+import { cli, Strategy } from '../../registry.js';
+import { formatSummaryRow, wikiFetch } from './utils.js';
 cli({
     site: 'wikipedia',
     name: 'summary',
@@ -15,14 +15,9 @@ cli({
     func: async (_page, args) => {
         const lang = args.lang || 'en';
         const title = encodeURIComponent(args.title.replace(/ /g, '_'));
-        const data = await wikiFetch(lang, `/api/rest_v1/page/summary/${title}`);
+        const data = (await wikiFetch(lang, `/api/rest_v1/page/summary/${title}`));
         if (!data?.title)
             throw new CliError('NOT_FOUND', `Article "${args.title}" not found`, 'Try searching first: opencli wikipedia search <keyword>');
-        return [{
-                title: data.title,
-                description: data.description ?? '-',
-                extract: (data.extract ?? '').slice(0, 300),
-                url: data.content_urls?.desktop?.page ?? `https://${lang}.wikipedia.org/wiki/${title}`,
-            }];
+        return [formatSummaryRow(data, lang)];
     },
 });

package/dist/clis/wikipedia/trending.d.ts

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

package/dist/clis/wikipedia/trending.js

@@ -0,0 +1,35 @@
+import { CliError } from '../../errors.js';
+import { cli, Strategy } from '../../registry.js';
+import { DESC_MAX_LEN, wikiFetch } from './utils.js';
+cli({
+    site: 'wikipedia',
+    name: 'trending',
+    description: 'Most-read Wikipedia articles (yesterday)',
+    strategy: Strategy.PUBLIC,
+    browser: false,
+    args: [
+        { name: 'limit', type: 'int', default: 10, help: 'Max results' },
+        { name: 'lang', default: 'en', help: 'Language code (e.g. en, zh, ja)' },
+    ],
+    columns: ['rank', 'title', 'description', 'views'],
+    func: async (_page, args) => {
+        const lang = args.lang || 'en';
+        const limit = Math.max(1, Math.min(Number(args.limit), 50));
+        // Use yesterday's UTC date — Wikipedia API expects UTC and yesterday
+        // guarantees data availability (today's aggregation may be incomplete).
+        const d = new Date(Date.now() - 86_400_000);
+        const yyyy = d.getUTCFullYear();
+        const mm = String(d.getUTCMonth() + 1).padStart(2, '0');
+        const dd = String(d.getUTCDate()).padStart(2, '0');
+        const data = (await wikiFetch(lang, `/api/rest_v1/feed/featured/${yyyy}/${mm}/${dd}`));
+        const articles = data?.mostread?.articles;
+        if (!articles?.length)
+            throw new CliError('NOT_FOUND', 'No trending articles available', 'Try a different language with --lang');
+        return articles.slice(0, limit).map((a, i) => ({
+            rank: i + 1,
+            title: a.title ?? '-',
+            description: (a.description ?? '-').slice(0, DESC_MAX_LEN),
+            views: a.views ?? 0,
+        }));
+    },
+});

package/dist/clis/wikipedia/utils.d.ts

@@ -5,4 +5,32 @@
  * REST API: https://en.wikipedia.org/api/rest_v1/
  * Action API: https://en.wikipedia.org/w/api.php
  */
+/** Maximum character length for article extract fields. */
+export declare const EXTRACT_MAX_LEN = 300;
+/** Maximum character length for short description fields. */
+export declare const DESC_MAX_LEN = 80;
+/** Response shape shared by /page/summary and /page/random/summary endpoints. */
+export interface WikiSummary {
+    title?: string;
+    description?: string;
+    extract?: string;
+    content_urls?: {
+        desktop?: {
+            page?: string;
+        };
+    };
+}
+/** Article entry returned by the /feed/featured most-read endpoint. */
+export interface WikiMostReadArticle {
+    title?: string;
+    description?: string;
+    views?: number;
+}
 export declare function wikiFetch(lang: string, path: string): Promise<unknown>;
+/** Map a WikiSummary API response to the standard output row. */
+export declare function formatSummaryRow(data: WikiSummary, lang: string): {
+    title: string;
+    description: string;
+    extract: string;
+    url: string;
+};

package/dist/clis/wikipedia/utils.js

@@ -6,6 +6,10 @@
  * Action API: https://en.wikipedia.org/w/api.php
  */
 import { CliError } from '../../errors.js';
+/** Maximum character length for article extract fields. */
+export const EXTRACT_MAX_LEN = 300;
+/** Maximum character length for short description fields. */
+export const DESC_MAX_LEN = 80;
 export async function wikiFetch(lang, path) {
     const url = `https://${lang}.wikipedia.org${path}`;
     const resp = await fetch(url, {
@@ -16,3 +20,12 @@ export async function wikiFetch(lang, path) {
     }
     return resp.json();
 }
+/** Map a WikiSummary API response to the standard output row. */
+export function formatSummaryRow(data, lang) {
+    return {
+        title: data.title,
+        description: data.description ?? '-',
+        extract: (data.extract ?? '').slice(0, EXTRACT_MAX_LEN),
+        url: data.content_urls?.desktop?.page ?? `https://${lang}.wikipedia.org`,
+    };
+}

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

@@ -326,7 +326,7 @@ 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', positional: true, type: 'string', required: true, help: 'Note ID (from creator-notes or note-detail page URL)' },
     ],
     columns: ['section', 'metric', 'value', 'extra'],
     func: async (page, kwargs) => {

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

@@ -15,6 +15,8 @@ function createPageMock(evaluateResult) {
         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: [] }),
         wait: vi.fn().mockResolvedValue(undefined),
         tabs: vi.fn().mockResolvedValue([]),
         closeTab: vi.fn().mockResolvedValue(undefined),

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

@@ -18,6 +18,8 @@ function createPageMock(evaluateResult, interceptedRequests = []) {
         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: [] }),
         wait: vi.fn().mockResolvedValue(undefined),
         tabs: vi.fn().mockResolvedValue([]),
         closeTab: vi.fn().mockResolvedValue(undefined),

package/dist/clis/xiaohongshu/download.js

@@ -16,7 +16,7 @@ cli({
     domain: 'www.xiaohongshu.com',
     strategy: Strategy.COOKIE,
     args: [
-        { name: 'note-id', required: true, help: 'Note ID (from URL)' },
+        { name: 'note-id', positional: true, required: true, help: 'Note ID (from URL)' },
         { name: 'output', default: './xiaohongshu-downloads', help: 'Output directory' },
     ],
     columns: ['index', 'type', 'status', 'size'],

package/dist/clis/xueqiu/earnings-date.yaml

@@ -0,0 +1,69 @@
+site: xueqiu
+name: earnings-date
+description: 获取股票预计财报发布日期（公司大事）
+domain: xueqiu.com
+browser: true
+
+args:
+  symbol:
+    positional: true
+    type: str
+    required: true
+    description: 股票代码，如 SH600519、SZ000858、00700
+  next:
+    type: bool
+    default: false
+    description: 仅返回最近一次未发布的财报日期
+  limit:
+    type: int
+    default: 10
+    description: 返回数量，默认 10
+
+pipeline:
+  - navigate: https://xueqiu.com
+  - evaluate: |
+      (async () => {
+        const symbol = (${{ args.symbol | json }} || '').toUpperCase();
+        const onlyNext = ${{ args.next }};
+        if (!symbol) throw new Error('Missing argument: symbol');
+        const resp = await fetch(
+          `https://stock.xueqiu.com/v5/stock/screener/event/list.json?symbol=${encodeURIComponent(symbol)}&page=1&size=100`,
+          { credentials: 'include' }
+        );
+        if (!resp.ok) throw new Error('HTTP ' + resp.status + ' Hint: Not logged in?');
+        const d = await resp.json();
+        if (!d.data || !d.data.items) throw new Error('获取失败: ' + JSON.stringify(d));
+
+        // subtype 2 = 预计财报发布
+        let items = d.data.items.filter(item => item.subtype === 2);
+
+        const now = Date.now();
+        let results = items.map(item => {
+          const ts = item.timestamp;
+          const dateStr = ts ? new Date(ts).toISOString().split('T')[0] : null;
+          const isFuture = ts && ts > now;
+          return {
+            date: dateStr,
+            report: item.message,
+            status: isFuture ? '⏳ 未发布' : '✅ 已发布',
+            _ts: ts,
+            _future: isFuture
+          };
+        });
+
+        if (onlyNext) {
+          const future = results.filter(r => r._future).sort((a, b) => a._ts - b._ts);
+          results = future.length ? [future[0]] : [];
+        }
+
+        return results;
+      })()
+
+  - map:
+      date: ${{ item.date }}
+      report: ${{ item.report }}
+      status: ${{ item.status }}
+
+  - limit: ${{ args.limit }}
+
+columns: [date, report, status]

package/dist/clis/xueqiu/search.yaml

@@ -6,7 +6,9 @@ browser: true
 
 args:
   query:
+    positional: true
     type: str
+    required: true
     description: 搜索关键词，如 茅台、AAPL、腾讯
   limit:
     type: int
@@ -19,7 +21,6 @@ pipeline:
       (async () => {
         const query = ${{ args.query | json }};
         const count = ${{ args.limit }};
-        if (!query) throw new Error('Missing argument: query');
         const resp = await fetch(`https://xueqiu.com/stock/search.json?code=${encodeURIComponent(query)}&size=${count}`, {credentials: 'include'});
         if (!resp.ok) throw new Error('HTTP ' + resp.status + ' Hint: Not logged in?');
         const d = await resp.json();

package/dist/clis/xueqiu/stock.yaml

@@ -6,7 +6,9 @@ browser: true
 
 args:
   symbol:
+    positional: true
     type: str
+    required: true
     description: 股票代码，如 SH600519、SZ000858、AAPL、00700
 
 pipeline:

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

@@ -10,7 +10,7 @@ cli({
     domain: 'finance.yahoo.com',
     strategy: Strategy.COOKIE,
     args: [
-        { name: 'symbol', required: true, help: 'Stock ticker (e.g. AAPL, MSFT, TSLA)' },
+        { name: 'symbol', required: true, positional: true, help: 'Stock ticker (e.g. AAPL, MSFT, TSLA)' },
     ],
     columns: ['symbol', 'name', 'price', 'change', 'changePercent', 'open', 'high', 'low', 'volume', 'marketCap'],
     func: async (page, kwargs) => {