@jackwener/opencli 1.4.1 → 1.5.1

package/dist/registry.d.ts

@@ -39,6 +39,10 @@ export interface CliCommand {
     source?: string;
     footerExtra?: (kwargs: CommandArgs) => string | undefined;
     requiredEnv?: RequiredEnv[];
+    /** Deprecation note shown in help / execution warnings. */
+    deprecated?: boolean | string;
+    /** Preferred replacement command, if any. */
+    replacedBy?: string;
     /**
      * Control pre-navigation for cookie/header context before command execution.
      *

package/dist/registry.js

@@ -27,6 +27,8 @@ export function cli(opts) {
         timeoutSeconds: opts.timeoutSeconds,
         footerExtra: opts.footerExtra,
         requiredEnv: opts.requiredEnv,
+        deprecated: opts.deprecated,
+        replacedBy: opts.replacedBy,
         navigateBefore: opts.navigateBefore,
     };
     const key = fullName(cmd);

package/dist/runtime-detect.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Runtime detection — identify whether opencli is running under Node.js or Bun.
+ *
+ * Bun injects `globalThis.Bun` at startup, making detection trivial.
+ * This module centralises the check so other code can adapt behaviour
+ * (e.g. logging, diagnostics) without littering runtime sniffing everywhere.
+ */
+export type Runtime = 'bun' | 'node';
+/**
+ * Detect the current JavaScript runtime.
+ */
+export declare function detectRuntime(): Runtime;
+/**
+ * Return a human-readable version string for the current runtime.
+ * Examples: "v22.13.0" (Node), "1.1.42" (Bun)
+ */
+export declare function getRuntimeVersion(): string;
+/**
+ * Return a combined label like "node v22.13.0" or "bun 1.1.42".
+ */
+export declare function getRuntimeLabel(): string;

package/dist/runtime-detect.js

@@ -0,0 +1,32 @@
+/**
+ * Runtime detection — identify whether opencli is running under Node.js or Bun.
+ *
+ * Bun injects `globalThis.Bun` at startup, making detection trivial.
+ * This module centralises the check so other code can adapt behaviour
+ * (e.g. logging, diagnostics) without littering runtime sniffing everywhere.
+ */
+/**
+ * Detect the current JavaScript runtime.
+ */
+export function detectRuntime() {
+    // Bun always exposes globalThis.Bun (including Bun.version)
+    if (typeof globalThis.Bun !== 'undefined')
+        return 'bun';
+    return 'node';
+}
+/**
+ * Return a human-readable version string for the current runtime.
+ * Examples: "v22.13.0" (Node), "1.1.42" (Bun)
+ */
+export function getRuntimeVersion() {
+    if (detectRuntime() === 'bun') {
+        return globalThis.Bun.version;
+    }
+    return process.version; // e.g. "v22.13.0"
+}
+/**
+ * Return a combined label like "node v22.13.0" or "bun 1.1.42".
+ */
+export function getRuntimeLabel() {
+    return `${detectRuntime()} ${getRuntimeVersion()}`;
+}

package/dist/runtime-detect.test.d.ts

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

package/dist/runtime-detect.test.js

@@ -0,0 +1,27 @@
+import { describe, it, expect } from 'vitest';
+import { detectRuntime, getRuntimeVersion, getRuntimeLabel } from './runtime-detect.js';
+describe('runtime-detect', () => {
+    it('detectRuntime returns a valid runtime string', () => {
+        const rt = detectRuntime();
+        expect(['bun', 'node']).toContain(rt);
+    });
+    it('getRuntimeVersion returns a non-empty version string', () => {
+        const ver = getRuntimeVersion();
+        expect(typeof ver).toBe('string');
+        expect(ver.length).toBeGreaterThan(0);
+    });
+    it('getRuntimeLabel returns "<runtime> <version>" format', () => {
+        const label = getRuntimeLabel();
+        expect(label).toMatch(/^(bun|node) .+$/);
+    });
+    it('detects the current environment correctly', () => {
+        const isBun = typeof globalThis.Bun !== 'undefined';
+        const rt = detectRuntime();
+        if (isBun) {
+            expect(rt).toBe('bun');
+        }
+        else {
+            expect(rt).toBe('node');
+        }
+    });
+});

package/dist/runtime.d.ts

@@ -13,6 +13,7 @@ export declare const DEFAULT_BROWSER_EXPLORE_TIMEOUT: number;
 export declare function runWithTimeout<T>(promise: Promise<T>, opts: {
     timeout: number;
     label?: string;
+    hint?: string;
 }): Promise<T>;
 /**
  * Timeout with milliseconds unit. Used for low-level internal timeouts.

package/dist/runtime.js

@@ -5,7 +5,7 @@ import { TimeoutError } from './errors.js';
  * Uses CDPBridge when OPENCLI_CDP_ENDPOINT is set, otherwise BrowserBridge.
  */
 export function getBrowserFactory() {
-    return (process.env.OPENCLI_CDP_ENDPOINT ? CDPBridge : BrowserBridge);
+    return process.env.OPENCLI_CDP_ENDPOINT ? CDPBridge : BrowserBridge;
 }
 function parseEnvTimeout(envVar, fallback) {
     const raw = process.env[envVar];
@@ -26,7 +26,7 @@ export const DEFAULT_BROWSER_EXPLORE_TIMEOUT = parseEnvTimeout('OPENCLI_BROWSER_
  */
 export async function runWithTimeout(promise, opts) {
     const label = opts.label ?? 'Operation';
-    return withTimeoutMs(promise, opts.timeout * 1000, () => new TimeoutError(label, opts.timeout));
+    return withTimeoutMs(promise, opts.timeout * 1000, () => new TimeoutError(label, opts.timeout, opts.hint));
 }
 /**
  * Timeout with milliseconds unit. Used for low-level internal timeouts.

package/dist/serialization.d.ts

@@ -27,6 +27,8 @@ export declare function serializeCommand(cmd: CliCommand): {
     args: SerializedArg[];
     columns: string[];
     domain: string | null;
+    deprecated: string | boolean | null;
+    replacedBy: string | null;
 };
 /** Human-readable arg summary: `<required> [optional]` style. */
 export declare function formatArgSummary(args: Arg[]): string;

package/dist/serialization.js

@@ -29,6 +29,8 @@ export function serializeCommand(cmd) {
         args: cmd.args.map(serializeArg),
         columns: cmd.columns ?? [],
         domain: cmd.domain ?? null,
+        deprecated: cmd.deprecated ?? null,
+        replacedBy: cmd.replacedBy ?? null,
     };
 }
 // ── Formatting ──────────────────────────────────────────────────────────────
@@ -56,6 +58,10 @@ export function formatRegistryHelpText(cmd) {
     meta.push(`Browser: ${cmd.browser ? 'yes' : 'no'}`);
     if (cmd.domain)
         meta.push(`Domain: ${cmd.domain}`);
+    if (cmd.deprecated)
+        meta.push(`Deprecated: ${typeof cmd.deprecated === 'string' ? cmd.deprecated : 'yes'}`);
+    if (cmd.replacedBy)
+        meta.push(`Use instead: ${cmd.replacedBy}`);
     lines.push(meta.join(' | '));
     if (cmd.columns?.length)
         lines.push(`Output columns: ${cmd.columns.join(', ')}`);

package/dist/types.d.ts

@@ -68,4 +68,7 @@ export interface IPage {
     installInterceptor(pattern: string): Promise<void>;
     getInterceptedRequests(): Promise<any[]>;
     screenshot(options?: ScreenshotOptions): Promise<string>;
+    closeWindow?(): Promise<void>;
+    /** Returns the current page URL, or null if unavailable. */
+    getCurrentUrl?(): Promise<string | null>;
 }

package/dist/update-check.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Non-blocking update checker.
+ *
+ * Pattern: register exit-hook + kick-off-background-fetch
+ * - On startup: kick off background fetch (non-blocking)
+ * - On process exit: read cache, print notice if newer version exists
+ * - Check interval: 24 hours
+ * - Notice appears AFTER command output, not before (same as npm/gh/yarn)
+ * - Never delays or blocks the CLI command
+ */
+/**
+ * Register a process exit hook that prints an update notice if a newer
+ * version was found on the last background check.
+ * Notice appears after command output — same pattern as npm/gh/yarn.
+ * Skipped during --get-completions to avoid polluting shell completion output.
+ */
+export declare function registerUpdateNoticeOnExit(): void;
+/**
+ * Kick off a background fetch to npm registry. Writes to cache for next run.
+ * Fully non-blocking — never awaited.
+ */
+export declare function checkForUpdateBackground(): void;

package/dist/update-check.js

@@ -0,0 +1,112 @@
+/**
+ * Non-blocking update checker.
+ *
+ * Pattern: register exit-hook + kick-off-background-fetch
+ * - On startup: kick off background fetch (non-blocking)
+ * - On process exit: read cache, print notice if newer version exists
+ * - Check interval: 24 hours
+ * - Notice appears AFTER command output, not before (same as npm/gh/yarn)
+ * - Never delays or blocks the CLI command
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import chalk from 'chalk';
+import { PKG_VERSION } from './version.js';
+const CACHE_DIR = path.join(os.homedir(), '.opencli');
+const CACHE_FILE = path.join(CACHE_DIR, 'update-check.json');
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24h
+const NPM_REGISTRY_URL = 'https://registry.npmjs.org/@jackwener/opencli/latest';
+// Read cache once at module load — shared by both exported functions
+const _cache = (() => {
+    try {
+        return JSON.parse(fs.readFileSync(CACHE_FILE, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+})();
+function writeCache(latestVersion) {
+    try {
+        fs.mkdirSync(CACHE_DIR, { recursive: true });
+        fs.writeFileSync(CACHE_FILE, JSON.stringify({ lastCheck: Date.now(), latestVersion }), 'utf-8');
+    }
+    catch {
+        // Best-effort; never fail
+    }
+}
+/** Compare semver strings. Returns true if `a` is strictly newer than `b`. */
+function isNewer(a, b) {
+    const parse = (v) => v.replace(/^v/, '').split('-')[0].split('.').map(Number);
+    const pa = parse(a);
+    const pb = parse(b);
+    if (pa.some(isNaN) || pb.some(isNaN))
+        return false;
+    const [aMaj, aMin, aPat] = pa;
+    const [bMaj, bMin, bPat] = pb;
+    if (aMaj !== bMaj)
+        return aMaj > bMaj;
+    if (aMin !== bMin)
+        return aMin > bMin;
+    return aPat > bPat;
+}
+function isCI() {
+    return !!(process.env.CI || process.env.CONTINUOUS_INTEGRATION);
+}
+/**
+ * Register a process exit hook that prints an update notice if a newer
+ * version was found on the last background check.
+ * Notice appears after command output — same pattern as npm/gh/yarn.
+ * Skipped during --get-completions to avoid polluting shell completion output.
+ */
+export function registerUpdateNoticeOnExit() {
+    if (isCI())
+        return;
+    if (process.argv.includes('--get-completions'))
+        return;
+    process.on('exit', (code) => {
+        if (code !== 0)
+            return; // Don't show update notice on error exit
+        if (!_cache)
+            return;
+        if (!isNewer(_cache.latestVersion, PKG_VERSION))
+            return;
+        try {
+            process.stderr.write(chalk.yellow(`\n  Update available: v${PKG_VERSION} → v${_cache.latestVersion}\n`) +
+                chalk.dim(`  Run: npm install -g @jackwener/opencli\n\n`));
+        }
+        catch {
+            // Ignore broken pipe (stderr closed before process exits)
+        }
+    });
+}
+/**
+ * Kick off a background fetch to npm registry. Writes to cache for next run.
+ * Fully non-blocking — never awaited.
+ */
+export function checkForUpdateBackground() {
+    if (isCI())
+        return;
+    if (_cache && Date.now() - _cache.lastCheck < CHECK_INTERVAL_MS)
+        return;
+    void (async () => {
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), 3000);
+            const res = await fetch(NPM_REGISTRY_URL, {
+                signal: controller.signal,
+                headers: { 'User-Agent': `opencli/${PKG_VERSION}` },
+            });
+            clearTimeout(timer);
+            if (!res.ok)
+                return;
+            const data = await res.json();
+            if (typeof data.version === 'string') {
+                writeCache(data.version);
+            }
+        }
+        catch {
+            // Network error: silently skip, try again next run
+        }
+    })();
+}

