@huyuan-ai/cli 1.0.0 → 1.0.1

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

@@ -0,0 +1,167 @@
+/**
+ * Xiaohongshu download — download images and videos from a note.
+ *
+ * Usage:
+ *   opencli xiaohongshu download <note-id-or-url> --output ./xhs
+ *
+ * Accepts a bare note ID, a full xiaohongshu.com URL (with xsec_token),
+ * or a short link (http://xhslink.com/...).
+ */
+import { cli, Strategy } from '../../registry.js';
+import { formatCookieHeader } from '../../download/index.js';
+import { downloadMedia } from '../../download/media-download.js';
+import { buildNoteUrl, parseNoteId } from './note-helpers.js';
+cli({
+    site: 'xiaohongshu',
+    name: 'download',
+    description: '下载小红书笔记中的图片和视频',
+    domain: 'www.xiaohongshu.com',
+    strategy: Strategy.COOKIE,
+    args: [
+        { name: 'note-id', positional: true, required: true, help: 'Note ID, full URL, or short link' },
+        { name: 'output', default: './xiaohongshu-downloads', help: 'Output directory' },
+    ],
+    columns: ['index', 'type', 'status', 'size'],
+    func: async (page, kwargs) => {
+        const rawInput = String(kwargs['note-id']);
+        const output = kwargs.output;
+        const noteId = parseNoteId(rawInput);
+        await page.goto(buildNoteUrl(rawInput));
+        // Extract note info and media URLs
+        const data = await page.evaluate(`
+      (() => {
+        const result = {
+          noteId: '${noteId}',
+          title: '',
+          author: '',
+          media: []
+        };
+        const seenMedia = new Set();
+        const pushMedia = (type, url) => {
+          if (!url) return;
+          const key = type + ':' + url;
+          if (seenMedia.has(key)) return;
+          seenMedia.add(key);
+          result.media.push({ type, url });
+        };
+        const locationMatch = (location.pathname || '').match(/\\/(?:explore|note|search_result|discovery\\/item)\\/([a-f0-9]+)/i);
+        if (locationMatch) {
+          result.noteId = locationMatch[1];
+        }
+
+        // Get title
+        const titleEl = document.querySelector('.title, #detail-title, .note-content .title');
+        result.title = titleEl?.textContent?.trim() || 'untitled';
+
+        // Get author
+        const authorEl = document.querySelector('.username, .author-name, .name');
+        result.author = authorEl?.textContent?.trim() || 'unknown';
+
+        // Get images - try multiple selectors
+        const imageSelectors = [
+          '.swiper-slide img',
+          '.carousel-image img',
+          '.note-slider img',
+          '.note-image img',
+          '.image-wrapper img',
+          '#noteContainer .media-container img[src*="xhscdn"]',
+          'img[src*="ci.xiaohongshu.com"]'
+        ];
+
+        const imageUrls = new Set();
+        for (const selector of imageSelectors) {
+          document.querySelectorAll(selector).forEach(img => {
+            let src = img.src || img.getAttribute('data-src') || '';
+            if (src && (src.includes('xhscdn') || src.includes('xiaohongshu'))) {
+              src = src.split('?')[0];
+              src = src.replace(/\\/imageView\\d+\\/\\d+\\/w\\/\\d+/, '');
+              imageUrls.add(src);
+            }
+          });
+        }
+
+        // Get video — prefer real URL from page state over blob: URLs
+
+        // Method 1: Extract from __INITIAL_STATE__ (SSR hydration data)
+        try {
+          const state = window.__INITIAL_STATE__;
+          if (state) {
+            const noteData = state.note?.noteDetailMap || state.note?.note || {};
+            for (const key of Object.keys(noteData)) {
+              const note = noteData[key]?.note || noteData[key];
+              const video = note?.video;
+              if (video) {
+                const vUrl = video.url || video.originVideoKey || video.consumer?.originVideoKey;
+                if (vUrl) {
+                  const fullUrl = vUrl.startsWith('http') ? vUrl : 'https://sns-video-bd.xhscdn.com/' + vUrl;
+                  pushMedia('video', fullUrl);
+                }
+                const streams = video.media?.stream?.h264 || [];
+                for (const stream of streams) {
+                  if (stream.masterUrl) pushMedia('video', stream.masterUrl);
+                }
+              }
+            }
+          }
+        } catch(e) {}
+
+        // Method 2: Extract video URLs from inline script JSON
+        if (result.media.filter(m => m.type === 'video').length === 0) {
+          try {
+            const scripts = document.querySelectorAll('script');
+            for (const s of scripts) {
+              const text = s.textContent || '';
+              const videoMatches = text.match(/https?:\\/\\/sns-video[^"'\\s]+\\.mp4[^"'\\s]*/g)
+                || text.match(/https?:\\/\\/[^"'\\s]*xhscdn[^"'\\s]*\\.mp4[^"'\\s]*/g);
+              if (videoMatches) {
+                videoMatches.forEach(url => {
+                  pushMedia('video', url.replace(/\\\\u002F/g, '/'));
+                });
+              }
+            }
+          } catch(e) {}
+        }
+
+        // Method 3: Fallback to DOM video elements, skip blob: URLs
+        if (result.media.filter(m => m.type === 'video').length === 0) {
+          const videoSelectors = [
+            'video source',
+            'video[src]',
+            '.player video',
+            '.video-player video'
+          ];
+          for (const selector of videoSelectors) {
+            document.querySelectorAll(selector).forEach(v => {
+              const src = v.src || v.getAttribute('src') || '';
+              if (src && !src.startsWith('blob:')) {
+                pushMedia('video', src);
+              }
+            });
+          }
+        }
+
+        // Add images to media
+        imageUrls.forEach(url => {
+          pushMedia('image', url);
+        });
+
+        return result;
+      })()
+    `);
+        if (!data || !data.media || data.media.length === 0) {
+            return [{ index: 0, type: '-', status: 'failed', size: 'No media found' }];
+        }
+        // Extract cookies for authenticated downloads
+        const cookies = formatCookieHeader(await page.getCookies({ domain: 'xiaohongshu.com' }));
+        const resolvedNoteId = typeof data.noteId === 'string' && data.noteId.trim()
+            ? data.noteId.trim()
+            : noteId;
+        return downloadMedia(data.media, {
+            output,
+            subdir: resolvedNoteId,
+            cookies,
+            filenamePrefix: resolvedNoteId,
+            timeout: 60000,
+        });
+    },
+});

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

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

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

