@agentrhq/webcmd 0.1.2 → 0.2.0

package/clis/xiaohongshu/auth.js

@@ -1,53 +0,0 @@
-import { AuthRequiredError, CommandExecutionError } from '@agentrhq/webcmd/errors';
-import { registerSiteAuthCommands } from '../_shared/site-auth.js';
-
-async function hasXhsSessionCookies(page) {
-  const cookies = await page.getCookies({ url: 'https://creator.xiaohongshu.com' });
-  const names = new Set(cookies.map(cookie => cookie.name));
-  return names.has('web_session');
-}
-
-async function verifyXhsIdentity(page) {
-  await page.goto('https://creator.xiaohongshu.com/new/home');
-  const payload = await page.evaluate(`
-    async () => {
-      try {
-        const resp = await fetch('/api/galaxy/creator/home/personal_info', { credentials: 'include' });
-        const text = await resp.text();
-        let parsed = null;
-        try { parsed = JSON.parse(text); } catch {}
-        return [resp.ok, resp.status, parsed, text.slice(0, 200)];
-      } catch (error) {
-        return [false, 0, null, String(error && error.message || error)];
-      }
-    }
-  `);
-  const [ok, status, parsed, preview] = Array.isArray(payload) ? payload : [];
-  if (!ok) {
-    const detail = parsed?.msg ?? preview ?? `HTTP ${status ?? ''}`;
-    throw new AuthRequiredError('creator.xiaohongshu.com', `Xiaohongshu creator profile requires login: ${detail}`);
-  }
-  const data = parsed?.data;
-  if (!data) {
-    throw new CommandExecutionError('Xiaohongshu creator profile returned malformed personal_info payload');
-  }
-  return {
-    username: data.name ?? '',
-    followers: data.fans_count ?? 0,
-  };
-}
-
-registerSiteAuthCommands({
-  site: 'xiaohongshu',
-  domain: 'creator.xiaohongshu.com',
-  loginUrl: 'https://creator.xiaohongshu.com/',
-  columns: ['username', 'followers'],
-  quickCheck: hasXhsSessionCookies,
-  verify: verifyXhsIdentity,
-  poll: async (page) => {
-    if (!await hasXhsSessionCookies(page)) {
-      throw new AuthRequiredError('creator.xiaohongshu.com', 'Waiting for Xiaohongshu session cookies');
-    }
-    return verifyXhsIdentity(page);
-  },
-});

package/clis/xiaohongshu/collection-helpers.js