package/dist/weixin-download.test.d.ts

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

package/dist/weixin-download.test.js

@@ -0,0 +1,30 @@
+import { describe, expect, it } from 'vitest';
+async function loadModule() {
+    return import('./clis/weixin/download.js');
+}
+describe('weixin publish time extraction', () => {
+    it('prefers publish_time text over create_time-like date strings', async () => {
+        const mod = await loadModule();
+        expect(mod.extractWechatPublishTime('2026年3月24日 22:38', 'var create_time = "2026年3月24日 22:38";')).toBe('2026年3月24日 22:38');
+    });
+    it('falls back to unix timestamp create_time values', async () => {
+        const mod = await loadModule();
+        expect(mod.extractWechatPublishTime('', 'var create_time = "1711291080";')).toBe('2024-03-24 22:38:00');
+    });
+    it('rejects malformed create_time values', async () => {
+        const mod = await loadModule();
+        expect(mod.extractWechatPublishTime('', 'var create_time = "2026年3月24日 22:38";')).toBe('');
+        expect(mod.extractWechatPublishTime('', 'var create_time = "1711291080abc";')).toBe('');
+        expect(mod.extractWechatPublishTime('', 'var create_time = "17112910800";')).toBe('');
+    });
+    it('builds a self-contained browser helper that matches fallback behavior', async () => {
+        const mod = await loadModule();
+        const extractInPage = eval(mod.buildExtractWechatPublishTimeJs());
+        expect(extractInPage('', 'var create_time = "1711291080";')).toBe('2024-03-24 22:38:00');
+    });
+    it('browser helper still prefers DOM publish_time text', async () => {
+        const mod = await loadModule();
+        const extractInPage = eval(mod.buildExtractWechatPublishTimeJs());
+        expect(extractInPage('2026年3月24日 22:38', 'var create_time = "1711291080";')).toBe('2026年3月24日 22:38');
+    });
+});