@@ -0,0 +1,73 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const { mockDownloadMedia, mockFormatCookieHeader } = vi.hoisted(() => ({
+    mockDownloadMedia: vi.fn(),
+    mockFormatCookieHeader: vi.fn(() => 'a=b'),
+}));
+vi.mock('../../download/media-download.js', () => ({
+    downloadMedia: mockDownloadMedia,
+}));
+vi.mock('../../download/index.js', () => ({
+    formatCookieHeader: mockFormatCookieHeader,
+}));
+import { getRegistry } from '../../registry.js';
+import './download.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({ 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([{ name: 'sid', value: 'secret', domain: '.xiaohongshu.com' }]),
+        screenshot: vi.fn().mockResolvedValue(''),
+        waitForCapture: vi.fn().mockResolvedValue(undefined),
+    };
+}
+describe('xiaohongshu download', () => {
+    const command = getRegistry().get('xiaohongshu/download');
+    beforeEach(() => {
+        mockDownloadMedia.mockReset();
+        mockFormatCookieHeader.mockClear();
+        mockDownloadMedia.mockResolvedValue([{ index: 1, type: 'video', status: 'success', size: '1 MB' }]);
+    });
+    it('preserves short links for navigation but uses canonical note id for output naming', async () => {
+        const page = createPageMock({
+            noteId: '69bc166f000000001a02069a',
+            media: [{ type: 'video', url: 'https://sns-video-hw.xhscdn.com/example.mp4' }],
+        });
+        const shortUrl = 'http://xhslink.com/o/4MKEjsZnhCz';
+        await command.func(page, { 'note-id': shortUrl, output: './out' });
+        expect(page.goto.mock.calls[0][0]).toBe(shortUrl);
+        expect(mockDownloadMedia).toHaveBeenCalledWith([{ type: 'video', url: 'https://sns-video-hw.xhscdn.com/example.mp4' }], expect.objectContaining({
+            output: './out',
+            subdir: '69bc166f000000001a02069a',
+            filenamePrefix: '69bc166f000000001a02069a',
+            cookies: 'a=b',
+        }));
+    });
+    it('preserves full note URL with xsec_token for navigation', async () => {
+        const page = createPageMock({
+            noteId: '69bc166f000000001a02069a',
+            media: [{ type: 'image', url: 'https://ci.xiaohongshu.com/example.jpg' }],
+        });
+        const fullUrl = 'https://www.xiaohongshu.com/explore/69bc166f000000001a02069a?xsec_token=abc&xsec_source=pc_search';
+        await command.func(page, { 'note-id': fullUrl, output: './out' });
+        expect(page.goto.mock.calls[0][0]).toBe(fullUrl);
+        expect(mockDownloadMedia).toHaveBeenCalledWith([{ type: 'image', url: 'https://ci.xiaohongshu.com/example.jpg' }], expect.objectContaining({
+            subdir: '69bc166f000000001a02069a',
+            filenamePrefix: '69bc166f000000001a02069a',
+        }));
+    });
+});

