@jackwener/opencli 1.6.0 → 1.6.2

package/dist/launcher.test.js

@@ -1,12 +1,24 @@
 import { describe, it, expect, vi, beforeEach } from 'vitest';
-import { probeCDP, detectProcess, discoverAppPath } from './launcher.js';
+import { detectProcess, discoverAppPath, launchDetachedApp, launchElectronApp, probeCDP, resolveExecutableCandidates } from './launcher.js';
+function createMockChildProcess() {
+    const listeners = new Map();
+    return {
+        once: vi.fn((event, handler) => {
+            listeners.set(event, [...(listeners.get(event) ?? []), handler]);
+        }),
+        off: vi.fn((event, handler) => {
+            listeners.set(event, (listeners.get(event) ?? []).filter((listener) => listener !== handler));
+        }),
+        unref: vi.fn(),
+        emit: (event, value) => {
+            for (const listener of listeners.get(event) ?? [])
+                listener(value);
+        },
+    };
+}
 vi.mock('node:child_process', () => ({
     execFileSync: vi.fn(),
-    spawn: vi.fn(() => ({
-        unref: vi.fn(),
-        pid: 12345,
-        on: vi.fn(),
-    })),
+    spawn: vi.fn(),
 }));
 const cp = vi.mocked(await import('node:child_process'));
 describe('probeCDP', () => {
@@ -28,7 +40,7 @@ describe('detectProcess', () => {
         const result = detectProcess('NonExistentApp');
         expect(result).toBe(false);
     });
-    it('returns true when pgrep finds a process', () => {
+    it.skipIf(process.platform === 'win32')('returns true when pgrep finds a process', () => {
         cp.execFileSync.mockReturnValue('12345\n');
         const result = detectProcess('Cursor');
         expect(result).toBe(true);
@@ -55,3 +67,72 @@ describe('discoverAppPath', () => {
         expect(result).toBeNull();
     });
 });
+describe('launchDetachedApp', () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+        cp.spawn.mockReset();
+    });
+    it('unrefs the process after spawn succeeds', async () => {
+        const child = createMockChildProcess();
+        cp.spawn.mockImplementation(() => {
+            queueMicrotask(() => child.emit('spawn'));
+            return child;
+        });
+        await expect(launchDetachedApp('/Applications/Antigravity.app/Contents/MacOS/Antigravity', ['--remote-debugging-port=9234'], 'Antigravity'))
+            .resolves
+            .toBeUndefined();
+        expect(child.unref).toHaveBeenCalledTimes(1);
+    });
+    it('converts ENOENT into a controlled launch error', async () => {
+        const child = createMockChildProcess();
+        cp.spawn.mockImplementation(() => {
+            queueMicrotask(() => child.emit('error', Object.assign(new Error('missing binary'), { code: 'ENOENT' })));
+            return child;
+        });
+        await expect(launchDetachedApp('/Applications/Antigravity.app/Contents/MacOS/Antigravity', ['--remote-debugging-port=9234'], 'Antigravity'))
+            .rejects
+            .toThrow('Could not launch Antigravity');
+        expect(child.unref).not.toHaveBeenCalled();
+    });
+});
+describe('resolveExecutableCandidates', () => {
+    it('prefers explicit executable candidates over processName', () => {
+        const app = {
+            port: 9234,
+            processName: 'Antigravity',
+            executableNames: ['Electron', 'Antigravity'],
+        };
+        expect(resolveExecutableCandidates('/Applications/Antigravity.app', app)).toEqual([
+            '/Applications/Antigravity.app/Contents/MacOS/Electron',
+            '/Applications/Antigravity.app/Contents/MacOS/Antigravity',
+        ]);
+    });
+});
+describe('launchElectronApp', () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+        cp.spawn.mockReset();
+    });
+    it('falls back to the next executable candidate when the first is missing', async () => {
+        const firstChild = createMockChildProcess();
+        const secondChild = createMockChildProcess();
+        const app = {
+            port: 9234,
+            processName: 'Antigravity',
+            executableNames: ['Electron', 'Antigravity'],
+        };
+        cp.spawn
+            .mockImplementationOnce(() => {
+            queueMicrotask(() => firstChild.emit('error', Object.assign(new Error('missing binary'), { code: 'ENOENT' })));
+            return firstChild;
+        })
+            .mockImplementationOnce(() => {
+            queueMicrotask(() => secondChild.emit('spawn'));
+            return secondChild;
+        });
+        await expect(launchElectronApp('/Applications/Antigravity.app', app, ['--remote-debugging-port=9234'], 'Antigravity')).resolves.toBeUndefined();
+        expect(cp.spawn).toHaveBeenNthCalledWith(1, '/Applications/Antigravity.app/Contents/MacOS/Electron', ['--remote-debugging-port=9234'], { detached: true, stdio: 'ignore' });
+        expect(cp.spawn).toHaveBeenNthCalledWith(2, '/Applications/Antigravity.app/Contents/MacOS/Antigravity', ['--remote-debugging-port=9234'], { detached: true, stdio: 'ignore' });
+        expect(secondChild.unref).toHaveBeenCalledTimes(1);
+    });
+});

