@agentrhq/webcmd 0.1.1 → 0.2.0

package/clis/weread/shelf.js

@@ -1,66 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { CliError } from '@agentrhq/webcmd/errors';
-import { log } from '@agentrhq/webcmd/logger';
-import { buildWebShelfEntries, fetchPrivateApi, loadWebShelfSnapshot, } from './utils.js';
-function normalizeShelfLimit(limit) {
-    if (!Number.isFinite(limit))
-        return 0;
-    return Math.max(0, Math.trunc(limit));
-}
-function normalizePrivateApiRows(data, limit) {
-    const books = data?.books ?? [];
-    return books.slice(0, limit).map((item) => ({
-        title: item.bookInfo?.title ?? item.title ?? '',
-        author: item.bookInfo?.author ?? item.author ?? '',
-        // TODO: readingProgress field name from community docs, verify with real API response
-        progress: item.readingProgress != null ? `${item.readingProgress}%` : '-',
-        bookId: item.bookId ?? item.bookInfo?.bookId ?? '',
-    }));
-}
-function normalizeWebShelfRows(snapshot, limit) {
-    if (limit <= 0)
-        return [];
-    return buildWebShelfEntries(snapshot)
-        .map((entry) => ({
-        title: entry.title,
-        author: entry.author,
-        progress: '-',
-        bookId: entry.bookId,
-    }))
-        .filter((item) => Boolean(item.title || item.bookId))
-        .slice(0, limit);
-}
-cli({
-    site: 'weread',
-    name: 'shelf',
-    access: 'read',
-    description: 'List books on your WeRead bookshelf',
-    domain: 'weread.qq.com',
-    strategy: Strategy.COOKIE,
-    args: [
-        { name: 'limit', type: 'int', default: 20, help: 'Max results' },
-    ],
-    columns: ['title', 'author', 'progress', 'bookId'],
-    func: async (page, args) => {
-        const limit = normalizeShelfLimit(Number(args.limit));
-        if (limit <= 0)
-            return [];
-        try {
-            const data = await fetchPrivateApi(page, '/shelf/sync', { synckey: '0', lectureSynckey: '0' });
-            return normalizePrivateApiRows(data, limit);
-        }
-        catch (error) {
-            if (!(error instanceof CliError) || error.code !== 'AUTH_REQUIRED') {
-                throw error;
-            }
-            const snapshot = await loadWebShelfSnapshot(page);
-            if (!snapshot.cacheFound) {
-                throw error;
-            }
-            // Make the fallback explicit so users do not mistake cached shelf data
-            // for a valid private API session.
-            log.warn('WeRead private API auth expired; showing cached shelf data from localStorage. Results may be stale, and detail commands may still require re-login.');
-            return normalizeWebShelfRows(snapshot, limit);
-        }
-    },
-});

package/clis/weread/utils.js

