@jackwener/opencli 1.0.6 → 1.1.1

package/dist/clis/xiaohongshu/creator-notes-summary.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Xiaohongshu Creator Notes Summary — batch summary for recent notes.
+ *
+ * Combines creator-notes and creator-note-detail into a single command that
+ * returns one summary row per note, suitable for quick review or downstream JSON use.
+ */
+import { type CreatorNoteRow } from './creator-notes.js';
+import { type CreatorNoteDetailRow } from './creator-note-detail.js';
+type CreatorNoteSummaryRow = {
+    rank: number;
+    id: string;
+    title: string;
+    published_at: string;
+    views: string;
+    likes: string;
+    collects: string;
+    comments: string;
+    shares: string;
+    avg_view_time: string;
+    rise_fans: string;
+    top_source: string;
+    top_source_pct: string;
+    top_interest: string;
+    top_interest_pct: string;
+    url: string;
+};
+export declare function summarizeCreatorNote(note: CreatorNoteRow, rows: CreatorNoteDetailRow[], rank: number): CreatorNoteSummaryRow;
+export {};

package/dist/clis/xiaohongshu/creator-notes-summary.js

@@ -0,0 +1,92 @@
+/**
+ * Xiaohongshu Creator Notes Summary — batch summary for recent notes.
+ *
+ * Combines creator-notes and creator-note-detail into a single command that
+ * returns one summary row per note, suitable for quick review or downstream JSON use.
+ */
+import { cli, Strategy } from '../../registry.js';
+import { fetchCreatorNotes } from './creator-notes.js';
+import { fetchCreatorNoteDetailRows } from './creator-note-detail.js';
+function findDetailValue(rows, metric) {
+    return rows.find((row) => row.metric === metric)?.value ?? '';
+}
+function findTopBySectionPrefix(rows, section, prefix) {
+    const matches = rows.filter((row) => row.section === section && row.metric.startsWith(prefix) && row.value);
+    if (matches.length === 0)
+        return { label: '', value: '' };
+    const sorted = [...matches].sort((a, b) => parseFloat(b.value) - parseFloat(a.value));
+    const top = sorted[0];
+    return {
+        label: top.metric.slice(prefix.length),
+        value: top.value,
+    };
+}
+export function summarizeCreatorNote(note, rows, rank) {
+    const topSource = findTopBySectionPrefix(rows, '观看来源', '');
+    const topInterest = findTopBySectionPrefix(rows, '观众画像', '兴趣/');
+    return {
+        rank,
+        id: note.id,
+        title: note.title,
+        published_at: findDetailValue(rows, 'published_at') || note.date,
+        views: findDetailValue(rows, '观看数') || String(note.views),
+        likes: findDetailValue(rows, '点赞数') || String(note.likes),
+        collects: findDetailValue(rows, '收藏数') || String(note.collects),
+        comments: findDetailValue(rows, '评论数') || String(note.comments),
+        shares: findDetailValue(rows, '分享数'),
+        avg_view_time: findDetailValue(rows, '平均观看时长'),
+        rise_fans: findDetailValue(rows, '涨粉数'),
+        top_source: topSource.label,
+        top_source_pct: topSource.value,
+        top_interest: topInterest.label,
+        top_interest_pct: topInterest.value,
+        url: note.url,
+    };
+}
+cli({
+    site: 'xiaohongshu',
+    name: 'creator-notes-summary',
+    description: '小红书最近笔记批量摘要 (列表 + 单篇关键数据汇总)',
+    domain: 'creator.xiaohongshu.com',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        { name: 'limit', type: 'int', default: 3, help: 'Number of recent notes to summarize' },
+    ],
+    columns: ['rank', 'id', 'title', 'views', 'likes', 'collects', 'comments', 'shares', 'avg_view_time', 'rise_fans', 'top_source', 'top_interest', 'url'],
+    timeoutSeconds: 180,
+    func: async (page, kwargs) => {
+        const limit = kwargs.limit || 3;
+        const notes = await fetchCreatorNotes(page, limit);
+        if (!notes.length) {
+            throw new Error('No notes found. Are you logged into creator.xiaohongshu.com?');
+        }
+        const results = [];
+        for (const [index, note] of notes.entries()) {
+            if (!note.id) {
+                results.push({
+                    rank: index + 1,
+                    id: note.id,
+                    title: note.title,
+                    published_at: note.date,
+                    views: String(note.views),
+                    likes: String(note.likes),
+                    collects: String(note.collects),
+                    comments: String(note.comments),
+                    shares: '',
+                    avg_view_time: '',
+                    rise_fans: '',
+                    top_source: '',
+                    top_source_pct: '',
+                    top_interest: '',
+                    top_interest_pct: '',
+                    url: note.url,
+                });
+                continue;
+            }
+            const detailRows = await fetchCreatorNoteDetailRows(page, note.id);
+            results.push(summarizeCreatorNote(note, detailRows, index + 1));
+        }
+        return results;
+    },
+});