package/dist/output.d.ts

@@ -3,6 +3,8 @@
  */
 export interface RenderOptions {
     fmt?: string;
+    /** True when the user explicitly passed -f on the command line */
+    fmtExplicit?: boolean;
     columns?: string[];
     title?: string;
     elapsed?: number;

package/dist/output.js

@@ -15,7 +15,16 @@ function resolveColumns(rows, opts) {
     return opts.columns ?? Object.keys(rows[0] ?? {});
 }
 export function render(data, opts = {}) {
-    const fmt = opts.fmt ?? 'table';
+    let fmt = opts.fmt ?? 'table';
+    // Non-TTY auto-downgrade only when format was NOT explicitly passed by user.
+    // Priority: explicit -f (any value) > OUTPUT env var > TTY auto-detect > table
+    if (!opts.fmtExplicit) {
+        const envFmt = process.env.OUTPUT?.trim().toLowerCase();
+        if (envFmt)
+            fmt = envFmt;
+        else if (fmt === 'table' && !process.stdout.isTTY)
+            fmt = 'yaml';
+    }
     if (data === null || data === undefined) {
         console.log(data);
         return;

package/dist/output.test.d.ts

@@ -1,4 +1 @@
-/**
- * Tests for output.ts: render function format coverage.
- */
 export {};

package/dist/output.test.js

@@ -1,95 +1,62 @@
-/**
- * Tests for output.ts: render function format coverage.
- */
-import { describe, it, expect, vi, afterEach } from 'vitest';
+import { describe, expect, it, vi, beforeEach, afterEach } from 'vitest';
 import { render } from './output.js';
-afterEach(() => {
-    vi.restoreAllMocks();
-});
-describe('render', () => {
-    it('renders JSON output', () => {
-        const log = vi.spyOn(console, 'log').mockImplementation(() => { });
-        render([{ title: 'Hello', rank: 1 }], { fmt: 'json' });
-        expect(log).toHaveBeenCalledOnce();
-        const output = log.mock.calls[0]?.[0];
-        const parsed = JSON.parse(output);
-        expect(parsed).toEqual([{ title: 'Hello', rank: 1 }]);
-    });
-    it('renders Markdown table output', () => {
-        const log = vi.spyOn(console, 'log').mockImplementation(() => { });
-        render([{ name: 'Alice', score: 100 }], { fmt: 'md', columns: ['name', 'score'] });
-        const calls = log.mock.calls.map(c => c[0]);
-        expect(calls[0]).toContain('| name | score |');
-        expect(calls[1]).toContain('| --- | --- |');
-        expect(calls[2]).toContain('| Alice | 100 |');
-    });
-    it('renders CSV output with proper quoting', () => {
-        const log = vi.spyOn(console, 'log').mockImplementation(() => { });
-        render([{ name: 'Alice, Bob', value: 'say "hi"' }], { fmt: 'csv' });
-        const calls = log.mock.calls.map(c => c[0]);
-        // Header
-        expect(calls[0]).toBe('name,value');
-        // Values with commas/quotes are quoted
-        expect(calls[1]).toContain('"Alice, Bob"');
-        expect(calls[1]).toContain('"say ""hi"""');
-    });
-    it('handles null and undefined data', () => {
-        const log = vi.spyOn(console, 'log').mockImplementation(() => { });
-        render(null, { fmt: 'json' });
-        expect(log).toHaveBeenCalledWith(null);
-    });
-    it('renders single object as single-row table', () => {
-        const log = vi.spyOn(console, 'log').mockImplementation(() => { });
-        render({ title: 'Test' }, { fmt: 'json' });
-        const output = log.mock.calls[0]?.[0];
-        const parsed = JSON.parse(output);
-        expect(parsed).toEqual({ title: 'Test' });
-    });
-    it('handles empty array gracefully', () => {
-        const log = vi.spyOn(console, 'log').mockImplementation(() => { });
-        render([], { fmt: 'table' });
-        // Should show "(no data)" for empty arrays
-        expect(log).toHaveBeenCalled();
-    });
-    it('uses custom columns for CSV', () => {
-        const log = vi.spyOn(console, 'log').mockImplementation(() => { });
-        render([{ a: 1, b: 2, c: 3 }], { fmt: 'csv', columns: ['a', 'c'] });
-        const calls = log.mock.calls.map(c => c[0]);
-        expect(calls[0]).toBe('a,c');
-        expect(calls[1]).toBe('1,3');
-    });
-    it('renders YAML output', () => {
-        const log = vi.spyOn(console, 'log').mockImplementation(() => { });
-        render([{ title: 'Hello', rank: 1 }], { fmt: 'yaml' });
-        expect(log).toHaveBeenCalledOnce();
-        expect(log.mock.calls[0]?.[0]).toContain('- title: Hello');
-        expect(log.mock.calls[0]?.[0]).toContain('rank: 1');
-    });
-    it('renders yml alias as YAML output', () => {
-        const log = vi.spyOn(console, 'log').mockImplementation(() => { });
-        render({ title: 'Hello' }, { fmt: 'yml' });
-        expect(log).toHaveBeenCalledOnce();
-        expect(log.mock.calls[0]?.[0]).toContain('title: Hello');
-    });
-    it('handles null values in CSV cells', () => {
-        const log = vi.spyOn(console, 'log').mockImplementation(() => { });
-        render([{ name: 'test', value: null }], { fmt: 'csv' });
-        const calls = log.mock.calls.map(c => c[0]);
-        expect(calls[1]).toBe('test,');
-    });
-    it('renders single-field rows in plain mode as the bare value', () => {
-        const log = vi.spyOn(console, 'log').mockImplementation(() => { });
-        render([{ response: 'Gemini says hi' }], { fmt: 'plain' });
-        expect(log).toHaveBeenCalledWith('Gemini says hi');
-    });
-    it('renders multi-field rows in plain mode as key-value lines', () => {
-        const log = vi.spyOn(console, 'log').mockImplementation(() => { });
-        render([{ status: 'ok', file: '~/tmp/a.png', link: 'https://example.com' }], { fmt: 'plain' });
-        const calls = log.mock.calls.map(c => c[0]);
-        expect(calls).toEqual([
-            'status: ok',
-            'file: ~/tmp/a.png',
-            'link: https://example.com',
-        ]);
+describe('output TTY detection', () => {
+    const originalIsTTY = process.stdout.isTTY;
+    const originalEnv = process.env.OUTPUT;
+    let logSpy;
+    beforeEach(() => {
+        logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+    });
+    afterEach(() => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: originalIsTTY, writable: true });
+        if (originalEnv === undefined)
+            delete process.env.OUTPUT;
+        else
+            process.env.OUTPUT = originalEnv;
+        logSpy.mockRestore();
+    });
+    it('outputs YAML in non-TTY when format is default table', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: false, writable: true });
+        // commanderAdapter always passes fmt:'table' as default — this must still trigger downgrade
+        render([{ name: 'alice', score: 10 }], { fmt: 'table', columns: ['name', 'score'] });
+        const out = logSpy.mock.calls.map((c) => c[0]).join('\n');
+        expect(out).toContain('name: alice');
+        expect(out).toContain('score: 10');
+    });
+    it('outputs table in TTY when format is default table', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, writable: true });
+        render([{ name: 'alice', score: 10 }], { fmt: 'table', columns: ['name', 'score'] });
+        const out = logSpy.mock.calls.map((c) => c[0]).join('\n');
+        expect(out).toContain('alice');
+    });
+    it('respects explicit -f json even in non-TTY', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: false, writable: true });
+        render([{ name: 'alice' }], { fmt: 'json' });
+        const out = logSpy.mock.calls.map((c) => c[0]).join('\n');
+        expect(JSON.parse(out)).toEqual([{ name: 'alice' }]);
+    });
+    it('OUTPUT env var overrides default table in non-TTY', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: false, writable: true });
+        process.env.OUTPUT = 'json';
+        render([{ name: 'alice' }], { fmt: 'table' });
+        const out = logSpy.mock.calls.map((c) => c[0]).join('\n');
+        expect(JSON.parse(out)).toEqual([{ name: 'alice' }]);
+    });
+    it('explicit -f flag takes precedence over OUTPUT env var', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: false, writable: true });
+        process.env.OUTPUT = 'json';
+        render([{ name: 'alice' }], { fmt: 'csv', fmtExplicit: true });
+        const out = logSpy.mock.calls.map((c) => c[0]).join('\n');
+        expect(out).toContain('name');
+        expect(out).toContain('alice');
+        expect(out).not.toContain('"name"'); // not JSON
+    });
+    it('explicit -f table overrides non-TTY auto-downgrade', () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: false, writable: true });
+        render([{ name: 'alice' }], { fmt: 'table', fmtExplicit: true, columns: ['name'] });
+        const out = logSpy.mock.calls.map((c) => c[0]).join('\n');
+        // Should be table output, not YAML
+        expect(out).not.toContain('name: alice');
+        expect(out).toContain('alice');
     });
 });

