@huyuan-ai/cli 1.0.0 → 1.0.2

package/vendor/opencli/dist/clis/xiaohongshu/publish.test.js

@@ -0,0 +1,195 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '../../registry.js';
+import './publish.js';
+function createPageMock(evaluateResults, overrides = {}) {
+    const evaluate = vi.fn();
+    for (const result of evaluateResults) {
+        evaluate.mockResolvedValueOnce(result);
+    }
+    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),
+        scrollTo: vi.fn().mockResolvedValue(undefined),
+        getFormState: vi.fn().mockResolvedValue({ forms: [], orphanFields: [] }),
+        wait: vi.fn().mockResolvedValue(undefined),
+        tabs: vi.fn().mockResolvedValue([]),
+        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),
+        ...overrides,
+    };
+}
+describe('xiaohongshu publish', () => {
+    it('prefers CDP setFileInput upload when the page supports it', async () => {
+        const cmd = getRegistry().get('xiaohongshu/publish');
+        expect(cmd?.func).toBeTypeOf('function');
+        const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'opencli-xhs-publish-'));
+        const imagePath = path.join(tempDir, 'demo.jpg');
+        fs.writeFileSync(imagePath, Buffer.from([0xff, 0xd8, 0xff, 0xd9]));
+        const setFileInput = vi.fn().mockResolvedValue(undefined);
+        const page = createPageMock([
+            'https://creator.xiaohongshu.com/publish/publish?from=menu_left',
+            { ok: true, target: '上传图文', text: '上传图文' },
+            { state: 'editor_ready', hasTitleInput: true, hasImageInput: true, hasVideoSurface: false },
+            'input[type="file"][accept*="image"],input[type="file"][accept*=".jpg"],input[type="file"][accept*=".jpeg"],input[type="file"][accept*=".png"],input[type="file"][accept*=".gif"],input[type="file"][accept*=".webp"]',
+            false,
+            true,
+            { ok: true, sel: 'input[maxlength="20"]' },
+            { ok: true, sel: '[contenteditable="true"][class*="content"]' },
+            true,
+            'https://creator.xiaohongshu.com/publish/success',
+            '发布成功',
+        ], {
+            setFileInput,
+        });
+        const result = await cmd.func(page, {
+            title: 'CDP上传优先',
+            content: '优先走 setFileInput 主路径',
+            images: imagePath,
+            topics: '',
+            draft: false,
+        });
+        expect(setFileInput).toHaveBeenCalledWith([imagePath], expect.stringContaining('input[type="file"][accept*="image"]'));
+        const evaluateCalls = page.evaluate.mock.calls.map((args) => String(args[0]));
+        expect(evaluateCalls.some((code) => code.includes('atob(img.base64)'))).toBe(false);
+        expect(result).toEqual([
+            {
+                status: '✅ 发布成功',
+                detail: '"CDP上传优先" · 1张图片 · 发布成功',
+            },
+        ]);
+    });
+    it('fails fast when only a generic file input exists on the page', async () => {
+        const cmd = getRegistry().get('xiaohongshu/publish');
+        expect(cmd?.func).toBeTypeOf('function');
+        const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'opencli-xhs-publish-'));
+        const imagePath = path.join(tempDir, 'demo.jpg');
+        fs.writeFileSync(imagePath, Buffer.from([0xff, 0xd8, 0xff, 0xd9]));
+        const setFileInput = vi.fn().mockResolvedValue(undefined);
+        const page = createPageMock([
+            'https://creator.xiaohongshu.com/publish/publish?from=menu_left',
+            { ok: true, target: '上传图文', text: '上传图文' },
+            { state: 'editor_ready', hasTitleInput: true, hasImageInput: true, hasVideoSurface: false },
+            null,
+        ], {
+            setFileInput,
+        });
+        await expect(cmd.func(page, {
+            title: '不要走泛化上传',
+            content: 'generic file input 应该直接报错',
+            images: imagePath,
+            topics: '',
+            draft: false,
+        })).rejects.toThrow('Image injection failed: No file input found on page');
+        expect(setFileInput).not.toHaveBeenCalled();
+        expect(page.screenshot).toHaveBeenCalledWith({ path: '/tmp/xhs_publish_upload_debug.png' });
+    });
+    it('selects the image-text tab and publishes successfully', async () => {
+        const cmd = getRegistry().get('xiaohongshu/publish');
+        expect(cmd?.func).toBeTypeOf('function');
+        const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'opencli-xhs-publish-'));
+        const imagePath = path.join(tempDir, 'demo.jpg');
+        fs.writeFileSync(imagePath, Buffer.from([0xff, 0xd8, 0xff, 0xd9]));
+        const page = createPageMock([
+            'https://creator.xiaohongshu.com/publish/publish?from=menu_left',
+            { ok: true, target: '上传图文', text: '上传图文' },
+            { state: 'editor_ready', hasTitleInput: true, hasImageInput: true, hasVideoSurface: false },
+            { ok: true, count: 1 },
+            false,
+            true, // waitForEditForm: editor appeared
+            { ok: true, sel: 'input[maxlength="20"]' },
+            { ok: true, sel: '[contenteditable="true"][class*="content"]' },
+            true,
+            'https://creator.xiaohongshu.com/publish/success',
+            '发布成功',
+        ]);
+        const result = await cmd.func(page, {
+            title: 'DeepSeek别乱问',
+            content: '一篇真实一点的小红书正文',
+            images: imagePath,
+            topics: '',
+            draft: false,
+        });
+        const evaluateCalls = page.evaluate.mock.calls.map((args) => String(args[0]));
+        expect(evaluateCalls.some((code) => code.includes("const targets = ['上传图文', '图文', '图片']"))).toBe(true);
+        expect(evaluateCalls.some((code) => code.includes("No image file input found on page"))).toBe(true);
+        expect(result).toEqual([
+            {
+                status: '✅ 发布成功',
+                detail: '"DeepSeek别乱问" · 1张图片 · 发布成功',
+            },
+        ]);
+    });
+    it('fails early with a clear error when still on the video page', async () => {
+        const cmd = getRegistry().get('xiaohongshu/publish');
+        expect(cmd?.func).toBeTypeOf('function');
+        const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'opencli-xhs-publish-'));
+        const imagePath = path.join(tempDir, 'demo.jpg');
+        fs.writeFileSync(imagePath, Buffer.from([0xff, 0xd8, 0xff, 0xd9]));
+        const page = createPageMock([
+            'https://creator.xiaohongshu.com/publish/publish?from=menu_left',
+            { ok: false, visibleTexts: ['上传视频', '上传图文'] },
+            { state: 'video_surface', hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
+            { state: 'video_surface', hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
+            { state: 'video_surface', hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
+            { state: 'video_surface', hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
+        ]);
+        await expect(cmd.func(page, {
+            title: 'DeepSeek别乱问',
+            content: '一篇真实一点的小红书正文',
+            images: imagePath,
+            topics: '',
+            draft: false,
+        })).rejects.toThrow('Still on the video publish page after trying to select 图文');
+        expect(page.screenshot).toHaveBeenCalledWith({ path: '/tmp/xhs_publish_tab_debug.png' });
+    });
+    it('waits for the image-text surface to appear after clicking the tab', async () => {
+        const cmd = getRegistry().get('xiaohongshu/publish');
+        expect(cmd?.func).toBeTypeOf('function');
+        const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'opencli-xhs-publish-'));
+        const imagePath = path.join(tempDir, 'demo.jpg');
+        fs.writeFileSync(imagePath, Buffer.from([0xff, 0xd8, 0xff, 0xd9]));
+        const page = createPageMock([
+            'https://creator.xiaohongshu.com/publish/publish?from=menu_left',
+            { ok: true, target: '上传图文', text: '上传图文' },
+            { state: 'video_surface', hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
+            { state: 'editor_ready', hasTitleInput: true, hasImageInput: true, hasVideoSurface: false },
+            { ok: true, count: 1 }, // injectImages
+            false, // waitForUploads: no progress indicator
+            true, // waitForEditForm: editor appeared
+            { ok: true, sel: 'input[maxlength="20"]' },
+            { ok: true, sel: '[contenteditable="true"][class*="content"]' },
+            true,
+            'https://creator.xiaohongshu.com/publish/success',
+            '发布成功',
+        ]);
+        const result = await cmd.func(page, {
+            title: '延迟切换也能过',
+            content: '图文页切换慢一点也继续等',
+            images: imagePath,
+            topics: '',
+            draft: false,
+        });
+        expect(page.wait.mock.calls).toContainEqual([{ time: 0.5 }]);
+        expect(result).toEqual([
+            {
+                status: '✅ 发布成功',
+                detail: '"延迟切换也能过" · 1张图片 · 发布成功',
+            },
+        ]);
+    });
+});