package/dist/weread-private-api-regression.test.d.ts

@@ -0,0 +1 @@
+import './clis/weread/shelf.js';

package/dist/weread-private-api-regression.test.js

@@ -0,0 +1,122 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { getRegistry } from './registry.js';
+import { fetchPrivateApi } from './clis/weread/utils.js';
+import './clis/weread/shelf.js';
+describe('weread private API regression', () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('uses browser cookies and Node fetch for private API requests', async () => {
+        const mockPage = {
+            getCookies: vi.fn()
+                .mockResolvedValueOnce([
+                { name: 'wr_name', value: 'alice', domain: 'weread.qq.com' },
+                { name: 'wr_vid', value: 'vid123', domain: 'i.weread.qq.com' },
+            ]),
+            evaluate: vi.fn(),
+        };
+        const fetchMock = vi.fn().mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: () => Promise.resolve({ title: 'Test Book', errcode: 0 }),
+        });
+        vi.stubGlobal('fetch', fetchMock);
+        const result = await fetchPrivateApi(mockPage, '/book/info', { bookId: '123' });
+        expect(result.title).toBe('Test Book');
+        expect(mockPage.getCookies).toHaveBeenCalledTimes(1);
+        expect(mockPage.getCookies).toHaveBeenCalledWith({ url: 'https://i.weread.qq.com/book/info?bookId=123' });
+        expect(mockPage.evaluate).not.toHaveBeenCalled();
+        expect(fetchMock).toHaveBeenCalledWith('https://i.weread.qq.com/book/info?bookId=123', expect.objectContaining({
+            headers: expect.objectContaining({
+                Cookie: 'wr_name=alice; wr_vid=vid123',
+            }),
+        }));
+    });
+    it('maps unauthenticated private API responses to AUTH_REQUIRED', async () => {
+        const mockPage = {
+            getCookies: vi.fn().mockResolvedValue([]),
+            evaluate: vi.fn(),
+        };
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: false,
+            status: 401,
+            json: () => Promise.resolve({ errcode: -2010, errmsg: '用户不存在' }),
+        }));
+        await expect(fetchPrivateApi(mockPage, '/book/info')).rejects.toThrow('Not logged in');
+    });
+    it('maps non-auth API errors to API_ERROR', async () => {
+        const mockPage = {
+            getCookies: vi.fn().mockResolvedValue([]),
+            evaluate: vi.fn(),
+        };
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: () => Promise.resolve({ errcode: -1, errmsg: 'unknown error' }),
+        }));
+        await expect(fetchPrivateApi(mockPage, '/book/info')).rejects.toThrow('unknown error');
+    });
+    it('maps non-401 HTTP failures to FETCH_ERROR', async () => {
+        const mockPage = {
+            getCookies: vi.fn().mockResolvedValue([]),
+            evaluate: vi.fn(),
+        };
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: false,
+            status: 403,
+            json: () => Promise.resolve({ errmsg: 'forbidden' }),
+        }));
+        await expect(fetchPrivateApi(mockPage, '/book/info')).rejects.toThrow('HTTP 403');
+    });
+    it('maps invalid JSON to PARSE_ERROR', async () => {
+        const mockPage = {
+            getCookies: vi.fn().mockResolvedValue([]),
+            evaluate: vi.fn(),
+        };
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: () => Promise.reject(new SyntaxError('Unexpected token <')),
+        }));
+        await expect(fetchPrivateApi(mockPage, '/book/info')).rejects.toThrow('Invalid JSON');
+    });
+    it('routes weread shelf through the private API helper path', async () => {
+        const command = getRegistry().get('weread/shelf');
+        expect(command?.func).toBeTypeOf('function');
+        const mockPage = {
+            getCookies: vi.fn()
+                .mockResolvedValueOnce([
+                { name: 'wr_name', value: 'alice', domain: 'weread.qq.com' },
+                { name: 'wr_vid', value: 'vid123', domain: 'i.weread.qq.com' },
+            ]),
+            evaluate: vi.fn(),
+        };
+        const fetchMock = vi.fn().mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: () => Promise.resolve({
+                books: [{
+                        title: 'Deep Work',
+                        author: 'Cal Newport',
+                        readingProgress: 42,
+                        bookId: 'abc123',
+                    }],
+            }),
+        });
+        vi.stubGlobal('fetch', fetchMock);
+        const result = await command.func(mockPage, { limit: 1 });
+        expect(mockPage.evaluate).not.toHaveBeenCalled();
+        expect(fetchMock).toHaveBeenCalledWith('https://i.weread.qq.com/shelf/sync?synckey=0&lectureSynckey=0', expect.any(Object));
+        expect(mockPage.getCookies).toHaveBeenCalledWith({
+            url: 'https://i.weread.qq.com/shelf/sync?synckey=0&lectureSynckey=0',
+        });
+        expect(result).toEqual([
+            {
+                title: 'Deep Work',
+                author: 'Cal Newport',
+                progress: '42%',
+                bookId: 'abc123',
+            },
+        ]);
+    });
+});