package/dist/clis/xiaohongshu/creator-notes-summary.test.d.ts

@@ -0,0 +1 @@
+import './creator-notes-summary.js';

package/dist/clis/xiaohongshu/creator-notes-summary.test.js

@@ -0,0 +1,49 @@
+import { describe, expect, it } from 'vitest';
+import { summarizeCreatorNote } from './creator-notes-summary.js';
+import './creator-notes-summary.js';
+describe('xiaohongshu creator-notes-summary', () => {
+    it('summarizes note list row and detail rows into one compact row', () => {
+        const note = {
+            id: '69ba940500000000200384db',
+            title: '一张图讲清 诡秘之主·耕种者途径',
+            date: '2026年03月18日 20:01',
+            views: 549,
+            likes: 19,
+            collects: 10,
+            comments: 7,
+            url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=69ba940500000000200384db',
+        };
+        const rows = [
+            { section: '笔记信息', metric: 'published_at', value: '2026-03-18 20:01', extra: '' },
+            { section: '基础数据', metric: '观看数', value: '549', extra: '' },
+            { section: '互动数据', metric: '点赞数', value: '19', extra: '' },
+            { section: '互动数据', metric: '收藏数', value: '10', extra: '' },
+            { section: '互动数据', metric: '评论数', value: '7', extra: '' },
+            { section: '互动数据', metric: '分享数', value: '6', extra: '' },
+            { section: '基础数据', metric: '平均观看时长', value: '51.5秒', extra: '' },
+            { section: '基础数据', metric: '涨粉数', value: '3', extra: '' },
+            { section: '观看来源', metric: '首页推荐', value: '89.9%', extra: '' },
+            { section: '观看来源', metric: '搜索', value: '0.3%', extra: '' },
+            { section: '观众画像', metric: '兴趣/二次元', value: '13%', extra: '' },
+            { section: '观众画像', metric: '兴趣/游戏', value: '11%', extra: '' },
+        ];
+        expect(summarizeCreatorNote(note, rows, 1)).toEqual({
+            rank: 1,
+            id: '69ba940500000000200384db',
+            title: '一张图讲清 诡秘之主·耕种者途径',
+            published_at: '2026-03-18 20:01',
+            views: '549',
+            likes: '19',
+            collects: '10',
+            comments: '7',
+            shares: '6',
+            avg_view_time: '51.5秒',
+            rise_fans: '3',
+            top_source: '首页推荐',
+            top_source_pct: '89.9%',
+            top_interest: '二次元',
+            top_interest_pct: '13%',
+            url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=69ba940500000000200384db',
+        });
+    });
+});

package/dist/clis/xiaohongshu/creator-notes.d.ts

@@ -1,11 +1,24 @@
 /**
  * Xiaohongshu Creator Note List — per-note metrics from the creator backend.
  *
- * Navigates to the note manager page and extracts per-note data from
- * the rendered DOM. This approach bypasses the v2 API signature requirement.
- *
- * Returns: note title, publish date, views, likes, collects, comments.
+ * In CDP mode we capture the real creator analytics API response so the list
+ * includes stable note ids and detail-page URLs. If that capture is unavailable,
+ * we fall back to the older interceptor and DOM parsing paths.
  *
  * Requires: logged into creator.xiaohongshu.com in Chrome.
  */
