@jackwener/opencli 1.4.1 → 1.5.1

package/dist/clis/xiaohongshu/comments.test.js

@@ -0,0 +1,79 @@
+import { describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '../../registry.js';
+import './comments.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([]),
+        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(''),
+    };
+}
+describe('xiaohongshu comments', () => {
+    const command = getRegistry().get('xiaohongshu/comments');
+    it('returns ranked comment rows', async () => {
+        const page = createPageMock({
+            loginWall: false,
+            results: [
+                { author: 'Alice', text: 'Great note!', likes: 10, time: '2024-01-01' },
+                { author: 'Bob', text: 'Very helpful', likes: 0, time: '2024-01-02' },
+            ],
+        });
+        const result = (await command.func(page, { 'note-id': '69aadbcb000000002202f131', limit: 5 }));
+        expect(page.goto.mock.calls[0][0]).toContain('/explore/69aadbcb000000002202f131');
+        expect(result).toEqual([
+            { rank: 1, author: 'Alice', text: 'Great note!', likes: 10, time: '2024-01-01' },
+            { rank: 2, author: 'Bob', text: 'Very helpful', likes: 0, time: '2024-01-02' },
+        ]);
+        expect(result[0]).not.toHaveProperty('loginWall');
+    });
+    it('strips /explore/ prefix from full URL input', async () => {
+        const page = createPageMock({
+            loginWall: false,
+            results: [{ author: 'Alice', text: 'Nice', likes: 1, time: '2024-01-01' }],
+        });
+        await command.func(page, {
+            'note-id': 'https://www.xiaohongshu.com/explore/69aadbcb000000002202f131',
+            limit: 5,
+        });
+        expect(page.goto.mock.calls[0][0]).toContain('/explore/69aadbcb000000002202f131');
+    });
+    it('throws AuthRequiredError when login wall is detected', async () => {
+        const page = createPageMock({ loginWall: true, results: [] });
+        await expect(command.func(page, { 'note-id': 'abc123', limit: 5 })).rejects.toThrow('Note comments require login');
+    });
+    it('returns empty array when no comments are found', async () => {
+        const page = createPageMock({ loginWall: false, results: [] });
+        await expect(command.func(page, { 'note-id': 'abc123', limit: 5 })).resolves.toEqual([]);
+    });
+    it('respects the limit', async () => {
+        const manyComments = Array.from({ length: 10 }, (_, i) => ({
+            author: `User${i}`,
+            text: `Comment ${i}`,
+            likes: i,
+            time: '2024-01-01',
+        }));
+        const page = createPageMock({ loginWall: false, results: manyComments });
+        const result = (await command.func(page, { 'note-id': 'abc123', limit: 3 }));
+        expect(result).toHaveLength(3);
+        expect(result[0].rank).toBe(1);
+        expect(result[2].rank).toBe(3);
+    });
+});

package/dist/clis/xiaohongshu/publish.js

@@ -22,6 +22,21 @@ const PUBLISH_URL = 'https://creator.xiaohongshu.com/publish/publish?from=menu_l
 const MAX_IMAGES = 9;
 const MAX_TITLE_LEN = 20;
 const UPLOAD_SETTLE_MS = 3000;