package/vendor/opencli/dist/clis/xiaohongshu/feed.yaml

@@ -0,0 +1,31 @@
+site: xiaohongshu
+name: feed
+description: "小红书首页推荐 Feed (via Pinia Store Action)"
+domain: www.xiaohongshu.com
+strategy: intercept
+browser: true
+
+args:
+  limit:
+    type: int
+    default: 20
+    description: Number of items to return
+
+columns: [title, author, likes, type, url]
+
+pipeline:
+  - navigate: https://www.xiaohongshu.com/explore
+  - tap:
+      store: feed
+      action: fetchFeeds
+      capture: homefeed
+      select: data.items
+      timeout: 8
+  - map:
+      id: ${{ item.id }}
+      title: ${{ item.note_card.display_title }}
+      type: ${{ item.note_card.type }}
+      author: ${{ item.note_card.user.nickname }}
+      likes: ${{ item.note_card.interact_info.liked_count }}
+      url: https://www.xiaohongshu.com/explore/${{ item.id }}
+  - limit: ${{ args.limit | default(20) }}

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

@@ -0,0 +1,12 @@
+/** Side-effect-free helpers shared by xiaohongshu note and comments commands. */
+/** Extract a bare note ID from a full URL or raw ID string. */
+export declare function parseNoteId(input: string): string;
+/**
+ * Build the best navigation URL for a note.
+ *
+ * XHS blocks direct `/explore/<id>` access without a valid `xsec_token`.
+ * When the user passes a full URL (from search results), we preserve it
+ * so the browser navigates with the token intact. For bare IDs we fall
+ * back to the `/explore/<id>` path (works when cookies carry enough context).
+ */
+export declare function buildNoteUrl(input: string): string;

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

@@ -0,0 +1,23 @@
+/** Side-effect-free helpers shared by xiaohongshu note and comments commands. */
+/** Extract a bare note ID from a full URL or raw ID string. */
+export function parseNoteId(input) {
+    const trimmed = input.trim();
+    const match = trimmed.match(/\/(?:explore|note|search_result)\/([a-f0-9]+)/);
+    return match ? match[1] : trimmed;
+}
+/**
+ * Build the best navigation URL for a note.
+ *
+ * XHS blocks direct `/explore/<id>` access without a valid `xsec_token`.
+ * When the user passes a full URL (from search results), we preserve it
+ * so the browser navigates with the token intact. For bare IDs we fall
+ * back to the `/explore/<id>` path (works when cookies carry enough context).
+ */
+export function buildNoteUrl(input) {
+    const trimmed = input.trim();
+    if (/^https?:\/\//.test(trimmed)) {
+        // Full URL — navigate as-is; the browser will follow any redirects
+        return trimmed;
+    }
+    return `https://www.xiaohongshu.com/explore/${trimmed}`;
+}

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

@@ -0,0 +1,7 @@
+/**
+ * Xiaohongshu note — read full note content from a public note page.
+ *
+ * Extracts title, author, description text, and engagement metrics
+ * (likes, collects, comment count) via DOM extraction.
+ */
+export {};

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