-export {};
+import type { IPage } from '../../types.js';
+type CreatorNoteRow = {
+    id: string;
+    title: string;
+    date: string;
+    views: number;
+    likes: number;
+    collects: number;
+    comments: number;
+    url: string;
+};
+export type { CreatorNoteRow };
+export declare function parseCreatorNotesText(bodyText: string): CreatorNoteRow[];
+export declare function parseCreatorNoteIdsFromHtml(bodyHtml: string): string[];
+export declare function fetchCreatorNotes(page: IPage, limit: number): Promise<CreatorNoteRow[]>;

package/dist/clis/xiaohongshu/creator-notes.js

@@ -1,14 +1,198 @@
 /**
  * Xiaohongshu Creator Note List — per-note metrics from the creator backend.
  *
- * Navigates to the note manager page and extracts per-note data from
- * the rendered DOM. This approach bypasses the v2 API signature requirement.
- *
- * Returns: note title, publish date, views, likes, collects, comments.
+ * In CDP mode we capture the real creator analytics API response so the list
+ * includes stable note ids and detail-page URLs. If that capture is unavailable,
+ * we fall back to the older interceptor and DOM parsing paths.
  *
  * Requires: logged into creator.xiaohongshu.com in Chrome.
  */
 import { cli, Strategy } from '../../registry.js';