+/** Selectors for the title field, ordered by priority (new UI first). */
+const TITLE_SELECTORS = [
+    // New creator center (2026-03) uses contenteditable for the title field.
+    // Placeholder observed: "填写标题会有更多赞哦"
+    '[contenteditable="true"][placeholder*="标题"]',
+    '[contenteditable="true"][placeholder*="赞"]',
+    '[contenteditable="true"][class*="title"]',
+    'input[maxlength="20"]',
+    'input[class*="title"]',
+    'input[placeholder*="标题"]',
+    'input[placeholder*="title" i]',
+    '.title-input input',
+    '.note-title input',
+    'input[maxlength]',
+];
 /**
  * Read a local image and return the name, MIME type, and base64 content.
  * Throws if the file does not exist or the extension is unsupported.
@@ -57,14 +72,22 @@ async function injectImages(page, images) {
     (async () => {
       const images = ${payload};
 
-      // Prefer image/* file inputs; fall back to the first available input.
+      // Only use image-capable file inputs. Do not fall back to a generic uploader,
+      // otherwise we can accidentally feed images into the video upload flow.
       const inputs = Array.from(document.querySelectorAll('input[type="file"]'));
       const input = inputs.find(el => {
         const accept = el.getAttribute('accept') || '';
-        return accept.includes('image') || accept.includes('.jpg') || accept.includes('.png');
-      }) || inputs[0];
+        return (
+          accept.includes('image') ||
+          accept.includes('.jpg') ||
+          accept.includes('.jpeg') ||
+          accept.includes('.png') ||
+          accept.includes('.gif') ||
+          accept.includes('.webp')
+        );
+      });
 
-      if (!input) return { ok: false, count: 0, error: 'No file input found on page' };
+      if (!input) return { ok: false, count: 0, error: 'No image file input found on page' };
 
       const dt = new DataTransfer();
       for (const img of images) {
@@ -141,6 +164,121 @@ async function fillField(page, selectors, text, fieldName) {
         throw new Error(`Could not find ${fieldName} input. Debug screenshot: /tmp/xhs_publish_${fieldName}_debug.png`);
     }
 }
+async function selectImageTextTab(page) {
+    const result = await page.evaluate(`
+    () => {
+      const isVisible = (el) => {
+        if (!el || el.offsetParent === null) return false;
+        const rect = el.getBoundingClientRect();
+        return rect.width > 0 && rect.height > 0;
+      };
+
+      const normalize = (value) => (value || '').replace(/\\s+/g, ' ').trim();
+      const selector = 'button, [role="tab"], [role="button"], a, label, div, span, li';
+      const nodes = Array.from(document.querySelectorAll(selector));
+      const targets = ['上传图文', '图文', '图片'];
+
+      for (const target of targets) {
+        for (const node of nodes) {
+          if (!isVisible(node)) continue;
+          const text = normalize(node.innerText || node.textContent || '');
+          if (!text || text.includes('视频')) continue;
+          if (text === target || text.startsWith(target) || text.includes(target)) {
+            const clickable = node.closest('button, [role="tab"], [role="button"], a, label') || node;
+            clickable.click();
+            return { ok: true, target, text };
+          }
+        }
+      }
+
+      const visibleTexts = [];
+      for (const node of nodes) {
+        if (!isVisible(node)) continue;
+        const text = normalize(node.innerText || node.textContent || '');
+        if (!text || text.length > 20) continue;
+        visibleTexts.push(text);
+        if (visibleTexts.length >= 20) break;
+      }
+      return { ok: false, visibleTexts };
+    }
+  `);
+    if (result?.ok) {
+        await page.wait({ time: 1 });
+    }
+    return result;
+}
+async function inspectPublishSurfaceState(page) {
+    return page.evaluate(`
+    () => {
+      const text = (document.body?.innerText || '').replace(/\s+/g, ' ').trim();
+      const hasTitleInput = !!Array.from(document.querySelectorAll('input, textarea')).find((el) => {
+        if (!el || el.offsetParent === null) return false;
+        const placeholder = (el.getAttribute('placeholder') || '').trim();
+        const cls = el.className ? String(el.className) : '';
+        const maxLength = Number(el.getAttribute('maxlength') || 0);
+        return (
+          placeholder.includes('标题') ||
+          /title/i.test(placeholder) ||
+          /title/i.test(cls) ||
+          maxLength === 20
+        );
+      });
+      const hasImageInput = !!Array.from(document.querySelectorAll('input[type="file"]')).find((el) => {
+        const accept = el.getAttribute('accept') || '';
+        return (
+          accept.includes('image') ||
+          accept.includes('.jpg') ||
+          accept.includes('.jpeg') ||
+          accept.includes('.png') ||
+          accept.includes('.gif') ||
+          accept.includes('.webp')
+        );
+      });
+      const hasVideoSurface = text.includes('拖拽视频到此处点击上传') || text.includes('上传视频');
+      const state = hasTitleInput ? 'editor_ready' : hasImageInput || !hasVideoSurface ? 'image_surface' : 'video_surface';
+      return { state, hasTitleInput, hasImageInput, hasVideoSurface };
+    }
+  `);
+}
+async function waitForPublishSurfaceState(page, maxWaitMs = 5_000) {
+    const pollMs = 500;
+    const maxAttempts = Math.max(1, Math.ceil(maxWaitMs / pollMs));
+    let surface = await inspectPublishSurfaceState(page);
+    for (let i = 0; i < maxAttempts; i++) {
+        if (surface.state !== 'video_surface') {
+            return surface;
+        }
+        if (i < maxAttempts - 1) {
+            await page.wait({ time: pollMs / 1_000 });
+            surface = await inspectPublishSurfaceState(page);
+        }
+    }
+    return surface;
+}
+/**
+ * Poll until the title/content editing form appears on the page.
+ * The new creator center UI only renders the editor after images are uploaded.
+ */
+async function waitForEditForm(page, maxWaitMs = 10_000) {
+    const pollMs = 1_000;
+    const maxAttempts = Math.ceil(maxWaitMs / pollMs);
+    for (let i = 0; i < maxAttempts; i++) {
+        const found = await page.evaluate(`
+      (() => {
+        const sels = ${JSON.stringify(TITLE_SELECTORS)};
+        for (const sel of sels) {
+          const el = document.querySelector(sel);
+          if (el && el.offsetParent !== null) return true;
+        }
+        return false;
+      })()`);
+        if (found)
+            return true;
+        if (i < maxAttempts - 1)
+            await page.wait({ time: pollMs / 1_000 });
+    }
+    return false;
+}
 cli({
     site: 'xiaohongshu',
     name: 'publish',
@@ -151,7 +289,7 @@ cli({
     args: [
         { name: 'title', required: true, help: '笔记标题 (最多20字)' },
         { name: 'content', required: true, positional: true, help: '笔记正文' },
-        { name: 'images', required: false, help: '图片路径，逗号分隔，最多9张 (jpg/png/gif/webp)' },
+        { name: 'images', required: true, help: '图片路径，逗号分隔，最多9张 (jpg/png/gif/webp)' },
         { name: 'topics', required: false, help: '话题标签，逗号分隔，不含 # 号' },
         { name: 'draft', type: 'bool', default: false, help: '保存为草稿，不直接发布' },
     ],
@@ -175,6 +313,8 @@ cli({
             throw new Error(`Title is ${title.length} chars — must be ≤ ${MAX_TITLE_LEN}`);
         if (!content)
             throw new Error('Positional argument <content> is required');
+        if (imagePaths.length === 0)
+            throw new Error('At least one --images path is required. The creator center now requires images before showing the editor.');
         if (imagePaths.length > MAX_IMAGES)
             throw new Error(`Too many images: ${imagePaths.length} (max ${MAX_IMAGES})`);
         // Read images in Node.js context before navigating (fast-fail on bad paths)
@@ -189,43 +329,35 @@ cli({
                 'Re-capture browser login via: opencli xiaohongshu creator-profile');
         }
         // ── Step 2: Select 图文 (image+text) note type if tabs are present ─────────
-        const tabClicked = await page.evaluate(`
-      () => {
-        const allEls = document.querySelectorAll('[class*="tab"], [class*="note-type"], [class*="type-item"]');
-        for (const el of allEls) {
-          const text = el.innerText || el.textContent || '';
-          if ((text.includes('图文') || text.includes('图片')) && el.offsetParent !== null) {
-            el.click();
-            return true;
-          }
+        const tabResult = await selectImageTextTab(page);
+        const surface = await waitForPublishSurfaceState(page, tabResult?.ok ? 5_000 : 2_000);
+        if (surface.state === 'video_surface') {
+            await page.screenshot({ path: '/tmp/xhs_publish_tab_debug.png' });
+            const detail = tabResult?.ok
+                ? `clicked "${tabResult.text}"`
+                : `visible candidates: ${(tabResult?.visibleTexts || []).join(' | ') || 'none'}`;
+            throw new Error('Still on the video publish page after trying to select 图文. ' +
+                `Details: ${detail}. Debug screenshot: /tmp/xhs_publish_tab_debug.png`);
         }
-        return false;
-      }
-    `);
-        if (tabClicked)
-            await page.wait({ time: 1 });
         // ── Step 3: Upload images ──────────────────────────────────────────────────
-        if (imageData.length > 0) {
-            const upload = await injectImages(page, imageData);
-            if (!upload.ok) {
-                await page.screenshot({ path: '/tmp/xhs_publish_upload_debug.png' });
-                throw new Error(`Image injection failed: ${upload.error ?? 'unknown'}. ` +
-                    'Debug screenshot: /tmp/xhs_publish_upload_debug.png');
-            }
-            // Allow XHS to process and upload images to its CDN
-            await page.wait({ time: UPLOAD_SETTLE_MS / 1_000 });
-            await waitForUploads(page);
+        const upload = await injectImages(page, imageData);
+        if (!upload.ok) {
+            await page.screenshot({ path: '/tmp/xhs_publish_upload_debug.png' });
+            throw new Error(`Image injection failed: ${upload.error ?? 'unknown'}. ` +
+                'Debug screenshot: /tmp/xhs_publish_upload_debug.png');
+        }
+        // Allow XHS to process and upload images to its CDN
+        await page.wait({ time: UPLOAD_SETTLE_MS / 1_000 });
+        await waitForUploads(page);
+        // ── Step 3b: Wait for editor form to render ───────────────────────────────
+        const formReady = await waitForEditForm(page);
+        if (!formReady) {
+            await page.screenshot({ path: '/tmp/xhs_publish_form_debug.png' });
+            throw new Error('Editing form did not appear after image upload. The page layout may have changed. ' +
+                'Debug screenshot: /tmp/xhs_publish_form_debug.png');
         }
         // ── Step 4: Fill title ─────────────────────────────────────────────────────
-        await fillField(page, [
-            'input[maxlength="20"]',
-            'input[class*="title"]',
-            'input[placeholder*="标题"]',
-            'input[placeholder*="title" i]',
-            '.title-input input',
-            '.note-title input',
-            'input[maxlength]',
-        ], title, 'title');
+        await fillField(page, TITLE_SELECTORS, title, 'title');
         await page.wait({ time: 0.5 });
         // ── Step 5: Fill content / body ────────────────────────────────────────────
         await fillField(page, [
@@ -237,7 +369,7 @@ cli({
             '.note-content [contenteditable="true"]',
             '.editor-content [contenteditable="true"]',
             // Broad fallback — last resort; filter out any title contenteditable
-            '[contenteditable="true"]:not([placeholder*="标题"]):not([placeholder*="title" i])',
+            '[contenteditable="true"]:not([placeholder*="标题"]):not([placeholder*="赞"]):not([placeholder*="title" i])',
         ], content, 'content');
         await page.wait({ time: 0.5 });
         // ── Step 6: Add topic hashtags ─────────────────────────────────────────────
@@ -294,14 +426,14 @@ cli({
             await page.wait({ time: 0.5 });
         }
         // ── Step 7: Publish or save draft ─────────────────────────────────────────
-        const actionLabel = isDraft ? '存草稿' : '发布';
+        const actionLabels = isDraft ? ['暂存离开', '存草稿'] : ['发布', '发布笔记'];
         const btnClicked = await page.evaluate(`
-      (label => {
+      (labels => {
         const buttons = document.querySelectorAll('button, [role="button"]');
         for (const btn of buttons) {
           const text = (btn.innerText || btn.textContent || '').trim();
           if (
-            (text === label || text.includes(label) || text === '发布笔记') &&
+            labels.some(l => text === l || text.includes(l)) &&
             btn.offsetParent !== null &&
             !btn.disabled
           ) {
@@ -310,11 +442,11 @@ cli({
           }
         }
         return false;
-      })(${JSON.stringify(actionLabel)})
+      })(${JSON.stringify(actionLabels)})
     `);
         if (!btnClicked) {
             await page.screenshot({ path: '/tmp/xhs_publish_submit_debug.png' });
-            throw new Error(`Could not find "${actionLabel}" button. ` +
+            throw new Error(`Could not find "${actionLabels[0]}" button. ` +
                 'Debug screenshot: /tmp/xhs_publish_submit_debug.png');
         }
         // ── Step 8: Verify success ─────────────────────────────────────────────────
@@ -326,7 +458,7 @@ cli({
           const text = (el.innerText || '').trim();
           if (
             el.children.length === 0 &&
-            (text.includes('发布成功') || text.includes('草稿已保存') || text.includes('上传成功'))
+            (text.includes('发布成功') || text.includes('草稿已保存') || text.includes('暂存成功') || text.includes('上传成功'))
           ) return text;
         }
         return '';
@@ -334,13 +466,13 @@ cli({
     `);
         const navigatedAway = !finalUrl.includes('/publish/publish');
         const isSuccess = successMsg.length > 0 || navigatedAway;
-        const verb = isDraft ? '草稿已保存' : '发布成功';
+        const verb = isDraft ? '暂存成功' : '发布成功';
         return [
             {
                 status: isSuccess ? `✅ ${verb}` : '⚠️ 操作完成，请在浏览器中确认',
                 detail: [
                     `"${title}"`,
-                    imageData.length ? `${imageData.length}张图片` : '无图',
+                    `${imageData.length}张图片`,
                     topics.length ? `话题: ${topics.join(' ')}` : '',
                     successMsg || finalUrl || '',
                 ]

package/dist/clis/xiaohongshu/publish.test.d.ts

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

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

@@ -0,0 +1,131 @@
+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) {
+    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([]),
+        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(''),
+    };
+}
+describe('xiaohongshu publish', () => {
+    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/dist/clis/xiaohongshu/search.d.ts

@@ -5,4 +5,11 @@
  * the search results page and extracts data from rendered DOM elements.
  * Ref: https://github.com/jackwener/opencli/issues/10
  */
-export {};
+/**
+ * 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/dist/clis/xiaohongshu/search.js

@@ -7,6 +7,24 @@
  */
 import { cli, Strategy } from '../../registry.js';
 import { AuthRequiredError } from '../../errors.js';
+/**
+ * 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',
@@ -17,7 +35,7 @@ cli({
         { name: 'query', required: true, positional: true, help: 'Search keyword' },
         { name: 'limit', type: 'int', default: 20, help: 'Number of results' },
     ],
-    columns: ['rank', 'title', 'author', 'likes', 'url'],
+    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`);
@@ -89,6 +107,7 @@ cli({
             .map((item, i) => ({
             rank: i + 1,
             ...item,
+            published_at: noteIdToDate(item.url),
         }));
     },
 });

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

@@ -1 +1 @@
-import './search.js';
+export {};

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

@@ -1,6 +1,6 @@
 import { describe, expect, it, vi } from 'vitest';
 import { getRegistry } from '../../registry.js';
-import './search.js';
+import { noteIdToDate } from './search.js';
 function createPageMock(evaluateResults) {
     const evaluate = vi.fn();
     for (const result of evaluateResults) {
@@ -70,6 +70,7 @@ describe('xiaohongshu search', () => {
                 title: '某鱼买FSD被坑了4万',
                 author: '随风',
                 likes: '261',
+                published_at: '2025-10-10',
                 url: detailUrl,
                 author_url: authorUrl,
             },
@@ -112,3 +113,33 @@ describe('xiaohongshu search', () => {
         expect(result[0]).toMatchObject({ rank: 1, title: 'Result A' });
     });
 });
+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/dist/commanderAdapter.d.ts

@@ -11,6 +11,7 @@
  */
 import { Command } from 'commander';
 import { type CliCommand } from './registry.js';
+export declare function normalizeArgValue(argType: string | undefined, value: unknown, name: string): unknown;
 /**
  * Register a single CliCommand as a Commander subcommand.
  */