@@ -1,283 +0,0 @@
-import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-import { buildXhsNoteUrl, normalizeXhsUserId } from './user-helpers.js';
-
-export const COLLECT_API_PATTERN = 'note/collect/page';
-export const LIKE_API_PATTERN = 'note/like/page';
-export const SAVED_PROFILE_TAB = 'fav';
-export const LIKED_PROFILE_TAB = 'liked';
-
-export function buildProfileCollectionUrl(userId, tab) {
-    const cleanUserId = toCleanString(userId);
-    const cleanTab = toCleanString(tab);
-    const url = new URL(`https://www.xiaohongshu.com/user/profile/${cleanUserId}`);
-    url.searchParams.set('tab', cleanTab);
-    url.searchParams.set('subTab', 'note');
-    return url.toString();
-}
-
-function toCleanString(value) {
-    return typeof value === 'string' ? value.trim() : value == null ? '' : String(value).trim();
-}
-
-function isObject(value) {
-    return value && typeof value === 'object' && !Array.isArray(value);
-}
-
-export function unwrapBrowserResult(payload) {
-    if (isObject(payload) && 'session' in payload && 'data' in payload) {
-        return payload.data;
-    }
-    return payload;
-}
-
-export function parseCollectionLimit(raw) {
-    const parsed = Number(raw ?? 20);
-    if (!Number.isFinite(parsed) || !Number.isInteger(parsed)) {
-        throw new ArgumentError(`--limit must be an integer between 1 and 100, got ${JSON.stringify(raw)}`);
-    }
-    if (parsed < 1 || parsed > 100) {
-        throw new ArgumentError(`--limit must be between 1 and 100, got ${parsed}`);
-    }
-    return parsed;
-}
-
-export function readSelfUserIdFromState(state) {
-    const unwrapped = unwrapBrowserResult(state);
-    const user = unwrapped?.user?.userInfo;
-    const info = user?._value ?? user ?? {};
-    return toCleanString(info.user_id ?? info.userId ?? info.userID ?? '');
-}
-
-export function mapCollectionNote(entry, options = {}) {
-    if (!isObject(entry))
-        return null;
-    const noteCard = entry.note_card ?? entry.noteCard ?? entry;
-    const noteId = toCleanString(entry.note_id
-        ?? entry.noteId
-        ?? entry.id
-        ?? noteCard.note_id
-        ?? noteCard.noteId
-        ?? noteCard.id);
-    if (!noteId)
-        return null;
-    const user = noteCard.user ?? entry.user ?? {};
-    const userId = toCleanString(user.user_id ?? user.userId ?? '');
-    const xsecToken = toCleanString(entry.xsec_token
-        ?? entry.xsecToken
-        ?? noteCard.xsec_token
-        ?? noteCard.xsecToken);
-    if (!xsecToken)
-        return null;
-    const interact = noteCard.interact_info ?? noteCard.interactInfo ?? entry.interact_info ?? entry.interactInfo ?? {};
-    const url = userId
-        ? buildXhsNoteUrl(userId, noteId, xsecToken)
-        : `https://www.xiaohongshu.com/explore/${encodeURIComponent(noteId)}?xsec_token=${encodeURIComponent(xsecToken)}&xsec_source=pc_user`;
-    return {
-        id: noteId,
-        title: toCleanString(noteCard.display_title ?? noteCard.displayTitle ?? noteCard.title ?? entry.title ?? entry.display_title),
-        author: toCleanString(user.nickname ?? user.nick_name ?? user.name),
-        likes: toCleanString(interact.liked_count ?? interact.likedCount ?? 0) || '0',
-        type: toCleanString(noteCard.type ?? entry.type),
-        url,
-    };
-}
-
-export function extractNotesFromResponses(requests, fallbackUserId) {
-    const rows = [];
-    const seen = new Set();
-    for (const req of requests ?? []) {
-        const payload = unwrapBrowserResult(req);
-        if (!isObject(payload)) {
-            throw new CommandExecutionError('xiaohongshu collection API returned a malformed payload');
-        }
-        const data = payload.data;
-        if (!isObject(data)) {
-            throw new CommandExecutionError('xiaohongshu collection API returned malformed data');
-        }
-        const notes = data.notes ?? data.note_list;
-        if (!Array.isArray(notes))
-            throw new CommandExecutionError('xiaohongshu collection API returned malformed notes');
-        for (const entry of notes) {
-            const row = mapCollectionNote(entry, { fallbackUserId });
-            if (!row?.id || !row.url.includes('xsec_token=')) {
-                throw new CommandExecutionError('xiaohongshu collection API returned a note without stable id/xsec token');
-            }
-            if (seen.has(row.id))
-                continue;
-            seen.add(row.id);
-            rows.push(row);
-        }
-    }
-    return rows;
-}
-
-export const EXTRACT_COLLECTION_DOM_JS = `
-  (() => {
-    const normalizeUrl = (href) => {
-      if (!href) return '';
-      let url;
-      try {
-        url = new URL(href, 'https://www.xiaohongshu.com');
-      } catch {
-        return '';
-      }
-      if (url.protocol !== 'https:' || url.hostname !== 'www.xiaohongshu.com') return '';
-      if (!url.searchParams.get('xsec_token')) return '';
-      return url.toString();
-    };
-    const cleanText = (value) => (value || '').replace(/\\s+/g, ' ').trim();
-    const results = [];
-    const seen = new Set();
-    document.querySelectorAll('section.note-item').forEach((el) => {
-      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, .author-name, .nick-name, .name');
-      const likesEl = el.querySelector('.count, .like-count, .like-wrapper .count');
-      const detailLinkEl =
-        el.querySelector('a.cover.mask') ||
-        el.querySelector('a[href*="/search_result/"]') ||
-        el.querySelector('a[href*="/explore/"]') ||
-        el.querySelector('a[href*="/note/"]') ||
-        el.querySelector('a[href*="/user/profile/"]');
-      const url = normalizeUrl(detailLinkEl?.getAttribute('href') || '');
-      if (!url) return;
-      const noteIdMatch = url.match(/\\/(?:search_result|explore|note)\\/([0-9a-f]{24})|\\/user\\/profile\\/[^/]+\\/([0-9a-f]{24})/i);
-      const id = noteIdMatch?.[1] || noteIdMatch?.[2] || '';
-      if (!id || seen.has(id)) return;
-      seen.add(id);
-      results.push({
-        id,
-        title: cleanText(titleEl?.textContent || ''),
-        author: cleanText(nameEl?.textContent || ''),
-        likes: cleanText(likesEl?.textContent || '0'),
-        type: '',
-        url,
-      });
-    });
-    return results;
-  })()
-`;
-
-const LOGIN_WALL_JS = `
-  (() => {
-    const pathName = (typeof location !== 'undefined' && location.pathname) ? location.pathname : '';
-    const userStore = window.__INITIAL_STATE__?.user;
-    const loggedInVal = userStore ? (userStore.loggedIn?._value ?? userStore.loggedIn) : undefined;
-    const bodyText = document.body?.innerText || '';
-    return Boolean(pathName.indexOf('/login') === 0 || loggedInVal === false || /登录后|请先登录|登录后查看/.test(bodyText));
-  })()
-`;
-
-const CURRENT_LOCATION_JS = `
-  (() => ({
-    href: location.href,
-    hostname: location.hostname,
-    pathname: location.pathname,
-  }))()
-`;
-
-async function throwIfLoginWall(page) {
-    const payload = unwrapBrowserResult(await page.evaluate(LOGIN_WALL_JS));
-    if (payload === true) {
-        throw new AuthRequiredError('www.xiaohongshu.com', 'Xiaohongshu collection page requires login; re-login to xiaohongshu.com and retry.');
-    }
-}
-
-export async function assertOnCollectionProfile(page, userId) {
-    await throwIfLoginWall(page);
-    const payload = unwrapBrowserResult(await page.evaluate(CURRENT_LOCATION_JS));
-    if (!isObject(payload)) {
-        throw new CommandExecutionError('xiaohongshu collection page returned malformed location');
-    }
-    const hostname = toCleanString(payload.hostname).toLowerCase();
-    const pathname = toCleanString(payload.pathname);
-    if (hostname === 'www.xiaohongshu.com' && pathname === '/login') {
-        throw new AuthRequiredError('xiaohongshu collection page requires login');
-    }
-    const expectedPath = `/user/profile/${toCleanString(userId)}`;
-    if (hostname !== 'www.xiaohongshu.com' || pathname !== expectedPath) {
-        throw new CommandExecutionError(`xiaohongshu collection landed on unexpected page: ${toCleanString(payload.href) || `${hostname}${pathname}`}`);
-    }
-}
-
-async function accumulateInterceptedNotes(page, bucket, fallbackUserId) {
-    const reqs = await page.getInterceptedRequests();
-    if (!Array.isArray(reqs)) {
-        throw new CommandExecutionError('xiaohongshu collection interceptor returned malformed captures');
-    }
-    if (Array.isArray(reqs) && reqs.length > 0)
-        bucket.push(...reqs);
-    return extractNotesFromResponses(bucket, fallbackUserId);
-}
-
-export async function resolveXhsUserId(page, rawId) {
-    if (rawId)
-        return normalizeXhsUserId(String(rawId));
-    await page.goto('https://www.xiaohongshu.com/explore');
-    await page.wait(2);
-    await throwIfLoginWall(page);
-    const userId = unwrapBrowserResult(await page.evaluate(`() => {
-      const user = window.__INITIAL_STATE__?.user?.userInfo;
-      const info = user?._value ?? user ?? {};
-      return info.user_id || info.userId || info.userID || '';
-    }`));
-    const clean = toCleanString(userId);
-    if (!clean) {
-        throw new AuthRequiredError('www.xiaohongshu.com', 'Not logged into Xiaohongshu (could not resolve current user id)');
-    }
-    return clean;
-}
-
-export async function extractNotesFromDom(page) {
-    const payload = unwrapBrowserResult(await page.evaluate(EXTRACT_COLLECTION_DOM_JS));
-    if (!Array.isArray(payload)) {
-        throw new CommandExecutionError('xiaohongshu collection DOM extraction returned malformed rows');
-    }
-    return payload.filter((item) => item?.id);
-}
-
-export async function fetchXhsCollectionNotes(page, {
-    userId,
-    profileTab,
-    apiPattern,
-    limit,
-    emptyLabel,
-}) {
-    const capturedRequests = [];
-    await page.installInterceptor(apiPattern);
-    await page.goto(buildProfileCollectionUrl(userId, profileTab));
-    await page.wait(2);
-    await assertOnCollectionProfile(page, userId);
-    let notes = [];
-    for (let i = 0; i < 16; i++) {
-        await page.wait(0.5);
-        notes = await accumulateInterceptedNotes(page, capturedRequests, userId);
-        if (notes.length > 0)
-            break;
-    }
-    let previousCount = notes.length;
-    for (let i = 0; notes.length < limit && i < 4; i += 1) {
-        await page.autoScroll({ times: 1, delayMs: 1500 });
-        await page.wait(1);
-        await assertOnCollectionProfile(page, userId);
-        const nextNotes = await accumulateInterceptedNotes(page, capturedRequests, userId);
-        if (nextNotes.length > previousCount) {
-            notes = nextNotes;
-            previousCount = nextNotes.length;
-            continue;
-        }
-        break;
-    }
-    if (notes.length === 0) {
-        const domNotes = await extractNotesFromDom(page);
-        if (domNotes.length > 0)
-            notes = domNotes;
-    }
-    if (notes.length === 0) {
-        throw new EmptyResultError('xiaohongshu collection', `No ${emptyLabel} notes found. Ensure you are logged in and this profile tab is visible.`);
-    }
-    return notes.slice(0, limit).map((item, index) => ({
-        rank: index + 1,
-        ...item,
-    }));
-}

