@agentrhq/webcmd 0.1.2 → 0.2.0

package/clis/dongchedi/specs.js

@@ -1,115 +0,0 @@
-/**
- * dongchedi specs — key configuration overview (配置概览) of a car series.
- *
- * Reads `pageProps.overviewData` from the SSR series page: body dimensions,
- * powertrain (engine / gearbox / 0-100), drivetrain + suspension, and
- * airbags. This is the unsigned SSR overview — the full per-trim parameter
- * sheet sits behind a ByteDance-signed XHR and is deliberately not faked.
- */
-
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { CommandExecutionError } from '@agentrhq/webcmd/errors';
-import {
-    SPECS_COLUMNS,
-    assertPlainObject,
-    clean,
-    dcdFetchPageProps,
-    normalizeSeriesId,
-} from './utils.js';
-
-/** Distinct, cleaned, non-empty values for a key across an array of objects. */
-function uniqueVals(arr, key) {
-    const out = [];
-    for (const o of (Array.isArray(arr) ? arr : [])) {
-        const v = clean(o?.[key]);
-        if (v && !out.includes(v)) out.push(v);
-    }
-    return out;
-}
-
-/** Build a min-max range string from a numeric field across rows ("6.4-7.2s"). */
-function rangeOf(arr, key, suffix = '') {
-    const nums = (Array.isArray(arr) ? arr : [])
-        .map((o) => parseFloat(String(o?.[key]).replace(/[^\d.]/g, '')))
-        .filter((n) => Number.isFinite(n));
-    if (nums.length === 0) return '';
-    const lo = Math.min(...nums); const hi = Math.max(...nums);
-    return lo === hi ? `${lo}${suffix}` : `${lo}-${hi}${suffix}`;
-}
-
-/** Summarize airbag coverage into a readable list. */
-function summarizeAirbags(airbagArr) {
-    const a = (Array.isArray(airbagArr) ? airbagArr : []);
-    if (a.length === 0) return '';
-    const any = (key) => a.some((x) => x?.[key]);
-    const labels = [
-        ['main_airbag', '主'], ['vice_airbag', '副'], ['front_airbag', '前'],
-        ['rear_airbag', '后'], ['side_air_curtain', '侧气帘'],
-        ['main_knee_airbag', '主膝部'], ['vice_knee_airbag', '副膝部'],
-    ];
-    const present = labels.filter(([k]) => any(k)).map(([, label]) => label);
-    return present.length ? present.join('/') + '气囊' : '';
-}
-
-/**
- * Pure parser: overviewData → field/value rows. Exported for unit tests.
- */
-export function parseSpecs(overviewData, seriesId) {
-    const ov = assertPlainObject(overviewData, 'dongchedi overviewData');
-    const space0 = (Array.isArray(ov.space) && ov.space[0]) || {};
-    const power = ov.power || {};
-    const powerItems = power.power_item || [];
-    const manip0 = (Array.isArray(ov.manipulation) && ov.manipulation[0]) || {};
-
-    const dims = (space0.length && space0.width && space0.height)
-        ? `${space0.length} × ${space0.width} × ${space0.height} mm`
-        : '';
-    const drivetrain = [clean(manip0.driver_form), clean(manip0.fourwheel_drive_type)]
-        .filter(Boolean).join(' · ');
-    const suspension = (manip0.front_suspension_form || manip0.rear_suspension_form)
-        ? `前 ${clean(manip0.front_suspension_form) || '?'} / 后 ${clean(manip0.rear_suspension_form) || '?'}`
-        : '';
-
-    const fields = [
-        ['series_id', String(seriesId)],
-        ['dimensions', dims],
-        ['wheelbase', space0.wheelbase ? `${space0.wheelbase} mm` : ''],
-        ['power', clean(power.overview)],
-        ['engine', uniqueVals(powerItems, 'engine_description').join(' / ')],
-        ['gearbox', uniqueVals(powerItems, 'gearbox_description').join(' / ')],
-        ['energy', uniqueVals(powerItems, 'fuel_form').join(' / ')],
-        ['acceleration', rangeOf(powerItems, 'acceleration_time', 's')],
-        ['drivetrain', drivetrain],
-        ['suspension', suspension],
-        ['airbags', summarizeAirbags(ov.airbag)],
-    ];
-    return fields.map(([field, value]) => ({ field, value }));
-}
-
-cli({
-    site: 'dongchedi',
-    name: 'specs',
-    access: 'read',
-    aliases: ['config'],
-    description: '懂车帝车系配置概览（尺寸 / 动力 / 发动机 / 变速箱 / 四驱 / 悬挂 / 气囊）',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'series_id', required: true, positional: true, help: '车系 ID（来自 search 的 series_id，或 /auto/series/<id> URL）' },
-    ],
-    columns: SPECS_COLUMNS,
-    func: async (args) => {
-        const seriesId = normalizeSeriesId(args.series_id);
-        const pp = await dcdFetchPageProps(`/auto/series/${seriesId}`, `specs ${seriesId}`);
-        const rows = parseSpecs(pp.overviewData, seriesId);
-        // Every series has at least dimensions/power; an all-empty sheet means
-        // the overview block was absent (layout drift) — don't emit a blank sheet.
-        if (rows.every((r) => r.field === 'series_id' || !r.value)) {
-            throw new CommandExecutionError(
-                `dongchedi specs ${seriesId}`,
-                'No spec overview found for this series (layout may have changed).',
-            );
-        }
-        return rows;
-    },
-});