@@ -1,321 +0,0 @@
-/**
- * WeRead shared helpers: fetch wrappers and formatting.
- *
- * Two API domains:
- * - WEB_API (weread.qq.com/web/*): public, Node.js fetch
- * - API (i.weread.qq.com/*): private, Node.js fetch with cookies from browser
- */
-import { CliError } from '@agentrhq/webcmd/errors';
-export const WEREAD_DOMAIN = 'weread.qq.com';
-export const WEREAD_WEB_ORIGIN = `https://${WEREAD_DOMAIN}`;
-export const WEREAD_SHELF_URL = `${WEREAD_WEB_ORIGIN}/web/shelf`;
-const WEB_API = `${WEREAD_WEB_ORIGIN}/web`;
-const API = `https://i.${WEREAD_DOMAIN}`;
-export const WEREAD_UA = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36';
-const WEREAD_AUTH_ERRCODES = new Set([-2010, -2012]);
-function buildCookieHeader(cookies) {
-    return cookies.map((cookie) => `${cookie.name}=${cookie.value}`).join('; ');
-}
-function isAuthErrorResponse(resp, data) {
-    return resp.status === 401 || WEREAD_AUTH_ERRCODES.has(Number(data?.errcode));
-}
-function getCurrentVid(cookies) {
-    return String(cookies.find((cookie) => cookie.name === 'wr_vid')?.value || '').trim();
-}
-function getWebShelfStorageKeys(currentVid) {
-    return {
-        rawBooksKey: `shelf:rawBooks:${currentVid}`,
-        shelfIndexesKey: `shelf:shelfIndexes:${currentVid}`,
-    };
-}
-function normalizeWebShelfSnapshot(value) {
-    return {
-        cacheFound: value?.cacheFound === true,
-        rawBooks: Array.isArray(value?.rawBooks) ? value.rawBooks : [],
-        shelfIndexes: Array.isArray(value?.shelfIndexes) ? value.shelfIndexes : [],
-    };
-}
-function buildShelfSnapshotPollScript(storageKeys, requireTrustedIndexes) {
-    return `
-    (() => new Promise((resolve) => {
-      const deadline = Date.now() + 5000;
-      const rawBooksKey = ${JSON.stringify(storageKeys.rawBooksKey)};
-      const shelfIndexesKey = ${JSON.stringify(storageKeys.shelfIndexesKey)};
-      const requireTrustedIndexes = ${JSON.stringify(requireTrustedIndexes)};
-
-      const readJson = (raw) => {
-        if (typeof raw !== 'string') return null;
-        try {
-          return JSON.parse(raw);
-        } catch {
-          return null;
-        }
-      };
-
-      const collectBookIds = (items) => Array.isArray(items)
-        ? Array.from(new Set(items.map((item) => String(item?.bookId || '').trim()).filter(Boolean)))
-        : [];
-
-      // Mirror of getTrustedIndexedBookIds in Node.js — keep in sync
-      const hasTrustedIndexes = (rawBooks, shelfIndexes) => {
-        const rawBookIds = collectBookIds(rawBooks);
-        if (rawBookIds.length === 0) return false;
-
-        const rawBookIdSet = new Set(rawBookIds);
-        const projectedIndexedBookIds = Array.isArray(shelfIndexes)
-          ? Array.from(new Set(
-              shelfIndexes
-                .filter((entry) => Number.isFinite(entry?.idx))
-                .sort((left, right) => Number(left?.idx ?? Number.MAX_SAFE_INTEGER) - Number(right?.idx ?? Number.MAX_SAFE_INTEGER))
-                .map((entry) => String(entry?.bookId || '').trim())
-                .filter((bookId) => rawBookIdSet.has(bookId)),
-            ))
-          : [];
-
-        return projectedIndexedBookIds.length === rawBookIds.length;
-      };
-
-      const poll = () => {
-        const rawBooks = readJson(localStorage.getItem(rawBooksKey));
-        const shelfIndexes = readJson(localStorage.getItem(shelfIndexesKey));
-        const cacheFound = Array.isArray(rawBooks);
-        const ready = cacheFound && (!requireTrustedIndexes || hasTrustedIndexes(rawBooks, shelfIndexes));
-
-        if (ready || Date.now() >= deadline) {
-          resolve({
-            cacheFound,
-            rawBooks: Array.isArray(rawBooks) ? rawBooks : [],
-            shelfIndexes: Array.isArray(shelfIndexes) ? shelfIndexes : [],
-          });
-          return;
-        }
-
-        setTimeout(poll, 100);
-      };
-
-      poll();
-    }))
-  `;
-}
-/**
- * Fetch a public WeRead web endpoint (Node.js direct fetch).
- * Used by search and ranking commands (browser: false).
- */
-export async function fetchWebApi(path, params) {
-    const url = new URL(`${WEB_API}${path}`);
-    if (params) {
-        for (const [k, v] of Object.entries(params))
-            url.searchParams.set(k, v);
-    }
-    const resp = await fetch(url.toString(), {
-        headers: { 'User-Agent': WEREAD_UA },
-    });
-    if (!resp.ok) {
-        throw new CliError('FETCH_ERROR', `HTTP ${resp.status} for ${path}`, 'WeRead API may be temporarily unavailable');
-    }
-    try {
-        return await resp.json();
-    }
-    catch {
-        throw new CliError('PARSE_ERROR', `Invalid JSON response for ${path}`, 'WeRead may have returned an HTML error page');
-    }
-}
-/**
- * Fetch a private WeRead API endpoint with cookies extracted from the browser.
- * The HTTP request itself runs in Node.js to avoid page-context CORS failures.
- *
- * Cookies are collected from both the API subdomain (i.weread.qq.com) and the
- * main domain (weread.qq.com). WeRead may set auth cookies as host-only on
- * weread.qq.com, which won't match i.weread.qq.com in a URL-based lookup.
- */
-export async function fetchPrivateApi(page, path, params) {
-    const url = new URL(`${API}${path}`);
-    if (params) {
-        for (const [k, v] of Object.entries(params))
-            url.searchParams.set(k, v);
-    }
-    const urlStr = url.toString();
-    // Merge cookies from both domains; API-domain cookies take precedence on name collision
-    const [apiCookies, domainCookies] = await Promise.all([
-        page.getCookies({ url: urlStr }),
-        page.getCookies({ domain: WEREAD_DOMAIN }),
-    ]);
-    const merged = new Map();
-    for (const c of domainCookies)
-        merged.set(c.name, c);
-    for (const c of apiCookies)
-        merged.set(c.name, c);
-    const cookieHeader = buildCookieHeader(Array.from(merged.values()));
-    let resp;
-    try {
-        resp = await fetch(urlStr, {
-            headers: {
-                'User-Agent': WEREAD_UA,
-                'Origin': 'https://weread.qq.com',
-                'Referer': 'https://weread.qq.com/',
-                ...(cookieHeader ? { 'Cookie': cookieHeader } : {}),
-            },
-        });
-    }
-    catch (error) {
-        throw new CliError('FETCH_ERROR', `Failed to fetch ${path}: ${error instanceof Error ? error.message : String(error)}`, 'WeRead API may be temporarily unavailable');
-    }
-    let data;
-    try {
-        data = await resp.json();
-    }
-    catch {
-        throw new CliError('PARSE_ERROR', `Invalid JSON response for ${path}`, 'WeRead may have returned an HTML error page');
-    }
-    if (isAuthErrorResponse(resp, data)) {
-        throw new CliError('AUTH_REQUIRED', 'Not logged in to WeRead', 'Please log in to weread.qq.com in Chrome first');
-    }
-    if (!resp.ok) {
-        throw new CliError('FETCH_ERROR', `HTTP ${resp.status} for ${path}`, 'WeRead API may be temporarily unavailable');
-    }
-    if (data?.errcode != null && data.errcode !== 0) {
-        throw new CliError('API_ERROR', data.errmsg ?? `WeRead API error ${data.errcode}`);
-    }
-    return data;
-}
-function getUniqueRawBookIds(snapshot) {
-    return Array.from(new Set(snapshot.rawBooks
-        .map((book) => String(book?.bookId || '').trim())
-        .filter(Boolean)));
-}
-/** Mirror of hasTrustedIndexes in buildShelfSnapshotPollScript — keep in sync */
-function getTrustedIndexedBookIds(snapshot) {
-    const rawBookIds = getUniqueRawBookIds(snapshot);
-    if (rawBookIds.length === 0)
-        return [];
-    const rawBookIdSet = new Set(rawBookIds);
-    const projectedIndexedBookIds = Array.from(new Set(snapshot.shelfIndexes
-        .filter((entry) => Number.isFinite(entry?.idx))
-        .sort((left, right) => Number(left?.idx ?? Number.MAX_SAFE_INTEGER) - Number(right?.idx ?? Number.MAX_SAFE_INTEGER))
-        .map((entry) => String(entry?.bookId || '').trim())
-        .filter((bookId) => rawBookIdSet.has(bookId))));
-    return projectedIndexedBookIds.length === rawBookIds.length ? projectedIndexedBookIds : [];
-}
-/**
- * Build stable shelf records from the web cache plus optional rendered reader URLs.
- * We only trust shelfIndexes when it fully covers the same bookId set as rawBooks;
- * otherwise we keep rawBooks order to avoid partial hydration reordering entries.
- */
-export function buildWebShelfEntries(snapshot, readerUrls = []) {
-    const rawBookIds = getUniqueRawBookIds(snapshot);
-    const trustedIndexedBookIds = getTrustedIndexedBookIds(snapshot);
-    const orderedBookIds = trustedIndexedBookIds.length > 0 ? trustedIndexedBookIds : rawBookIds;
-    const rawBookById = new Map();
-    for (const book of snapshot.rawBooks) {
-        const bookId = String(book?.bookId || '').trim();
-        if (!bookId || rawBookById.has(bookId))
-            continue;
-        rawBookById.set(bookId, book);
-    }
-    return orderedBookIds.map((bookId, index) => {
-        const book = rawBookById.get(bookId);
-        return {
-            bookId,
-            title: String(book?.title || '').trim(),
-            author: String(book?.author || '').trim(),
-            readerUrl: String(readerUrls[index] || '').trim(),
-        };
-    });
-}
-/**
- * Internal: load shelf snapshot and return the currentVid alongside it,
- * so callers like resolveShelfReaderUrl can reuse it without a second getCookies.
- */
-async function loadWebShelfSnapshotWithVid(page) {
-    await page.goto(WEREAD_SHELF_URL);
-    const cookies = await page.getCookies({ domain: WEREAD_DOMAIN });
-    const currentVid = getCurrentVid(cookies);
-    if (!currentVid) {
-        return { snapshot: { cacheFound: false, rawBooks: [], shelfIndexes: [] }, currentVid: '' };
-    }
-    const result = await page.evaluate(buildShelfSnapshotPollScript(getWebShelfStorageKeys(currentVid), false));
-    return {
-        snapshot: normalizeWebShelfSnapshot(result),
-        currentVid,
-    };
-}
-/**
- * Read the structured shelf cache from the WeRead shelf page.
- * The page hydrates localStorage asynchronously, so we poll briefly before
- * giving up and treating the cache as unavailable for the current session.
- */
-export async function loadWebShelfSnapshot(page) {
-    const { snapshot } = await loadWebShelfSnapshotWithVid(page);
-    return snapshot;
-}
-/**
- * `book` needs a trustworthy `bookId -> readerUrl` mapping, which may lag behind
- * the first rawBooks cache hydration. Keep the fast shelf fallback path separate
- * and only wait here, with a bounded poll, when resolving reader URLs.
- */
-async function waitForTrustedWebShelfSnapshot(page, snapshot, currentVid) {
-    // Cache not available; nothing to wait for
-    if (!snapshot.cacheFound)
-        return snapshot;
-    // Indexes already fully cover rawBooks; no need to re-poll
-    if (getTrustedIndexedBookIds(snapshot).length > 0)
-        return snapshot;
-    if (!currentVid)
-        return snapshot;
-    const result = await page.evaluate(buildShelfSnapshotPollScript(getWebShelfStorageKeys(currentVid), true));
-    return normalizeWebShelfSnapshot(result);
-}
-/**
- * Resolve a shelf bookId to the current web reader URL by pairing structured
- * shelf cache order with the visible shelf links rendered on the page.
- */
-export async function resolveShelfReaderUrl(page, bookId) {
-    const resolution = await resolveShelfReader(page, bookId);
-    return resolution.readerUrl;
-}
-/**
- * Resolve the current reader URL for a shelf entry and return the parsed shelf
- * snapshot used during resolution, so callers can reuse cached title/author
- * metadata without loading the shelf page twice.
- */
-export async function resolveShelfReader(page, bookId) {
-    const { snapshot: initialSnapshot, currentVid } = await loadWebShelfSnapshotWithVid(page);
-    const snapshot = await waitForTrustedWebShelfSnapshot(page, initialSnapshot, currentVid);
-    if (!snapshot.cacheFound) {
-        return { snapshot, readerUrl: null };
-    }
-    const rawBookIds = getUniqueRawBookIds(snapshot);
-    const trustedIndexedBookIds = getTrustedIndexedBookIds(snapshot);
-    const canUseRawOrderFallback = trustedIndexedBookIds.length === 0
-        && rawBookIds.length > 0
-        && snapshot.shelfIndexes.length === 0;
-    if (trustedIndexedBookIds.length === 0 && !canUseRawOrderFallback) {
-        return { snapshot, readerUrl: null };
-    }
-    const readerUrls = await page.evaluate(`
-    (() => Array.from(document.querySelectorAll('a.shelfBook[href]'))
-      .map((anchor) => {
-        const href = anchor.getAttribute('href') || '';
-        return href ? new URL(href, location.origin).toString() : '';
-      })
-      .filter(Boolean))
-  `);
-    const expectedEntryCount = trustedIndexedBookIds.length > 0 ? trustedIndexedBookIds.length : rawBookIds.length;
-    if (readerUrls.length !== expectedEntryCount) {
-        return { snapshot, readerUrl: null };
-    }
-    const entries = buildWebShelfEntries(snapshot, readerUrls);
-    const entry = entries.find((candidate) => candidate.bookId === bookId);
-    return {
-        snapshot,
-        readerUrl: entry?.readerUrl || null,
-    };
-}
-/** Format a Unix timestamp (seconds) to YYYY-MM-DD in UTC+8. Returns '-' for invalid input. */
-export function formatDate(ts) {
-    if (!Number.isFinite(ts) || ts <= 0)
-        return '-';
-    // WeRead timestamps are China-centric; offset to UTC+8 to avoid off-by-one near midnight
-    const d = new Date(ts * 1000 + 8 * 3600_000);
-    return d.toISOString().slice(0, 10);
-}