@@ -0,0 +1,87 @@
+/**
+ * Xiaohongshu note — read full note content from a public note page.
+ *
+ * Extracts title, author, description text, and engagement metrics
+ * (likes, collects, comment count) via DOM extraction.
+ */
+import { cli, Strategy } from '../../registry.js';
+import { AuthRequiredError, EmptyResultError } from '../../errors.js';
+import { parseNoteId, buildNoteUrl } from './note-helpers.js';
+cli({
+    site: 'xiaohongshu',
+    name: 'note',
+    description: '获取小红书笔记正文和互动数据',
+    domain: 'www.xiaohongshu.com',
+    strategy: Strategy.COOKIE,
+    args: [
+        { name: 'note-id', required: true, positional: true, help: 'Note ID or full URL (preserves xsec_token for access)' },
+    ],
+    columns: ['field', 'value'],
+    func: async (page, kwargs) => {
+        const raw = String(kwargs['note-id']);
+        const isBareNoteId = !/^https?:\/\//.test(raw.trim());
+        const noteId = parseNoteId(raw);
+        const url = buildNoteUrl(raw);
+        await page.goto(url);
+        await page.wait(3);
+        const data = await page.evaluate(`
+      (() => {
+        const loginWall = /登录后查看|请登录/.test(document.body.innerText || '')
+        const notFound = /页面不见了|笔记不存在|无法浏览/.test(document.body.innerText || '')
+
+        const clean = (el) => (el?.textContent || '').replace(/\\s+/g, ' ').trim()
+
+        const title = clean(document.querySelector('#detail-title, .title'))
+        const desc = clean(document.querySelector('#detail-desc, .desc, .note-text'))
+        const author = clean(document.querySelector('.username, .author-wrapper .name'))
+        const likes = clean(document.querySelector('.like-wrapper .count'))
+        const collects = clean(document.querySelector('.collect-wrapper .count'))
+        const comments = clean(document.querySelector('.chat-wrapper .count'))
+
+        // Try to extract tags/topics
+        const tags = []
+        document.querySelectorAll('#detail-desc a.tag, #detail-desc a[href*="search_result"]').forEach(el => {
+          const t = (el.textContent || '').trim()
+          if (t) tags.push(t)
+        })
+
+        return { loginWall, notFound, title, desc, author, likes, collects, comments, tags }
+      })()
+    `);
+        if (!data || typeof data !== 'object') {
+            throw new EmptyResultError('xiaohongshu/note', 'Unexpected evaluate response');
+        }
+        if (data.loginWall) {
+            throw new AuthRequiredError('www.xiaohongshu.com', 'Note content requires login');
+        }
+        if (data.notFound) {
+            throw new EmptyResultError('xiaohongshu/note', `Note ${noteId} not found or unavailable — it may have been deleted or restricted`);
+        }
+        const d = data;
+        // XHS renders placeholder text like "赞"/"收藏"/"评论" when count is 0;
+        // normalize to '0' unless the value looks numeric.
+        const numOrZero = (v) => /^\d+/.test(v) ? v : '0';
+        // XHS sometimes renders an empty shell page for bare /explore/<id> visits
+        // when the request lacks a valid xsec_token.  Title + author are always
+        // present on a real note, so their absence is the simplest reliable signal.
+        const emptyShell = !d.title && !d.author;
+        if (emptyShell) {
+            if (isBareNoteId) {
+                throw new EmptyResultError('xiaohongshu/note', 'Pass the full search_result URL with xsec_token, for example from `opencli xiaohongshu search`, instead of a bare note ID.');
+            }
+            throw new EmptyResultError('xiaohongshu/note', 'The note page loaded without visible content. Retry with a fresh URL or run with --verbose; if it persists, the page structure may have changed.');
+        }
+        const rows = [
+            { field: 'title', value: d.title || '' },
+            { field: 'author', value: d.author || '' },
+            { field: 'content', value: d.desc || '' },
+            { field: 'likes', value: numOrZero(d.likes || '') },
+            { field: 'collects', value: numOrZero(d.collects || '') },
+            { field: 'comments', value: numOrZero(d.comments || '') },
+        ];
+        if (d.tags?.length) {
+            rows.push({ field: 'tags', value: d.tags.join(', ') });
+        }
+        return rows;
+    },
+});

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

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

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