package/dist/yaml-schema.d.ts

@@ -24,3 +24,6 @@ export interface YamlCliDefinition {
     timeout?: number;
     navigateBefore?: boolean | string;
 }
+import type { Arg } from './registry.js';
+/** Convert YAML args definition to the internal Arg[] format. */
+export declare function parseYamlArgs(args: Record<string, YamlArgDefinition> | undefined): Arg[];

package/dist/yaml-schema.js

@@ -2,4 +2,21 @@
  * Shared YAML CLI definition types.
  * Used by both discovery.ts (runtime) and build-manifest.ts (build-time).
  */
-export {};
+/** Convert YAML args definition to the internal Arg[] format. */
+export function parseYamlArgs(args) {
+    if (!args || typeof args !== 'object')
+        return [];
+    const result = [];
+    for (const [argName, argDef] of Object.entries(args)) {
+        result.push({
+            name: argName,
+            type: argDef?.type ?? 'str',
+            default: argDef?.default,
+            required: argDef?.required ?? false,
+            positional: argDef?.positional ?? false,
+            help: argDef?.description ?? argDef?.help ?? '',
+            choices: argDef?.choices,
+        });
+    }
+    return result;
+}

package/docs/.vitepress/config.mts

@@ -32,6 +32,7 @@ export default defineConfig({
                 { text: 'Comparison', link: '/comparison' },
                 { text: 'Browser Bridge', link: '/guide/browser-bridge' },
                 { text: 'Troubleshooting', link: '/guide/troubleshooting' },
+                { text: 'Add an Electron App CLI', link: '/guide/electron-app-cli' },
                 { text: 'Plugins', link: '/guide/plugins' },
               ],
             },