package/clis/xiaohongshu/collection-helpers.test.js

@@ -1,125 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { CommandExecutionError } from '@agentrhq/webcmd/errors';
-import {
-    COLLECT_API_PATTERN,
-    LIKE_API_PATTERN,
-    LIKED_PROFILE_TAB,
-    SAVED_PROFILE_TAB,
-    buildProfileCollectionUrl,
-    extractNotesFromResponses,
-    mapCollectionNote,
-    parseCollectionLimit,
-    readSelfUserIdFromState,
-} from './collection-helpers.js';
-
-describe('xiaohongshu collection helpers', () => {
-    it('reads the logged-in user id from INITIAL_STATE', () => {
-        expect(readSelfUserIdFromState({
-            user: {
-                userInfo: {
-                    _value: { user_id: 'abc123' },
-                },
-            },
-        })).toBe('abc123');
-    });
-
-    it('unwraps Browser Bridge envelopes when reading logged-in user id', () => {
-        expect(readSelfUserIdFromState({
-            session: 's1',
-            data: {
-                user: {
-                    userInfo: { userId: 'self-user' },
-                },
-            },
-        })).toBe('self-user');
-    });
-
-    it('validates collection limits instead of silently clamping', () => {
-        expect(parseCollectionLimit('20')).toBe(20);
-        expect(() => parseCollectionLimit(0)).toThrow(/between 1 and 100/);
-        expect(() => parseCollectionLimit(101)).toThrow(/between 1 and 100/);
-        expect(() => parseCollectionLimit('1.5')).toThrow(/integer/);
-    });
-
-    it('maps collect API notes with xsec_token into profile URLs', () => {
-        const row = mapCollectionNote({
-            note_id: '662908190000000001007366',
-            xsec_token: 'token-1',
-            note_card: {
-                display_title: 'Saved note',
-                type: 'normal',
-                user: { user_id: 'user-1', nickname: 'Alice' },
-                interact_info: { liked_count: '12' },
-            },
-        }, { fallbackUserId: 'fallback' });
-        expect(row).toMatchObject({
-            id: '662908190000000001007366',
-            title: 'Saved note',
-            author: 'Alice',
-            likes: '12',
-            type: 'normal',
-            url: 'https://www.xiaohongshu.com/user/profile/user-1/662908190000000001007366?xsec_token=token-1&xsec_source=pc_user',
-        });
-    });
-
-    it('dedupes notes across multiple intercepted responses', () => {
-        const requests = [
-            {
-                data: {
-                    notes: [
-                        {
-                            note_id: 'note-1',
-                            xsec_token: 'tok-1',
-                            title: 'First',
-                            user: { nickname: 'A' },
-                            interact_info: { liked_count: '1' },
-                        },
-                    ],
-                },
-            },
-            {
-                data: {
-                    notes: [
-                        {
-                            note_id: 'note-1',
-                            xsec_token: 'tok-1b',
-                            title: 'First duplicate',
-                            user: { nickname: 'A' },
-                            interact_info: { liked_count: '1' },
-                        },
-                        {
-                            note_id: 'note-2',
-                            xsec_token: 'tok-2',
-                            title: 'Second',
-                            user: { nickname: 'B' },
-                            interact_info: { liked_count: '2' },
-                        },
-                    ],
-                },
-            },
-        ];
-        const rows = extractNotesFromResponses(requests, 'self');
-        expect(rows).toHaveLength(2);
-        expect(rows.map((row) => row.id)).toEqual(['note-1', 'note-2']);
-    });
-
-    it('fails closed when intercepted collection payload shape is malformed', () => {
-        expect(() => extractNotesFromResponses([{ data: { notes: null } }], 'self'))
-            .toThrow(CommandExecutionError);
-        expect(() => extractNotesFromResponses([{ data: { notes: [{ note_id: 'note-1' }] } }], 'self'))
-            .toThrow(/stable id\/xsec token/);
-    });
-
-    it('uses the expected API patterns', () => {
-        expect(COLLECT_API_PATTERN).toBe('note/collect/page');
-        expect(LIKE_API_PATTERN).toBe('note/like/page');
-    });
-
-    it('builds profile URLs for saved and liked tabs', () => {
-        const userId = '66c876f7000000001d023624';
-        expect(buildProfileCollectionUrl(userId, SAVED_PROFILE_TAB))
-            .toBe('https://www.xiaohongshu.com/user/profile/66c876f7000000001d023624?tab=fav&subTab=note');
-        expect(buildProfileCollectionUrl(userId, LIKED_PROFILE_TAB))
-            .toBe('https://www.xiaohongshu.com/user/profile/66c876f7000000001d023624?tab=liked&subTab=note');
-    });
-});

