@agentrhq/webcmd 0.1.2 → 0.2.1

package/clis/weread/book.js

@@ -1,233 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { CliError } from '@agentrhq/webcmd/errors';
-import { fetchPrivateApi, fetchWebApi, resolveShelfReader, WEREAD_UA, WEREAD_WEB_ORIGIN, } from './utils.js';
-function decodeHtmlText(value) {
-    return value
-        .replace(/<[^>]+>/g, '')
-        .replace(/&#x([0-9a-fA-F]+);/gi, (_, n) => String.fromCharCode(parseInt(n, 16)))
-        .replace(/&#(\d+);/g, (_, n) => String.fromCharCode(Number(n)))
-        .replace(/&nbsp;/g, ' ')
-        .replace(/&amp;/g, '&')
-        .replace(/&quot;/g, '"')
-        .trim();
-}
-function normalizeSearchText(value) {
-    return value.replace(/\s+/g, ' ').trim();
-}
-function buildSearchIdentity(title, author) {
-    return `${normalizeSearchText(title)}\u0000${normalizeSearchText(author)}`;
-}
-function countSearchTitles(entries) {
-    const counts = new Map();
-    for (const entry of entries) {
-        const key = normalizeSearchText(entry.title);
-        if (!key)
-            continue;
-        counts.set(key, (counts.get(key) || 0) + 1);
-    }
-    return counts;
-}
-function countSearchIdentities(entries) {
-    const counts = new Map();
-    for (const entry of entries) {
-        const key = buildSearchIdentity(entry.title, entry.author);
-        if (!normalizeSearchText(entry.title) || !normalizeSearchText(entry.author))
-            continue;
-        counts.set(key, (counts.get(key) || 0) + 1);
-    }
-    return counts;
-}
-export function strictTitleFromWereadDocumentTitle(rawTitle) {
-    const suffix = ' - 微信读书';
-    const normalized = String(rawTitle || '').trim();
-    if (!normalized.endsWith(suffix))
-        return '';
-    const base = normalized.slice(0, -suffix.length).trim();
-    // Only accept the title when WeRead exposes the strict "<title> - 微信读书"
-    // shape. If extra separators remain, the page title is ambiguous.
-    return base.includes(' - ') ? '' : base;
-}
-export function extractReaderFallbackMetadata(doc) {
-    const text = (node) => node?.textContent?.trim() || '';
-    const firstText = (...sels) => { for (const s of sels) {
-        const v = text(doc.querySelector(s));
-        if (v)
-            return v;
-    } return ''; };
-    const bodyText = doc.body?.innerText?.replace(/\s+/g, ' ').trim() || '';
-    const extractRating = () => {
-        const match = bodyText.match(/微信读书推荐值\s*([0-9.]+%)/);
-        return match ? match[1] : '';
-    };
-    const extractPublisher = () => {
-        const direct = text(doc.querySelector('.introDialog_content_pub_line'));
-        return direct.startsWith('出版社') ? direct.replace(/^出版社\s*/, '').trim() : '';
-    };
-    const extractIntro = () => {
-        const selectors = [
-            '.horizontalReaderCoverPage_content_bookInfo_intro',
-            '.wr_flyleaf_page_bookIntro_content',
-            '.introDialog_content_intro_para',
-        ];
-        for (const selector of selectors) {
-            const value = text(doc.querySelector(selector));
-            if (value)
-                return value;
-        }
-        return '';
-    };
-    const categorySource = Array.from(doc.scripts || [])
-        .map((script) => script.textContent || '')
-        .find((scriptText) => scriptText.includes('"category"')) || '';
-    const categoryMatch = categorySource.match(/"category"\s*:\s*"([^"]+)"/);
-    const title = firstText('.horizontalReaderCoverPage_content_bookTitle', '.wr_flyleaf_page_bookInfo_bookTitle', '.outline_book_detail_header_title', '.readerTopBar_title_link') || strictTitleFromWereadDocumentTitle(doc.title || '');
-    const author = firstText('.horizontalReaderCoverPage_content_author', '.wr_flyleaf_page_bookInfo_author', '.outline_book_detail_header_author');
-    return {
-        title,
-        author,
-        publisher: extractPublisher(),
-        intro: extractIntro(),
-        category: categoryMatch ? categoryMatch[1].trim() : '',
-        rating: extractRating(),
-        metadataReady: Boolean(title || author),
-    };
-}
-/**
- * Reuse the public search page as a last-resort reader URL source when the
- * cached shelf page cannot provide a trustworthy bookId-to-reader mapping.
- */
-async function resolveSearchReaderUrl(title, author) {
-    const normalizedTitle = normalizeSearchText(title);
-    const normalizedAuthor = normalizeSearchText(author);
-    if (!normalizedTitle)
-        return '';
-    try {
-        const [data, htmlEntries] = await Promise.all([
-            fetchWebApi('/search/global', { keyword: normalizedTitle }),
-            (async () => {
-                const url = new URL('/web/search/books', WEREAD_WEB_ORIGIN);
-                url.searchParams.set('keyword', normalizedTitle);
-                const resp = await fetch(url.toString(), {
-                    headers: { 'User-Agent': WEREAD_UA },
-                });
-                if (!resp.ok)
-                    return [];
-                const html = await resp.text();
-                const items = Array.from(html.matchAll(/<li[^>]*class="wr_bookList_item"[^>]*>([\s\S]*?)<\/li>/g));
-                return items.map((match) => {
-                    const chunk = match[1];
-                    const hrefMatch = chunk.match(/<a[^>]*href="([^"]+)"[^>]*class="wr_bookList_item_link"[^>]*>|<a[^>]*class="wr_bookList_item_link"[^>]*href="([^"]+)"[^>]*>/);
-                    const titleMatch = chunk.match(/<p[^>]*class="wr_bookList_item_title"[^>]*>([\s\S]*?)<\/p>/);
-                    const authorMatch = chunk.match(/<p[^>]*class="wr_bookList_item_author"[^>]*>([\s\S]*?)<\/p>/);
-                    const href = hrefMatch?.[1] || hrefMatch?.[2] || '';
-                    return {
-                        title: decodeHtmlText(titleMatch?.[1] || ''),
-                        author: decodeHtmlText(authorMatch?.[1] || ''),
-                        url: href ? new URL(href, WEREAD_WEB_ORIGIN).toString() : '',
-                    };
-                }).filter((entry) => entry.title && entry.url);
-            })(),
-        ]);
-        const books = Array.isArray(data?.books) ? data.books : [];
-        const apiIdentityCounts = countSearchIdentities(books.map((item) => ({
-            title: item.bookInfo?.title ?? '',
-            author: item.bookInfo?.author ?? '',
-        })));
-        const htmlIdentityCounts = countSearchIdentities(htmlEntries.filter((entry) => entry.author));
-        const identityKey = buildSearchIdentity(normalizedTitle, normalizedAuthor);
-        if (normalizedAuthor &&
-            (apiIdentityCounts.get(identityKey) || 0) === 1 &&
-            (htmlIdentityCounts.get(identityKey) || 0) === 1) {
-            const exactMatch = htmlEntries.find((entry) => buildSearchIdentity(entry.title, entry.author) === identityKey);
-            if (exactMatch?.url)
-                return exactMatch.url;
-        }
-        const sameTitleHtmlEntries = htmlEntries.filter((entry) => normalizeSearchText(entry.title) === normalizedTitle);
-        if (normalizedAuthor && sameTitleHtmlEntries.some((entry) => normalizeSearchText(entry.author))) {
-            return '';
-        }
-        const apiTitleCounts = countSearchTitles(books.map((item) => ({ title: item.bookInfo?.title ?? '' })));
-        const htmlTitleCounts = countSearchTitles(htmlEntries);
-        if ((apiTitleCounts.get(normalizedTitle) || 0) !== 1 || (htmlTitleCounts.get(normalizedTitle) || 0) !== 1) {
-            return '';
-        }
-        return htmlEntries.find((entry) => normalizeSearchText(entry.title) === normalizedTitle)?.url || '';
-    }
-    catch {
-        return '';
-    }
-}
-/**
- * Read visible book metadata from the web reader cover/flyleaf page.
- * This path is used as a fallback when the private API session has expired.
- */
-async function loadReaderFallbackResult(page, readerUrl) {
-    await page.goto(readerUrl);
-    await page.wait({ selector: '.horizontalReaderCoverPage_content_bookTitle, .wr_flyleaf_page_bookInfo_bookTitle, .readerTopBar_title_link', timeout: 10 });
-    const result = await page.evaluate(`
-    (${extractReaderFallbackMetadata.toString()})(document)
-  `);
-    return {
-        title: String(result?.title || '').trim(),
-        author: String(result?.author || '').trim(),
-        publisher: String(result?.publisher || '').trim(),
-        intro: String(result?.intro || '').trim(),
-        category: String(result?.category || '').trim(),
-        rating: String(result?.rating || '').trim(),
-        metadataReady: result?.metadataReady === true,
-    };
-}
-cli({
-    site: 'weread',
-    name: 'book',
-    access: 'read',
-    description: 'View book details on WeRead',
-    domain: 'weread.qq.com',
-    strategy: Strategy.COOKIE,
-    args: [
-        { name: 'book-id', positional: true, required: true, help: 'Book ID from search or shelf results' },
-    ],
-    columns: ['title', 'author', 'publisher', 'intro', 'category', 'rating'],
-    func: async (page, args) => {
-        const bookId = String(args['book-id'] || '').trim();
-        try {
-            const data = await fetchPrivateApi(page, '/book/info', { bookId });
-            // newRating is 0-1000 scale per community docs; needs runtime verification
-            const rating = data.newRating ? `${(data.newRating / 10).toFixed(1)}%` : '-';
-            return [{
-                    title: data.title ?? '',
-                    author: data.author ?? '',
-                    publisher: data.publisher ?? '',
-                    intro: data.intro ?? '',
-                    category: data.category ?? '',
-                    rating,
-                }];
-        }
-        catch (error) {
-            if (!(error instanceof CliError) || error.code !== 'AUTH_REQUIRED') {
-                throw error;
-            }
-            const { readerUrl: resolvedReaderUrl, snapshot } = await resolveShelfReader(page, bookId);
-            let readerUrl = resolvedReaderUrl;
-            if (!readerUrl) {
-                const cachedBook = snapshot.rawBooks.find((book) => String(book?.bookId || '').trim() === bookId);
-                readerUrl = await resolveSearchReaderUrl(String(cachedBook?.title || ''), String(cachedBook?.author || ''));
-            }
-            if (!readerUrl) {
-                throw error;
-            }
-            const data = await loadReaderFallbackResult(page, readerUrl);
-            if (!data.metadataReady || !data.title) {
-                throw error;
-            }
-            return [{
-                    title: data.title,
-                    author: data.author,
-                    publisher: data.publisher,
-                    intro: data.intro,
-                    category: data.category,
-                    rating: data.rating,
-                }];
-        }
-    },
-});

package/clis/weread/commands.test.js

@@ -1,398 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-import { CliError } from '@agentrhq/webcmd/errors';
-const { mockFetchPrivateApi } = vi.hoisted(() => ({
-    mockFetchPrivateApi: vi.fn(),
-}));
-vi.mock('./utils.js', async () => {
-    const actual = await vi.importActual('./utils.js');
-    return {
-        ...actual,
-        fetchPrivateApi: mockFetchPrivateApi,
-    };
-});
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import './book.js';
-import './highlights.js';
-import './notes.js';
-import { extractReaderFallbackMetadata, strictTitleFromWereadDocumentTitle } from './book.js';
-describe('weread book-id positional args', () => {
-    const book = getRegistry().get('weread/book');
-    const highlights = getRegistry().get('weread/highlights');
-    const notes = getRegistry().get('weread/notes');
-    const repeatValue = (value, count) => Array.from({ length: count }, () => value);
-    const createPageStub = (...evaluateResults) => ({
-        getCookies: vi.fn().mockResolvedValue([
-            { name: 'wr_vid', value: '70486028', domain: '.weread.qq.com' },
-        ]),
-        goto: vi.fn().mockResolvedValue(undefined),
-        wait: vi.fn().mockResolvedValue(undefined),
-        evaluate: vi.fn().mockImplementation(async () => evaluateResults.shift()),
-    });
-    beforeEach(() => {
-        mockFetchPrivateApi.mockReset();
-        vi.unstubAllGlobals();
-    });
-    it('passes the positional book-id to book details', async () => {
-        mockFetchPrivateApi.mockResolvedValue({ title: 'Three Body', newRating: 880 });
-        await book.func({}, { 'book-id': '12345' });
-        expect(mockFetchPrivateApi).toHaveBeenCalledWith({}, '/book/info', { bookId: '12345' });
-    });
-    it('falls back to the shelf reader page when private API auth has expired', async () => {
-        mockFetchPrivateApi.mockRejectedValue(new CliError('AUTH_REQUIRED', 'Not logged in to WeRead', 'Please log in to weread.qq.com in Chrome first'));
-        const page = createPageStub({
-            cacheFound: true,
-            rawBooks: [
-                { bookId: 'MP_WXS_3634777637', title: '文明、现代化、价值投资与中国', author: '李录' },
-            ],
-            shelfIndexes: [
-                { bookId: 'MP_WXS_3634777637', idx: 0, role: 'book' },
-            ],
-        }, ['https://weread.qq.com/web/reader/6f5323f071bd7f7b6f521e8'], {
-            title: '文明、现代化、价值投资与中国',
-            author: '李录',
-            publisher: '中信出版集团',
-            intro: '对中国未来几十年的预测。',
-            category: '',
-            rating: '84.1%',
-            metadataReady: true,
-        });
-        const result = await book.func(page, { 'book-id': 'MP_WXS_3634777637' });
-        expect(page.goto).toHaveBeenNthCalledWith(1, 'https://weread.qq.com/web/shelf');
-        expect(page.goto).toHaveBeenNthCalledWith(2, 'https://weread.qq.com/web/reader/6f5323f071bd7f7b6f521e8');
-        expect(page.evaluate).toHaveBeenCalledTimes(3);
-        expect(result).toEqual([
-            {
-                title: '文明、现代化、价值投资与中国',
-                author: '李录',
-                publisher: '中信出版集团',
-                intro: '对中国未来几十年的预测。',
-                category: '',
-                rating: '84.1%',
-            },
-        ]);
-    });
-    it('keeps mixed shelf entries aligned when resolving MP_WXS reader urls', async () => {
-        mockFetchPrivateApi.mockRejectedValue(new CliError('AUTH_REQUIRED', 'Not logged in to WeRead', 'Please log in to weread.qq.com in Chrome first'));
-        const page = createPageStub({
-            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',
-        ], {
-            title: '公众号文章一',
-            author: '作者甲',
-            publisher: '微信读书',
-            intro: '第一篇文章。',
-            category: '',
-            rating: '',
-            metadataReady: true,
-        });
-        const result = await book.func(page, { 'book-id': 'MP_WXS_1' });
-        expect(page.goto).toHaveBeenNthCalledWith(1, 'https://weread.qq.com/web/shelf');
-        expect(page.goto).toHaveBeenNthCalledWith(2, 'https://weread.qq.com/web/reader/mp1');
-        expect(result).toEqual([
-            {
-                title: '公众号文章一',
-                author: '作者甲',
-                publisher: '微信读书',
-                intro: '第一篇文章。',
-                category: '',
-                rating: '',
-            },
-        ]);
-    });
-    it('rethrows AUTH_REQUIRED when shelf ordering is incomplete and reader urls cannot be trusted', async () => {
-        mockFetchPrivateApi.mockRejectedValue(new CliError('AUTH_REQUIRED', 'Not logged in to WeRead', 'Please log in to weread.qq.com in Chrome first'));
-        vi.stubGlobal('fetch', vi.fn().mockRejectedValue(new Error('network disabled')));
-        const page = createPageStub({
-            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/book2',
-            'https://weread.qq.com/web/reader/book1',
-        ]);
-        await expect(book.func(page, { 'book-id': 'BOOK_1' })).rejects.toMatchObject({
-            code: 'AUTH_REQUIRED',
-            message: 'Not logged in to WeRead',
-        });
-        expect(page.goto).toHaveBeenCalledTimes(1);
-        expect(page.goto).toHaveBeenNthCalledWith(1, 'https://weread.qq.com/web/shelf');
-    });
-    it('falls back to the public search page when a cached ordinary book has no trusted shelf reader url', async () => {
-        mockFetchPrivateApi.mockRejectedValue(new CliError('AUTH_REQUIRED', 'Not logged in to WeRead', 'Please log in to weread.qq.com in Chrome first'));
-        const fetchMock = vi.fn()
-            .mockResolvedValueOnce({
-            ok: true,
-            json: () => Promise.resolve({
-                books: [
-                    {
-                        bookInfo: {
-                            title: '数据化运营：系统方法与实践案例',
-                            author: '赵宏田 江丽萍 李宁',
-                            bookId: '22920382',
-                        },
-                    },
-                ],
-            }),
-        })
-            .mockResolvedValueOnce({
-            ok: true,
-            text: () => Promise.resolve(`
-          <ul class="search_bookDetail_list">
-            <li class="wr_bookList_item">
-              <a class="wr_bookList_item_link" href="/web/reader/book229"></a>
-              <p class="wr_bookList_item_title">数据化运营：系统方法与实践案例</p>
-              <p class="wr_bookList_item_author">赵宏田 江丽萍 李宁</p>
-            </li>
-          </ul>
-        `),
-        });
-        vi.stubGlobal('fetch', fetchMock);
-        const staleSnapshot = {
-            cacheFound: true,
-            rawBooks: [
-                { bookId: '22920382', title: '数据化运营：系统方法与实践案例', author: '赵宏田 江丽萍 李宁' },
-            ],
-            shelfIndexes: [
-                { bookId: 'stale-entry', idx: 0, role: 'book' },
-            ],
-        };
-        const page = createPageStub(...repeatValue(staleSnapshot, 2), {
-            title: '数据化运营：系统方法与实践案例',
-            author: '赵宏田 江丽萍 李宁',
-            publisher: '电子工业出版社',
-            intro: '一本关于数据化运营的方法论书籍。',
-            category: '',
-            rating: '',
-            metadataReady: true,
-        });
-        const result = await book.func(page, { 'book-id': '22920382' });
-        expect(fetchMock).toHaveBeenCalledTimes(2);
-        expect(String(fetchMock.mock.calls[0][0])).toContain('/web/search/global?keyword=');
-        expect(String(fetchMock.mock.calls[1][0])).toContain('/web/search/books?keyword=');
-        expect(page.goto).toHaveBeenNthCalledWith(1, 'https://weread.qq.com/web/shelf');
-        expect(page.goto).toHaveBeenNthCalledWith(2, 'https://weread.qq.com/web/reader/book229');
-        expect(result).toEqual([
-            {
-                title: '数据化运营：系统方法与实践案例',
-                author: '赵宏田 江丽萍 李宁',
-                publisher: '电子工业出版社',
-                intro: '一本关于数据化运营的方法论书籍。',
-                category: '',
-                rating: '',
-            },
-        ]);
-    });
-    it('rethrows AUTH_REQUIRED when search fallback finds the same title with a different visible author', async () => {
-        mockFetchPrivateApi.mockRejectedValue(new CliError('AUTH_REQUIRED', 'Not logged in to WeRead', 'Please log in to weread.qq.com in Chrome first'));
-        const fetchMock = vi.fn()
-            .mockResolvedValueOnce({
-            ok: true,
-            json: () => Promise.resolve({
-                books: [
-                    {
-                        bookInfo: {
-                            title: '文明',
-                            author: '作者乙',
-                            bookId: 'wrong-book',
-                        },
-                    },
-                ],
-            }),
-        })
-            .mockResolvedValueOnce({
-            ok: true,
-            text: () => Promise.resolve(`
-          <ul class="search_bookDetail_list">
-            <li class="wr_bookList_item">
-              <a class="wr_bookList_item_link" href="/web/reader/wrong-reader"></a>
-              <p class="wr_bookList_item_title">文明</p>
-              <p class="wr_bookList_item_author">作者乙</p>
-            </li>
-          </ul>
-        `),
-        });
-        vi.stubGlobal('fetch', fetchMock);
-        const staleSnapshot = {
-            cacheFound: true,
-            rawBooks: [
-                { bookId: 'BOOK_1', title: '文明', author: '作者甲' },
-            ],
-            shelfIndexes: [
-                { bookId: 'stale-entry', idx: 0, role: 'book' },
-            ],
-        };
-        const page = createPageStub(...repeatValue(staleSnapshot, 2));
-        await expect(book.func(page, { 'book-id': 'BOOK_1' })).rejects.toMatchObject({
-            code: 'AUTH_REQUIRED',
-            message: 'Not logged in to WeRead',
-        });
-        expect(fetchMock).toHaveBeenCalledTimes(2);
-        expect(page.goto).toHaveBeenNthCalledWith(1, 'https://weread.qq.com/web/shelf');
-    });
-    it('falls back to raw cache order when shelf indexes never hydrate but rendered reader urls cover every cached entry', async () => {
-        mockFetchPrivateApi.mockRejectedValue(new CliError('AUTH_REQUIRED', 'Not logged in to WeRead', 'Please log in to weread.qq.com in Chrome first'));
-        vi.stubGlobal('fetch', vi.fn().mockRejectedValue(new Error('network disabled')));
-        const emptyIndexSnapshot = {
-            cacheFound: true,
-            rawBooks: [
-                { bookId: '22920382', title: '数据化运营：系统方法与实践案例', author: '赵宏田 江丽萍 李宁' },
-                { bookId: 'MP_WXS_3634777637', title: '方伟看10年', author: '公众号' },
-            ],
-            shelfIndexes: [],
-        };
-        const page = createPageStub(...repeatValue(emptyIndexSnapshot, 2), [
-            'https://weread.qq.com/web/reader/book229',
-            'https://weread.qq.com/web/reader/mp3634',
-        ], {
-            title: '方伟看10年',
-            author: '公众号',
-            publisher: '',
-            intro: '公众号文章详情。',
-            category: '',
-            rating: '',
-            metadataReady: true,
-        });
-        const result = await book.func(page, { 'book-id': 'MP_WXS_3634777637' });
-        expect(page.goto).toHaveBeenNthCalledWith(1, 'https://weread.qq.com/web/shelf');
-        expect(page.goto).toHaveBeenNthCalledWith(2, 'https://weread.qq.com/web/reader/mp3634');
-        expect(result).toEqual([
-            {
-                title: '方伟看10年',
-                author: '公众号',
-                publisher: '',
-                intro: '公众号文章详情。',
-                category: '',
-                rating: '',
-            },
-        ]);
-    });
-    it('waits for shelf indexes to hydrate before resolving a trusted reader url', async () => {
-        mockFetchPrivateApi.mockRejectedValue(new CliError('AUTH_REQUIRED', 'Not logged in to WeRead', 'Please log in to weread.qq.com in Chrome first'));
-        const page = createPageStub({
-            cacheFound: true,
-            rawBooks: [
-                { bookId: 'BOOK_1', title: '第一本', author: '作者甲' },
-                { bookId: 'BOOK_2', title: '第二本', author: '作者乙' },
-            ],
-            shelfIndexes: [
-                { bookId: 'BOOK_2', idx: 0, role: 'book' },
-            ],
-        }, {
-            cacheFound: true,
-            rawBooks: [
-                { bookId: 'BOOK_1', title: '第一本', author: '作者甲' },
-                { bookId: 'BOOK_2', title: '第二本', author: '作者乙' },
-            ],
-            shelfIndexes: [
-                { bookId: 'BOOK_2', idx: 0, role: 'book' },
-                { bookId: 'BOOK_1', idx: 1, role: 'book' },
-            ],
-        }, [
-            'https://weread.qq.com/web/reader/book2',
-            'https://weread.qq.com/web/reader/book1',
-        ], {
-            title: '第一本',
-            author: '作者甲',
-            publisher: '出版社甲',
-            intro: '简介甲',
-            category: '',
-            rating: '',
-            metadataReady: true,
-        });
-        const result = await book.func(page, { 'book-id': 'BOOK_1' });
-        expect(page.goto).toHaveBeenNthCalledWith(1, 'https://weread.qq.com/web/shelf');
-        expect(page.goto).toHaveBeenNthCalledWith(2, 'https://weread.qq.com/web/reader/book1');
-        expect(result).toEqual([
-            {
-                title: '第一本',
-                author: '作者甲',
-                publisher: '出版社甲',
-                intro: '简介甲',
-                category: '',
-                rating: '',
-            },
-        ]);
-    });
-    it('rethrows AUTH_REQUIRED when the reader page lacks stable cover metadata', async () => {
-        mockFetchPrivateApi.mockRejectedValue(new CliError('AUTH_REQUIRED', 'Not logged in to WeRead', 'Please log in to weread.qq.com in Chrome first'));
-        const page = createPageStub({
-            cacheFound: true,
-            rawBooks: [
-                { bookId: 'BOOK_1', title: '第一本', author: '作者甲' },
-            ],
-            shelfIndexes: [
-                { bookId: 'BOOK_1', idx: 0, role: 'book' },
-            ],
-        }, [
-            'https://weread.qq.com/web/reader/book1',
-        ], {
-            title: '',
-            author: '',
-            publisher: '',
-            intro: '这是正文第一段，不应该被当成简介。',
-            category: '',
-            rating: '',
-            metadataReady: false,
-        });
-        await expect(book.func(page, { 'book-id': 'BOOK_1' })).rejects.toMatchObject({
-            code: 'AUTH_REQUIRED',
-            message: 'Not logged in to WeRead',
-        });
-    });
-    it('does not guess author from document.title when the reader page skips cover metadata', async () => {
-        const nodes = new Map([
-            ['.readerTopBar_title_link', { textContent: 'Part 1 - Part 2' }],
-            ['.introDialog_content_pub_line', { textContent: '出版社 测试出版社' }],
-            ['.introDialog_content_intro_para', { textContent: '测试简介。' }],
-        ]);
-        const mockDocument = {
-            title: 'Part 1 - Part 2 - 作者甲 - 微信读书',
-            body: { innerText: '微信读书推荐值 88.8%' },
-            scripts: [],
-            querySelector: (selector) => nodes.get(selector) || null,
-        };
-        expect(strictTitleFromWereadDocumentTitle(mockDocument.title)).toBe('');
-        expect(extractReaderFallbackMetadata(mockDocument)).toEqual({
-            title: 'Part 1 - Part 2',
-            author: '',
-            publisher: '测试出版社',
-            intro: '测试简介。',
-            category: '',
-            rating: '88.8%',
-            metadataReady: true,
-        });
-    });
-    it('passes the positional book-id to highlights', async () => {
-        mockFetchPrivateApi.mockResolvedValue({ updated: [] });
-        await highlights.func({}, { 'book-id': 'abc', limit: 5 });
-        expect(mockFetchPrivateApi).toHaveBeenCalledWith({}, '/book/bookmarklist', { bookId: 'abc' });
-    });
-    it('passes the positional book-id to notes', async () => {
-        mockFetchPrivateApi.mockResolvedValue({ reviews: [] });
-        await notes.func({}, { 'book-id': 'xyz', limit: 5 });
-        expect(mockFetchPrivateApi).toHaveBeenCalledWith({}, '/review/list', {
-            bookId: 'xyz',
-            listType: '11',
-            mine: '1',
-            synckey: '0',
-        });
-    });
-});

package/clis/weread/highlights.js

@@ -1,24 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { fetchPrivateApi, formatDate } from './utils.js';
-cli({
-    site: 'weread',
-    name: 'highlights',
-    access: 'read',
-    description: 'List your highlights (underlines) in a book',
-    domain: 'weread.qq.com',
-    strategy: Strategy.COOKIE,
-    args: [
-        { name: 'book-id', positional: true, required: true, help: 'Book ID (from shelf or search results)' },
-        { name: 'limit', type: 'int', default: 20, help: 'Max results' },
-    ],
-    columns: ['chapter', 'text', 'createTime'],
-    func: async (page, args) => {
-        const data = await fetchPrivateApi(page, '/book/bookmarklist', { bookId: args['book-id'] });
-        const items = data?.updated ?? [];
-        return items.slice(0, Number(args.limit)).map((item) => ({
-            chapter: item.chapterName ?? '',
-            text: item.markText ?? '',
-            createTime: formatDate(item.createTime),
-        }));
-    },
-});

package/clis/weread/notebooks.js

@@ -1,22 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { fetchPrivateApi } from './utils.js';
-cli({
-    site: 'weread',
-    name: 'notebooks',
-    access: 'read',
-    description: 'List books that have highlights or notes',
-    domain: 'weread.qq.com',
-    strategy: Strategy.COOKIE,
-    columns: ['title', 'author', 'noteCount', 'bookId'],
-    func: async (page, _args) => {
-        const data = await fetchPrivateApi(page, '/user/notebooks');
-        const books = data?.books ?? [];
-        return books.map((item) => ({
-            title: item.book?.title ?? '',
-            author: item.book?.author ?? '',
-            // TODO: bookmarkCount/reviewCount field names from community docs, verify with real API
-            noteCount: (item.bookmarkCount ?? 0) + (item.reviewCount ?? 0),
-            bookId: item.bookId ?? '',
-        }));
-    },
-});