+const DATE_LINE_RE = /^发布于 (\d{4}年\d{2}月\d{2}日 \d{2}:\d{2})$/;
+const METRIC_LINE_RE = /^\d+$/;
+const VISIBILITY_LINE_RE = /可见$/;
+const NOTE_ANALYZE_API_PATH = '/api/galaxy/creator/datacenter/note/analyze/list';
+const NOTE_DETAIL_PAGE_URL = 'https://creator.xiaohongshu.com/statistics/note-detail';
+const NOTE_ID_HTML_RE = /"noteId":"([0-9a-f]{24})"/g;
+function buildNoteDetailUrl(noteId) {
+    return noteId ? `${NOTE_DETAIL_PAGE_URL}?noteId=${encodeURIComponent(noteId)}` : '';
+}
+function formatPostTime(ts) {
+    if (!ts)
+        return '';
+    // XHS API timestamps are Beijing time (UTC+8)
+    const date = new Date(ts + 8 * 3600_000);
+    const pad = (value) => String(value).padStart(2, '0');
+    return `${date.getUTCFullYear()}年${pad(date.getUTCMonth() + 1)}月${pad(date.getUTCDate())}日 ${pad(date.getUTCHours())}:${pad(date.getUTCMinutes())}`;
+}
+export function parseCreatorNotesText(bodyText) {
+    const lines = bodyText
+        .split('\n')
+        .map((line) => line.trim())
+        .filter(Boolean);
+    const results = [];
+    const seen = new Set();
+    for (let i = 0; i < lines.length; i++) {
+        const dateMatch = lines[i].match(DATE_LINE_RE);
+        if (!dateMatch)
+            continue;
+        let titleIndex = i - 1;
+        while (titleIndex >= 0 && VISIBILITY_LINE_RE.test(lines[titleIndex]))
+            titleIndex--;
+        if (titleIndex < 0)
+            continue;
+        const title = lines[titleIndex];
+        const metrics = [];
+        let cursor = i + 1;
+        while (cursor < lines.length && METRIC_LINE_RE.test(lines[cursor]) && metrics.length < 5) {
+            metrics.push(parseInt(lines[cursor], 10));
+            cursor++;
+        }
+        if (metrics.length < 4)
+            continue;
+        const key = `${title}@@${dateMatch[1]}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        results.push({
+            id: '',
+            title,
+            date: dateMatch[1],
+            views: metrics[0] ?? 0,
+            likes: metrics[2] ?? 0,
+            collects: metrics[3] ?? 0,
+            comments: metrics[1] ?? 0,
+            url: '',
+        });
+        i = cursor - 1;
+    }
+    return results;
+}
+export function parseCreatorNoteIdsFromHtml(bodyHtml) {
+    const ids = [];
+    const seen = new Set();
+    for (const match of bodyHtml.matchAll(NOTE_ID_HTML_RE)) {
+        const id = match[1];
+        if (!id || seen.has(id))
+            continue;
+        seen.add(id);
+        ids.push(id);
+    }
+    return ids;
+}
+function mapDomCards(cards) {
+    return cards.map((card) => ({
+        id: card.id,
+        title: card.title,
+        date: card.date,
+        views: card.metrics[0] ?? 0,
+        likes: card.metrics[2] ?? 0,
+        collects: card.metrics[3] ?? 0,
+        comments: card.metrics[1] ?? 0,
+        url: buildNoteDetailUrl(card.id),
+    }));
+}
+function mapAnalyzeItems(items) {
+    return (items ?? []).map((item) => ({
+        id: item.id ?? '',
+        title: item.title ?? '',
+        date: formatPostTime(item.post_time),
+        views: item.read_count ?? 0,
+        likes: item.like_count ?? 0,
+        collects: item.fav_count ?? 0,
+        comments: item.comment_count ?? 0,
+        url: buildNoteDetailUrl(item.id),
+    }));
+}
+async function fetchCreatorNotesByApi(page, limit) {
+    const pageSize = Math.min(Math.max(limit, 10), 20);
+    const maxPages = Math.max(1, Math.ceil(limit / pageSize));
+    const notes = [];
+    await page.goto(`https://creator.xiaohongshu.com/statistics/data-analysis?type=0&page_size=${pageSize}&page_num=1`);
+    for (let pageNum = 1; pageNum <= maxPages && notes.length < limit; pageNum++) {
+        const apiPath = `${NOTE_ANALYZE_API_PATH}?type=0&page_size=${pageSize}&page_num=${pageNum}`;
+        const fetched = await page.evaluate(`
+      async () => {
+        try {
+          const resp = await fetch(${JSON.stringify(apiPath)}, { credentials: 'include' });
+          if (!resp.ok) return { error: 'HTTP ' + resp.status };
+          return await resp.json();
+        } catch (e) {
+          return { error: e?.message ?? String(e) };
+        }
+      }
+    `);
+        let items = fetched?.data?.note_infos ?? [];
+        if (!items.length) {
+            await page.installInterceptor(NOTE_ANALYZE_API_PATH);
+            await page.evaluate(`
+        async () => {
+          try {
+            await fetch(${JSON.stringify(apiPath)}, { credentials: 'include' });
+          } catch {}
+          return true;
+        }
+      `);
+            await page.wait(1);
+            const intercepted = await page.getInterceptedRequests();
+            const data = intercepted.find((entry) => Array.isArray(entry?.data?.note_infos));
+            items = data?.data?.note_infos ?? [];
+        }
+        if (!items.length)
+            break;
+        notes.push(...mapAnalyzeItems(items));
+        if (items.length < pageSize)
+            break;
+    }
+    return notes.slice(0, limit);
+}
+export async function fetchCreatorNotes(page, limit) {
+    let notes = await fetchCreatorNotesByApi(page, limit);
+    if (notes.length === 0) {
+        await page.goto('https://creator.xiaohongshu.com/new/note-manager');
+        const maxPageDowns = Math.max(0, Math.ceil(limit / 10) + 1);
+        for (let i = 0; i <= maxPageDowns; i++) {
+            const domCards = await page.evaluate(`() => {
+        const noteIdRe = /"noteId":"([0-9a-f]{24})"/;
+        return Array.from(document.querySelectorAll('div.note[data-impression], div.note')).map((card) => {
+          const impression = card.getAttribute('data-impression') || '';
+          const id = impression.match(noteIdRe)?.[1] || '';
+          const title = (card.querySelector('.title, .raw')?.innerText || '').trim();
+          const dateText = (card.querySelector('.time_status, .time')?.innerText || '').trim();
+          const date = dateText.replace(/^发布于\\s*/, '');
+          const metrics = Array.from(card.querySelectorAll('.icon_list .icon'))
+            .map((el) => parseInt((el.innerText || '').trim(), 10))
+            .filter((value) => Number.isFinite(value));
+          return { id, title, date, metrics };
+        });
+      }`);
+            const parsedDomNotes = mapDomCards(Array.isArray(domCards) ? domCards : []).filter((note) => note.title && note.date);
+            if (parsedDomNotes.length > 0) {
+                notes = parsedDomNotes;
+            }
+            if (notes.length >= limit || (notes.length > 0 && i === 0))
+                break;
+            const body = await page.evaluate('() => ({ text: document.body.innerText, html: document.body.innerHTML })');
+            const bodyText = typeof body?.text === 'string' ? body.text : '';
+            const bodyHtml = typeof body?.html === 'string' ? body.html : '';
+            const parsedNotes = parseCreatorNotesText(bodyText);
+            const noteIds = parseCreatorNoteIdsFromHtml(bodyHtml);
+            notes = parsedNotes.map((note, index) => {
+                const id = noteIds[index] ?? '';
+                return {
+                    ...note,
+                    id,
+                    url: buildNoteDetailUrl(id),
+                };
+            });
+            if (notes.length >= limit || i === maxPageDowns)
+                break;
+            await page.pressKey('PageDown');
+            await page.wait(1);
+        }
+    }
+    return notes.slice(0, limit);
+}
 cli({
     site: 'xiaohongshu',
     name: 'creator-notes',
@@ -22,73 +206,7 @@ cli({
     columns: ['rank', 'id', 'title', 'date', 'views', 'likes', 'collects', 'comments', 'url'],
     func: async (page, kwargs) => {
         const limit = kwargs.limit || 20;
-        // Navigate to note manager
-        await page.goto('https://creator.xiaohongshu.com/new/note-manager');
-        await page.wait(4);
-        // Scroll to load more notes if needed
-        await page.autoScroll({ times: Math.ceil(limit / 10), delayMs: 1500 });
-        // Extract note data from rendered DOM
-        const notes = await page.evaluate(`
-      (() => {
-        const results = [];
-        // Note cards in the manager page contain title, date, and metric numbers
-        // Each note card has a consistent structure with the title, date line,
-        // and a row of 4 numbers (views, likes, collects, comments)
-        const cards = document.querySelectorAll('[class*="note-item"], [class*="noteItem"], [class*="card"]');
-
-        if (cards.length === 0) {
-          // Fallback: parse from any container with note-like content
-          const allText = document.body.innerText;
-          const notePattern = /(.+?)\\s+发布于\\s+(\\d{4}年\\d{2}月\\d{2}日\\s+\\d{2}:\\d{2})\\s*(\\d+)\\s*(\\d+)\\s*(\\d+)\\s*(\\d+)/g;
-          let match;
-          while ((match = notePattern.exec(allText)) !== null) {
-            results.push({
-              title: match[1].trim(),
-              date: match[2],
-              views: parseInt(match[3]) || 0,
-              likes: parseInt(match[4]) || 0,
-              collects: parseInt(match[5]) || 0,
-              comments: parseInt(match[6]) || 0,
-            });
-          }
-          return results;
-        }
-
-        cards.forEach(card => {
-          const text = card.innerText || '';
-          const linkEl = card.querySelector('a[href*="/publish/"], a[href*="/note/"], a[href*="/explore/"]');
-          const href = linkEl?.getAttribute('href') || '';
-          const idMatch = href.match(/\/(?:publish|explore|note)\/([a-zA-Z0-9]+)/);
-          // Try to extract structured data
-          const lines = text.split('\\n').map(l => l.trim()).filter(Boolean);
-          if (lines.length < 2) return;
-
-          const title = lines[0];
-          const dateLine = lines.find(l => l.includes('发布于'));
-          const dateMatch = dateLine?.match(/发布于\\s+(\\d{4}年\\d{2}月\\d{2}日\\s+\\d{2}:\\d{2})/);
-
-          // Remove the publish timestamp before collecting note metrics.
-          // Otherwise year/month/day/hour digits are picked up as views/likes/etc.
-          const metricText = dateLine ? text.replace(dateLine, ' ') : text;
-          const nums = metricText.match(/(?:^|\\s)(\\d+)(?:\\s|$)/g)?.map(n => parseInt(n.trim())) || [];
-
-          if (title && !title.includes('全部笔记')) {
-            results.push({
-              id: idMatch ? idMatch[1] : '',
-              title: title.replace(/\\s+/g, ' ').substring(0, 80),
-              date: dateMatch ? dateMatch[1] : '',
-              views: nums[0] || 0,
-              likes: nums[1] || 0,
-              collects: nums[2] || 0,
-              comments: nums[3] || 0,
-              url: href ? new URL(href, window.location.origin).toString() : '',
-            });
-          }
-        });
-
-        return results;
-      })()
-    `);
+        const notes = await fetchCreatorNotes(page, limit);
         if (!Array.isArray(notes) || notes.length === 0) {
             throw new Error('No notes found. Are you logged into creator.xiaohongshu.com?');
         }

package/dist/clis/xiaohongshu/creator-notes.test.d.ts

@@ -0,0 +1 @@
+import './creator-notes.js';

package/dist/clis/xiaohongshu/creator-notes.test.js

@@ -0,0 +1,191 @@
+import { describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '../../registry.js';
+import { parseCreatorNoteIdsFromHtml, parseCreatorNotesText } from './creator-notes.js';
+import './creator-notes.js';
+function createPageMock(evaluateResult, interceptedRequests = []) {
+    const evaluate = Array.isArray(evaluateResult)
+        ? vi.fn()
+            .mockResolvedValueOnce(evaluateResult[0])
+            .mockResolvedValue(evaluateResult[evaluateResult.length - 1])
+        : vi.fn().mockResolvedValue(evaluateResult);
+    const getInterceptedRequests = Array.isArray(interceptedRequests)
+        ? vi.fn().mockResolvedValue(interceptedRequests)
+        : vi.fn().mockResolvedValue([]);
+    return {
+        goto: vi.fn().mockResolvedValue(undefined),
+        evaluate,
+        snapshot: vi.fn().mockResolvedValue(undefined),
+        click: vi.fn().mockResolvedValue(undefined),
+        typeText: vi.fn().mockResolvedValue(undefined),
+        pressKey: vi.fn().mockResolvedValue(undefined),
+        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,
+        getCookies: vi.fn().mockResolvedValue([]),
+        screenshot: vi.fn().mockResolvedValue(''),
+    };
+}
+describe('xiaohongshu creator-notes', () => {
+    it('parses creator note text blocks into rows', () => {
+        const bodyText = `笔记管理
+全部笔记(366)
+已发布
+神雕侠侣战力金字塔
+发布于 2025年12月04日 19:45
+148208
+324
+2279
+465
+32
+权限设置
+取消置顶
+编辑
+删除
+仅自己可见
+终于等到了！！！
+发布于 2026年03月18日 12:39
+10
+0
+0
+0
+0
+权限设置`;
+        expect(parseCreatorNotesText(bodyText)).toEqual([
+            {
+                id: '',
+                title: '神雕侠侣战力金字塔',
+                date: '2025年12月04日 19:45',
+                views: 148208,
+                likes: 2279,
+                collects: 465,
+                comments: 324,
+                url: '',
+            },
+            {
+                id: '',
+                title: '终于等到了！！！',
+                date: '2026年03月18日 12:39',
+                views: 10,
+                likes: 0,
+                collects: 0,
+                comments: 0,
+                url: '',
+            },
+        ]);
+    });
+    it('reads body text and returns ranked rows', async () => {
+        const cmd = getRegistry().get('xiaohongshu/creator-notes');
+        expect(cmd?.func).toBeTypeOf('function');
+        const page = createPageMock([
+            undefined,
+            {
+                text: `示例笔记
+发布于 2026年03月19日 12:00
+10
+2
+3
+4
+5
+权限设置`,
+                html: '"noteId":"69ba940500000000200384db"',
+            },
+        ]);
+        const result = await cmd.func(page, { limit: 1 });
+        expect(page.evaluate.mock.calls.at(-1)?.[0]).toBe('() => ({ text: document.body.innerText, html: document.body.innerHTML })');
+        expect(result).toEqual([
+            {
+                rank: 1,
+                id: '69ba940500000000200384db',
+                title: '示例笔记',
+                date: '2026年03月19日 12:00',
+                views: 10,
+                likes: 3,
+                collects: 4,
+                comments: 2,
+                url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=69ba940500000000200384db',
+            },
+        ]);
+    });
+    it('prefers note card dom data when the analyze api is unavailable', async () => {
+        const cmd = getRegistry().get('xiaohongshu/creator-notes');
+        expect(cmd?.func).toBeTypeOf('function');
+        const page = createPageMock([
+            undefined,
+            [
+                {
+                    id: '693155fc000000000d03b42c',
+                    title: '神雕侠侣战力金字塔',
+                    date: '2025年12月04日 19:45',
+                    metrics: [148284, 319, 2280, 466, 33],
+                },
+            ],
+        ]);
+        const result = await cmd.func(page, { limit: 1 });
+        expect(result).toEqual([
+            {
+                rank: 1,
+                id: '693155fc000000000d03b42c',
+                title: '神雕侠侣战力金字塔',
+                date: '2025年12月04日 19:45',
+                views: 148284,
+                likes: 2280,
+                collects: 466,
+                comments: 319,
+                url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=693155fc000000000d03b42c',
+            },
+        ]);
+    });
+    it('prefers the creator analyze API and preserves note ids', async () => {
+        const cmd = getRegistry().get('xiaohongshu/creator-notes');
+        expect(cmd?.func).toBeTypeOf('function');
+        const page = createPageMock(undefined, [{
+                data: {
+                    note_infos: [
+                        {
+                            id: '69ba940500000000200384db',
+                            title: '一张图讲清 诡秘之主·耕种者途径',
+                            post_time: new Date('2026-03-18T20:01:00+08:00').getTime(),
+                            read_count: 521,
+                            like_count: 18,
+                            fav_count: 10,
+                            comment_count: 7,
+                        },
+                    ],
+                },
+            }]);
+        const result = await cmd.func(page, { limit: 1 });
+        expect(page.installInterceptor.mock.calls[0][0]).toContain('/api/galaxy/creator/datacenter/note/analyze/list');
+        expect(result).toEqual([
+            {
+                rank: 1,
+                id: '69ba940500000000200384db',
+                title: '一张图讲清 诡秘之主·耕种者途径',
+                date: '2026年03月18日 20:01',
+                views: 521,
+                likes: 18,
+                collects: 10,
+                comments: 7,
+                url: 'https://creator.xiaohongshu.com/statistics/note-detail?noteId=69ba940500000000200384db',
+            },
+        ]);
+    });
+    it('extracts note ids from creator note-manager html', () => {
+        const html = `
+      <div>&quot;noteId&quot;:&quot;69ba940500000000200384db&quot;</div>
+      <div>&quot;noteId&quot;:&quot;69ba2c98000000001a026e0f&quot;</div>
+      <div>&quot;noteId&quot;:&quot;69ba940500000000200384db&quot;</div>
+    `;
+        expect(parseCreatorNoteIdsFromHtml(html)).toEqual([
+            '69ba940500000000200384db',
+            '69ba2c98000000001a026e0f',
+        ]);
+    });
+});