package/clis/dongchedi/utils.js

@@ -1,180 +0,0 @@
-/**
- * Shared helpers for the 懂车帝 (Dongchedi) adapter.
- *
- * Dongchedi (a ByteDance car-info site) is a Next.js app that server-side
- * renders every functional page with a `<script id="__NEXT_DATA__">` blob
- * holding the full page data. A plain HTTP GET (no login, no signature, no
- * browser) returns that blob, so every command here is a PUBLIC `fetch()`
- * that pulls `props.pageProps` out of the SSR HTML and parses pure JSON —
- * no cookies, no anti-bot tokens, no DOM scraping.
- *
- * The koubei/config XHR JSON APIs (`/motor/...`) are ByteDance-signature
- * gated (a_bogus / X-Bogus) and 404 without a valid signature, so they are
- * deliberately NOT used — the SSR pages expose the same data unsigned.
- *
- * Scores are stored x100 ints (422 == 4.22 / 5) — `parseScore` rescales.
- */
-
-import {
-    ArgumentError,
-    CommandExecutionError,
-    EmptyResultError,
-} from '@agentrhq/webcmd/errors';
-
-export const DCD_BASE = 'https://www.dongchedi.com';
-
-const UA =
-    'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 '
-    + '(KHTML, like Gecko) Chrome/126.0 Safari/537.36';
-
-export const SEARCH_COLUMNS = ['rank', 'series_id', 'name', 'brand', 'official_price', 'dealer_price', 'pictures', 'url'];
-export const SERIES_COLUMNS = ['field', 'value'];
-export const MODELS_COLUMNS = ['car_id', 'name', 'year', 'official_price', 'dealer_price', 'owner_price'];
-export const SPECS_COLUMNS = ['field', 'value'];
-export const SCORE_COLUMNS = ['dimension', 'score', 'same_level_avg'];
-export const KOUBEI_COLUMNS = ['rank', 'user', 'car', 'score', 'likes', 'comments', 'content', 'url'];
-
-// pageProps keys present on Dongchedi's "city gateway / 404" fallback shell.
-// A real page always carries more than just these housekeeping fields.
-const FALLBACK_SHELL_KEYS = ['__hasUrlCity', 'is_gray', 'has_gray', 'clientIp', 'sensitiveSeriesIdList'];
-
-/**
- * Extract `props.pageProps` from a Dongchedi SSR page's `__NEXT_DATA__`.
- *
- * Pure (string in, object|null out) so it runs identically against the
- * live `fetch()` body and the frozen JSDOM-free fixtures in the unit test.
- * Returns null when the blob is missing or unparseable.
- */
-export function extractPageProps(html) {
-    const m = String(html || '').match(/<script id="__NEXT_DATA__"[^>]*>([\s\S]*?)<\/script>/);
-    if (!m) return null;
-    try {
-        const data = JSON.parse(m[1]);
-        return (data && data.props && data.props.pageProps) || null;
-    } catch {
-        return null;
-    }
-}
-
-/**
- * True when pageProps is Dongchedi's empty fallback shell (wrong URL form,
- * city gateway, or a soft 404) rather than a real data page.
- */
-export function isFallbackShell(pp) {
-    if (!pp || typeof pp !== 'object') return true;
-    const real = Object.keys(pp).filter((k) => !FALLBACK_SHELL_KEYS.includes(k));
-    return real.length === 0;
-}
-
-/**
- * Fetch a Dongchedi page and return its parsed `pageProps`.
- * Throws typed errors so callers can let them propagate.
- */
-export async function dcdFetchPageProps(path, contextHint) {
-    let resp;
-    try {
-        resp = await fetch(`${DCD_BASE}${path}`, {
-            headers: {
-                'User-Agent': UA,
-                Referer: `${DCD_BASE}/`,
-                'Accept-Language': 'zh-CN,zh;q=0.9',
-            },
-        });
-    } catch (err) {
-        throw new CommandExecutionError(
-            `dongchedi ${contextHint} network error: ${err?.message || err}`,
-        );
-    }
-    if (!resp.ok) {
-        throw new CommandExecutionError(`dongchedi ${contextHint} HTTP ${resp.status}`);
-    }
-    const html = await resp.text();
-    const pp = extractPageProps(html);
-    if (!pp) {
-        throw new CommandExecutionError(
-            `dongchedi ${contextHint} returned no __NEXT_DATA__`,
-            'Dongchedi likely changed its page structure, or the request hit an anti-bot page.',
-        );
-    }
-    if (isFallbackShell(pp)) {
-        throw new CommandExecutionError(
-            `dongchedi ${contextHint}`,
-            'Dongchedi served its empty fallback shell — the id may not exist or the URL form changed.',
-        );
-    }
-    return pp;
-}
-
-export function assertPlainObject(value, label) {
-    if (!value || typeof value !== 'object' || Array.isArray(value)) {
-        throw new CommandExecutionError(`${label} returned an unexpected payload shape; expected an object.`);
-    }
-    return value;
-}
-
-export function requireArray(value, label) {
-    if (!Array.isArray(value)) {
-        throw new CommandExecutionError(`${label} returned an unexpected payload shape; expected an array.`);
-    }
-    return value;
-}
-
-export function requireStableId(value, label) {
-    const id = String(value ?? '').trim();
-    if (!/^\d+$/.test(id) || id === '0') {
-        throw new CommandExecutionError(`${label} did not include a stable numeric id.`);
-    }
-    return id;
-}
-
-export function requireText(value, label) {
-    const text = clean(value);
-    if (!text) {
-        throw new CommandExecutionError(`${label} did not include a stable text value.`);
-    }
-    return text;
-}
-
-/** Rescale a Dongchedi x100 score int (422) to a /5 float (4.22). */
-export function parseScore(raw) {
-    const n = Number(raw);
-    if (!Number.isFinite(n) || n <= 0) return null;
-    return Number((n / 100).toFixed(2));
-}
-
-/**
- * Normalize a series id argument: a bare number, or a
- * `https://www.dongchedi.com/auto/series/<id>` URL.
- */
-export function normalizeSeriesId(rawInput) {
-    const raw = String(rawInput || '').trim();
-    if (!raw) throw new ArgumentError('series_id must be a non-empty value');
-    const m = raw.match(/series\/(\d+)/) || raw.match(/^(\d+)$/);
-    if (!m) {
-        throw new ArgumentError(
-            `'${rawInput}' does not look like a dongchedi series id (a number, or a /auto/series/<id> URL)`,
-        );
-    }
-    return m[1];
-}
-
-/** Validate an integer limit in [1, max]. */
-export function requireLimit(value, def, max) {
-    const raw = value == null || value === '' ? def : value;
-    const n = typeof raw === 'number' ? raw : Number(String(raw).trim());
-    if (!Number.isInteger(n) || n < 1 || n > max) {
-        throw new ArgumentError(`limit must be an integer between 1 and ${max}`);
-    }
-    return n;
-}
-
-/** Collapse whitespace and trim; returns '' for nullish. */
-export function clean(s) {
-    return String(s == null ? '' : s).replace(/\s+/g, ' ').trim();
-}
-
-/** Truncate long review text for table display, keeping it on one line. */
-export function snippet(s, max = 180) {
-    const t = clean(s);
-    return t.length > max ? `${t.slice(0, max)}…` : t;
-}