package/clis/weread/utils.test.js

@@ -1,128 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-import { buildWebShelfEntries, formatDate, fetchWebApi } from './utils.js';
-describe('formatDate', () => {
-    it('formats a typical Unix timestamp in UTC+8', () => {
-        // 1705276800 = 2024-01-15 00:00:00 UTC = 2024-01-15 08:00:00 Beijing
-        expect(formatDate(1705276800)).toBe('2024-01-15');
-    });
-    it('handles UTC midnight edge case with UTC+8 offset', () => {
-        // 1705190399 = 2024-01-13 23:59:59 UTC = 2024-01-14 07:59:59 Beijing
-        expect(formatDate(1705190399)).toBe('2024-01-14');
-    });
-    it('returns dash for zero', () => {
-        expect(formatDate(0)).toBe('-');
-    });
-    it('returns dash for negative', () => {
-        expect(formatDate(-1)).toBe('-');
-    });
-    it('returns dash for NaN', () => {
-        expect(formatDate(NaN)).toBe('-');
-    });
-    it('returns dash for Infinity', () => {
-        expect(formatDate(Infinity)).toBe('-');
-    });
-    it('returns dash for undefined', () => {
-        expect(formatDate(undefined)).toBe('-');
-    });
-    it('returns dash for null', () => {
-        expect(formatDate(null)).toBe('-');
-    });
-});
-describe('fetchWebApi', () => {
-    beforeEach(() => {
-        vi.restoreAllMocks();
-    });
-    it('returns parsed JSON for successful response', async () => {
-        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
-            ok: true,
-            json: () => Promise.resolve({ books: [{ title: 'Test' }] }),
-        }));
-        const result = await fetchWebApi('/search/global', { keyword: 'test' });
-        expect(result).toEqual({ books: [{ title: 'Test' }] });
-    });
-    it('throws CliError on HTTP error', async () => {
-        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
-            ok: false,
-            status: 403,
-            json: () => Promise.resolve({}),
-        }));
-        await expect(fetchWebApi('/search/global')).rejects.toThrow('HTTP 403');
-    });
-    it('throws PARSE_ERROR on non-JSON response', async () => {
-        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
-            ok: true,
-            json: () => Promise.reject(new SyntaxError('Unexpected token <')),
-        }));
-        await expect(fetchWebApi('/search/global')).rejects.toThrow('Invalid JSON');
-    });
-});
-describe('buildWebShelfEntries', () => {
-    it('keeps mixed shelf item reader urls aligned when shelf indexes include non-book roles', () => {
-        const result = buildWebShelfEntries({
-            cacheFound: true,
-            rawBooks: [
-                { bookId: 'MP_WXS_1', title: '公众号文章一', author: '作者甲' },
-                { bookId: 'BOOK_2', title: '普通书二', author: '作者乙' },
-                { bookId: 'MP_WXS_3', title: '公众号文章三', author: '作者丙' },
-            ],
-            shelfIndexes: [
-                { bookId: 'MP_WXS_1', idx: 0, role: 'mp' },
-                { bookId: 'BOOK_2', idx: 1, role: 'book' },
-                { bookId: 'MP_WXS_3', idx: 2, role: 'mp' },
-            ],
-        }, [
-            'https://weread.qq.com/web/reader/mp1',
-            'https://weread.qq.com/web/reader/book2',
-            'https://weread.qq.com/web/reader/mp3',
-        ]);
-        expect(result).toEqual([
-            {
-                bookId: 'MP_WXS_1',
-                title: '公众号文章一',
-                author: '作者甲',
-                readerUrl: 'https://weread.qq.com/web/reader/mp1',
-            },
-            {
-                bookId: 'BOOK_2',
-                title: '普通书二',
-                author: '作者乙',
-                readerUrl: 'https://weread.qq.com/web/reader/book2',
-            },
-            {
-                bookId: 'MP_WXS_3',
-                title: '公众号文章三',
-                author: '作者丙',
-                readerUrl: 'https://weread.qq.com/web/reader/mp3',
-            },
-        ]);
-    });
-    it('falls back to raw cache order when shelf indexes are incomplete', () => {
-        const result = buildWebShelfEntries({
-            cacheFound: true,
-            rawBooks: [
-                { bookId: 'BOOK_1', title: '第一本', author: '作者甲' },
-                { bookId: 'BOOK_2', title: '第二本', author: '作者乙' },
-            ],
-            shelfIndexes: [
-                { bookId: 'BOOK_2', idx: 0, role: 'book' },
-            ],
-        }, [
-            'https://weread.qq.com/web/reader/book1',
-            'https://weread.qq.com/web/reader/book2',
-        ]);
-        expect(result).toEqual([
-            {
-                bookId: 'BOOK_1',
-                title: '第一本',
-                author: '作者甲',
-                readerUrl: 'https://weread.qq.com/web/reader/book1',
-            },
-            {
-                bookId: 'BOOK_2',
-                title: '第二本',
-                author: '作者乙',
-                readerUrl: 'https://weread.qq.com/web/reader/book2',
-            },
-        ]);
-    });
-});