package/dist/pipeline/executor.test.js

@@ -17,8 +17,6 @@ function createMockPage(overrides = {}) {
         getFormState: vi.fn().mockResolvedValue({}),
         wait: vi.fn(),
         tabs: vi.fn().mockResolvedValue([]),
-        closeTab: vi.fn(),
-        newTab: vi.fn(),
         selectTab: vi.fn(),
         networkRequests: vi.fn().mockResolvedValue([]),
         consoleMessages: vi.fn().mockResolvedValue(''),

package/dist/pipeline/steps/download.test.js

@@ -29,8 +29,6 @@ function createMockPage(getCookies) {
         getFormState: vi.fn().mockResolvedValue({}),
         wait: vi.fn(),
         tabs: vi.fn().mockResolvedValue([]),
-        closeTab: vi.fn(),
-        newTab: vi.fn(),
         selectTab: vi.fn(),
         networkRequests: vi.fn().mockResolvedValue([]),
         consoleMessages: vi.fn().mockResolvedValue([]),

package/dist/registry.d.ts

@@ -14,6 +14,7 @@ export interface Arg {
     type?: string;
     default?: unknown;
     required?: boolean;
+    valueRequired?: boolean;
     positional?: boolean;
     help?: string;
     choices?: string[];
@@ -40,6 +41,7 @@ export interface CliCommand {
     source?: string;
     footerExtra?: (kwargs: CommandArgs) => string | undefined;
     requiredEnv?: RequiredEnv[];
+    validateArgs?: (kwargs: CommandArgs) => void;
     /** Deprecation note shown in help / execution warnings. */
     deprecated?: boolean | string;
     /** Preferred replacement command, if any. */

package/dist/serialization.d.ts

@@ -9,6 +9,7 @@ export type SerializedArg = {
     name: string;
     type: string;
     required: boolean;
+    valueRequired: boolean;
     positional: boolean;
     choices: string[];
     default: unknown;

package/dist/serialization.js

@@ -11,6 +11,7 @@ export function serializeArg(a) {
         name: a.name,
         type: a.type ?? 'string',
         required: !!a.required,
+        valueRequired: !!a.valueRequired,
         positional: !!a.positional,
         choices: a.choices ?? [],
         default: a.default ?? null,

package/dist/types.d.ts

@@ -56,8 +56,8 @@ export interface IPage {
     getFormState(): Promise<any>;
     wait(options: number | WaitOptions): Promise<void>;
     tabs(): Promise<any>;
-    closeTab(index?: number): Promise<void>;
-    newTab(): Promise<void>;
+    closeTab?(index?: number): Promise<void>;
+    newTab?(): Promise<void>;
     selectTab(index: number): Promise<void>;
     networkRequests(includeStatic?: boolean): Promise<any>;
     consoleMessages(level?: string): Promise<any>;
@@ -70,11 +70,18 @@ export interface IPage {
     getInterceptedRequests(): Promise<any[]>;
     waitForCapture(timeout?: number): Promise<void>;
     screenshot(options?: ScreenshotOptions): Promise<string>;
+    startNetworkCapture?(pattern?: string): Promise<void>;
+    readNetworkCapture?(): Promise<unknown[]>;
     /**
      * Set local file paths on a file input element via CDP DOM.setFileInputFiles.
      * Chrome reads the files directly — no base64 encoding or payload size limits.
      */
     setFileInput?(files: string[], selector?: string): Promise<void>;
+    /**
+     * Insert text via native CDP Input.insertText into the currently focused element.
+     * Useful for rich editors that ignore synthetic DOM value/text mutations.
+     */
+    insertText?(text: string): Promise<void>;
     closeWindow?(): Promise<void>;
     /** Returns the current page URL, or null if unavailable. */
     getCurrentUrl?(): Promise<string | null>;

package/docs/.vitepress/config.mts

@@ -54,6 +54,7 @@ export default defineConfig({
                 { text: 'Bilibili', link: '/adapters/browser/bilibili' },
                 { text: 'Zhihu', link: '/adapters/browser/zhihu' },
                 { text: 'Xiaohongshu', link: '/adapters/browser/xiaohongshu' },
+                { text: 'Xiaoe', link: '/adapters/browser/xiaoe' },
                 { text: 'Weibo', link: '/adapters/browser/weibo' },
                 { text: 'YouTube', link: '/adapters/browser/youtube' },
                 { text: 'Xueqiu', link: '/adapters/browser/xueqiu' },
@@ -73,7 +74,9 @@ export default defineConfig({
                 { text: 'Chaoxing', link: '/adapters/browser/chaoxing' },
                 { text: 'Grok', link: '/adapters/browser/grok' },
                 { text: 'Amazon', link: '/adapters/browser/amazon' },
+                { text: '1688', link: '/adapters/browser/1688' },
                 { text: 'Gemini', link: '/adapters/browser/gemini' },
+                { text: 'Yuanbao', link: '/adapters/browser/yuanbao' },
                 { text: 'NotebookLM', link: '/adapters/browser/notebooklm' },
                 { text: 'WeRead', link: '/adapters/browser/weread' },
                 { text: 'Douban', link: '/adapters/browser/douban' },
@@ -91,6 +94,7 @@ export default defineConfig({
                 { text: 'TikTok', link: '/adapters/browser/tiktok' },
                 { text: 'Web (Generic)', link: '/adapters/browser/web' },
                 { text: 'Weixin', link: '/adapters/browser/weixin' },
+                { text: 'Xianyu', link: '/adapters/browser/xianyu' },
               ],
             },
             {

package/docs/adapters/browser/1688.md

@@ -0,0 +1,52 @@
+# 1688
+
+**Mode**: 🔐 Browser · **Domain**: `1688.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli 1688 search "<query>" --limit <n>` | Search public product candidates with price, MOQ, seller link, and visible badges |
+| `opencli 1688 item <url-or-offer-id>` | Read a public product detail page with price tiers, MOQ, delivery text, and seller basics |
+| `opencli 1688 store <url-or-member-id>` | Read a public supplier/store page with company info, years on platform, categories, and visible service signals |
+
+## Usage Examples
+
+```bash
+# Search products
+opencli 1688 search "桌面置物架 宿舍 收纳" --limit 10
+
+# JSON output
+opencli 1688 search "桌面置物架 宿舍 收纳" --limit 10 -f json
+
+# Read an item by offer id
+opencli 1688 item 841141931191 -f json
+
+# Read an item by URL
+opencli 1688 item https://detail.1688.com/offer/841141931191.html -f json
+
+# Read a supplier store
+opencli 1688 store https://shop52908bfw19166.1688.com/ -f json
+
+# Read a supplier by member id
+opencli 1688 store b2b-22154705262941f196 -f json
+```
+
+## Prerequisites
+
+- Chrome running and **logged into** `1688.com`
+- [Browser Bridge extension](/guide/browser-bridge) installed
+
+## Notes
+
+- This adapter only returns fields visible on public pages. It does not send inquiries, place orders, or access seller back office data.
+- Prefer stable identifiers such as `offer_id`, `member_id`, and `shop_id` for follow-up workflows.
+- `search --limit` defaults to `20` and is capped at `100`.
+- `search` deduplicates with key priority: `offer_id` first, then canonical `item_url`.
+- `item` can be more sensitive to the active browser target than `search` or `store`.
+
+## Troubleshooting
+
+- If `opencli 1688 item` reports `did not expose product context`, first make sure the open page is a real `detail.1688.com` item page.
+- If the browser target is too broad, retry with `OPENCLI_CDP_TARGET=detail.1688.com`.
+- If you hit a slider or verification page, refresh the real page in Chrome and retry.

package/docs/adapters/browser/36kr.md

@@ -44,4 +44,5 @@ opencli 36kr hot -f json
 
 ## Prerequisites
 
-- No browser required — uses public API
+- `news`: No browser required — uses public RSS feed
+- `hot`, `search`, `article`: Chrome running with [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/doubao.md

@@ -11,12 +11,16 @@ Browser adapter for [Doubao Chat](https://www.doubao.com/chat).
 | `opencli doubao send "..."` | Send a message to the current Doubao chat |
 | `opencli doubao read` | Read the visible Doubao conversation |
 | `opencli doubao ask "..."` | Send a prompt and wait for a reply |
+| `opencli doubao detail <id>` | 对话详情 |
+| `opencli doubao history` | 历史对话列表 |
+| `opencli doubao meeting-summary <id>` | 会议总结 |
+| `opencli doubao meeting-transcript <id>` | 会议记录 |
 
 ## Prerequisites
 
 - Chrome is running
 - You are already logged into [doubao.com](https://www.doubao.com/)
-- Playwright MCP Bridge / browser bridge is configured for OpenCLI
+- Browser Bridge extension is installed and enabled for OpenCLI
 
 ## Examples
 

package/docs/adapters/browser/hupu.md

@@ -0,0 +1,53 @@
+# Hupu (虎扑)
+
+**Mode**: 🌐 Public / 🔐 Browser · **Domain**: `bbs.hupu.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli hupu hot` | Read Hupu hot threads |
+| `opencli hupu search <keyword>` | Search Hupu threads by keyword |
+| `opencli hupu detail <tid>` | Read one thread and optional hot replies |
+| `opencli hupu reply <tid> <text>` | Reply to a thread or quote one reply |
+| `opencli hupu like <tid> <pid>` | Like one reply |
+| `opencli hupu unlike <tid> <pid>` | Cancel like on one reply |
+
+## Usage Examples
+
+```bash
+# Hot threads
+opencli hupu hot --limit 5
+
+# Search threads
+opencli hupu search 湖人 --limit 10
+
+# Read one thread and include hot replies
+opencli hupu detail 638234927 --replies true
+
+# Reply to the thread
+opencli hupu reply 638234927 "hello from opencli" --topic_id 502
+
+# Quote one hot reply by pid
+opencli hupu reply 638234927 "replying to this comment" --topic_id 502 --quote_id 174908
+
+# Like / unlike one reply
+opencli hupu like 638234927 174908 --fid 4860
+opencli hupu unlike 638234927 174908 --fid 4860
+
+# JSON output
+opencli hupu detail 638234927 -f json
+```
+
+## Notes
+
+- `reply --topic_id` maps to Hupu's API `topicId`, for example `502` for Basketball News
+- `reply --quote_id` is the quoted reply `pid`
+- `like` / `unlike --fid` uses the forum ID from thread metadata
+- `detail --replies true` appends top hot replies to the content field
+
+## Prerequisites
+
+- Chrome running and able to open `bbs.hupu.com`
+- [Browser Bridge extension](/guide/browser-bridge) installed
+- For `reply`, `like`, and `unlike`, a valid Hupu login session in Chrome is required

package/docs/adapters/browser/sinafinance.md

@@ -9,6 +9,7 @@
 | `opencli sinafinance news` | 新浪财经 7×24 小时实时快讯 | 🌐 Public |
 | `opencli sinafinance rolling-news` | 新浪财经滚动新闻 | 🔐 Browser |
 | `opencli sinafinance stock` | 新浪财经行情（A股/港股/美股） | 🌐 Public |
+| `opencli sinafinance stock-rank` | 新浪财经热搜榜 | 🔐 Browser |
 
 ## Usage Examples
 
@@ -56,6 +57,28 @@ opencli sinafinance stock 招商证券
 opencli sinafinance stock 贵州茅台 -f json
 ```
 
+### stock-rank - 热搜榜
+
+```bash
+# Default A股热搜榜
+opencli sinafinance stock-rank
+
+# 港股热搜榜
+opencli sinafinance stock-rank --market hk
+
+# 美股热搜榜
+opencli sinafinance stock-rank --market us
+
+# 外汇热搜榜
+opencli sinafinance stock-rank --market ft
+
+# 期货热搜榜
+opencli sinafinance stock-rank --market wh
+
+# JSON output
+opencli sinafinance stock-rank -f json
+```
+
 ## Options
 
 ### news
@@ -71,11 +94,17 @@ opencli sinafinance stock 贵州茅台 -f json
 |--------|-------------|
 | `--market` | Market: `cn`, `hk`, `us`, `auto` (default: auto). When `auto`, searches in cn, hk, us order |
 
+### stock-rank
+
+| Option | Description |
+|--------|-------------|
+| `--market` | Market: `cn` (A股, 默认), `ft` (期货), `us` (美股), `wh` (外汇), `hk` (港股) |
+
 ## Prerequisites
 
 - `news` & `stock`: No browser required — uses public API
-- `rolling-news`: Chrome running and **logged into** `finance.sina.com.cn`
-- For `rolling-news`: [Browser Bridge extension](/guide/browser-bridge) installed
+- `rolling-news` & `stock-rank`: Chrome running and **logged into** `finance.sina.com.cn`
+- For `rolling-news` & `stock-rank`: [Browser Bridge extension](/guide/browser-bridge) installed
 
 ## Notes
 
@@ -83,3 +112,4 @@ opencli sinafinance stock 贵州茅台 -f json
 - `stock` supports Chinese names, Chinese codes, and ticker symbols; auto-detects market
 - Market priority for auto-detection: cn (A股) → hk (港股) → us (美股)
 - US stock `High`/`Low` columns show 52-week range; A股/港股 show today's range
+- `stock-rank` scrapes the hot search list from the Sina Finance homepage; requires browser login

package/docs/adapters/browser/weibo.md

@@ -6,8 +6,13 @@
 
 | Command | Description |
 |---------|-------------|
-| `opencli weibo hot` | |
+| `opencli weibo hot` | 微博热搜 |
 | `opencli weibo search` | Search Weibo posts by keyword |
+| `opencli weibo feed` | 首页时间线 |
+| `opencli weibo user` | 用户信息 |
+| `opencli weibo me` | 我的信息 |
+| `opencli weibo post` | 发微博 |
+| `opencli weibo comments` | 微博评论 |
 
 ## Usage Examples
 

package/docs/adapters/browser/wikipedia.md

@@ -8,6 +8,8 @@
 |---------|-------------|
 | `opencli wikipedia search` | Search Wikipedia articles |
 | `opencli wikipedia summary` | Get Wikipedia article summary |
+| `opencli wikipedia random` | Random Wikipedia article |
+| `opencli wikipedia trending` | Trending Wikipedia articles |
 
 ## Usage Examples