package/clis/douban/auth.js

@@ -1,50 +0,0 @@
-import { AuthRequiredError, CommandExecutionError } from '@agentrhq/webcmd/errors';
-import { registerSiteAuthCommands } from '../_shared/site-auth.js';
-
-async function hasDoubanSessionCookie(page) {
-  const cookies = await page.getCookies({ url: 'https://www.douban.com' });
-  const names = new Set(cookies.map(c => c.name));
-  return names.has('dbcl2') || names.has('ck');
-}
-
-async function verifyDoubanIdentity(page) {
-  if (!await hasDoubanSessionCookie(page)) {
-    throw new AuthRequiredError('douban.com', 'Douban dbcl2 / ck cookies missing');
-  }
-  await page.goto('https://www.douban.com/');
-  await page.wait(2);
-  const probe = await page.evaluate(`
-    (() => {
-      const navUser = document.querySelector('.nav-user-account .bn-more, .top-nav-info a.bn-more');
-      if (!navUser) {
-        return { kind: 'auth', detail: 'Douban nav-user element missing — not signed in' };
-      }
-      const href = navUser.getAttribute('href') || '';
-      const m = href.match(/people\\/(\\d+)\\/?/);
-      const user_id = m ? m[1] : '';
-      const name = (navUser.textContent || '').trim();
-      if (!user_id) {
-        return { kind: 'auth', detail: 'Douban user_id parse failed: href=' + href };
-      }
-      return { ok: true, user_id, name };
-    })()
-  `);
-  if (probe?.kind === 'auth') throw new AuthRequiredError('douban.com', probe.detail);
-  if (!probe?.ok) throw new CommandExecutionError(`Unexpected Douban probe: ${JSON.stringify(probe)}`);
-  return { user_id: probe.user_id, name: probe.name };
-}
-
-registerSiteAuthCommands({
-  site: 'douban',
-  domain: 'douban.com',
-  loginUrl: 'https://accounts.douban.com/passport/login',
-  columns: ['user_id', 'name'],
-  quickCheck: hasDoubanSessionCookie,
-  verify: verifyDoubanIdentity,
-  poll: async (page) => {
-    if (!await hasDoubanSessionCookie(page)) {
-      throw new AuthRequiredError('douban.com', 'Waiting for Douban dbcl2 / ck cookies');
-    }
-    return verifyDoubanIdentity(page);
-  },
-});