package/clis/weread-official/book.js

@@ -1,135 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import {
-    callGateway,
-    emptyResult,
-    formatDate,
-    formatDuration,
-    formatRating,
-    makeDeepLink,
-    requireBookId,
-    truncate,
-} from './utils.js';
-
-/**
- * 3-in-1 book lookup: `/book/info` always runs; `/book/chapterinfo` and
- * `/book/getprogress` are opt-out via `--no-chapters` / `--no-progress`
- * so users can shave 1-2 gateway calls when only a single section is needed.
- *
- * Output is a flat row list with a `section` column so table/json/yaml
- * consumers can filter without ad-hoc joins:
- *   - section=info       — single row, basic metadata
- *   - section=chapter    — one row per chapter (level/title/wordCount)
- *   - section=progress   — single row, progress % + cumulative read time
- */
-cli({
-    site: 'weread-official',
-    name: 'book',
-    access: 'read',
-    description: 'Show WeRead book metadata, chapters, and reading progress',
-    domain: 'weread.qq.com',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'bookId', positional: true, required: true, help: 'WeRead bookId (from `weread-official search`)' },
-        { name: 'no-chapters', type: 'boolean', default: false, help: 'Skip /book/chapterinfo call' },
-        { name: 'no-progress', type: 'boolean', default: false, help: 'Skip /book/getprogress call' },
-    ],
-    columns: ['section', 'idx', 'key', 'value', 'link'],
-    func: async (args) => {
-        const bookId = requireBookId(args.bookId);
-
-        const tasks = [callGateway('/book/info', { bookId })];
-        const want = {
-            chapters: !args['no-chapters'],
-            progress: !args['no-progress'],
-        };
-        if (want.chapters) tasks.push(callGateway('/book/chapterinfo', { bookId }));
-        if (want.progress) tasks.push(callGateway('/book/getprogress', { bookId }));
-
-        const results = await Promise.all(tasks);
-        let cursor = 0;
-        const info = results[cursor++];
-        const chapters = want.chapters ? results[cursor++] : null;
-        const progress = want.progress ? results[cursor++] : null;
-
-        const rows = [];
-
-        // ── info section ────────────────────────────────────────────────────
-        const infoPairs = [
-            ['bookId', String(info?.bookId ?? bookId)],
-            ['title', String(info?.title ?? '')],
-            ['author', String(info?.author ?? '')],
-            ['translator', String(info?.translator ?? '')],
-            ['category', String(info?.category ?? '')],
-            ['publisher', String(info?.publisher ?? '')],
-            ['publishTime', String(info?.publishTime ?? '')],
-            ['isbn', String(info?.isbn ?? '')],
-            ['wordCount', String(info?.wordCount ?? '')],
-            ['rating', formatRating(info?.newRating)],
-            ['ratingCount', String(info?.newRatingCount ?? '')],
-            ['intro', truncate(info?.intro, 400)],
-            ['cover', String(info?.cover ?? '')],
-        ];
-        for (let i = 0; i < infoPairs.length; i += 1) {
-            const [key, value] = infoPairs[i];
-            rows.push({ section: 'info', idx: i + 1, key, value, link: '' });
-        }
-        rows.push({
-            section: 'info',
-            idx: infoPairs.length + 1,
-            key: 'link',
-            value: '',
-            link: makeDeepLink({ bookId }),
-        });
-
-        // ── chapters section ────────────────────────────────────────────────
-        if (chapters) {
-            const list = Array.isArray(chapters?.chapters) ? chapters.chapters : [];
-            list.forEach((ch, i) => {
-                const chapterUid = String(ch?.chapterUid ?? '').trim();
-                const level = Number(ch?.level ?? 1);
-                const indent = '  '.repeat(Math.max(0, level - 1));
-                const title = `${indent}${String(ch?.title ?? '')}`;
-                const wordCount = Number(ch?.wordCount ?? 0);
-                const paid = Number(ch?.paid ?? 0) === 1;
-                const price = Number(ch?.price ?? 0);
-                const meta = [`${wordCount}字`];
-                if (price > 0) meta.push(paid ? '已购买' : `${price}元`);
-                rows.push({
-                    section: 'chapter',
-                    idx: Number(ch?.chapterIdx ?? i + 1),
-                    key: chapterUid,
-                    value: `${title}  (${meta.join(' · ')})`,
-                    link: chapterUid ? makeDeepLink({ bookId, chapterUid }) : '',
-                });
-            });
-        }
-
-        // ── progress section ────────────────────────────────────────────────
-        if (progress) {
-            const p = progress?.book ?? {};
-            const pct = Number(p?.progress ?? 0);
-            const updateTime = formatDate(p?.updateTime);
-            const finishTime = pct === 100 ? formatDate(p?.finishTime) : '';
-            const cumulative = formatDuration(p?.recordReadingTime);
-            const isStart = Number(p?.isStartReading ?? 0) === 1;
-            const progressPairs = [
-                ['progress', `${pct}%`],
-                ['cumulative', cumulative],
-                ['lastReadAt', updateTime],
-                ['finishedAt', finishTime],
-                ['isStartReading', isStart ? 'true' : 'false'],
-                ['currentChapterUid', String(p?.chapterUid ?? '')],
-            ];
-            for (let i = 0; i < progressPairs.length; i += 1) {
-                const [key, value] = progressPairs[i];
-                rows.push({ section: 'progress', idx: i + 1, key, value, link: '' });
-            }
-        }
-
-        if (rows.length === 0) {
-            emptyResult('book', `No data returned for bookId=${bookId}`);
-        }
-        return rows;
-    },
-});