@jackwener/opencli 1.5.6 → 1.5.7

package/dist/clis/notebooklm/utils.test.d.ts

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

package/dist/clis/notebooklm/utils.test.js

@@ -0,0 +1,390 @@
+import { describe, expect, it } from 'vitest';
+import { buildNotebooklmRpcBody, classifyNotebooklmPage, extractNotebooklmHistoryPreview, extractNotebooklmRpcResult, getNotebooklmPageState, normalizeNotebooklmTitle, parseNotebooklmHistoryThreadIdsResult, parseNotebooklmIdFromUrl, parseNotebooklmListResult, parseNotebooklmNoteListRawRows, parseNotebooklmNotebookDetailResult, parseNotebooklmSourceFulltextResult, parseNotebooklmSourceGuideResult, parseNotebooklmSourceListResult, } from './utils.js';
+describe('notebooklm utils', () => {
+    it('parses notebook id from a notebook url', () => {
+        expect(parseNotebooklmIdFromUrl('https://notebooklm.google.com/notebook/abc-123')).toBe('abc-123');
+    });
+    it('returns empty string when notebook id is absent', () => {
+        expect(parseNotebooklmIdFromUrl('https://notebooklm.google.com/')).toBe('');
+    });
+    it('classifies notebook pages correctly', () => {
+        expect(classifyNotebooklmPage('https://notebooklm.google.com/notebook/demo-id')).toBe('notebook');
+        expect(classifyNotebooklmPage('https://notebooklm.google.com/')).toBe('home');
+        expect(classifyNotebooklmPage('https://example.com/notebook/demo-id')).toBe('unknown');
+    });
+    it('normalizes notebook titles', () => {
+        expect(normalizeNotebooklmTitle('  Demo   Notebook  ')).toBe('Demo Notebook');
+        expect(normalizeNotebooklmTitle('', 'Untitled')).toBe('Untitled');
+    });
+    it('builds the notebooklm rpc request body with csrf token', () => {
+        const body = buildNotebooklmRpcBody('wXbhsf', [null, 1, null, [2]], 'csrf123');
+        expect(body).toContain('f.req=');
+        expect(body).toContain('at=csrf123');
+        expect(body.endsWith('&')).toBe(true);
+        expect(decodeURIComponent(body)).toContain('"[null,1,null,[2]]"');
+    });
+    it('extracts notebooklm rpc payload from chunked batchexecute response', () => {
+        const raw = ')]}\'\n107\n[["wrb.fr","wXbhsf","[[[\\"Notebook One\\",null,\\"nb1\\",null,null,[null,false,null,null,null,[1704067200]]]]]"]]';
+        const result = extractNotebooklmRpcResult(raw, 'wXbhsf');
+        expect(Array.isArray(result)).toBe(true);
+        expect(result[0]).toBeDefined();
+    });
+    it('parses notebook rows from notebooklm rpc payload', () => {
+        const rows = parseNotebooklmListResult([
+            [
+                ['Notebook One', null, 'nb1', null, null, [null, false, null, null, null, [1704067200]]],
+            ],
+        ]);
+        expect(rows).toEqual([
+            {
+                id: 'nb1',
+                title: 'Notebook One',
+                url: 'https://notebooklm.google.com/notebook/nb1',
+                source: 'rpc',
+                is_owner: true,
+                created_at: '2024-01-01T00:00:00.000Z',
+            },
+        ]);
+    });
+    it('parses notebook metadata from notebook detail rpc payload', () => {
+        const notebook = parseNotebooklmNotebookDetailResult([
+            'Browser Automation',
+            [
+                [
+                    [['src1']],
+                    'Pasted text',
+                    [null, 359, [1774872183, 855096000], ['doc1', [1774872183, 356519000]], 8, null, 1, null, null, null, null, null, null, null, [1774872185, 395271000]],
+                    [null, 2],
+                ],
+            ],
+            'nb-demo',
+            '🕸️',
+            null,
+            [1, false, true, null, null, [1774889558, 348721000], 1, false, [1774872161, 361922000], null, null, null, false, true, 1, false, null, true, 1],
+        ]);
+        expect(notebook).toEqual({
+            id: 'nb-demo',
+            title: 'Browser Automation',
+            url: 'https://notebooklm.google.com/notebook/nb-demo',
+            source: 'rpc',
+            emoji: '🕸️',
+            source_count: 1,
+            is_owner: true,
+            created_at: '2026-03-30T12:02:41.361Z',
+            updated_at: '2026-03-30T16:52:38.348Z',
+        });
+    });
+    it('parses notebook metadata when detail rpc wraps the payload in a singleton envelope', () => {
+        const notebook = parseNotebooklmNotebookDetailResult([
+            [
+                'Browser Automation',
+                [
+                    [
+                        [['src1']],
+                        'Pasted text',
+                        [null, 359, [1774872183, 855096000], ['doc1', [1774872183, 356519000]], 8, null, 1, null, null, null, null, null, null, null, [1774872185, 395271000]],
+                        [null, 2],
+                    ],
+                ],
+                'nb-demo',
+                '🕸️',
+                null,
+                [1, false, true, null, null, [1774889558, 348721000], 1, false, [1774872161, 361922000], null, null, null, false, true, 1, false, null, true, 1],
+            ],
+        ]);
+        expect(notebook).toEqual({
+            id: 'nb-demo',
+            title: 'Browser Automation',
+            url: 'https://notebooklm.google.com/notebook/nb-demo',
+            source: 'rpc',
+            emoji: '🕸️',
+            source_count: 1,
+            is_owner: true,
+            created_at: '2026-03-30T12:02:41.361Z',
+            updated_at: '2026-03-30T16:52:38.348Z',
+        });
+    });
+    it('parses sources from notebook detail rpc payload', () => {
+        const rows = parseNotebooklmSourceListResult([
+            'Browser Automation',
+            [
+                [
+                    [['src1']],
+                    'Pasted text',
+                    [null, 359, [1774872183, 855096000], ['doc1', [1774872183, 356519000]], 8, null, 1, null, null, null, null, null, null, null, [1774872185, 395271000]],
+                    [null, 2],
+                ],
+            ],
+            'nb-demo',
+            '🕸️',
+            null,
+            [1, false, true, null, null, [1774889558, 348721000], 1, false, [1774872161, 361922000], null, null, null, false, true, 1, false, null, true, 1],
+        ]);
+        expect(rows).toEqual([
+            {
+                id: 'src1',
+                notebook_id: 'nb-demo',
+                title: 'Pasted text',
+                type: 'pasted-text',
+                type_code: 8,
+                size: 359,
+                created_at: '2026-03-30T12:03:03.855Z',
+                updated_at: '2026-03-30T12:03:05.395Z',
+                url: 'https://notebooklm.google.com/notebook/nb-demo',
+                source: 'rpc',
+            },
+        ]);
+    });
+    it('parses sources when detail rpc wraps the payload in a singleton envelope', () => {
+        const rows = parseNotebooklmSourceListResult([
+            [
+                'Browser Automation',
+                [
+                    [
+                        [['src1']],
+                        'Pasted text',
+                        [null, 359, [1774872183, 855096000], ['doc1', [1774872183, 356519000]], 8, null, 1, null, null, null, null, null, null, null, [1774872185, 395271000]],
+                        [null, 2],
+                    ],
+                ],
+                'nb-demo',
+                '🕸️',
+                null,
+                [1, false, true, null, null, [1774889558, 348721000], 1, false, [1774872161, 361922000], null, null, null, false, true, 1, false, null, true, 1],
+            ],
+        ]);
+        expect(rows).toEqual([
+            {
+                id: 'src1',
+                notebook_id: 'nb-demo',
+                title: 'Pasted text',
+                type: 'pasted-text',
+                type_code: 8,
+                size: 359,
+                created_at: '2026-03-30T12:03:03.855Z',
+                updated_at: '2026-03-30T12:03:05.395Z',
+                url: 'https://notebooklm.google.com/notebook/nb-demo',
+                source: 'rpc',
+            },
+        ]);
+    });
+    it('parses sources when the source id container is only wrapped once', () => {
+        const rows = parseNotebooklmSourceListResult([
+            [
+                'Browser Automation',
+                [
+                    [
+                        ['src-live'],
+                        'Pasted text',
+                        [null, 359, [1774872183, 855096000], ['doc1', [1774872183, 356519000]], 8, null, 1, null, null, null, null, null, null, null, [1774872185, 395271000]],
+                        [null, 2],
+                    ],
+                ],
+                'nb-demo',
+                '🕸️',
+                null,
+                [1, false, true, null, null, [1774889558, 348721000], 1, false, [1774872161, 361922000], null, null, null, false, true, 1, false, null, true, 1],
+            ],
+        ]);
+        expect(rows).toEqual([
+            {
+                id: 'src-live',
+                notebook_id: 'nb-demo',
+                title: 'Pasted text',
+                type: 'pasted-text',
+                type_code: 8,
+                size: 359,
+                created_at: '2026-03-30T12:03:03.855Z',
+                updated_at: '2026-03-30T12:03:05.395Z',
+                url: 'https://notebooklm.google.com/notebook/nb-demo',
+                source: 'rpc',
+            },
+        ]);
+    });
+    it('parses source type from metadata slot instead of the stale entry[3] envelope', () => {
+        const rows = parseNotebooklmSourceListResult([
+            [
+                'Browser Automation',
+                [
+                    [
+                        ['src-pdf'],
+                        'Manual.pdf',
+                        [null, 18940, [1774872183, 855096000], ['doc1', [1774872183, 356519000]], 3, null, 1, null, null, null, null, null, null, null, [1774872185, 395271000]],
+                        [null, 2],
+                    ],
+                    [
+                        ['src-web'],
+                        'Example Site',
+                        [null, 131, [1774872183, 855096000], ['doc2', [1774872183, 356519000]], 5, ['https://example.com'], 1, null, null, null, null, null, null, null, [1774872185, 395271000]],
+                        [null, 2],
+                    ],
+                    [
+                        ['src-yt'],
+                        'Video Source',
+                        [null, 11958, [1774872183, 855096000], ['doc3', [1774872183, 356519000]], 9, ['https://youtu.be/demo', 'demo', 'Uploader'], 1, null, null, null, null, null, null, null, [1774872185, 395271000]],
+                        [null, 2],
+                    ],
+                ],
+                'nb-demo',
+                '🕸️',
+                null,
+                [1, false, true, null, null, [1774889558, 348721000], 1, false, [1774872161, 361922000], null, null, null, false, true, 1, false, null, true, 1],
+            ],
+        ]);
+        expect(rows).toEqual([
+            expect.objectContaining({
+                id: 'src-pdf',
+                type: 'pdf',
+                type_code: 3,
+            }),
+            expect.objectContaining({
+                id: 'src-web',
+                type: 'web',
+                type_code: 5,
+            }),
+            expect.objectContaining({
+                id: 'src-yt',
+                type: 'youtube',
+                type_code: 9,
+            }),
+        ]);
+    });
+    it('parses notebook history thread ids from hPTbtc payload', () => {
+        const threadIds = parseNotebooklmHistoryThreadIdsResult([
+            [[['28e0f2cb-4591-45a3-a661-7653666f7c78']]],
+        ]);
+        expect(threadIds).toEqual(['28e0f2cb-4591-45a3-a661-7653666f7c78']);
+    });
+    it('extracts a notebook history preview from khqZz payload', () => {
+        const preview = extractNotebooklmHistoryPreview([
+            [
+                ['28e0f2cb-4591-45a3-a661-7653666f7c78'],
+                [null, 'Summarize this notebook'],
+            ],
+        ]);
+        expect(preview).toBe('Summarize this notebook');
+    });
+    it('parses notebook notes from studio note rows', () => {
+        const rows = parseNotebooklmNoteListRawRows([
+            {
+                title: '新建笔记',
+                text: 'sticky_note_2 新建笔记 6 分钟前 more_vert',
+            },
+        ], 'nb-demo', 'https://notebooklm.google.com/notebook/nb-demo');
+        expect(rows).toEqual([
+            {
+                notebook_id: 'nb-demo',
+                title: '新建笔记',
+                created_at: '6 分钟前',
+                url: 'https://notebooklm.google.com/notebook/nb-demo',
+                source: 'studio-list',
+            },
+        ]);
+    });
+    it('parses source fulltext from hizoJc payload', () => {
+        const row = parseNotebooklmSourceFulltextResult([
+            [
+                [['src-1']],
+                '粘贴的文字',
+                [null, 359, [1774872183, 855096000], null, 8, null, 1, ['https://example.com/source']],
+                [null, 2],
+            ],
+            null,
+            null,
+            [
+                [
+                    [
+                        [0, 5, [[[0, 5, ['第一段']]]]],
+                        [5, 10, [[[5, 10, ['第二段']]]]],
+                    ],
+                ],
+            ],
+        ], 'nb-demo', 'https://notebooklm.google.com/notebook/nb-demo');
+        expect(row).toEqual({
+            source_id: 'src-1',
+            notebook_id: 'nb-demo',
+            title: '粘贴的文字',
+            kind: 'pasted-text',
+            content: '第一段\n第二段',
+            char_count: 7,
+            url: 'https://example.com/source',
+            source: 'rpc',
+        });
+    });
+    it('parses source guide from tr032e payloads with either null or source-id envelope in slot 0', () => {
+        const source = {
+            id: 'src-yt',
+            notebook_id: 'nb-demo',
+            title: 'Video Source',
+            type: 'youtube',
+        };
+        expect(parseNotebooklmSourceGuideResult([
+            [
+                [
+                    null,
+                    ['Guide summary'],
+                    [['AI', 'agents']],
+                    [],
+                ],
+            ],
+        ], source)).toEqual({
+            source_id: 'src-yt',
+            notebook_id: 'nb-demo',
+            title: 'Video Source',
+            type: 'youtube',
+            summary: 'Guide summary',
+            keywords: ['AI', 'agents'],
+            source: 'rpc',
+        });
+        expect(parseNotebooklmSourceGuideResult([
+            [
+                [
+                    [['src-yt']],
+                    ['Guide summary'],
+                    [['AI', 'agents']],
+                    [],
+                ],
+            ],
+        ], source)).toEqual({
+            source_id: 'src-yt',
+            notebook_id: 'nb-demo',
+            title: 'Video Source',
+            type: 'youtube',
+            summary: 'Guide summary',
+            keywords: ['AI', 'agents'],
+            source: 'rpc',
+        });
+    });
+    it('prefers real NotebookLM page tokens over login text heuristics', async () => {
+        let call = 0;
+        const page = {
+            evaluate: async () => {
+                call += 1;
+                if (call === 1) {
+                    return {
+                        url: 'https://notebooklm.google.com/notebook/nb-demo',
+                        title: 'Demo Notebook - NotebookLM',
+                        hostname: 'notebooklm.google.com',
+                        kind: 'notebook',
+                        notebookId: 'nb-demo',
+                        loginRequired: true,
+                        notebookCount: 0,
+                    };
+                }
+                return {
+                    html: '<html>"SNlM0e":"csrf-123","FdrFJe":"sess-456"</html>',
+                    sourcePath: '/notebook/nb-demo',
+                };
+            },
+        };
+        await expect(getNotebooklmPageState(page)).resolves.toEqual({
+            url: 'https://notebooklm.google.com/notebook/nb-demo',
+            title: 'Demo Notebook - NotebookLM',
+            hostname: 'notebooklm.google.com',
+            kind: 'notebook',
+            notebookId: 'nb-demo',
+            loginRequired: false,
+            notebookCount: 0,
+        });
+    });
+});