@@ -0,0 +1,183 @@
+import { describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '../../registry.js';
+import { parseNoteId, buildNoteUrl } from './note-helpers.js';
+import './note.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({ 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('parseNoteId', () => {
+    it('extracts ID from /explore/ URL', () => {
+        expect(parseNoteId('https://www.xiaohongshu.com/explore/69c131c9000000002800be4c')).toBe('69c131c9000000002800be4c');
+    });
+    it('extracts ID from /search_result/ URL with query params', () => {
+        expect(parseNoteId('https://www.xiaohongshu.com/search_result/69c131c9000000002800be4c?xsec_token=abc')).toBe('69c131c9000000002800be4c');
+    });
+    it('extracts ID from /note/ URL', () => {
+        expect(parseNoteId('https://www.xiaohongshu.com/note/69c131c9000000002800be4c')).toBe('69c131c9000000002800be4c');
+    });
+    it('returns raw string when no URL pattern matches', () => {
+        expect(parseNoteId('69c131c9000000002800be4c')).toBe('69c131c9000000002800be4c');
+    });
+    it('trims whitespace', () => {
+        expect(parseNoteId('  69c131c9000000002800be4c  ')).toBe('69c131c9000000002800be4c');
+    });
+});
+describe('buildNoteUrl', () => {
+    it('returns full URL as-is when given https URL', () => {
+        const url = 'https://www.xiaohongshu.com/search_result/abc123?xsec_token=tok';
+        expect(buildNoteUrl(url)).toBe(url);
+    });
+    it('constructs /explore/ URL for bare note ID', () => {
+        expect(buildNoteUrl('abc123')).toBe('https://www.xiaohongshu.com/explore/abc123');
+    });
+});
+describe('xiaohongshu note', () => {
+    const command = getRegistry().get('xiaohongshu/note');
+    it('is registered', () => {
+        expect(command).toBeDefined();
+        expect(command.func).toBeTypeOf('function');
+    });
+    it('returns note content as field/value rows', async () => {
+        const page = createPageMock({
+            loginWall: false,
+            notFound: false,
+            title: '尚界Z7实车体验',
+            desc: '今天去看了实车，外观很帅',
+            author: '小红薯用户',
+            likes: '257',
+            collects: '98',
+            comments: '45',
+            tags: ['#尚界Z7', '#鸿蒙智行'],
+        });
+        const result = (await command.func(page, { 'note-id': '69c131c9000000002800be4c' }));
+        expect(page.goto.mock.calls[0][0]).toContain('/explore/69c131c9000000002800be4c');
+        expect(result).toEqual([
+            { field: 'title', value: '尚界Z7实车体验' },
+            { field: 'author', value: '小红薯用户' },
+            { field: 'content', value: '今天去看了实车，外观很帅' },
+            { field: 'likes', value: '257' },
+            { field: 'collects', value: '98' },
+            { field: 'comments', value: '45' },
+            { field: 'tags', value: '#尚界Z7, #鸿蒙智行' },
+        ]);
+    });
+    it('parses note ID from full /explore/ URL', async () => {
+        const page = createPageMock({
+            loginWall: false, notFound: false,
+            title: 'Test', desc: '', author: '', likes: '0', collects: '0', comments: '0', tags: [],
+        });
+        await command.func(page, {
+            'note-id': 'https://www.xiaohongshu.com/explore/69c131c9000000002800be4c?xsec_token=abc',
+        });
+        expect(page.goto.mock.calls[0][0]).toContain('/explore/69c131c9000000002800be4c');
+    });
+    it('preserves full search_result URL with xsec_token for navigation', async () => {
+        const page = createPageMock({
+            loginWall: false, notFound: false,
+            title: 'Test', desc: '', author: '', likes: '0', collects: '0', comments: '0', tags: [],
+        });
+        const fullUrl = 'https://www.xiaohongshu.com/search_result/69c131c9000000002800be4c?xsec_token=abc';
+        await command.func(page, { 'note-id': fullUrl });
+        // Should navigate to the full URL as-is, not strip the token
+        expect(page.goto.mock.calls[0][0]).toBe(fullUrl);
+    });
+    it('throws AuthRequiredError on login wall', async () => {
+        const page = createPageMock({ loginWall: true, notFound: false });
+        await expect(command.func(page, { 'note-id': 'abc123' })).rejects.toThrow('Note content requires login');
+    });
+    it('throws EmptyResultError when note is not found', async () => {
+        const page = createPageMock({ loginWall: false, notFound: true });
+        await expect(command.func(page, { 'note-id': 'abc123' })).rejects.toThrow('returned no data');
+    });
+    it('throws a token hint when the note page renders as an empty shell', async () => {
+        const page = createPageMock({
+            loginWall: false,
+            notFound: false,
+            title: '',
+            desc: '',
+            author: '',
+            likes: '',
+            collects: '',
+            comments: '',
+            tags: [],
+        });
+        try {
+            await command.func(page, { 'note-id': '69ca3927000000001a020fd5' });
+            throw new Error('expected xiaohongshu note to fail on an empty shell page');
+        }
+        catch (error) {
+            expect(error).toMatchObject({
+                code: 'EMPTY_RESULT',
+                hint: expect.stringMatching(/xsec_token|full url|search_result/i),
+            });
+        }
+    });
+    it('keeps the empty-shell hint generic when the user already passed a full URL', async () => {
+        const page = createPageMock({
+            loginWall: false,
+            notFound: false,
+            title: '',
+            desc: '',
+            author: '',
+            likes: '',
+            collects: '',
+            comments: '',
+            tags: [],
+        });
+        try {
+            await command.func(page, {
+                'note-id': 'https://www.xiaohongshu.com/search_result/69ca3927000000001a020fd5?xsec_token=abc',
+            });
+            throw new Error('expected xiaohongshu note to fail on an empty shell page');
+        }
+        catch (error) {
+            expect(error).toMatchObject({
+                code: 'EMPTY_RESULT',
+                hint: expect.stringContaining('loaded without visible content'),
+            });
+            expect(error.hint).not.toContain('bare note ID');
+        }
+    });
+    it('normalizes placeholder text to 0 for zero-count metrics', async () => {
+        const page = createPageMock({
+            loginWall: false, notFound: false,
+            title: 'New note', desc: 'Just posted', author: 'Author',
+            likes: '赞', collects: '收藏', comments: '评论', tags: [],
+        });
+        const result = (await command.func(page, { 'note-id': 'abc123' }));
+        expect(result.find((r) => r.field === 'likes').value).toBe('0');
+        expect(result.find((r) => r.field === 'collects').value).toBe('0');
+        expect(result.find((r) => r.field === 'comments').value).toBe('0');
+    });
+    it('omits tags row when no tags present', async () => {
+        const page = createPageMock({
+            loginWall: false, notFound: false,
+            title: 'No tags', desc: 'Content', author: 'Author',
+            likes: '1', collects: '2', comments: '3', tags: [],
+        });
+        const result = (await command.func(page, { 'note-id': 'abc123' }));
+        expect(result.find((r) => r.field === 'tags')).toBeUndefined();
+        expect(result).toHaveLength(6);
+    });
+});