package/clis/xiaohongshu/comments.js

@@ -1,228 +0,0 @@
-/**
- * Xiaohongshu comments — DOM extraction from note detail page.
- * XHS API requires signed requests, so we scrape the rendered DOM instead.
- *
- * Supports both top-level comments and nested replies (楼中楼) via
- * the --with-replies flag.
- */
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { AuthRequiredError, CliError, EmptyResultError } from '@agentrhq/webcmd/errors';
-import { parseNoteId, buildNoteUrl } from './note-helpers.js';
-
-const XHS_PROFILE_HREF_SELECTOR = '.author-wrapper a[href*="/user/profile/"], a.name[href*="/user/profile/"], a.user-name[href*="/user/profile/"], a[href*="/user/profile/"]';
-
-export function parseXhsProfileHref(href, webHost = 'www.xiaohongshu.com') {
-    const raw = typeof href === 'string' ? href.trim() : '';
-    if (!raw)
-        return '';
-    const expectedHost = String(webHost || 'www.xiaohongshu.com').toLowerCase();
-    let parsed;
-    try {
-        parsed = new URL(raw, `https://${expectedHost}`);
-    }
-    catch {
-        return '';
-    }
-    if (parsed.protocol !== 'https:')
-        return '';
-    const host = parsed.hostname.toLowerCase();
-    if (host !== expectedHost)
-        return '';
-    const match = parsed.pathname.match(/^\/user\/profile\/([a-zA-Z0-9]+)\/?$/);
-    return match?.[1] ?? '';
-}
-
-export function buildXhsProfileUrl(href, webHost = 'www.xiaohongshu.com') {
-    const userId = parseXhsProfileHref(href, webHost);
-    if (!userId)
-        return '';
-    return `https://${webHost}/user/profile/${userId}`;
-}
-export function parseCommentLimit(raw, fallback = 20) {
-    const n = Number(raw);
-    if (!Number.isFinite(n))
-        return fallback;
-    return Math.max(1, Math.min(Math.floor(n), 50));
-}
-
-export function parseXhsLikeCountText(value) {
-    const integerRe = /^(?:\d+|\d{1,3}(?:[,，]\d{3})+)\+?$/u;
-    const shortformRe = /^((?:\d+|\d{1,3}(?:[,，]\d{3})+)(?:\.\d+)?)([wWkK万千])\+?$/u;
-    const raw = String(value ?? '').replace(/\s+/g, '');
-    if (!raw)
-        return 0;
-    if (integerRe.test(raw))
-        return Number(raw.replace(/[,+，]/g, ''));
-    const short = raw.match(shortformRe);
-    if (!short)
-        return 0;
-    const numeric = Number(short[1].replace(/[,，]/g, ''));
-    if (!Number.isFinite(numeric))
-        return 0;
-    const unit = short[2].toLowerCase();
-    const multiplier = unit === 'w' || unit === '万' ? 10000 : 1000;
-    return Math.round(numeric * multiplier);
-}
-
-/**
- * Host-agnostic IIFE that scrolls a note's comment list and extracts
- * top-level comments (and optionally nested 楼中楼 replies). Exported so
- * the rednote adapter can reuse the exact same selector chain.
- */
-export function buildCommentsExtractJs(withReplies) {
-    const parseLikeCountText = parseXhsLikeCountText.toString();
-    return `
-      (async () => {
-        const wait = (ms) => new Promise(r => setTimeout(r, ms))
-        const withReplies = ${withReplies}
-
-        // Check login state
-        const bodyText = document.body?.innerText || ''
-        const loginWall = /登录后查看|请登录/.test(bodyText)
-        const securityBlock = /安全限制|访问链接异常/.test(bodyText)
-          || /website-login\\/error|error_code=300017|error_code=300031/.test(location.href)
-
-        // Scroll the note container to trigger comment loading
-        const scroller = document.querySelector('.note-scroller') || document.querySelector('.container')
-        if (scroller) {
-          for (let i = 0; i < 3; i++) {
-            const beforeCount = scroller.querySelectorAll('.parent-comment').length
-            scroller.scrollTo(0, scroller.scrollHeight)
-            await wait(800 + Math.random() * 1200)
-            const afterCount = scroller.querySelectorAll('.parent-comment').length
-            if (afterCount <= beforeCount) break
-          }
-        }
-
-        const clean = (el) => (el?.textContent || '').replace(/\\s+/g, ' ').trim()
-        const parseLikeCountText = ${parseLikeCountText}
-        const parseLikes = (el) => {
-          return parseLikeCountText(clean(el))
-        }
-        const HREF_SELECTOR = ${JSON.stringify(XHS_PROFILE_HREF_SELECTOR)}
-        const extractAuthorHref = (el) => {
-          if (!el) return ''
-          const anchor = el.querySelector(HREF_SELECTOR)
-          return anchor ? (anchor.getAttribute('href') || '') : ''
-        }
-        const expandReplyThreads = async (root) => {
-          if (!withReplies || !root) return
-          const clickedTexts = new Set()
-          for (let round = 0; round < 3; round++) {
-            const expanders = Array.from(root.querySelectorAll('button, [role="button"], span, div')).filter(el => {
-              if (!(el instanceof HTMLElement)) return false
-              const text = clean(el)
-              if (!text || text.length > 24) return false
-              if (!/(展开|更多回复|全部回复|查看.*回复|共\\d+条回复)/.test(text)) return false
-              if (clickedTexts.has(text)) return false
-              return true
-            })
-            if (!expanders.length) break
-            for (const el of expanders) {
-              const text = clean(el)
-              el.click()
-              clickedTexts.add(text)
-              await wait(200 + Math.random() * 300)
-            }
-          }
-        }
-
-        const results = []
-        const parents = document.querySelectorAll('.parent-comment')
-        for (const p of parents) {
-          const item = p.querySelector('.comment-item')
-          if (!item) continue
-
-          const author = clean(item.querySelector('.author-wrapper .name, .user-name'))
-          const authorHrefRaw = extractAuthorHref(item)
-          const text = clean(item.querySelector('.content, .note-text'))
-          const likes = parseLikes(item.querySelector('.count'))
-          const time = clean(item.querySelector('.date, .time'))
-
-          if (!text) continue
-          results.push({ author, authorHrefRaw, text, likes, time, is_reply: false, reply_to: '' })
-
-          // Extract nested replies (楼中楼)
-          if (withReplies) {
-            await expandReplyThreads(p)
-            p.querySelectorAll('.reply-container .comment-item-sub, .sub-comment-list .comment-item').forEach(sub => {
-              const sAuthor = clean(sub.querySelector('.name, .user-name'))
-              const sAuthorHrefRaw = extractAuthorHref(sub)
-              const sText = clean(sub.querySelector('.content, .note-text'))
-              const sLikes = parseLikes(sub.querySelector('.count'))
-              const sTime = clean(sub.querySelector('.date, .time'))
-              if (!sText) return
-              results.push({ author: sAuthor, authorHrefRaw: sAuthorHrefRaw, text: sText, likes: sLikes, time: sTime, is_reply: true, reply_to: author })
-            })
-          }
-        }
-
-        return { pageUrl: location.href, securityBlock, loginWall, results }
-      })()
-    `;
-}
-export const command = cli({
-    site: 'xiaohongshu',
-    name: 'comments',
-    access: 'read',
-    description: '获取小红书笔记评论（支持楼中楼子回复）',
-    domain: 'www.xiaohongshu.com',
-    strategy: Strategy.COOKIE,
-    navigateBefore: false,
-    args: [
-        { name: 'note-id', required: true, positional: true, help: 'Full Xiaohongshu note URL with xsec_token' },
-        { name: 'limit', type: 'int', default: 20, help: 'Number of top-level comments (max 50)' },
-        { name: 'with-replies', type: 'boolean', default: false, help: 'Include nested replies (楼中楼)' },
-    ],
-    columns: ['rank', 'author', 'userId', 'profileUrl', 'text', 'likes', 'time', 'is_reply', 'reply_to'],
-    func: async (page, kwargs) => {
-        const limit = parseCommentLimit(kwargs.limit);
-        const withReplies = Boolean(kwargs['with-replies']);
-        const raw = String(kwargs['note-id']);
-        const noteId = parseNoteId(raw);
-        await page.goto(buildNoteUrl(raw, { commandName: 'xiaohongshu comments' }));
-        await page.wait({ time: 2 + Math.random() * 3 });
-        const data = await page.evaluate(buildCommentsExtractJs(withReplies));
-        if (!data || typeof data !== 'object') {
-            throw new EmptyResultError('xiaohongshu/comments', 'Unexpected evaluate response');
-        }
-        if (data.securityBlock) {
-            throw new CliError('SECURITY_BLOCK', 'Xiaohongshu security block: the note detail page was blocked by risk control.', /^https?:\/\//.test(raw)
-                ? 'The page may be temporarily restricted. Try again later or from a different session.'
-                : 'Try using a full URL from search results (with xsec_token) instead of a bare note ID.');
-        }
-        if (data.loginWall) {
-            throw new AuthRequiredError('www.xiaohongshu.com', 'Note comments require login');
-        }
-        // noteId currently unused after parsing — kept for symmetry with the note command
-        void noteId;
-        const all = data.results ?? [];
-        // authorHrefRaw is a raw transport field from the extractor; it is consumed
-        // here into userId / profileUrl and intentionally not part of the row shape.
-        const enrich = (c, i) => ({
-            rank: i + 1,
-            author: c.author,
-            userId: c.authorHrefRaw ? parseXhsProfileHref(c.authorHrefRaw) : '',
-            profileUrl: c.authorHrefRaw ? buildXhsProfileUrl(c.authorHrefRaw) : '',
-            text: c.text,
-            likes: c.likes,
-            time: c.time,
-            is_reply: c.is_reply,
-            reply_to: c.reply_to,
-        });
-        // When limiting, count only top-level comments; their replies are included for free
-        if (withReplies) {
-            const limited = [];
-            let topCount = 0;
-            for (const c of all) {
-                if (!c.is_reply)
-                    topCount++;
-                if (topCount > limit)
-                    break;
-                limited.push(c);
-            }
-            return limited.map(enrich);
-        }
-        return all.slice(0, limit).map(enrich);
-    },
-});