package/clis/douban/book-hot.js

@@ -1,15 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { loadDoubanBookHot } from './utils.js';
-cli({
-    site: 'douban',
-    name: 'book-hot',
-    access: 'read',
-    description: '豆瓣图书热门榜单',
-    domain: 'book.douban.com',
-    strategy: Strategy.COOKIE,
-    args: [
-        { name: 'limit', type: 'int', default: 20, help: '返回的图书数量' },
-    ],
-    columns: ['rank', 'title', 'rating', 'quote', 'author', 'publisher', 'year', 'url'],
-    func: async (page, args) => loadDoubanBookHot(page, Number(args.limit) || 20),
-});

package/clis/douban/download.js

@@ -1,68 +0,0 @@
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import { formatBytes } from '@agentrhq/webcmd/download/progress';
-import { httpDownload, sanitizeFilename } from '@agentrhq/webcmd/download';
-import { EmptyResultError } from '@agentrhq/webcmd/errors';
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { getDoubanPhotoExtension, loadDoubanSubjectPhotos, normalizeDoubanSubjectId } from './utils.js';
-function buildDoubanPhotoFilename(subjectId, photo) {
-    const index = String(photo.index).padStart(3, '0');
-    const suffix = sanitizeFilename(photo.title || photo.photoId || 'photo', 80) || 'photo';
-    return `${subjectId}_${index}_${photo.photoId || 'photo'}_${suffix}${getDoubanPhotoExtension(photo.imageUrl)}`;
-}
-cli({
-    site: 'douban',
-    name: 'download',
-    access: 'read',
-    description: '下载电影海报/剧照图片',
-    domain: 'movie.douban.com',
-    strategy: Strategy.COOKIE,
-    args: [
-        { name: 'id', positional: true, required: true, help: '电影 subject ID' },
-        { name: 'type', default: 'Rb', help: '豆瓣 photos 的 type 参数，默认 Rb（海报）' },
-        { name: 'limit', type: 'int', default: 120, help: '最多下载多少张图片' },
-        { name: 'photo-id', help: '只下载指定 photo_id 的图片' },
-        { name: 'output', default: './douban-downloads', help: '输出目录' },
-    ],
-    columns: ['index', 'title', 'status', 'size'],
-    func: async (page, kwargs) => {
-        const subjectId = normalizeDoubanSubjectId(String(kwargs.id || ''));
-        const output = String(kwargs.output || './douban-downloads');
-        const requestedPhotoId = String(kwargs['photo-id'] || '').trim();
-        const loadOptions = {
-            type: String(kwargs.type || 'Rb'),
-        };
-        if (requestedPhotoId)
-            loadOptions.targetPhotoId = requestedPhotoId;
-        else
-            loadOptions.limit = Number(kwargs.limit) || 120;
-        const data = await loadDoubanSubjectPhotos(page, subjectId, loadOptions);
-        const photos = requestedPhotoId
-            ? data.photos.filter((photo) => photo.photoId === requestedPhotoId)
-            : data.photos;
-        if (requestedPhotoId && !photos.length) {
-            throw new EmptyResultError('douban download', `Photo ID ${requestedPhotoId} was not found under subject ${subjectId}. Try "douban photos ${subjectId} -f json" first.`);
-        }
-        const outputDir = path.join(output, subjectId);
-        fs.mkdirSync(outputDir, { recursive: true });
-        const results = [];
-        for (const photo of photos) {
-            const filename = buildDoubanPhotoFilename(subjectId, photo);
-            const destPath = path.join(outputDir, filename);
-            const result = await httpDownload(photo.imageUrl, destPath, {
-                headers: { Referer: photo.detailUrl || `https://movie.douban.com/subject/${subjectId}/photos?type=${encodeURIComponent(String(kwargs.type || 'Rb'))}` },
-                timeout: 60000,
-            });
-            results.push({
-                index: photo.index,
-                title: photo.title,
-                photo_id: photo.photoId,
-                image_url: photo.imageUrl,
-                detail_url: photo.detailUrl,
-                status: result.success ? 'success' : 'failed',
-                size: result.success ? formatBytes(result.size) : (result.error || 'unknown error'),
-            });
-        }
-        return results;
-    },
-});