package/dist/clis/substack/utils.d.ts

@@ -2,3 +2,7 @@ import type { IPage } from '../../types.js';
 export declare function buildSubstackBrowseUrl(category?: string): string;
 export declare function loadSubstackFeed(page: IPage, url: string, limit: number): Promise<any[]>;
 export declare function loadSubstackArchive(page: IPage, baseUrl: string, limit: number): Promise<any[]>;
+export declare const __test__: {
+    FEED_POST_LINK_SELECTOR: string;
+    ARCHIVE_POST_LINK_SELECTOR: string;
+};

package/dist/clis/substack/utils.js

@@ -1,4 +1,6 @@
 import { CommandExecutionError } from '../../errors.js';
+const FEED_POST_LINK_SELECTOR = 'a[href*="/home/post/"], a[href*="/p/"]';
+const ARCHIVE_POST_LINK_SELECTOR = 'a[href*="/p/"]';
 export function buildSubstackBrowseUrl(category) {
     if (!category || category === 'all')
         return 'https://substack.com/';
@@ -9,7 +11,7 @@ export async function loadSubstackFeed(page, url, limit) {
     if (!page)
         throw new CommandExecutionError('Browser session required for substack feed');
     await page.goto(url);
-    await page.wait({ selector: 'article', timeout: 5 });
+    await page.wait({ selector: FEED_POST_LINK_SELECTOR, timeout: 5 });
     const data = await page.evaluate(`
     (async () => {
       await new Promise((resolve) => setTimeout(resolve, 3000));
@@ -77,7 +79,7 @@ export async function loadSubstackArchive(page, baseUrl, limit) {
     if (!page)
         throw new CommandExecutionError('Browser session required for substack archive');
     await page.goto(`${baseUrl}/archive`);
-    await page.wait({ selector: 'article', timeout: 5 });
+    await page.wait({ selector: ARCHIVE_POST_LINK_SELECTOR, timeout: 5 });
     const data = await page.evaluate(`
     (async () => {
       await new Promise((resolve) => setTimeout(resolve, 3000));
@@ -128,3 +130,7 @@ export async function loadSubstackArchive(page, baseUrl, limit) {
   `);
     return Array.isArray(data) ? data : [];
 }
+export const __test__ = {
+    FEED_POST_LINK_SELECTOR,
+    ARCHIVE_POST_LINK_SELECTOR,
+};

package/dist/clis/substack/utils.test.d.ts

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

package/dist/clis/substack/utils.test.js

@@ -0,0 +1,46 @@
+import { describe, expect, it, vi } from 'vitest';
+import { __test__, loadSubstackArchive, loadSubstackFeed } from './utils.js';
+function createPageMock(evaluateResult) {
+    return {
+        goto: vi.fn().mockResolvedValue(undefined),
+        evaluate: vi.fn().mockResolvedValue(evaluateResult),
+        snapshot: vi.fn().mockResolvedValue(undefined),
+        click: vi.fn().mockResolvedValue(undefined),
+        typeText: vi.fn().mockResolvedValue(undefined),
+        pressKey: vi.fn().mockResolvedValue(undefined),
+        scrollTo: vi.fn().mockResolvedValue(undefined),
+        getFormState: vi.fn().mockResolvedValue({}),
+        wait: vi.fn().mockResolvedValue(undefined),
+        tabs: vi.fn().mockResolvedValue([]),
+        closeTab: vi.fn().mockResolvedValue(undefined),
+        newTab: vi.fn().mockResolvedValue(undefined),
+        selectTab: vi.fn().mockResolvedValue(undefined),
+        networkRequests: vi.fn().mockResolvedValue([]),
+        consoleMessages: vi.fn().mockResolvedValue([]),
+        scroll: vi.fn().mockResolvedValue(undefined),
+        autoScroll: vi.fn().mockResolvedValue(undefined),
+        installInterceptor: vi.fn().mockResolvedValue(undefined),
+        getInterceptedRequests: vi.fn().mockResolvedValue([]),
+        getCookies: vi.fn().mockResolvedValue([]),
+        screenshot: vi.fn().mockResolvedValue(''),
+        waitForCapture: vi.fn().mockResolvedValue(undefined),
+    };
+}
+describe('substack utils wait selectors', () => {
+    it('waits for both feed link shapes before scraping the feed', async () => {
+        const page = createPageMock([]);
+        await loadSubstackFeed(page, 'https://substack.com/', 5);
+        expect(page.wait).toHaveBeenCalledWith({
+            selector: __test__.FEED_POST_LINK_SELECTOR,
+            timeout: 5,
+        });
+    });
+    it('waits for archive post links before scraping archive pages', async () => {
+        const page = createPageMock([]);
+        await loadSubstackArchive(page, 'https://example.substack.com', 5);
+        expect(page.wait).toHaveBeenCalledWith({
+            selector: __test__.ARCHIVE_POST_LINK_SELECTOR,
+            timeout: 5,
+        });
+    });
+});

package/dist/clis/v2ex/hot.yaml

@@ -16,10 +16,13 @@ pipeline:
       url: https://www.v2ex.com/api/topics/hot.json
 
   - map:
+      id: ${{ item.id }}
       rank: ${{ index + 1 }}
       title: ${{ item.title }}
+      node: ${{ item.node.title }}
       replies: ${{ item.replies }}
+      url: ${{ item.url }}
 
   - limit: ${{ args.limit }}
 
-columns: [rank, title, replies]
+columns: [id, rank, title, node, replies, url]

package/dist/clis/v2ex/latest.yaml

@@ -16,10 +16,13 @@ pipeline:
       url: https://www.v2ex.com/api/topics/latest.json
 
   - map:
+      id: ${{ item.id }}
       rank: ${{ index + 1 }}
       title: ${{ item.title }}
+      node: ${{ item.node.title }}
       replies: ${{ item.replies }}
+      url: ${{ item.url }}
 
   - limit: ${{ args.limit }}
 
-columns: [rank, title, replies]
+columns: [id, rank, title, node, replies, url]

package/dist/clis/v2ex/topic.yaml

@@ -19,10 +19,15 @@ pipeline:
         id: ${{ args.id }}
 
   - map:
+      id: ${{ item.id }}
       title: ${{ item.title }}
+      content: ${{ item.content }}
+      member: ${{ item.member.username }}
+      created: ${{ item.created }}
+      node: ${{ item.node.title }}
       replies: ${{ item.replies }}
       url: ${{ item.url }}
 
   - limit: 1
 
-columns: [title, replies, url]
+columns: [id, title, content, member, created, node, replies, url]

package/dist/clis/weixin/download.d.ts

@@ -23,7 +23,16 @@ export declare function extractWechatCreateTimeValue(htmlStr: string): string;
  * Extract the publish time from DOM text first, then fall back to numeric create_time values.
  */
 export declare function extractWechatPublishTime(publishTimeText: string | null | undefined, htmlStr: string): string;
+/**
+ * Detect WeChat anti-bot / verification gate pages before we try to parse the article.
+ */
+export declare function detectWechatAccessIssue(pageText: string | null | undefined, htmlStr: string): string;
+export declare function pickFirstWechatMetaText(...candidates: Array<string | null | undefined>): string;
 /**
  * Build a self-contained helper for execution inside page.evaluate().
  */
 export declare function buildExtractWechatPublishTimeJs(): string;
+/**
+ * Build a self-contained access-issue detector for execution inside page.evaluate().
+ */
+export declare function buildDetectWechatAccessIssueJs(): string;

package/dist/clis/weixin/download.js

@@ -89,6 +89,28 @@ export function extractWechatPublishTime(publishTimeText, htmlStr) {
         return '';
     return formatWechatTimestamp(rawCreateTime);
 }
+/**
+ * Detect WeChat anti-bot / verification gate pages before we try to parse the article.
+ */
+export function detectWechatAccessIssue(pageText, htmlStr) {
+    const normalizedText = (pageText || '').replace(/\s+/g, ' ').trim();
+    if (/环境异常/.test(normalizedText) &&
+        /(完成验证后即可继续访问|去验证)/.test(normalizedText)) {
+        return 'environment verification required';
+    }
+    if (/secitptpage\/verify\.html/.test(htmlStr) || /id=["']js_verify["']/.test(htmlStr)) {
+        return 'environment verification required';
+    }
+    return '';
+}
+export function pickFirstWechatMetaText(...candidates) {
+    for (const candidate of candidates) {
+        const normalized = (candidate || '').replace(/\s+/g, ' ').trim();
+        if (normalized && normalized !== 'Name cleared')
+            return normalized;
+    }
+    return '';
+}
 /**
  * Build a self-contained helper for execution inside page.evaluate().
  */
@@ -127,6 +149,22 @@ export function buildExtractWechatPublishTimeJs() {
         return formatWechatTimestamp(rawCreateTime);
     }.toString()})`;
 }
+/**
+ * Build a self-contained access-issue detector for execution inside page.evaluate().
+ */
+export function buildDetectWechatAccessIssueJs() {
+    return `(${function detectWechatAccessIssueInPage(pageText, htmlStr) {
+        const normalizedText = (pageText || '').replace(/\s+/g, ' ').trim();
+        if (/环境异常/.test(normalizedText) &&
+            /(完成验证后即可继续访问|去验证)/.test(normalizedText)) {
+            return 'environment verification required';
+        }
+        if (/secitptpage\/verify\.html/.test(htmlStr) || /id=["']js_verify["']/.test(htmlStr)) {
+            return 'environment verification required';
+        }
+        return '';
+    }.toString()})`;
+}
 // ============================================================
 // CLI Registration
 // ============================================================
@@ -158,18 +196,34 @@ cli({
           title: '',
           author: '',
           publishTime: '',
+          errorHint: '',
           contentHtml: '',
           codeBlocks: [],
           imageUrls: []
         };
 
-        // Title: #activity-name
-        const titleEl = document.querySelector('#activity-name');
-        result.title = titleEl ? titleEl.textContent.trim() : '';
+        const pickFirstText = (...selectors) => {
+          for (const selector of selectors) {
+            const text = document.querySelector(selector)?.textContent?.replace(/\\s+/g, ' ').trim() || '';
+            if (text && text !== 'Name cleared') return text;
+          }
+          return '';
+        };
 
-        // Author (WeChat Official Account name): #js_name
-        const authorEl = document.querySelector('#js_name');
-        result.author = authorEl ? authorEl.textContent.trim() : '';
+        // WeChat has multiple article templates. Newer pages use #js_text_title.
+        result.title = pickFirstText(
+          '#activity-name',
+          '#js_text_title',
+          '.rich_media_title',
+        );
+
+        result.author = pickFirstText(
+          '#js_name',
+          '.wx_follow_nickname',
+          '#profileBt .profile_nickname',
+          '.rich_media_meta.rich_media_meta_nickname',
+          '.rich_media_meta_nickname',
+        );
 
         // Publish time: prefer the rendered DOM text, then fall back to numeric create_time values.
         const publishTimeEl = document.querySelector('#publish_time');
@@ -179,6 +233,13 @@ cli({
           document.documentElement.innerHTML,
         );
 
+        const detectWechatAccessIssue = ${buildDetectWechatAccessIssueJs()};
+        result.errorHint = detectWechatAccessIssue(
+          document.body ? document.body.innerText : '',
+          document.documentElement.innerHTML,
+        );
+        if (result.errorHint) return result;
+
         // Content processing
         const contentEl = document.querySelector('#js_content');
         if (!contentEl) return result;
@@ -229,6 +290,15 @@ cli({
         return result;
       })()
     `);
+        if (data?.errorHint === 'environment verification required') {
+            return [{
+                    title: 'Error',
+                    author: '-',
+                    publish_time: '-',
+                    status: 'failed — verification required in WeChat browser page',
+                    size: '-',
+                }];
+        }
         return downloadArticle({
             title: data?.title || '',
             author: data?.author,