package/vendor/opencli/dist/clis/xiaohongshu/notifications.yaml

@@ -0,0 +1,37 @@
+site: xiaohongshu
+name: notifications
+description: "小红书通知 (mentions/likes/connections)"
+domain: www.xiaohongshu.com
+strategy: intercept
+browser: true
+
+args:
+  type:
+    type: str
+    default: mentions
+    description: "Notification type: mentions, likes, or connections"
+  limit:
+    type: int
+    default: 20
+    description: Number of notifications to return
+
+columns: [rank, user, action, content, note, time]
+
+pipeline:
+  - navigate: https://www.xiaohongshu.com/notification
+  - tap:
+      store: notification
+      action: getNotification
+      args:
+        - ${{ args.type | default('mentions') }}
+      capture: /you/
+      select: data.message_list
+      timeout: 8
+  - map:
+      rank: ${{ index + 1 }}
+      user: ${{ item.user_info.nickname }}
+      action: ${{ item.title }}
+      content: ${{ item.comment_info.content }}
+      note: ${{ item.item_info.content }}
+      time: ${{ item.time }}
+  - limit: ${{ args.limit | default(20) }}

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

@@ -0,0 +1,18 @@
+/**
+ * Xiaohongshu 图文笔记 publisher — creator center UI automation.
+ *
+ * Flow:
+ *   1. Navigate to creator publish page
+ *   2. Upload images via CDP DOM.setFileInputFiles (with base64 fallback)
+ *   3. Fill title and body text
+ *   4. Add topic hashtags
+ *   5. Publish (or save as draft)
+ *
+ * Requires: logged into creator.xiaohongshu.com in Chrome.
+ *
+ * Usage:
+ *   opencli xiaohongshu publish --title "标题" "正文内容" \
+ *     --images /path/a.jpg,/path/b.jpg \
+ *     --topics 生活,旅行
+ */
+export {};