package/clis/douban/download.test.js

@@ -1,170 +0,0 @@
-import { beforeAll, beforeEach, describe, expect, it, vi } from 'vitest';
-import path from 'node:path';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-const { mockHttpDownload, mockLoadDoubanSubjectPhotos, mockMkdirSync } = vi.hoisted(() => ({
-    mockHttpDownload: vi.fn(),
-    mockLoadDoubanSubjectPhotos: vi.fn(),
-    mockMkdirSync: vi.fn(),
-}));
-vi.mock('@agentrhq/webcmd/download', () => ({
-    httpDownload: mockHttpDownload,
-    sanitizeFilename: vi.fn((value) => value.replace(/\s+/g, '_')),
-}));
-vi.mock('./utils.js', async () => {
-    const actual = await vi.importActual('./utils.js');
-    return {
-        ...actual,
-        loadDoubanSubjectPhotos: mockLoadDoubanSubjectPhotos,
-    };
-});
-vi.mock('@agentrhq/webcmd/download/progress', () => ({
-    formatBytes: vi.fn((size) => `${size} B`),
-}));
-vi.mock('node:fs', () => ({
-    mkdirSync: mockMkdirSync,
-}));
-await import('./download.js');
-let cmd;
-beforeAll(() => {
-    cmd = getRegistry().get('douban/download');
-    expect(cmd?.func).toBeTypeOf('function');
-});
-function toPosixPath(value) {
-    return value.replaceAll(path.sep, '/');
-}
-describe('douban download', () => {
-    beforeEach(() => {
-        mockHttpDownload.mockReset();
-        mockLoadDoubanSubjectPhotos.mockReset();
-        mockMkdirSync.mockReset();
-    });
-    it('downloads douban poster images and merges metadata into the result', async () => {
-        const page = {};
-        mockLoadDoubanSubjectPhotos.mockResolvedValue({
-            subjectId: '30382501',
-            subjectTitle: 'The Wandering Earth 2',
-            type: 'Rb',
-            photos: [
-                {
-                    index: 1,
-                    photoId: '2913450214',
-                    title: 'Main poster',
-                    imageUrl: 'https://img1.doubanio.com/view/photo/l/public/p2913450214.webp',
-                    thumbUrl: 'https://img1.doubanio.com/view/photo/m/public/p2913450214.webp',
-                    detailUrl: 'https://movie.douban.com/photos/photo/2913450214/',
-                    page: 1,
-                },
-                {
-                    index: 2,
-                    photoId: '2913450215',
-                    title: 'Character poster',
-                    imageUrl: 'https://img1.doubanio.com/view/photo/l/public/p2913450215.jpg',
-                    thumbUrl: 'https://img1.doubanio.com/view/photo/m/public/p2913450215.jpg',
-                    detailUrl: 'https://movie.douban.com/photos/photo/2913450215/',
-                    page: 1,
-                },
-            ],
-        });
-        mockHttpDownload
-            .mockResolvedValueOnce({ success: true, size: 1200 })
-            .mockResolvedValueOnce({ success: true, size: 980 });
-        const result = await cmd.func(page, {
-            id: '30382501',
-            type: 'Rb',
-            limit: 20,
-            output: '/tmp/douban-test',
-        });
-        expect(mockLoadDoubanSubjectPhotos).toHaveBeenCalledWith(page, '30382501', {
-            type: 'Rb',
-            limit: 20,
-        });
-        expect(mockMkdirSync).toHaveBeenCalledTimes(1);
-        expect(toPosixPath(mockMkdirSync.mock.calls[0][0])).toBe('/tmp/douban-test/30382501');
-        expect(mockMkdirSync.mock.calls[0][1]).toEqual({ recursive: true });
-        expect(mockHttpDownload).toHaveBeenCalledTimes(2);
-        expect(mockHttpDownload.mock.calls[0]?.[0]).toBe('https://img1.doubanio.com/view/photo/l/public/p2913450214.webp');
-        expect(toPosixPath(mockHttpDownload.mock.calls[0]?.[1])).toBe('/tmp/douban-test/30382501/30382501_001_2913450214_Main_poster.webp');
-        expect(mockHttpDownload.mock.calls[0]?.[2]).toEqual(expect.objectContaining({
-            headers: { Referer: 'https://movie.douban.com/photos/photo/2913450214/' },
-            timeout: 60000,
-        }));
-        expect(mockHttpDownload.mock.calls[1]?.[0]).toBe('https://img1.doubanio.com/view/photo/l/public/p2913450215.jpg');
-        expect(toPosixPath(mockHttpDownload.mock.calls[1]?.[1])).toBe('/tmp/douban-test/30382501/30382501_002_2913450215_Character_poster.jpg');
-        expect(mockHttpDownload.mock.calls[1]?.[2]).toEqual(expect.objectContaining({
-            headers: { Referer: 'https://movie.douban.com/photos/photo/2913450215/' },
-            timeout: 60000,
-        }));
-        expect(result).toEqual([
-            {
-                index: 1,
-                title: 'Main poster',
-                photo_id: '2913450214',
-                image_url: 'https://img1.doubanio.com/view/photo/l/public/p2913450214.webp',
-                detail_url: 'https://movie.douban.com/photos/photo/2913450214/',
-                status: 'success',
-                size: '1200 B',
-            },
-            {
-                index: 2,
-                title: 'Character poster',
-                photo_id: '2913450215',
-                image_url: 'https://img1.doubanio.com/view/photo/l/public/p2913450215.jpg',
-                detail_url: 'https://movie.douban.com/photos/photo/2913450215/',
-                status: 'success',
-                size: '980 B',
-            },
-        ]);
-    });
-    it('downloads only the requested photo when photo-id is provided', async () => {
-        const page = {};
-        mockLoadDoubanSubjectPhotos.mockResolvedValue({
-            subjectId: '30382501',
-            subjectTitle: 'The Wandering Earth 2',
-            type: 'Rb',
-            photos: [
-                {
-                    index: 2,
-                    photoId: '2913450215',
-                    title: 'Character poster',
-                    imageUrl: 'https://img1.doubanio.com/view/photo/l/public/p2913450215.jpg',
-                    thumbUrl: 'https://img1.doubanio.com/view/photo/m/public/p2913450215.jpg',
-                    detailUrl: 'https://movie.douban.com/photos/photo/2913450215/',
-                    page: 1,
-                },
-            ],
-        });
-        mockHttpDownload.mockResolvedValueOnce({ success: true, size: 980 });
-        const result = await cmd.func(page, {
-            id: '30382501',
-            type: 'Rb',
-            'photo-id': '2913450215',
-            output: '/tmp/douban-test',
-        });
-        expect(mockLoadDoubanSubjectPhotos).toHaveBeenCalledWith(page, '30382501', {
-            type: 'Rb',
-            targetPhotoId: '2913450215',
-        });
-        expect(mockHttpDownload).toHaveBeenCalledTimes(1);
-        expect(mockHttpDownload.mock.calls[0]?.[0]).toBe('https://img1.doubanio.com/view/photo/l/public/p2913450215.jpg');
-        expect(toPosixPath(mockHttpDownload.mock.calls[0]?.[1])).toBe('/tmp/douban-test/30382501/30382501_002_2913450215_Character_poster.jpg');
-        expect(mockHttpDownload.mock.calls[0]?.[2]).toEqual(expect.objectContaining({
-            headers: { Referer: 'https://movie.douban.com/photos/photo/2913450215/' },
-            timeout: 60000,
-        }));
-        expect(result).toEqual([
-            {
-                index: 2,
-                title: 'Character poster',
-                photo_id: '2913450215',
-                image_url: 'https://img1.doubanio.com/view/photo/l/public/p2913450215.jpg',
-                detail_url: 'https://movie.douban.com/photos/photo/2913450215/',
-                status: 'success',
-                size: '980 B',
-            },
-        ]);
-    });
-    it('rejects invalid subject ids before attempting browser work', async () => {
-        await expect(cmd.func({}, { id: 'movie-30382501' })).rejects.toThrow('Invalid Douban subject ID');
-        expect(mockHttpDownload).not.toHaveBeenCalled();
-    });
-});