package/vendor/opencli/dist/clis/xiaohongshu/search.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Xiaohongshu search — DOM-based extraction from search results page.
+ * The previous Pinia store + XHR interception approach broke because
+ * the API now returns empty items. This version navigates directly to
+ * the search results page and extracts data from rendered DOM elements.
+ * Ref: https://github.com/jackwener/opencli/issues/10
+ */
+/**
+ * Extract approximate publish date from a Xiaohongshu note URL.
+ * XHS note IDs follow MongoDB ObjectID format where the first 8 hex
+ * characters encode a Unix timestamp (the moment the ID was generated,
+ * which closely matches publish time but is not an official API field).
+ * e.g. "697f6c74..." → 0x697f6c74 = 1769958516 → 2026-02-01
+ */
+export declare function noteIdToDate(url: string): string;

package/vendor/opencli/dist/clis/xiaohongshu/search.js

@@ -0,0 +1,131 @@
+/**
+ * Xiaohongshu search — DOM-based extraction from search results page.
+ * The previous Pinia store + XHR interception approach broke because
+ * the API now returns empty items. This version navigates directly to
+ * the search results page and extracts data from rendered DOM elements.
+ * Ref: https://github.com/jackwener/opencli/issues/10
+ */
+import { cli, Strategy } from '../../registry.js';
+import { AuthRequiredError } from '../../errors.js';
+/**
+ * Wait for search results or login wall using MutationObserver (max 5s).
+ * Returns 'content' if note items appeared, 'login_wall' if login gate
+ * detected, or 'timeout' if neither appeared within the deadline.
+ */
+const WAIT_FOR_CONTENT_JS = `
+  new Promise((resolve) => {
+    const detect = () => {
+      if (document.querySelector('section.note-item')) return 'content';
+      if (/登录后查看搜索结果/.test(document.body?.innerText || '')) return 'login_wall';
+      return null;
+    };
+    const found = detect();
+    if (found) return resolve(found);
+    const observer = new MutationObserver(() => {
+      const result = detect();
+      if (result) { observer.disconnect(); resolve(result); }
+    });
+    observer.observe(document.body, { childList: true, subtree: true });
+    setTimeout(() => { observer.disconnect(); resolve('timeout'); }, 5000);
+  })
+`;
+/**
+ * Extract approximate publish date from a Xiaohongshu note URL.
+ * XHS note IDs follow MongoDB ObjectID format where the first 8 hex
+ * characters encode a Unix timestamp (the moment the ID was generated,
+ * which closely matches publish time but is not an official API field).
+ * e.g. "697f6c74..." → 0x697f6c74 = 1769958516 → 2026-02-01
+ */
+export function noteIdToDate(url) {
+    const match = url.match(/\/(?:search_result|explore|note)\/([0-9a-f]{24})(?=[?#/]|$)/i);
+    if (!match)
+        return '';
+    const hex = match[1].substring(0, 8);
+    const ts = parseInt(hex, 16);
+    if (!ts || ts < 1_000_000_000 || ts > 4_000_000_000)
+        return '';
+    // Offset by UTC+8 (China Standard Time) so the date matches what XHS users see
+    return new Date((ts + 8 * 3600) * 1000).toISOString().slice(0, 10);
+}
+cli({
+    site: 'xiaohongshu',
+    name: 'search',
+    description: '搜索小红书笔记',
+    domain: 'www.xiaohongshu.com',
+    strategy: Strategy.COOKIE,
+    args: [
+        { name: 'query', required: true, positional: true, help: 'Search keyword' },
+        { name: 'limit', type: 'int', default: 20, help: 'Number of results' },
+    ],
+    columns: ['rank', 'title', 'author', 'likes', 'published_at', 'url'],
+    func: async (page, kwargs) => {
+        const keyword = encodeURIComponent(kwargs.query);
+        await page.goto(`https://www.xiaohongshu.com/search_result?keyword=${keyword}&source=web_search_result_notes`);
+        // Wait for search results to render (or login wall to appear).
+        // Uses MutationObserver to resolve as soon as content appears,
+        // instead of a fixed delay + blind retry.
+        const waitResult = await page.evaluate(WAIT_FOR_CONTENT_JS);
+        if (waitResult === 'login_wall') {
+            throw new AuthRequiredError('www.xiaohongshu.com', 'Xiaohongshu search results are blocked behind a login wall');
+        }
+        // Scroll a couple of times to load more results
+        await page.autoScroll({ times: 2 });
+        const payload = await page.evaluate(`
+      (() => {
+        const normalizeUrl = (href) => {
+          if (!href) return '';
+          if (href.startsWith('http://') || href.startsWith('https://')) return href;
+          if (href.startsWith('/')) return 'https://www.xiaohongshu.com' + href;
+          return '';
+        };
+
+        const cleanText = (value) => (value || '').replace(/\\s+/g, ' ').trim();
+
+        const results = [];
+        const seen = new Set();
+
+        document.querySelectorAll('section.note-item').forEach(el => {
+          // Skip "related searches" sections
+          if (el.classList.contains('query-note-item')) return;
+
+          const titleEl = el.querySelector('.title, .note-title, a.title, .footer .title span');
+          const nameEl = el.querySelector('a.author .name, .name, .author-name, .nick-name, a.author');
+          const likesEl = el.querySelector('.count, .like-count, .like-wrapper .count');
+          // Prefer search_result link (preserves xsec_token) over generic /explore/ link
+          const detailLinkEl =
+            el.querySelector('a.cover.mask') ||
+            el.querySelector('a[href*="/search_result/"]') ||
+            el.querySelector('a[href*="/explore/"]') ||
+            el.querySelector('a[href*="/note/"]');
+          const authorLinkEl = el.querySelector('a.author, a[href*="/user/profile/"]');
+
+          const url = normalizeUrl(detailLinkEl?.getAttribute('href') || '');
+          if (!url) return;
+
+          const key = url;
+          if (seen.has(key)) return;
+          seen.add(key);
+
+          results.push({
+            title: cleanText(titleEl?.textContent || ''),
+            author: cleanText(nameEl?.textContent || ''),
+            likes: cleanText(likesEl?.textContent || '0'),
+            url,
+            author_url: normalizeUrl(authorLinkEl?.getAttribute('href') || ''),
+          });
+        });
+
+        return results;
+      })()
+    `);
+        const data = Array.isArray(payload) ? payload : [];
+        return data
+            .filter((item) => item.title)
+            .slice(0, kwargs.limit)
+            .map((item, i) => ({
+            rank: i + 1,
+            ...item,
+            published_at: noteIdToDate(item.url),
+        }));
+    },
+});

package/vendor/opencli/dist/clis/xiaohongshu/search.test.d.ts

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

package/vendor/opencli/dist/clis/xiaohongshu/search.test.js

@@ -0,0 +1,160 @@
+import { describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '../../registry.js';
+import { noteIdToDate } from './search.js';
+function createPageMock(evaluateResults) {
+    const evaluate = vi.fn();
+    for (const result of evaluateResults) {
+        evaluate.mockResolvedValueOnce(result);
+    }
+    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),
+        scrollTo: vi.fn().mockResolvedValue(undefined),
+        getFormState: vi.fn().mockResolvedValue({ forms: [], orphanFields: [] }),
+        wait: vi.fn().mockResolvedValue(undefined),
+        tabs: vi.fn().mockResolvedValue([]),
+        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('xiaohongshu search', () => {
+    it('throws a clear error when the search page is blocked by a login wall', async () => {
+        const cmd = getRegistry().get('xiaohongshu/search');
+        expect(cmd?.func).toBeTypeOf('function');
+        const page = createPageMock([
+            // First evaluate: MutationObserver wait (login wall detected)
+            'login_wall',
+        ]);
+        await expect(cmd.func(page, { query: '特斯拉', limit: 5 })).rejects.toThrow('Xiaohongshu search results are blocked behind a login wall');
+        // autoScroll must NOT be called when a login wall is detected early
+        expect(page.autoScroll).not.toHaveBeenCalled();
+    });
+    it('returns ranked results with search_result url and author_url preserved', async () => {
+        const cmd = getRegistry().get('xiaohongshu/search');
+        expect(cmd?.func).toBeTypeOf('function');
+        const detailUrl = 'https://www.xiaohongshu.com/search_result/68e90be80000000004022e66?xsec_token=test-token&xsec_source=';
+        const authorUrl = 'https://www.xiaohongshu.com/user/profile/635a9c720000000018028b40?xsec_token=user-token&xsec_source=pc_search';
+        const page = createPageMock([
+            // First evaluate: MutationObserver wait (content appeared)
+            'content',
+            // Second evaluate: main DOM extraction (returns array directly)
+            [
+                {
+                    title: '某鱼买FSD被坑了4万',
+                    author: '随风',
+                    likes: '261',
+                    url: detailUrl,
+                    author_url: authorUrl,
+                },
+            ],
+        ]);
+        const result = await cmd.func(page, { query: '特斯拉', limit: 1 });
+        // Should only do one goto (the search page itself), no per-note detail navigation
+        expect(page.goto.mock.calls).toHaveLength(1);
+        expect(result).toEqual([
+            {
+                rank: 1,
+                title: '某鱼买FSD被坑了4万',
+                author: '随风',
+                likes: '261',
+                published_at: '2025-10-10',
+                url: detailUrl,
+                author_url: authorUrl,
+            },
+        ]);
+    });
+    it('filters out results with no title and respects the limit', async () => {
+        const cmd = getRegistry().get('xiaohongshu/search');
+        expect(cmd?.func).toBeTypeOf('function');
+        const page = createPageMock([
+            // First evaluate: MutationObserver wait (content appeared)
+            'content',
+            // Second evaluate: main DOM extraction (returns array directly)
+            [
+                {
+                    title: 'Result A',
+                    author: 'UserA',
+                    likes: '10',
+                    url: 'https://www.xiaohongshu.com/search_result/aaa',
+                    author_url: '',
+                },
+                {
+                    title: '',
+                    author: 'UserB',
+                    likes: '5',
+                    url: 'https://www.xiaohongshu.com/search_result/bbb',
+                    author_url: '',
+                },
+                {
+                    title: 'Result C',
+                    author: 'UserC',
+                    likes: '3',
+                    url: 'https://www.xiaohongshu.com/search_result/ccc',
+                    author_url: '',
+                },
+            ],
+        ]);
+        const result = (await cmd.func(page, { query: '测试', limit: 1 }));
+        // limit=1 should return only the first valid-titled result
+        expect(result).toHaveLength(1);
+        expect(result[0]).toMatchObject({ rank: 1, title: 'Result A' });
+    });
+    it('waits for content via MutationObserver before extracting', async () => {
+        const cmd = getRegistry().get('xiaohongshu/search');
+        expect(cmd?.func).toBeTypeOf('function');
+        const page = createPageMock([
+            // First evaluate: MutationObserver wait (content appeared)
+            'content',
+            // Second evaluate: extraction (returns empty array)
+            [],
+        ]);
+        const result = (await cmd.func(page, { query: '测试等待', limit: 5 }));
+        expect(result).toHaveLength(0);
+        // Only one navigation, no retry
+        expect(page.goto).toHaveBeenCalledTimes(1);
+        // Two evaluate calls: wait + extraction
+        expect(page.evaluate).toHaveBeenCalledTimes(2);
+    });
+});
+describe('noteIdToDate (ObjectID timestamp parsing)', () => {
+    it('parses a known note ID to the correct China-timezone date', () => {
+        // 0x697f6c74 = 1769958516 → 2026-02-01 in UTC+8
+        expect(noteIdToDate('https://www.xiaohongshu.com/search_result/697f6c74000000002103de17')).toBe('2026-02-01');
+        // 0x68e90be8 → 2025-10-10 in UTC+8
+        expect(noteIdToDate('https://www.xiaohongshu.com/explore/68e90be80000000004022e66')).toBe('2025-10-10');
+    });
+    it('returns China date when UTC+8 crosses into the next day', () => {
+        // 0x69b739f0 = 2026-03-15 23:00 UTC = 2026-03-16 07:00 CST
+        // Without UTC+8 offset this would incorrectly return 2026-03-15
+        expect(noteIdToDate('https://www.xiaohongshu.com/search_result/69b739f00000000000000000')).toBe('2026-03-16');
+    });
+    it('handles /note/ path variant', () => {
+        expect(noteIdToDate('https://www.xiaohongshu.com/note/697f6c74000000002103de17')).toBe('2026-02-01');
+    });
+    it('handles URL with query parameters', () => {
+        expect(noteIdToDate('https://www.xiaohongshu.com/search_result/697f6c74000000002103de17?xsec_token=abc')).toBe('2026-02-01');
+    });
+    it('returns empty string for non-matching URLs', () => {
+        expect(noteIdToDate('https://www.xiaohongshu.com/user/profile/635a9c720000000018028b40')).toBe('');
+        expect(noteIdToDate('https://www.xiaohongshu.com/')).toBe('');
+    });
+    it('returns empty string for IDs shorter than 24 hex chars', () => {
+        expect(noteIdToDate('https://www.xiaohongshu.com/search_result/abcdef')).toBe('');
+    });
+    it('returns empty string when timestamp is out of range', () => {
+        // All zeros → ts = 0
+        expect(noteIdToDate('https://www.xiaohongshu.com/search_result/000000000000000000000000')).toBe('');
+    });
+});

package/vendor/opencli/dist/clis/xiaohongshu/user-helpers.d.ts

@@ -0,0 +1,16 @@
+export interface XhsUserPageSnapshot {
+    noteGroups?: unknown;
+    pageData?: unknown;
+}
+export interface XhsUserNoteRow {
+    id: string;
+    title: string;
+    type: string;
+    likes: string;
+    cover: string;
+    url: string;
+}
+export declare function normalizeXhsUserId(input: string): string;
+export declare function flattenXhsNoteGroups(noteGroups: unknown): any[];
+export declare function buildXhsNoteUrl(userId: string, noteId: string, xsecToken?: string): string;
+export declare function extractXhsUserNotes(snapshot: XhsUserPageSnapshot, fallbackUserId: string): XhsUserNoteRow[];

package/vendor/opencli/dist/clis/xiaohongshu/user-helpers.js

@@ -0,0 +1,69 @@
+function toCleanString(value) {
+    return typeof value === 'string' ? value.trim() : value == null ? '' : String(value).trim();
+}
+export function normalizeXhsUserId(input) {
+    const trimmed = toCleanString(input);
+    const withoutQuery = trimmed.replace(/[?#].*$/, '');
+    const matched = withoutQuery.match(/\/user\/profile\/([a-zA-Z0-9]+)/);
+    if (matched?.[1])
+        return matched[1];
+    return withoutQuery.replace(/\/+$/, '').split('/').pop() ?? withoutQuery;
+}
+export function flattenXhsNoteGroups(noteGroups) {
+    if (!Array.isArray(noteGroups))
+        return [];
+    const notes = [];
+    for (const group of noteGroups) {
+        if (!group)
+            continue;
+        if (Array.isArray(group)) {
+            for (const item of group) {
+                if (item)
+                    notes.push(item);
+            }
+            continue;
+        }
+        notes.push(group);
+    }
+    return notes;
+}
+export function buildXhsNoteUrl(userId, noteId, xsecToken) {
+    const cleanUserId = toCleanString(userId);
+    const cleanNoteId = toCleanString(noteId);
+    if (!cleanUserId || !cleanNoteId)
+        return '';
+    const url = new URL(`https://www.xiaohongshu.com/user/profile/${cleanUserId}/${cleanNoteId}`);
+    const cleanToken = toCleanString(xsecToken);
+    if (cleanToken) {
+        url.searchParams.set('xsec_token', cleanToken);
+        url.searchParams.set('xsec_source', 'pc_user');
+    }
+    return url.toString();
+}
+export function extractXhsUserNotes(snapshot, fallbackUserId) {
+    const notes = flattenXhsNoteGroups(snapshot.noteGroups);
+    const rows = [];
+    const seen = new Set();
+    for (const entry of notes) {
+        const noteCard = entry?.noteCard ?? entry?.note_card ?? entry;
+        if (!noteCard || typeof noteCard !== 'object')
+            continue;
+        const noteId = toCleanString(noteCard.noteId ?? noteCard.note_id ?? entry?.noteId ?? entry?.note_id ?? entry?.id);
+        if (!noteId || seen.has(noteId))
+            continue;
+        seen.add(noteId);
+        const userId = toCleanString(noteCard.user?.userId ?? noteCard.user?.user_id ?? fallbackUserId);
+        const xsecToken = toCleanString(entry?.xsecToken ?? entry?.xsec_token ?? noteCard.xsecToken ?? noteCard.xsec_token);
+        const likes = toCleanString(noteCard.interactInfo?.likedCount ?? noteCard.interact_info?.liked_count ?? 0) || '0';
+        const cover = toCleanString(noteCard.cover?.urlDefault ?? noteCard.cover?.urlPre ?? noteCard.cover?.url ?? '');
+        rows.push({
+            id: noteId,
+            title: toCleanString(noteCard.displayTitle ?? noteCard.display_title ?? noteCard.title),
+            type: toCleanString(noteCard.type),
+            likes,
+            cover,
+            url: buildXhsNoteUrl(userId || fallbackUserId, noteId, xsecToken),
+        });
+    }
+    return rows;
+}

package/vendor/opencli/dist/clis/xiaohongshu/user-helpers.test.d.ts

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