@jackwener/opencli 1.5.0 → 1.5.2

package/dist/clis/weread/shelf.js

@@ -1,5 +1,120 @@
 import { cli, Strategy } from '../../registry.js';
+import { CliError } from '../../errors.js';
 import { fetchPrivateApi } from './utils.js';
+const WEREAD_DOMAIN = 'weread.qq.com';
+const WEREAD_SHELF_URL = `https://${WEREAD_DOMAIN}/web/shelf`;
+function normalizeShelfLimit(limit) {
+    if (!Number.isFinite(limit))
+        return 0;
+    return Math.max(0, Math.trunc(limit));
+}
+function normalizePrivateApiRows(data, limit) {
+    const books = data?.books ?? [];
+    return books.slice(0, limit).map((item) => ({
+        title: item.bookInfo?.title ?? item.title ?? '',
+        author: item.bookInfo?.author ?? item.author ?? '',
+        // TODO: readingProgress field name from community docs, verify with real API response
+        progress: item.readingProgress != null ? `${item.readingProgress}%` : '-',
+        bookId: item.bookId ?? item.bookInfo?.bookId ?? '',
+    }));
+}
+function normalizeWebShelfRows(snapshot, limit) {
+    if (limit <= 0)
+        return [];
+    const bookById = new Map();
+    for (const book of snapshot.rawBooks) {
+        const bookId = String(book?.bookId || '').trim();
+        if (!bookId)
+            continue;
+        bookById.set(bookId, book);
+    }
+    const orderedBookIds = snapshot.shelfIndexes
+        .filter((entry) => String(entry?.role || 'book') === 'book')
+        .sort((left, right) => Number(left?.idx ?? Number.MAX_SAFE_INTEGER) - Number(right?.idx ?? Number.MAX_SAFE_INTEGER))
+        .map((entry) => String(entry?.bookId || '').trim())
+        .filter(Boolean);
+    const fallbackOrder = snapshot.rawBooks
+        .map((book) => String(book?.bookId || '').trim())
+        .filter(Boolean);
+    const orderedUniqueBookIds = Array.from(new Set([
+        ...orderedBookIds,
+        ...fallbackOrder,
+    ]));
+    return orderedUniqueBookIds
+        .map((bookId) => {
+        const book = bookById.get(bookId);
+        if (!book)
+            return null;
+        return {
+            title: String(book.title || '').trim(),
+            author: String(book.author || '').trim(),
+            progress: '-',
+            bookId,
+        };
+    })
+        .filter((item) => Boolean(item && (item.title || item.bookId)))
+        .slice(0, limit);
+}
+/**
+ * Read the structured shelf cache from the web shelf page.
+ * The page hydrates localStorage with raw book data plus shelf ordering.
+ */
+async function loadWebShelfSnapshot(page) {
+    await page.goto(WEREAD_SHELF_URL);
+    const cookies = await page.getCookies({ domain: WEREAD_DOMAIN });
+    const currentVid = String(cookies.find((cookie) => cookie.name === 'wr_vid')?.value || '').trim();
+    if (!currentVid) {
+        return { cacheFound: false, rawBooks: [], shelfIndexes: [] };
+    }
+    const rawBooksKey = `shelf:rawBooks:${currentVid}`;
+    const shelfIndexesKey = `shelf:shelfIndexes:${currentVid}`;
+    const result = await page.evaluate(`
+    (() => new Promise((resolve) => {
+      const deadline = Date.now() + 5000;
+      const rawBooksKey = ${JSON.stringify(rawBooksKey)};
+      const shelfIndexesKey = ${JSON.stringify(shelfIndexesKey)};
+
+      const readJson = (raw) => {
+        if (typeof raw !== 'string') return null;
+        try {
+          return JSON.parse(raw);
+        } catch {
+          return null;
+        }
+      };
+
+      const poll = () => {
+        const rawBooksRaw = localStorage.getItem(rawBooksKey);
+        const shelfIndexesRaw = localStorage.getItem(shelfIndexesKey);
+        const rawBooks = readJson(rawBooksRaw);
+        const shelfIndexes = readJson(shelfIndexesRaw);
+        const cacheFound = Array.isArray(rawBooks);
+
+        if (cacheFound || Date.now() >= deadline) {
+          resolve({
+            cacheFound,
+            rawBooks: Array.isArray(rawBooks) ? rawBooks : [],
+            shelfIndexes: Array.isArray(shelfIndexes) ? shelfIndexes : [],
+          });
+          return;
+        }
+
+        setTimeout(poll, 100);
+      };
+
+      poll();
+    }))
+  `);
+    if (!result || typeof result !== 'object') {
+        return { cacheFound: false, rawBooks: [], shelfIndexes: [] };
+    }
+    const snapshot = result;
+    return {
+        cacheFound: snapshot.cacheFound === true,
+        rawBooks: Array.isArray(snapshot.rawBooks) ? snapshot.rawBooks : [],
+        shelfIndexes: Array.isArray(snapshot.shelfIndexes) ? snapshot.shelfIndexes : [],
+    };
+}
 cli({
     site: 'weread',
     name: 'shelf',
@@ -11,14 +126,22 @@ cli({
     ],
     columns: ['title', 'author', 'progress', 'bookId'],
     func: async (page, args) => {
-        const data = await fetchPrivateApi(page, '/shelf/sync', { synckey: '0', lectureSynckey: '0' });
-        const books = data?.books ?? [];
-        return books.slice(0, Number(args.limit)).map((item) => ({
-            title: item.bookInfo?.title ?? item.title ?? '',
-            author: item.bookInfo?.author ?? item.author ?? '',
-            // TODO: readingProgress field name from community docs, verify with real API response
-            progress: item.readingProgress != null ? `${item.readingProgress}%` : '-',
-            bookId: item.bookId ?? item.bookInfo?.bookId ?? '',
-        }));
+        const limit = normalizeShelfLimit(Number(args.limit));
+        if (limit <= 0)
+            return [];
+        try {
+            const data = await fetchPrivateApi(page, '/shelf/sync', { synckey: '0', lectureSynckey: '0' });
+            return normalizePrivateApiRows(data, limit);
+        }
+        catch (error) {
+            if (!(error instanceof CliError) || error.code !== 'AUTH_REQUIRED') {
+                throw error;
+            }
+            const snapshot = await loadWebShelfSnapshot(page);
+            if (!snapshot.cacheFound) {
+                throw error;
+            }
+            return normalizeWebShelfRows(snapshot, limit);
+        }
     },
 });

package/dist/clis/weread/utils.js

@@ -9,9 +9,13 @@ import { CliError } from '../../errors.js';
 const WEB_API = 'https://weread.qq.com/web';
 const API = 'https://i.weread.qq.com';
 const UA = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36';
+const WEREAD_AUTH_ERRCODES = new Set([-2010, -2012]);
 function buildCookieHeader(cookies) {
     return cookies.map((cookie) => `${cookie.name}=${cookie.value}`).join('; ');
 }
+function isAuthErrorResponse(resp, data) {
+    return resp.status === 401 || WEREAD_AUTH_ERRCODES.has(Number(data?.errcode));
+}
 /**
  * Fetch a public WeRead web endpoint (Node.js direct fetch).
  * Used by search and ranking commands (browser: false).
@@ -69,7 +73,7 @@ export async function fetchPrivateApi(page, path, params) {
     catch {
         throw new CliError('PARSE_ERROR', `Invalid JSON response for ${path}`, 'WeRead may have returned an HTML error page');
     }
-    if (resp.status === 401 || data?.errcode === -2010) {
+    if (isAuthErrorResponse(resp, data)) {
         throw new CliError('AUTH_REQUIRED', 'Not logged in to WeRead', 'Please log in to weread.qq.com in Chrome first');
     }
     if (!resp.ok) {

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.
@@ -192,10 +207,10 @@ async function selectImageTextTab(page) {
     }
     return result;
 }
-async function inspectPublishSurface(page) {
+async function inspectPublishSurfaceState(page) {
     return page.evaluate(`
     () => {
-      const text = (document.body?.innerText || '').replace(/\\s+/g, ' ').trim();
+      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();
@@ -219,29 +234,51 @@ async function inspectPublishSurface(page) {
           accept.includes('.webp')
         );
       });
-      return {
-        hasTitleInput,
-        hasImageInput,
-        hasVideoSurface: text.includes('拖拽视频到此处点击上传') || text.includes('上传视频'),
-      };
+      const hasVideoSurface = text.includes('拖拽视频到此处点击上传') || text.includes('上传视频');
+      const state = hasTitleInput ? 'editor_ready' : hasImageInput || !hasVideoSurface ? 'image_surface' : 'video_surface';
+      return { state, hasTitleInput, hasImageInput, hasVideoSurface };
     }
   `);
 }
-async function waitForImageTextSurface(page, maxWaitMs = 5_000) {
+async function waitForPublishSurfaceState(page, maxWaitMs = 5_000) {
     const pollMs = 500;
     const maxAttempts = Math.max(1, Math.ceil(maxWaitMs / pollMs));
-    let surface = await inspectPublishSurface(page);
+    let surface = await inspectPublishSurfaceState(page);
     for (let i = 0; i < maxAttempts; i++) {
-        if (surface.hasTitleInput || surface.hasImageInput || !surface.hasVideoSurface) {
+        if (surface.state !== 'video_surface') {
             return surface;
         }
         if (i < maxAttempts - 1) {
             await page.wait({ time: pollMs / 1_000 });
-            surface = await inspectPublishSurface(page);
+            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',
@@ -252,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: '保存为草稿，不直接发布' },
     ],
@@ -276,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)
@@ -291,8 +330,8 @@ cli({
         }
         // ── Step 2: Select 图文 (image+text) note type if tabs are present ─────────
         const tabResult = await selectImageTextTab(page);
-        const surface = await waitForImageTextSurface(page, tabResult?.ok ? 5_000 : 2_000);
-        if (!surface.hasTitleInput && !surface.hasImageInput && surface.hasVideoSurface) {
+        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}"`
@@ -301,27 +340,24 @@ cli({
                 `Details: ${detail}. Debug screenshot: /tmp/xhs_publish_tab_debug.png`);
         }
         // ── 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, [
@@ -333,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 ─────────────────────────────────────────────
@@ -390,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
           ) {
@@ -406,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 ─────────────────────────────────────────────────
@@ -422,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 '';
@@ -430,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.js

@@ -43,9 +43,10 @@ describe('xiaohongshu publish', () => {
         const page = createPageMock([
             'https://creator.xiaohongshu.com/publish/publish?from=menu_left',
             { ok: true, target: '上传图文', text: '上传图文' },
-            { hasTitleInput: true, hasImageInput: true, hasVideoSurface: false },
+            { 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,
@@ -72,17 +73,21 @@ describe('xiaohongshu publish', () => {
     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: ['上传视频', '上传图文'] },
-            { hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
-            { hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
-            { hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
-            { 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 },
+            { 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 图文');
@@ -91,11 +96,17 @@ describe('xiaohongshu publish', () => {
     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: '上传图文' },
-            { hasTitleInput: false, hasImageInput: false, hasVideoSurface: true },
-            { hasTitleInput: true, hasImageInput: true, hasVideoSurface: false },
+            { 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,
@@ -105,6 +116,7 @@ describe('xiaohongshu publish', () => {
         const result = await cmd.func(page, {
             title: '延迟切换也能过',
             content: '图文页切换慢一点也继续等',
+            images: imagePath,
             topics: '',
             draft: false,
         });
@@ -112,7 +124,7 @@ describe('xiaohongshu publish', () => {
         expect(result).toEqual([
             {
                 status: '✅ 发布成功',
-                detail: '"延迟切换也能过" · 无图 · 发布成功',
+                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/daemon.js

@@ -175,6 +175,7 @@ const wss = new WebSocketServer({
 wss.on('connection', (ws) => {
     console.error('[daemon] Extension connected');
     extensionWs = ws;
+    extensionVersion = null; // cleared until hello message arrives
     // ── Heartbeat: ping every 15s, close if 2 pongs missed ──
     let missedPongs = 0;
     const heartbeatInterval = setInterval(() => {