@@ -78,6 +79,7 @@ export default defineConfig({
                 { text: 'Doubao', link: '/adapters/browser/doubao' },
                 { text: 'Facebook', link: '/adapters/browser/facebook' },
                 { text: 'Google', link: '/adapters/browser/google' },
+                { text: 'IMDb', link: '/adapters/browser/imdb' },
                 { text: 'Instagram', link: '/adapters/browser/instagram' },
                 { text: 'JD.com', link: '/adapters/browser/jd' },
                 { text: 'Medium', link: '/adapters/browser/medium' },
@@ -98,6 +100,7 @@ export default defineConfig({
                 { text: 'Xiaoyuzhou', link: '/adapters/browser/xiaoyuzhou' },
                 { text: 'Yahoo Finance', link: '/adapters/browser/yahoo-finance' },
                 { text: 'arXiv', link: '/adapters/browser/arxiv' },
+                { text: 'paperreview.ai', link: '/adapters/browser/paperreview' },
                 { text: 'Barchart', link: '/adapters/browser/barchart' },
                 { text: 'Hugging Face', link: '/adapters/browser/hf' },
                 { text: 'Sina Finance', link: '/adapters/browser/sinafinance' },
@@ -168,6 +171,7 @@ export default defineConfig({
                 { text: '快速开始', link: '/zh/guide/getting-started' },
                 { text: '安装', link: '/zh/guide/installation' },
                 { text: 'Browser Bridge', link: '/zh/guide/browser-bridge' },
+                { text: '给新 Electron 应用生成 CLI', link: '/zh/guide/electron-app-cli' },
                 { text: '插件', link: '/zh/guide/plugins' },
               ],
             },

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

@@ -0,0 +1,47 @@
+# 36kr (36氪)
+
+**Mode**: 🌐 Public / 🔐 Browser · **Domain**: `36kr.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli 36kr hot` | 36氪热榜 — trending articles |
+| `opencli 36kr news` | Latest tech/startup news from 36kr |
+| `opencli 36kr search <query>` | Search 36kr articles |
+| `opencli 36kr article <id-or-url>` | Read full article content |
+
+## Usage Examples
+
+```bash
+# Trending articles
+opencli 36kr hot --limit 10
+
+# Hot by type
+opencli 36kr hot --type renqi --limit 10
+opencli 36kr hot --type zonghe --limit 10
+
+# Latest news
+opencli 36kr news --limit 20
+
+# Search articles
+opencli 36kr search "AI" --limit 10
+opencli 36kr search "OpenAI" --limit 5
+
+# Read full article (by ID or URL)
+opencli 36kr article 3000000123456
+opencli 36kr article https://36kr.com/p/3000000123456
+
+# JSON output
+opencli 36kr hot -f json
+```
+
+## Notes
+
+- `news` uses the public RSS feed and works without Browser Bridge.
+- `hot`, `search`, and `article` use Browser Bridge and are best run with Chrome open.
+- `hot --type` accepts `catalog`, `renqi`, `zonghe`, and `shoucang`.
+
+## Prerequisites
+
+- No browser required — uses public API

package/docs/adapters/browser/bluesky.md

@@ -0,0 +1,53 @@
+# Bluesky
+
+**Mode**: 🌐 Public · **Domain**: `bsky.app`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli bluesky profile` | User profile info |
+| `opencli bluesky user` | Recent posts from a user |
+| `opencli bluesky trending` | Trending topics |
+| `opencli bluesky search` | Search users |
+| `opencli bluesky feeds` | Popular feed generators |
+| `opencli bluesky followers` | User's followers |
+| `opencli bluesky following` | Accounts a user follows |
+| `opencli bluesky thread` | Post thread with replies |
+| `opencli bluesky starter-packs` | User's starter packs |
+
+## Usage Examples
+
+```bash
+# User profile
+opencli bluesky profile --handle bsky.app
+
+# Recent posts
+opencli bluesky user --handle bsky.app --limit 10
+
+# Trending topics
+opencli bluesky trending --limit 10
+
+# Search users
+opencli bluesky search --query "AI" --limit 10
+
+# Popular feeds
+opencli bluesky feeds --limit 10
+
+# Followers / following
+opencli bluesky followers --handle bsky.app --limit 10
+opencli bluesky following --handle bsky.app
+
+# Post thread with replies
+opencli bluesky thread --uri "at://did:.../app.bsky.feed.post/..."
+
+# Starter packs
+opencli bluesky starter-packs --handle bsky.app
+
+# JSON output
+opencli bluesky profile --handle bsky.app -f json
+```
+
+## Prerequisites
+
+None — all commands use the public Bluesky AT Protocol API, no browser or login required.

package/docs/adapters/browser/douban.md

@@ -9,6 +9,8 @@
 | `opencli douban search` | 搜索豆瓣电影、图书或音乐 |
 | `opencli douban top250` | 豆瓣电影 Top 250 |
 | `opencli douban subject` | 条目详情 |
+| `opencli douban photos` | 获取电影海报/剧照图片列表 |
+| `opencli douban download` | 下载电影海报/剧照图片 |
 | `opencli douban marks` | 我的标记 |
 | `opencli douban reviews` | 我的短评 |
 | `opencli douban movie-hot` | 豆瓣电影热门榜单 |
@@ -32,6 +34,18 @@ opencli douban top250 --limit 10
 # 条目详情
 opencli douban subject 1292052
 
+# 获取海报直链（默认 type=Rb）
+opencli douban photos 30382501 --limit 20
+
+# 下载海报到本地目录
+opencli douban download 30382501 --output ./douban
+
+# 只下载指定 photo_id 的一张图
+opencli douban download 30382501 --photo-id 2913621075 --output ./douban
+
+# 返回 JSON，便于上层界面直接渲染图片并右键取图
+opencli douban photos 30382501 -f json
+
 # 电影热门
 opencli douban movie-hot --limit 10