@jackwener/opencli 1.7.11 → 1.7.13

package/clis/twitter/reply-dm.js

@@ -3,15 +3,16 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'twitter',
     name: 'reply-dm',
+    access: 'write',
     description: 'Send a message to recent DM conversations',
     domain: 'x.com',
     strategy: Strategy.UI,
     browser: true,
-    timeoutSeconds: 600, // 10 min — batch operation
     args: [
         { name: 'text', type: 'string', required: true, positional: true, help: 'Message text to send (e.g. "我的微信 wxkabi")' },
         { name: 'max', type: 'int', required: false, default: 20, help: 'Maximum number of conversations to reply to (default: 20)' },
         { name: 'skip-replied', type: 'boolean', required: false, default: true, help: 'Skip conversations where you already sent the same text (default: true)' },
+        { name: 'timeout', type: 'int', required: false, default: 600, help: 'Max seconds for the overall command (default: 600 — batch op)' },
     ],
     columns: ['index', 'status', 'user', 'message'],
     func: async (page, kwargs) => {

package/clis/twitter/reply.js

@@ -213,6 +213,7 @@ async function submitReply(page, text) {
 cli({
     site: 'twitter',
     name: 'reply',
+    access: 'write',
     description: 'Reply to a specific tweet, optionally with a local or remote image',
     domain: 'x.com',
     strategy: Strategy.UI, // Uses the UI directly to input and click post

package/clis/twitter/reply.test.js

@@ -4,35 +4,7 @@ import * as path from 'node:path';
 import { describe, expect, it, vi } from 'vitest';
 import { getRegistry } from '@jackwener/opencli/registry';
 import { __test__ } from './reply.js';
-function createPageMock(evaluateResults, overrides = {}) {
-    const evaluate = vi.fn();
-    for (const result of evaluateResults) {
-        evaluate.mockResolvedValueOnce(result);
-    }
-    return {
-        goto: 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: [] }),
-        wait: vi.fn().mockResolvedValue(undefined),
-        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),
-        ...overrides,
-    };
-}
+import { createPageMock } from '../test-utils.js';
 describe('twitter reply command', () => {
     it('uses the dedicated reply composer for text-only replies too', async () => {
         const cmd = getRegistry().get('twitter/reply');

package/clis/twitter/search.js

@@ -94,6 +94,7 @@ async function navigateToSearch(page, query, filter) {
 cli({
     site: 'twitter',
     name: 'search',
+    access: 'read',
     description: 'Search Twitter/X for tweets',
     domain: 'x.com',
     strategy: Strategy.INTERCEPT, // Use intercept strategy

package/clis/twitter/thread.js

@@ -95,6 +95,7 @@ function parseTweetDetail(data, seen) {
 cli({
     site: 'twitter',
     name: 'thread',
+    access: 'read',
     description: 'Get a tweet thread (original + all replies)',
     domain: 'x.com',
     strategy: Strategy.COOKIE,

package/clis/twitter/timeline.js

@@ -136,6 +136,7 @@ function parseHomeTimeline(data, seen) {
 cli({
     site: 'twitter',
     name: 'timeline',
+    access: 'read',
     description: 'Fetch Twitter timeline (for-you or following)',
     domain: 'x.com',
     strategy: Strategy.COOKIE,

package/clis/twitter/trending.js

@@ -1,9 +1,18 @@
 import { cli, Strategy } from '@jackwener/opencli/registry';
 import { AuthRequiredError, EmptyResultError } from '@jackwener/opencli/errors';
 // ── CLI definition ────────────────────────────────────────────────────
+//
+// X (Twitter) removed the post-count caption from each trend cell on the
+// /explore/tabs/trending page in 2024-2025. The DOM now only carries:
+//   divs[0] = rank + category (e.g. "1 · Trending in United States")
+//   divs[1] = topic
+//   divs[2..] = caret menu button (no post-count text)
+// We previously surfaced a `tweets` column whose value was permanently
+// "N/A" on every row — that's silent-wrong data, drop it.
 cli({
     site: 'twitter',
     name: 'trending',
+    access: 'read',
     description: 'Twitter/X trending topics',
     domain: 'x.com',
     strategy: Strategy.COOKIE,
@@ -11,7 +20,7 @@ cli({
     args: [
         { name: 'limit', type: 'int', default: 20, help: 'Number of trends to show' },
     ],
-    columns: ['rank', 'topic', 'tweets', 'category'],
+    columns: ['rank', 'topic', 'category'],
     func: async (page, kwargs) => {
         const limit = kwargs.limit || 20;
         // Navigate to trending page
@@ -23,9 +32,6 @@ cli({
     })()`);
         if (!ct0)
             throw new AuthRequiredError('x.com', 'Not logged into x.com (no ct0 cookie)');
-        // Scrape trends from DOM (consistent with what the user sees on the page)
-        // DOM children: [0] rank + category, [1] topic, optional post count,
-        // and a caret menu button identified by [data-testid="caret"].
         await page.wait(2);
         const trends = await page.evaluate(`(() => {
       const items = [];
@@ -41,14 +47,7 @@ cli({
         if (!topic) return;
         const catText = divs[0].textContent.trim();
         const category = catText.replace(/^\\d+\\s*/, '').replace(/^\\xB7\\s*/, '').trim();
-        // Find post count: skip rank, topic, and the caret menu button
-        let tweets = 'N/A';
-        for (let j = 2; j < divs.length; j++) {
-          if (divs[j].matches('[data-testid="caret"]') || divs[j].querySelector('[data-testid="caret"]')) continue;
-          const t = divs[j].textContent.trim();
-          if (t && /\\d/.test(t)) { tweets = t; break; }
-        }
-        items.push({ rank: items.length + 1, topic, tweets, category });
+        items.push({ rank: items.length + 1, topic, category });
       });
       return items;
     })()`);

package/clis/twitter/trending.test.js

@@ -0,0 +1,15 @@
+import { describe, expect, it } from 'vitest';
+import { getRegistry } from '@jackwener/opencli/registry';
+import './trending.js';
+
+describe('twitter trending', () => {
+    it('registers the trending command with rank/topic/category columns only', () => {
+        const cmd = getRegistry().get('twitter/trending');
+        expect(cmd).toBeDefined();
+        // The `tweets` column was permanently "N/A" because X removed the post-count
+        // caption from the trend cell; we drop it rather than keep returning a
+        // silent-wrong sentinel for every row. Guard against re-introduction.
+        expect(cmd.columns).toEqual(['rank', 'topic', 'category']);
+        expect(cmd.columns).not.toContain('tweets');
+    });
+});

package/clis/twitter/tweets.js

@@ -144,6 +144,7 @@ function parseUserTweets(data, seen) {
 cli({
     site: 'twitter',
     name: 'tweets',
+    access: 'read',
     description: "Fetch a Twitter user's most recent tweets (chronological, excludes pinned)",
     domain: 'x.com',
     strategy: Strategy.COOKIE,
@@ -152,7 +153,7 @@ cli({
         { name: 'username', type: 'string', positional: true, required: true, help: 'Twitter screen name (with or without @)' },
         { name: 'limit', type: 'int', default: 20, help: 'Max tweets to return' },
     ],
-    columns: ['author', 'created_at', 'is_retweet', 'text', 'likes', 'retweets', 'replies', 'views', 'url', 'has_media', 'media_urls'],
+    columns: ['id', 'author', 'created_at', 'is_retweet', 'text', 'likes', 'retweets', 'replies', 'views', 'url', 'has_media', 'media_urls'],
     func: async (page, kwargs) => {
         const limit = Math.max(1, Math.min(200, kwargs.limit || 20));
         const username = String(kwargs.username || '').replace(/^@/, '').trim();

package/clis/twitter/tweets.test.js

@@ -3,9 +3,9 @@ import { getRegistry } from '@jackwener/opencli/registry';
 import { __test__ } from './tweets.js';
 
 describe('twitter tweets helpers', () => {
-    it('registers is_retweet in the default columns', () => {
+    it('registers id and is_retweet in the default columns', () => {
         const cmd = getRegistry().get('twitter/tweets');
-        expect(cmd?.columns).toEqual(['author', 'created_at', 'is_retweet', 'text', 'likes', 'retweets', 'replies', 'views', 'url', 'has_media', 'media_urls']);
+        expect(cmd?.columns).toEqual(['id', 'author', 'created_at', 'is_retweet', 'text', 'likes', 'retweets', 'replies', 'views', 'url', 'has_media', 'media_urls']);
     });
 
     it('falls back when queryId contains unsafe characters', () => {

package/clis/twitter/unblock.js

@@ -3,6 +3,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'twitter',
     name: 'unblock',
+    access: 'write',
     description: 'Unblock a Twitter user',
     domain: 'x.com',
     strategy: Strategy.UI,

package/clis/twitter/unbookmark.js

@@ -3,6 +3,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'twitter',
     name: 'unbookmark',
+    access: 'write',
     description: 'Remove a tweet from bookmarks',
     domain: 'x.com',
     strategy: Strategy.UI,

package/clis/twitter/unfollow.js

@@ -3,6 +3,7 @@ import { CommandExecutionError } from '@jackwener/opencli/errors';
 cli({
     site: 'twitter',
     name: 'unfollow',
+    access: 'write',
     description: 'Unfollow a Twitter user',
     domain: 'x.com',
     strategy: Strategy.UI,

package/clis/uisdc/news.js

@@ -0,0 +1,105 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { ArgumentError, CommandExecutionError, EmptyResultError, getErrorMessage } from '@jackwener/opencli/errors';
+
+const UISDC_NEWS_URL = 'https://www.uisdc.com/news';
+const DEFAULT_LIMIT = 20;
+const MAX_LIMIT = 50;
+
+function normalizeLimit(value) {
+    const raw = value ?? DEFAULT_LIMIT;
+    const limit = Number(raw);
+    if (!Number.isInteger(limit) || limit <= 0) {
+        throw new ArgumentError('limit must be a positive integer', `Example: opencli uisdc news --limit ${DEFAULT_LIMIT}`);
+    }
+    if (limit > MAX_LIMIT) {
+        throw new ArgumentError(`limit must be <= ${MAX_LIMIT}`, `Example: opencli uisdc news --limit ${MAX_LIMIT}`);
+    }
+    return limit;
+}
+
+function normalizeText(value) {
+    return String(value ?? '').replace(/\s+/g, ' ').trim();
+}
+
+function buildExtractUisdcNewsJs() {
+    return `
+      (() => {
+        const cards = Array.from(document.querySelectorAll(
+          '.news-list > .news-item:first-child > .item-content > .dubao-items > .dubao-item'
+        ));
+        if (cards.length === 0) {
+          return {
+            ok: false,
+            reason: 'selector-missing',
+            title: document.title || '',
+            bodyText: (document.body?.innerText || document.body?.textContent || '').slice(0, 500),
+          };
+        }
+        const rows = cards.map((el, index) => {
+          const anchor = el.querySelector('a[href]');
+          return {
+            rank: index + 1,
+            title: el.querySelector('.dubao-title')?.textContent || '',
+            summary: el.querySelector('.dubao-content')?.textContent || '',
+            url: anchor ? new URL(anchor.getAttribute('href'), location.href).href : '',
+          };
+        });
+        return { ok: true, rows };
+      })()
+    `;
+}
+
+function toRows(payload, limit) {
+    if (!payload || typeof payload !== 'object') {
+        throw new CommandExecutionError('UISDC news page returned an unreadable payload');
+    }
+    if (!payload.ok) {
+        const reason = typeof payload.reason === 'string' && payload.reason.trim() ? payload.reason.trim() : 'selector-drift';
+        throw new CommandExecutionError(
+            `UISDC news selector drift: ${reason}`,
+            payload.title ? `Page title: ${payload.title}` : undefined,
+        );
+    }
+    const rows = (Array.isArray(payload.rows) ? payload.rows : [])
+        .map((row, index) => ({
+            rank: index + 1,
+            title: normalizeText(row.title),
+            summary: normalizeText(row.summary),
+            url: normalizeText(row.url),
+        }))
+        .filter((row) => row.title && row.url);
+    if (rows.length === 0) {
+        throw new EmptyResultError('uisdc news', 'UISDC news page loaded, but no news rows with title and URL were extracted.');
+    }
+    return rows.slice(0, limit).map((row, index) => ({ ...row, rank: index + 1 }));
+}
+
+async function loadUisdcNews(page, args) {
+    const limit = normalizeLimit(args.limit);
+    await page.goto(UISDC_NEWS_URL, { waitUntil: 'load', settleMs: 3000 });
+    const payload = await page.evaluate(buildExtractUisdcNewsJs()).catch((error) => {
+        throw new CommandExecutionError(`Failed to extract UISDC news: ${getErrorMessage(error)}`);
+    });
+    return toRows(payload, limit);
+}
+
+export const uisdcNewsCommand = cli({
+    site: 'uisdc',
+    name: 'news',
+    access: 'read',
+    description: '优设读报 - 最新 AI/设计行业新闻',
+    domain: 'www.uisdc.com',
+    strategy: Strategy.PUBLIC,
+    browser: true,
+    args: [
+        { name: 'limit', type: 'int', default: DEFAULT_LIMIT, help: `Number of news items to return (max ${MAX_LIMIT})` },
+    ],
+    columns: ['rank', 'title', 'summary', 'url'],
+    func: loadUisdcNews,
+});
+
+export const __test__ = {
+    buildExtractUisdcNewsJs,
+    normalizeLimit,
+    toRows,
+};

package/clis/uisdc/news.test.js

@@ -0,0 +1,66 @@
+import { JSDOM } from 'jsdom';
+import { describe, expect, it, vi } from 'vitest';
+import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
+import { uisdcNewsCommand, __test__ } from './news.js';
+
+function runBrowserScript(html, script, url = 'https://www.uisdc.com/news') {
+    const dom = new JSDOM(html, { url, runScripts: 'outside-only' });
+    return dom.window.eval(script);
+}
+
+function makePage(evaluateResult) {
+    return {
+        goto: vi.fn().mockResolvedValue(undefined),
+        evaluate: vi.fn().mockResolvedValue(evaluateResult),
+    };
+}
+
+describe('uisdc/news', () => {
+    it('registers stable URL in columns', () => {
+        expect(uisdcNewsCommand.access).toBe('read');
+        expect(uisdcNewsCommand.columns).toEqual(['rank', 'title', 'summary', 'url']);
+    });
+
+    it('validates limit before browser navigation', async () => {
+        const page = makePage({ ok: true, rows: [] });
+        await expect(uisdcNewsCommand.func(page, { limit: 0 })).rejects.toBeInstanceOf(ArgumentError);
+        await expect(uisdcNewsCommand.func(page, { limit: 51 })).rejects.toBeInstanceOf(ArgumentError);
+        expect(page.goto).not.toHaveBeenCalled();
+    });
+
+    it('extracts rows from the UISDC news DOM', async () => {
+        const html = `
+          <div class="news-list">
+            <div class="news-item">
+              <div class="item-content">
+                <div class="dubao-items">
+                  <div class="dubao-item">
+                    <a href="/article-1"><span class="dubao-title"> AI design news </span></a>
+                    <div class="dubao-content"> summary text </div>
+                  </div>
+                </div>
+              </div>
+            </div>
+          </div>
+        `;
+        const payload = runBrowserScript(html, __test__.buildExtractUisdcNewsJs());
+        const page = makePage(payload);
+
+        const rows = await uisdcNewsCommand.func(page, { limit: 10 });
+
+        expect(page.goto).toHaveBeenCalledWith('https://www.uisdc.com/news', { waitUntil: 'load', settleMs: 3000 });
+        expect(rows).toEqual([{
+            rank: 1,
+            title: 'AI design news',
+            summary: 'summary text',
+            url: 'https://www.uisdc.com/article-1',
+        }]);
+    });
+
+    it('maps selector drift and empty rows to typed errors', async () => {
+        await expect(uisdcNewsCommand.func(makePage({ ok: false, reason: 'selector-missing' }), { limit: 1 }))
+            .rejects.toBeInstanceOf(CommandExecutionError);
+        await expect(uisdcNewsCommand.func(makePage({ ok: true, rows: [{ title: '', url: '' }] }), { limit: 1 }))
+            .rejects.toBeInstanceOf(EmptyResultError);
+    });
+});

package/clis/uiverse/code.js

@@ -10,6 +10,7 @@ import {
 cli({
   site: 'uiverse',
   name: 'code',
+    access: 'read',
   description: 'Export Uiverse component code (HTML, CSS, React, or Vue)',
   domain: 'uiverse.io',
   strategy: Strategy.PUBLIC,

package/clis/uiverse/preview.js

@@ -10,6 +10,7 @@ import {
 cli({
   site: 'uiverse',
   name: 'preview',
+    access: 'read',
   description: 'Capture a screenshot of the Uiverse preview element',
   domain: 'uiverse.io',
   strategy: Strategy.PUBLIC,

package/clis/v2ex/daily.js

@@ -6,6 +6,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'v2ex',
     name: 'daily',
+    access: 'write',
     description: 'V2EX 每日签到并领取铜币',
     domain: 'www.v2ex.com',
     strategy: Strategy.COOKIE,

package/clis/v2ex/hot.js

@@ -2,6 +2,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'v2ex',
     name: 'hot',
+    access: 'read',
     description: 'V2EX 热门话题',
     domain: 'www.v2ex.com',
     strategy: Strategy.PUBLIC,

package/clis/v2ex/latest.js

@@ -2,6 +2,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'v2ex',
     name: 'latest',
+    access: 'read',
     description: 'V2EX 最新话题',
     domain: 'www.v2ex.com',
     strategy: Strategy.PUBLIC,

package/clis/v2ex/me.js

@@ -6,6 +6,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'v2ex',
     name: 'me',
+    access: 'read',
     description: 'V2EX 获取个人资料 (余额/未读提醒)',
     domain: 'www.v2ex.com',
     strategy: Strategy.COOKIE,

package/clis/v2ex/member.js

@@ -2,6 +2,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'v2ex',
     name: 'member',
+    access: 'read',
     description: 'V2EX 用户资料',
     domain: 'www.v2ex.com',
     strategy: Strategy.PUBLIC,

package/clis/v2ex/node.js

@@ -2,6 +2,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'v2ex',
     name: 'node',
+    access: 'read',
     description: 'V2EX 节点话题列表',
     domain: 'www.v2ex.com',
     strategy: Strategy.PUBLIC,

package/clis/v2ex/nodes.js

@@ -2,6 +2,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'v2ex',
     name: 'nodes',
+    access: 'read',
     description: 'V2EX 所有节点列表',
     domain: 'www.v2ex.com',
     strategy: Strategy.PUBLIC,

package/clis/v2ex/notifications.js

@@ -6,6 +6,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'v2ex',
     name: 'notifications',
+    access: 'read',
     description: 'V2EX 获取提醒 (回复/由于)',
     domain: 'www.v2ex.com',
     strategy: Strategy.COOKIE,

package/clis/v2ex/replies.js

@@ -2,6 +2,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'v2ex',
     name: 'replies',
+    access: 'read',
     description: 'V2EX 主题回复列表',
     domain: 'www.v2ex.com',
     strategy: Strategy.PUBLIC,

package/clis/v2ex/topic.js

@@ -2,6 +2,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'v2ex',
     name: 'topic',
+    access: 'read',
     description: 'V2EX 主题详情和回复',
     domain: 'www.v2ex.com',
     strategy: Strategy.PUBLIC,

package/clis/v2ex/user.js

@@ -2,6 +2,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 cli({
     site: 'v2ex',
     name: 'user',
+    access: 'read',
     description: 'V2EX 用户发帖列表',
     domain: 'www.v2ex.com',
     strategy: Strategy.PUBLIC,

package/clis/wanfang/search.js

@@ -4,6 +4,7 @@ import { clampInt, requireNonEmptyQuery } from '../_shared/common.js';
 cli({
     site: 'wanfang',
     name: 'search',
+    access: 'read',
     description: '万方数据论文搜索',
     domain: 's.wanfangdata.com.cn',
     strategy: Strategy.PUBLIC,
@@ -13,7 +14,6 @@ cli({
         { name: 'limit', type: 'int', default: 10, help: '返回结果数量 (max 20)' },
     ],
     columns: ['rank', 'title', 'authors', 'source', 'year', 'type', 'cited', 'url'],
-    navigateBefore: false,
     func: async (page, kwargs) => {
         const limit = clampInt(kwargs.limit, 10, 1, 20);
         const query = requireNonEmptyQuery(kwargs.query);