@skills-store/rednote 0.1.11 → 0.1.13

package/bin/rednote.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import { runRootCli } from '../dist/index.js';
+import { stringifyError } from '../dist/utils/browser-cli.js';
+
+async function finalizeCliProcess(exitCode) {
+  await new Promise((resolve) => process.stdout.write('', () => resolve()));
+  await new Promise((resolve) => process.stderr.write('', () => resolve()));
+  process.exit(exitCode);
+}
+
+try {
+  await runRootCli(process.argv.slice(2));
+  await finalizeCliProcess(0);
+} catch (error) {
+  process.stderr.write(
+    `${JSON.stringify(
+      {
+        ok: false,
+        error: stringifyError(error),
+      },
+      null,
+      2,
+    )}\n`,
+  );
+  await finalizeCliProcess(1);
+}

package/dist/rednote/env.js

@@ -1,17 +1,19 @@
 #!/usr/bin/env node
 import { parseArgs } from 'node:util';
-import { printJson, runCli } from '../utils/browser-cli.js';
+import { runCli } from '../utils/browser-cli.js';
 import { getRednoteEnvironmentInfo } from '../utils/browser-core.js';
+import { ensureJsonSavePath, renderJsonSaveSummary, resolveJsonSavePath, writeJsonFile } from './output-format.js';
 function printEnvHelp() {
     process.stdout.write(`rednote env
 
 Usage:
-  npx -y @skills-store/rednote env [--format md|json]
-  node --experimental-strip-types ./scripts/rednote/env.ts [--format md|json]
-  bun ./scripts/rednote/env.ts [--format md|json]
+  npx -y @skills-store/rednote env [--format md|json] [--save PATH]
+  node --experimental-strip-types ./scripts/rednote/env.ts [--format md|json] [--save PATH]
+  bun ./scripts/rednote/env.ts [--format md|json] [--save PATH]
 
 Options:
   --format FORMAT   Output format: md | json. Default: md
+  --save PATH       Required when --format json is used. Saves the full result as JSON
   -h, --help        Show this help
 `);
 }
@@ -40,8 +42,12 @@ export async function runEnvCommand(values = {}) {
         return;
     }
     const format = values.format ?? 'md';
+    ensureJsonSavePath(format, values.savePath);
     if (format === 'json') {
-        printJson(getRednoteEnvironmentInfo());
+        const result = getRednoteEnvironmentInfo();
+        const savedPath = resolveJsonSavePath(values.savePath);
+        writeJsonFile(result, savedPath);
+        process.stdout.write(renderJsonSaveSummary(savedPath, result));
         return;
     }
     process.stdout.write(renderEnvironmentMarkdown());
@@ -55,6 +61,9 @@ async function main() {
             format: {
                 type: 'string'
             },
+            save: {
+                type: 'string'
+            },
             help: {
                 type: 'boolean',
                 short: 'h'
@@ -64,6 +73,10 @@ async function main() {
     if (values.format && values.format !== 'md' && values.format !== 'json') {
         throw new Error(`Invalid --format value: ${String(values.format)}`);
     }
-    await runEnvCommand(values);
+    await runEnvCommand({
+        format: values.format,
+        savePath: values.save,
+        help: values.help
+    });
 }
 runCli(import.meta.url, main);

package/dist/rednote/getFeedDetail.js

@@ -2,59 +2,125 @@
 import * as cheerio from 'cheerio';
 import { parseArgs } from 'node:util';
 import vm from 'node:vm';
-import { printJson, runCli } from '../utils/browser-cli.js';
+import { runCli } from '../utils/browser-cli.js';
 import { resolveStatusTarget } from './status.js';
 import { createRednoteSession, disconnectRednoteSession, ensureRednoteLoggedIn } from './checkLogin.js';
+import { ensureJsonSavePath, renderJsonSaveSummary, resolveJsonSavePath, writeJsonFile } from './output-format.js';
 function printGetFeedDetailHelp() {
     process.stdout.write(`rednote get-feed-detail
 
 Usage:
-  npx -y @skills-store/rednote get-feed-detail [--instance NAME] --url URL [--url URL] [--format md|json]
-  node --experimental-strip-types ./scripts/rednote/getFeedDetail.ts --instance NAME --url URL [--url URL] [--format md|json]
-  bun ./scripts/rednote/getFeedDetail.ts --instance NAME --url URL [--url URL] [--format md|json]
+  npx -y @skills-store/rednote get-feed-detail [--instance NAME] --url URL [--url URL] [--comments [COUNT]] [--format md|json] [--save PATH]
+  node --experimental-strip-types ./scripts/rednote/getFeedDetail.ts --instance NAME --url URL [--url URL] [--comments [COUNT]] [--format md|json] [--save PATH]
+  bun ./scripts/rednote/getFeedDetail.ts --instance NAME --url URL [--url URL] [--comments [COUNT]] [--format md|json] [--save PATH]
 
 Options:
   --instance NAME   Optional. Defaults to the saved lastConnect instance
   --url URL         Required. Xiaohongshu explore url, repeatable
+  --comments [COUNT]  Optional. Include comment data. When COUNT is provided, scroll \`.note-scroller\` until COUNT comments, the end, or timeout
   --format FORMAT   Output format: md | json. Default: md
+  --save PATH       Required when --format json is used. Saves the selected result array as JSON
   -h, --help        Show this help
 `);
 }
+function parseOptionWithEquals(arg) {
+    const equalIndex = arg.indexOf('=');
+    if (equalIndex === -1) {
+        return null;
+    }
+    return {
+        key: arg.slice(0, equalIndex),
+        value: arg.slice(equalIndex + 1)
+    };
+}
+function parseCommentsValue(value) {
+    if (!value) {
+        throw new Error('Missing value for --comments');
+    }
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw new Error(`Invalid --comments value: ${String(value)}`);
+    }
+    return parsed;
+}
 export function parseGetFeedDetailCliArgs(argv) {
-    const { values, positionals } = parseArgs({
-        args: argv,
-        allowPositionals: true,
-        strict: false,
-        options: {
-            instance: {
-                type: 'string'
-            },
-            url: {
-                type: 'string',
-                multiple: true
-            },
-            format: {
-                type: 'string'
-            },
-            help: {
-                type: 'boolean',
-                short: 'h'
+    const values = {
+        urls: [],
+        format: 'md',
+        comments: undefined,
+        help: false
+    };
+    const positionals = [];
+    for(let index = 0; index < argv.length; index += 1){
+        const arg = argv[index];
+        const withEquals = parseOptionWithEquals(arg);
+        if (arg === '-h' || arg === '--help') {
+            values.help = true;
+            continue;
+        }
+        if (withEquals?.key === '--instance') {
+            values.instance = withEquals.value;
+            continue;
+        }
+        if (arg === '--instance') {
+            values.instance = argv[index + 1];
+            index += 1;
+            continue;
+        }
+        if (withEquals?.key === '--url') {
+            values.urls.push(withEquals.value);
+            continue;
+        }
+        if (arg === '--url') {
+            const nextArg = argv[index + 1];
+            if (!nextArg || nextArg.startsWith('-')) {
+                throw new Error('Missing required option value: --url');
+            }
+            values.urls.push(nextArg);
+            index += 1;
+            continue;
+        }
+        if (withEquals?.key === '--format') {
+            values.format = withEquals.value;
+            continue;
+        }
+        if (arg === '--format') {
+            values.format = argv[index + 1];
+            index += 1;
+            continue;
+        }
+        if (withEquals?.key === '--comments') {
+            values.comments = withEquals.value ? parseCommentsValue(withEquals.value) : null;
+            continue;
+        }
+        if (arg === '--comments') {
+            const nextArg = argv[index + 1];
+            if (nextArg && !nextArg.startsWith('-')) {
+                values.comments = parseCommentsValue(nextArg);
+                index += 1;
+            } else {
+                values.comments = null;
             }
+            continue;
         }
-    });
+        if (withEquals?.key === '--save') {
+            values.savePath = withEquals.value;
+            continue;
+        }
+        if (arg === '--save') {
+            values.savePath = argv[index + 1];
+            index += 1;
+            continue;
+        }
+        positionals.push(arg);
+    }
     if (positionals.length > 0) {
         throw new Error(`Unexpected positional arguments: ${positionals.join(' ')}`);
     }
-    const format = values.format ?? 'md';
-    if (format !== 'md' && format !== 'json') {
-        throw new Error(`Invalid --format value: ${String(format)}`);
+    if (values.format !== 'md' && values.format !== 'json') {
+        throw new Error(`Invalid --format value: ${String(values.format)}`);
     }
-    return {
-        instance: values.instance,
-        urls: values.url ?? [],
-        format,
-        help: values.help
-    };
+    return values;
 }
 function validateFeedDetailUrl(url) {
     try {
@@ -94,103 +160,150 @@ function extractVideoUrl(note) {
     const firstAvailable = streams.find((items)=>Array.isArray(items) && items.length > 0);
     return firstAvailable?.[0]?.backupUrls?.[0] ?? null;
 }
+const COMMENTS_CONTAINER_SELECTOR = '.note-scroller';
+const COMMENT_SCROLL_TIMEOUT_MS = 20_000;
+const COMMENT_SCROLL_IDLE_LIMIT = 4;
+function hasCommentsEnabled(comments) {
+    return comments !== undefined;
+}
+function buildCommentKey(comment) {
+    return String(comment?.id ?? comment?.commentId ?? comment?.comment_id ?? `${comment?.userInfo?.userId ?? comment?.user_info?.user_id ?? 'unknown'}:${comment?.createTime ?? comment?.create_time ?? 'unknown'}:${comment?.content ?? ''}`);
+}
+function getCommentCount(commentsMap) {
+    return commentsMap.size;
+}
+async function scrollCommentsContainer(page, targetCount, getCount) {
+    const container = page.locator(COMMENTS_CONTAINER_SELECTOR).first();
+    const visible = await container.isVisible().catch(()=>false);
+    if (!visible) {
+        return;
+    }
+    await container.scrollIntoViewIfNeeded().catch(()=>{});
+    await container.hover().catch(()=>{});
+    const getMetrics = async ()=>await container.evaluate((element)=>{
+            const htmlElement = element;
+            const atBottom = htmlElement.scrollTop + htmlElement.clientHeight >= htmlElement.scrollHeight - 8;
+            return {
+                scrollTop: htmlElement.scrollTop,
+                scrollHeight: htmlElement.scrollHeight,
+                clientHeight: htmlElement.clientHeight,
+                atBottom
+            };
+        }).catch(()=>null);
+    const deadline = Date.now() + COMMENT_SCROLL_TIMEOUT_MS;
+    let idleRounds = 0;
+    while(Date.now() < deadline){
+        if (getCount() >= targetCount) {
+            return;
+        }
+        const beforeMetrics = await getMetrics();
+        if (!beforeMetrics) {
+            return;
+        }
+        const beforeCount = getCount();
+        const delta = Math.max(Math.floor(beforeMetrics.clientHeight * 0.85), 480);
+        await page.mouse.wheel(0, delta).catch(()=>{});
+        await page.waitForTimeout(900);
+        const afterMetrics = await getMetrics();
+        await page.waitForTimeout(400);
+        const afterCount = getCount();
+        const countChanged = afterCount > beforeCount;
+        const scrollMoved = Boolean(afterMetrics) && afterMetrics.scrollTop > beforeMetrics.scrollTop;
+        const reachedBottom = Boolean(afterMetrics?.atBottom);
+        if (countChanged || scrollMoved) {
+            idleRounds = 0;
+            continue;
+        }
+        idleRounds += 1;
+        if (reachedBottom && idleRounds >= 2 || idleRounds >= COMMENT_SCROLL_IDLE_LIMIT) {
+            return;
+        }
+    }
+}
 function normalizeDetailNote(note) {
     return {
         noteId: note?.noteId ?? null,
         title: note?.title ?? null,
         desc: note?.desc ?? null,
         type: note?.type ?? null,
-        interactInfo: {
-            liked: note?.interactInfo?.liked ?? null,
-            likedCount: note?.interactInfo?.likedCount ?? null,
-            commentCount: note?.interactInfo?.commentCount ?? null,
-            collected: note?.interactInfo?.collected ?? null,
-            collectedCount: note?.interactInfo?.collectedCount ?? null,
-            shareCount: note?.interactInfo?.shareCount ?? null,
-            followed: note?.interactInfo?.followed ?? null
-        },
-        tagList: Array.isArray(note?.tagList) ? note.tagList.map((tag)=>({
-                name: tag?.name ?? null
-            })) : [],
-        imageList: Array.isArray(note?.imageList) ? note.imageList.map((image)=>({
-                urlDefault: image?.urlDefault ?? null,
-                urlPre: image?.urlPre ?? null,
-                width: image?.width ?? null,
-                height: image?.height ?? null
-            })) : [],
-        video: note?.video ? {
-            url: extractVideoUrl(note),
-            raw: note.video
-        } : null,
-        raw: note
+        liked: note?.interactInfo?.liked ?? null,
+        likedCount: note?.interactInfo?.likedCount ?? null,
+        commentCount: note?.interactInfo?.commentCount ?? null,
+        collected: note?.interactInfo?.collected ?? null,
+        collectedCount: note?.interactInfo?.collectedCount ?? null,
+        shareCount: note?.interactInfo?.shareCount ?? null,
+        followed: note?.interactInfo?.followed ?? null,
+        tagList: Array.isArray(note?.tagList) ? note.tagList.map((tag)=>tag?.name ?? null).filter((tag)=>Boolean(tag)) : [],
+        imageList: Array.isArray(note?.imageList) ? note.imageList.map((image)=>image?.urlDefault ?? null).filter((imageUrl)=>Boolean(imageUrl)) : [],
+        video: extractVideoUrl(note)
     };
 }
 function normalizeComments(comments) {
     return comments.map((comment)=>({
-            id: comment?.id ?? comment?.commentId ?? null,
             content: comment?.content ?? null,
-            userId: comment?.userInfo?.userId ?? null,
-            nickname: comment?.userInfo?.nickname ?? null,
-            likedCount: comment?.interactInfo?.likedCount ?? null,
-            subCommentCount: typeof comment?.subCommentCount === 'number' ? comment.subCommentCount : null,
-            raw: comment
+            userId: comment?.userInfo?.userId ?? comment?.user_info?.user_id ?? null,
+            nickname: comment?.userInfo?.nickname ?? comment?.user_info?.nickname ?? null,
+            create_time: comment?.createTime ?? comment?.create_time ?? null,
+            like_count: comment?.likeCount ?? comment?.like_count ?? comment?.interactInfo?.likedCount ?? null,
+            sub_comment_count: typeof (comment?.subCommentCount ?? comment?.sub_comment_count) === 'string' ? comment?.subCommentCount ?? comment?.sub_comment_count : null
         }));
 }
 function formatDetailField(value) {
     return value ?? '';
 }
-function renderDetailMarkdown(items) {
+function renderDetailMarkdown(items, includeComments = false) {
     if (items.length === 0) {
-        return '没有获取到帖子详情。\n';
+        return 'No feed details were captured.\n';
     }
     return `${items.map((item)=>{
         const lines = [];
         lines.push('## Note');
         lines.push('');
-        lines.push(`- Url: ${item.url}`);
         lines.push(`- Title: ${formatDetailField(item.note.title)}`);
-        lines.push(`- Type: ${formatDetailField(item.note.type)}`);
-        lines.push(`- Liked: ${formatDetailField(item.note.interactInfo.liked)}`);
-        lines.push(`- Collected: ${formatDetailField(item.note.interactInfo.collected)}`);
-        lines.push(`- LikedCount: ${formatDetailField(item.note.interactInfo.likedCount)}`);
-        lines.push(`- CommentCount: ${formatDetailField(item.note.interactInfo.commentCount)}`);
-        lines.push(`- CollectedCount: ${formatDetailField(item.note.interactInfo.collectedCount)}`);
-        lines.push(`- ShareCount: ${formatDetailField(item.note.interactInfo.shareCount)}`);
-        lines.push(`- Tags: ${item.note.tagList.map((tag)=>tag.name ? `#${tag.name}` : '').filter(Boolean).join(' ')}`);
+        lines.push(`- Liked: ${formatDetailField(item.note.liked)}`);
+        lines.push(`- Collected: ${formatDetailField(item.note.collected)}`);
+        lines.push(`- LikedCount: ${formatDetailField(item.note.likedCount)}`);
+        lines.push(`- CommentCount: ${formatDetailField(item.note.commentCount)}`);
+        lines.push(`- CollectedCount: ${formatDetailField(item.note.collectedCount)}`);
+        lines.push(`- ShareCount: ${formatDetailField(item.note.shareCount)}`);
+        lines.push(`- Tags: ${item.note.tagList.map((tag)=>`#${tag}`).join(' ')}`);
         lines.push('');
         lines.push('## Content');
         lines.push('');
         lines.push(item.note.desc ?? '');
-        if (item.note.imageList.length > 0 || item.note.video?.url) {
+        if (item.note.imageList.length > 0 || item.note.video) {
             lines.push('');
             lines.push('## Media');
             lines.push('');
-            item.note.imageList.forEach((image, index)=>{
-                if (image.urlDefault) {
-                    lines.push(`- Image${index + 1}: ${image.urlDefault}`);
-                }
+            item.note.imageList.forEach((imageUrl, index)=>{
+                lines.push(`- Image${index + 1}: ${imageUrl}`);
             });
-            if (item.note.video?.url) {
-                lines.push(`- Video: ${item.note.video.url}`);
+            if (item.note.video) {
+                lines.push(`- Video: ${item.note.video}`);
             }
         }
-        lines.push('');
-        lines.push('## Comments');
-        lines.push('');
-        if (item.comments.length === 0) {
-            lines.push('- Comments not found');
-        } else {
-            item.comments.forEach((comment)=>{
-                const prefix = comment.nickname ? `${comment.nickname}: ` : '';
-                lines.push(`- ${prefix}${comment.content ?? ''}`);
-            });
+        if (includeComments) {
+            lines.push('');
+            lines.push('## Comments');
+            lines.push('');
+            if (!item.comments || item.comments.length === 0) {
+                lines.push('- Comments not found');
+            } else {
+                item.comments.forEach((comment)=>{
+                    const prefix = comment.nickname ? `${comment.nickname}: ` : '';
+                    lines.push(`- ${prefix}${comment.content ?? ''}`);
+                });
+            }
         }
         return lines.join('\n');
     }).join('\n\n---\n\n')}\n`;
 }
-async function captureFeedDetail(page, targetUrl) {
+async function captureFeedDetail(page, targetUrl, commentsOption = undefined) {
+    const includeComments = hasCommentsEnabled(commentsOption);
+    const commentsTarget = typeof commentsOption === 'number' ? commentsOption : null;
     let note = null;
-    let comments = null;
+    let commentsLoaded = !includeComments;
+    const commentsMap = new Map();
     const handleResponse = async (response)=>{
         try {
             const url = new URL(response.url());
@@ -214,9 +327,13 @@ async function captureFeedDetail(page, targetUrl) {
                         note = noteState.noteDetailMap[noteState.currentNoteId]?.note ?? note;
                     }
                 });
-            } else if (url.href.includes('comment/page?')) {
+            } else if (includeComments && url.href.includes('comment/page?')) {
                 const data = await response.json();
-                comments = Array.isArray(data?.data?.comments) ? data.data.comments : [];
+                const nextComments = Array.isArray(data?.data?.comments) ? data.data.comments : [];
+                commentsLoaded = true;
+                for (const comment of nextComments){
+                    commentsMap.set(buildCommentKey(comment), comment);
+                }
             }
         } catch  {}
     };
@@ -227,7 +344,7 @@ async function captureFeedDetail(page, targetUrl) {
         });
         const deadline = Date.now() + 15_000;
         while(Date.now() < deadline){
-            if (note && comments !== null) {
+            if (note && commentsLoaded) {
                 break;
             }
             await page.waitForTimeout(200);
@@ -235,22 +352,29 @@ async function captureFeedDetail(page, targetUrl) {
         if (!note) {
             throw new Error(`Failed to capture note detail: ${targetUrl}`);
         }
+        if (includeComments && commentsTarget) {
+            await scrollCommentsContainer(page, commentsTarget, ()=>getCommentCount(commentsMap));
+        }
         return {
             url: targetUrl,
             note: normalizeDetailNote(note),
-            comments: normalizeComments(comments ?? [])
+            ...includeComments ? {
+                comments: normalizeComments([
+                    ...commentsMap.values()
+                ])
+            } : {}
         };
     } finally{
         page.off('response', handleResponse);
     }
 }
-export async function getFeedDetails(session, urls) {
+export async function getFeedDetails(session, urls, commentsOption = undefined) {
     const page = await getOrCreateXiaohongshuPage(session);
     const items = [];
     for (const url of urls){
         const normalizedUrl = normalizeFeedDetailUrl(url);
         validateFeedDetailUrl(normalizedUrl);
-        items.push(await captureFeedDetail(page, normalizedUrl));
+        items.push(await captureFeedDetail(page, normalizedUrl, commentsOption));
     }
     return {
         ok: true,
@@ -261,12 +385,18 @@ export async function getFeedDetails(session, urls) {
         }
     };
 }
-function writeFeedDetailOutput(result, format) {
-    if (format === 'json') {
-        printJson(result);
+function selectFeedDetailOutput(result) {
+    return result.detail.items;
+}
+function writeFeedDetailOutput(result, values) {
+    const output = selectFeedDetailOutput(result);
+    if (values.format === 'json') {
+        const savedPath = resolveJsonSavePath(values.savePath);
+        writeJsonFile(output, savedPath);
+        process.stdout.write(renderJsonSaveSummary(savedPath, output));
         return;
     }
-    process.stdout.write(renderDetailMarkdown(result.detail.items));
+    process.stdout.write(renderDetailMarkdown(result.detail.items, hasCommentsEnabled(values.comments)));
 }
 export async function runGetFeedDetailCommand(values = {
     urls: [],
@@ -276,6 +406,7 @@ export async function runGetFeedDetailCommand(values = {
         printGetFeedDetailHelp();
         return;
     }
+    ensureJsonSavePath(values.format, values.savePath);
     if (values.urls.length === 0) {
         throw new Error('Missing required option: --url');
     }
@@ -283,8 +414,8 @@ export async function runGetFeedDetailCommand(values = {
     const session = await createRednoteSession(target);
     try {
         await ensureRednoteLoggedIn(target, 'fetching feed detail', session);
-        const result = await getFeedDetails(session, values.urls);
-        writeFeedDetailOutput(result, values.format);
+        const result = await getFeedDetails(session, values.urls, values.comments);
+        writeFeedDetailOutput(result, values);
     } finally{
         await disconnectRednoteSession(session);
     }

package/dist/rednote/getProfile.js

@@ -2,21 +2,24 @@
 import * as cheerio from 'cheerio';
 import { parseArgs } from 'node:util';
 import vm from 'node:vm';
-import { printJson, runCli } from '../utils/browser-cli.js';
+import { runCli } from '../utils/browser-cli.js';
 import { resolveStatusTarget } from './status.js';
 import { createRednoteSession, disconnectRednoteSession, ensureRednoteLoggedIn } from './checkLogin.js';
+import { ensureJsonSavePath, renderJsonSaveSummary, renderPostsMarkdown, resolveJsonSavePath, writeJsonFile } from './output-format.js';
 function printGetProfileHelp() {
     process.stdout.write(`rednote get-profile
 
 Usage:
-  npx -y @skills-store/rednote get-profile [--instance NAME] --id USER_ID [--format md|json]
-  node --experimental-strip-types ./scripts/rednote/getProfile.ts --instance NAME --id USER_ID [--format md|json]
-  bun ./scripts/rednote/getProfile.ts --instance NAME --id USER_ID [--format md|json]
+  npx -y @skills-store/rednote get-profile [--instance NAME] --id USER_ID [--mode profile|notes] [--format md|json] [--save PATH]
+  node --experimental-strip-types ./scripts/rednote/getProfile.ts --instance NAME --id USER_ID [--mode profile|notes] [--format md|json] [--save PATH]
+  bun ./scripts/rednote/getProfile.ts --instance NAME --id USER_ID [--mode profile|notes] [--format md|json] [--save PATH]
 
 Options:
   --instance NAME   Optional. Defaults to the saved lastConnect instance
   --id USER_ID      Required. Xiaohongshu profile user id
+  --mode MODE       Optional. profile | notes. Default: profile
   --format FORMAT   Output format: md | json. Default: md
+  --save PATH       Required when --format json is used. Saves only the selected mode data as JSON
   -h, --help        Show this help
 `);
 }
@@ -35,6 +38,12 @@ export function parseGetProfileCliArgs(argv) {
             format: {
                 type: 'string'
             },
+            mode: {
+                type: 'string'
+            },
+            save: {
+                type: 'string'
+            },
             help: {
                 type: 'boolean',
                 short: 'h'
@@ -48,10 +57,16 @@ export function parseGetProfileCliArgs(argv) {
     if (format !== 'md' && format !== 'json') {
         throw new Error(`Invalid --format value: ${String(format)}`);
     }
+    const mode = values.mode ?? 'profile';
+    if (mode !== 'profile' && mode !== 'notes') {
+        throw new Error(`Invalid --mode value: ${String(values.mode)}`);
+    }
     return {
         instance: values.instance,
         id: values.id,
         format,
+        mode,
+        savePath: values.save,
         help: values.help
     };
 }
@@ -103,8 +118,7 @@ function normalizeProfileUser(userPageData) {
         follows: follows,
         fans: fans,
         interaction: interaction,
-        tags,
-        raw: userPageData
+        tags
     };
 }
 function normalizeProfileNote(item) {
@@ -197,8 +211,8 @@ function normalizeProfileNotes(notesRaw) {
 function formatProfileField(value) {
     return value ?? '';
 }
-function renderProfileMarkdown(result) {
-    const { user, notes, url, userId } = result.profile;
+function renderProfileUserMarkdown(result) {
+    const { user, url, userId } = result.profile;
     const lines = [];
     lines.push('## UserInfo');
     lines.push('');
@@ -211,23 +225,17 @@ function renderProfileMarkdown(result) {
     lines.push(`- Fans: ${formatProfileField(user.fans)}`);
     lines.push(`- Interactions: ${formatProfileField(user.interaction)}`);
     lines.push(`- Tags: ${user.tags.length > 0 ? user.tags.map((tag)=>`#${tag}`).join(' ') : ''}`);
-    lines.push('');
-    lines.push('## Notes');
-    lines.push('');
-    if (notes.length === 0) {
-        lines.push('- Notes not found or the profile is private');
-    } else {
-        notes.forEach((note, index)=>{
-            lines.push(`- Title: ${note.noteCard.displayTitle ?? ''}`);
-            lines.push(`  Url: ${note.url}`);
-            lines.push(`  Interaction: ${note.noteCard.interactInfo.likedCount ?? ''}`);
-            if (index < notes.length - 1) {
-                lines.push('');
-            }
-        });
-    }
     return `${lines.join('\n')}\n`;
 }
+function selectProfileOutput(result, mode) {
+    return mode === 'notes' ? result.profile.notes : result.profile.user;
+}
+function renderProfileMarkdown(result, mode) {
+    if (mode === 'notes') {
+        return renderPostsMarkdown(result.profile.notes);
+    }
+    return renderProfileUserMarkdown(result);
+}
 async function captureProfile(page, targetUrl) {
     let userPageData = null;
     let notes = null;
@@ -286,26 +294,33 @@ export async function getProfile(session, url, userId) {
             userId,
             url,
             fetchedAt: new Date().toISOString(),
-            user: normalizeProfileUser(captured.userPageData),
-            notes: normalizeProfileNotes(captured.notes),
-            raw: captured
+            user: normalizeProfileUser({
+                ...captured.userPageData,
+                userId
+            }),
+            notes: normalizeProfileNotes(captured.notes)
         }
     };
 }
-function writeProfileOutput(result, format) {
-    if (format === 'json') {
-        printJson(result);
+function writeProfileOutput(result, values) {
+    const output = selectProfileOutput(result, values.mode);
+    if (values.format === 'json') {
+        const savedPath = resolveJsonSavePath(values.savePath);
+        writeJsonFile(output, savedPath);
+        process.stdout.write(renderJsonSaveSummary(savedPath, output));
         return;
     }
-    process.stdout.write(renderProfileMarkdown(result));
+    process.stdout.write(renderProfileMarkdown(result, values.mode));
 }
 export async function runGetProfileCommand(values = {
-    format: 'md'
+    format: 'md',
+    mode: 'profile'
 }) {
     if (values.help) {
         printGetProfileHelp();
         return;
     }
+    ensureJsonSavePath(values.format, values.savePath);
     if (!values.id) {
         throw new Error('Missing required option: --id');
     }
@@ -315,7 +330,7 @@ export async function runGetProfileCommand(values = {
     try {
         await ensureRednoteLoggedIn(target, 'fetching profile', session);
         const result = await getProfile(session, buildProfileUrl(normalizedUserId), normalizedUserId);
-        writeProfileOutput(result, values.format);
+        writeProfileOutput(result, values);
     } finally{
         await disconnectRednoteSession(session);
     }

package/dist/rednote/home.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import { parseArgs } from 'node:util';
-import { printJson, runCli } from '../utils/browser-cli.js';
+import { runCli } from '../utils/browser-cli.js';
 import { resolveStatusTarget } from './status.js';
 import * as cheerio from 'cheerio';
 import vm from 'node:vm';
-import { parseOutputCliArgs, renderPostsMarkdown, resolveSavePath, writePostsJsonl } from './output-format.js';
+import { ensureJsonSavePath, parseOutputCliArgs, renderJsonSaveSummary, renderPostsMarkdown, resolveJsonSavePath, resolveSavePath, writeJsonFile, writePostsJsonl } from './output-format.js';
 import { createRednoteSession, disconnectRednoteSession } from './checkLogin.js';
 export function parseHomeCliArgs(argv) {
     return parseOutputCliArgs(argv);
@@ -20,7 +20,7 @@ Usage:
 Options:
   --instance NAME   Optional. Defaults to the saved lastConnect instance
   --format FORMAT   Output format: md | json. Default: md
-  --save [PATH]     Save posts as JSONL. Uses a default path when PATH is omitted
+  --save [PATH]     In markdown mode, saves posts as JSONL and uses a default path when PATH is omitted. In json mode, PATH is required and the full result is saved as JSON
   -h, --help        Show this help
 `);
 }
@@ -165,6 +165,13 @@ export async function getRednoteHomePosts(session) {
     };
 }
 function writeHomeOutput(result, values) {
+    if (values.format === 'json') {
+        const savedPath = resolveJsonSavePath(values.savePath);
+        result.home.savedPath = savedPath;
+        writeJsonFile(result.home.posts, savedPath);
+        process.stdout.write(renderJsonSaveSummary(savedPath, result.home.posts));
+        return;
+    }
     const posts = result.home.posts;
     let savedPath;
     if (values.saveRequested) {
@@ -172,10 +179,6 @@ function writeHomeOutput(result, values) {
         writePostsJsonl(posts, savedPath);
         result.home.savedPath = savedPath;
     }
-    if (values.format === 'json') {
-        printJson(result);
-        return;
-    }
     let markdown = renderPostsMarkdown(posts);
     if (savedPath) {
         markdown = `Saved JSONL: ${savedPath}\n\n${markdown}`;
@@ -190,6 +193,7 @@ export async function runHomeCommand(values = {
         printHomeHelp();
         return;
     }
+    ensureJsonSavePath(values.format, values.savePath);
     const target = resolveStatusTarget(values.instance);
     const session = await createRednoteSession(target);
     try {

package/dist/rednote/index.js

@@ -6,7 +6,7 @@ function printRednoteHelp() {
 
 Commands:
   browser <list|create|remove|connect>
-  env [--format md|json]
+  env [--format md|json] [--save PATH]
   status [--instance NAME]
   check-login [--instance NAME]
   login [--instance NAME]
@@ -14,21 +14,22 @@ Commands:
   interact [--instance NAME] --url URL [--like] [--collect] [--comment TEXT]
   home [--instance NAME] [--format md|json] [--save [PATH]]
   search [--instance NAME] --keyword TEXT [--format md|json] [--save [PATH]]
-  get-feed-detail [--instance NAME] --url URL [--url URL] [--format md|json]
-  get-profile [--instance NAME] --id USER_ID [--format md|json]
+  get-feed-detail [--instance NAME] --url URL [--url URL] [--comments [COUNT]] [--format md|json] [--save PATH]
+  get-profile [--instance NAME] --id USER_ID [--mode profile|notes] [--format md|json] [--save PATH]
 
 Examples:
   npx -y @skills-store/rednote browser list
   npx -y @skills-store/rednote browser create --name seller-main --browser chrome
   npx -y @skills-store/rednote env
+  npx -y @skills-store/rednote env --format json --save ./output/env.json
   npx -y @skills-store/rednote status --instance seller-main
   npx -y @skills-store/rednote login --instance seller-main
-  npx -y @skills-store/rednote publish --instance seller-main --type video --video ./note.mp4 --title 标题 --content 描述
-  npx -y @skills-store/rednote interact --instance seller-main --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy" --like --collect --comment "写得真好"
+  npx -y @skills-store/rednote publish --instance seller-main --type video --video ./note.mp4 --title "Video title" --content "Video description"
+  npx -y @skills-store/rednote interact --instance seller-main --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy" --like --collect --comment "Great post"
   npx -y @skills-store/rednote home --instance seller-main --format md --save
-  npx -y @skills-store/rednote search --instance seller-main --keyword 护肤 --format json --save ./output/search.jsonl
-  npx -y @skills-store/rednote get-feed-detail --instance seller-main --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy"
-  npx -y @skills-store/rednote get-profile --instance seller-main --id USER_ID
+  npx -y @skills-store/rednote search --instance seller-main --keyword skincare --format json --save ./output/search.json
+  npx -y @skills-store/rednote get-feed-detail --instance seller-main --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy" --comments 100 --format json --save ./output/feed-detail.json
+  npx -y @skills-store/rednote get-profile --instance seller-main --id USER_ID --mode notes --format json --save ./output/profile-notes.json
 `);
 }
 function parseBasicArgs(argv) {

package/dist/rednote/interact.js

@@ -135,7 +135,7 @@ async function requireVisibleLocator(locator, errorMessage, timeoutMs = 5_000) {
 }
 async function typeCommentContent(page, content) {
     const commentInput = page.locator(COMMENT_INPUT_SELECTOR);
-    const visibleCommentInput = await requireVisibleLocator(commentInput, '未找到评论输入框，请确认帖子详情页已正确加载。', 15_000);
+    const visibleCommentInput = await requireVisibleLocator(commentInput, 'Could not find the comment input. Make sure the feed detail page finished loading.', 15_000);
     await visibleCommentInput.scrollIntoViewIfNeeded();
     await visibleCommentInput.click({
         force: true
@@ -160,7 +160,7 @@ async function clickSendComment(page) {
     const sendButton = page.locator(COMMENT_SEND_BUTTON_SELECTOR).filter({
         hasText: COMMENT_SEND_BUTTON_TEXT
     });
-    const visibleSendButton = await requireVisibleLocator(sendButton, '未找到“发送”按钮，请确认评论工具栏已正确加载。', 15_000);
+    const visibleSendButton = await requireVisibleLocator(sendButton, 'Could not find the Send button. Make sure the comment toolbar finished loading.', 15_000);
     await page.waitForFunction(({ selector, text })=>{
         const buttons = [
             ...document.querySelectorAll(selector)
@@ -198,10 +198,10 @@ async function commentOnCurrentFeedPage(page, content) {
 async function waitForInteractContainer(page) {
     await page.waitForLoadState('domcontentloaded');
     await page.waitForTimeout(500);
-    await requireVisibleLocator(page.locator(INTERACT_CONTAINER_SELECTOR), '未找到互动工具栏，请确认帖子详情页已正确加载。', 15_000);
+    await requireVisibleLocator(page.locator(INTERACT_CONTAINER_SELECTOR), 'Could not find the interaction toolbar. Make sure the feed detail page finished loading.', 15_000);
 }
 function getActionErrorMessage(action) {
-    return action === 'like' ? '未找到点赞按钮，请确认帖子详情页已正确加载。' : '未找到收藏按钮，请确认帖子详情页已正确加载。';
+    return action === 'like' ? 'Could not find the Like button. Make sure the feed detail page finished loading.' : 'Could not find the Collect button. Make sure the feed detail page finished loading.';
 }
 async function ensureActionApplied(page, action, alreadyActive) {
     if (alreadyActive) {

package/dist/rednote/login.js

@@ -72,7 +72,7 @@ async function saveQrCodeImage(page) {
         });
         return filePath;
     }
-    throw new Error('未检测到可用的小红书登录二维码，请确认登录弹窗是否已打开。');
+    throw new Error('No usable Xiaohongshu login QR code was detected. Make sure the login dialog is open.');
 }
 function printLoginHelp() {
     process.stdout.write(`rednote login
@@ -108,11 +108,12 @@ export async function openRednoteLogin(target, session) {
                 pageUrl: session.page.url(),
                 waitingForPhoneLogin: false,
                 qrCodePath: null,
-                message: '当前实例已登录，无需重复执行登录操作。'
+                message: 'The current instance is already logged in. No additional login step is required.'
             }
         };
     }
     const { page } = await getOrCreateXiaohongshuPage(session);
+    await page.reload();
     const loginButton = page.locator('#login-btn');
     const hasLoginButton = await loginButton.count() > 0;
     if (!hasLoginButton) {
@@ -123,12 +124,13 @@ export async function openRednoteLogin(target, session) {
                 pageUrl: page.url(),
                 waitingForPhoneLogin: false,
                 qrCodePath: null,
-                message: '未检测到登录按钮，当前实例可能已经登录。'
+                message: 'No login button was found. The current instance may already be logged in.'
             }
         };
     }
     await loginButton.first().click({
-        timeout: 2000
+        timeout: 2000,
+        force: true
     });
     await page.waitForTimeout(500);
     const qrCodePath = await saveQrCodeImage(page);
@@ -139,7 +141,7 @@ export async function openRednoteLogin(target, session) {
             pageUrl: page.url(),
             waitingForPhoneLogin: true,
             qrCodePath,
-            message: '已点击登录按钮并导出二维码图片，请扫码完成登录。'
+            message: 'The login button was clicked and the QR code image was exported. Scan the code to finish logging in.'
         }
     };
 }

package/dist/rednote/output-format.js

@@ -98,12 +98,86 @@ export function writePostsJsonl(posts, filePath) {
     const content = posts.map((post)=>JSON.stringify(post)).join('\n');
     fs.writeFileSync(filePath, content ? `${content}\n` : '', 'utf8');
 }
+export function ensureJsonSavePath(format, savePath) {
+    if (format !== 'json') {
+        return;
+    }
+    if (!savePath?.trim()) {
+        throw new Error('The --save PATH option is required when --format json is used.');
+    }
+}
+export function resolveJsonSavePath(explicitPath) {
+    const normalizedPath = explicitPath?.trim();
+    if (!normalizedPath) {
+        throw new Error('The --save PATH option is required when --format json is used.');
+    }
+    return path.resolve(normalizedPath);
+}
+export function writeJsonFile(payload, filePath) {
+    fs.mkdirSync(path.dirname(filePath), {
+        recursive: true
+    });
+    fs.writeFileSync(filePath, `${JSON.stringify(payload, null, 2)}\n`, 'utf8');
+}
+function describeStringValue(value, key) {
+    if (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/.test(value) || key.toLowerCase().endsWith('at')) {
+        return 'ISO-8601 string';
+    }
+    if (key.toLowerCase().endsWith('url')) {
+        return 'string (URL)';
+    }
+    if (key.toLowerCase().endsWith('path')) {
+        return 'string (path)';
+    }
+    return 'string';
+}
+function buildJsonFieldExample(value, key = '', depth = 0) {
+    if (value === null) {
+        return 'null';
+    }
+    if (value === undefined) {
+        return 'undefined';
+    }
+    if (typeof value === 'string') {
+        return describeStringValue(value, key);
+    }
+    if (typeof value === 'number') {
+        return 'number';
+    }
+    if (typeof value === 'boolean') {
+        return 'boolean';
+    }
+    if (Array.isArray(value)) {
+        return value.length > 0 ? [
+            buildJsonFieldExample(value[0], key, depth + 1)
+        ] : [
+            'unknown'
+        ];
+    }
+    if (typeof value === 'object') {
+        if (depth >= 3 || key === 'raw') {
+            return 'object';
+        }
+        const entries = Object.entries(value);
+        if (entries.length === 0) {
+            return 'object';
+        }
+        return Object.fromEntries(entries.map(([entryKey, entryValue])=>[
+                entryKey,
+                buildJsonFieldExample(entryValue, entryKey, depth + 1)
+            ]));
+    }
+    return typeof value;
+}
+export function renderJsonSaveSummary(filePath, payload) {
+    return `Saved JSON: ${filePath}\n\nField format example:\n${JSON.stringify(buildJsonFieldExample(payload), null, 3)}\n`;
+}
 function formatField(value) {
     return value ?? '';
 }
 export function renderPostsMarkdown(posts) {
     if (posts.length === 0) {
-        return '没有获取到帖子。\n';
+        return 'No posts were captured.\n';
     }
     return `${posts.map((post)=>[
             `- id: ${post.id}`,

package/dist/rednote/publish.js

@@ -34,24 +34,36 @@ function printPublishHelp() {
     process.stdout.write(`rednote publish
 
 Usage:
-  npx -y @skills-store/rednote publish --type video --video ./video.mp4 --title 标题 --content 描述 [--tag 穿搭] [--tag 日常] [--publish] [--instance NAME]
-  npx -y @skills-store/rednote publish --type image --image ./1.jpg --image ./2.jpg --title 标题 --content 描述 [--tag 探店] [--publish] [--instance NAME]
-  npx -y @skills-store/rednote publish --type article --title 标题 --content '# 一级标题\n\n正文' [--publish] [--instance NAME]
+  npx -y @skills-store/rednote publish --type video --video ./video.mp4 --title "Video title" --content "Video description" [--tag fashion] [--tag ootd] [--publish] [--instance NAME]
+  npx -y @skills-store/rednote publish --type image --image ./1.jpg --image ./2.jpg --title "Image title" --content "Image description" [--tag travel] [--publish] [--instance NAME]
+  npx -y @skills-store/rednote publish --type article --title "Article title" --content '# Heading\n\nBody content' [--publish] [--instance NAME]
   node --experimental-strip-types ./scripts/rednote/publish.ts ...
   bun ./scripts/rednote/publish.ts ...
 
 Options:
   --instance NAME      Optional. Defaults to the saved lastConnect instance
-  --type TYPE          可选。video | image | article；不传时会按参数自动推断
-  --title TEXT         Required. 发布标题
-  --content TEXT       必填。视频/图文时为描述，长文时为 Markdown 内容
-  --tag TEXT           可选。重复传入多个标签，例如 --tag 穿搭 --tag OOTD
-  --video PATH         视频模式必填。只能传 1 个视频文件
-  --image PATH         图文模式必填。重复传入多张图片，最多 ${MAX_IMAGE_COUNT} 张，首张为首图
-  --publish            立即发布。不传时默认保存草稿
+  --type TYPE          Optional. video | image | article. If omitted, the type is inferred from the provided assets
+  --title TEXT         Required. Post title
+  --content TEXT       Required. Description for video/image posts, or Markdown content for article posts
+  --tag TEXT           Optional. Repeat to provide multiple tags, for example: --tag fashion --tag OOTD
+  --video PATH         Required for video posts. Only one video file is accepted
+  --image PATH         Required for image posts. Repeat to provide multiple images, up to ${MAX_IMAGE_COUNT}; the first image becomes the cover
+  --publish            Publish immediately. If omitted, the content is saved as a draft
   -h, --help           Show this help
 `);
 }
+function describePublishType(type) {
+    if (type === 'video') {
+        return 'Upload Video';
+    }
+    if (type === 'image') {
+        return 'Upload Image Post';
+    }
+    return 'Write Article';
+}
+function describePublishAction(draft) {
+    return draft ? 'Save Draft and Leave' : 'Publish';
+}
 function isCreatorHomeUrl(url) {
     return url === CREATOR_HOME_URL || url.startsWith(`${CREATOR_HOME_URL}?`) || url.startsWith(`${CREATOR_HOME_URL}#`);
 }
@@ -313,13 +325,13 @@ async function openPublishComposer(page, type) {
     const publishNoteButton = page.locator(PUBLISH_NOTE_BUTTON_SELECTOR).filter({
         hasText: PUBLISH_NOTE_BUTTON_TEXT
     });
-    const visiblePublishNoteButton = await requireVisibleLocator(publishNoteButton, '未找到“发布笔记”按钮，请确认已进入创作服务首页。', 15_000);
+    const visiblePublishNoteButton = await requireVisibleLocator(publishNoteButton, 'Could not find the Publish Note button. Make sure the Creator Services home page is open.', 15_000);
     await visiblePublishNoteButton.click();
     const publishTypeTabText = resolvePublishTypeTabText(type);
     const publishTypeTab = page.locator(PUBLISH_TYPE_TAB_SELECTOR).filter({
         hasText: publishTypeTabText
     }).last();
-    const visiblePublishTypeTab = await requireVisibleLocator(publishTypeTab, `未找到“${publishTypeTabText}”入口，请确认创作服务页面已正确加载。`, 15_000);
+    const visiblePublishTypeTab = await requireVisibleLocator(publishTypeTab, `Could not find the ${describePublishType(type)} entry. Make sure the Creator Services page finished loading.`, 15_000);
     await visiblePublishTypeTab.click();
     await page.waitForTimeout(300);
 }
@@ -327,7 +339,7 @@ async function uploadVideoFile(page, videoPath) {
     const uploadVideoButton = page.locator(VIDEO_UPLOAD_BUTTON_SELECTOR).filter({
         hasText: VIDEO_UPLOAD_BUTTON_TEXT
     });
-    const visibleUploadVideoButton = await requireVisibleLocator(uploadVideoButton, '未找到“上传视频”按钮，请确认已进入视频发布页。', 15_000);
+    const visibleUploadVideoButton = await requireVisibleLocator(uploadVideoButton, 'Could not find the Upload Video button. Make sure the video publishing page is open.', 15_000);
     const fileChooserPromise = page.waitForEvent('filechooser', {
         timeout: 3_000
     }).catch(()=>null);
@@ -339,7 +351,7 @@ async function uploadVideoFile(page, videoPath) {
     }
     const videoFileInput = page.locator(`${VIDEO_FILE_INPUT_SELECTOR}[accept*="video"], ${VIDEO_FILE_INPUT_SELECTOR}`);
     if (await videoFileInput.count() === 0) {
-        throw new Error('未找到视频文件输入框，请确认上传组件已正确加载。');
+        throw new Error('Could not find the video file input. Make sure the upload component finished loading.');
     }
     await videoFileInput.first().setInputFiles(videoPath);
 }
@@ -347,7 +359,7 @@ async function uploadImageFiles(page, imagePaths) {
     const uploadImageButton = page.locator(IMAGE_UPLOAD_BUTTON_SELECTOR).filter({
         hasText: IMAGE_UPLOAD_BUTTON_TEXT
     });
-    const visibleUploadImageButton = await requireVisibleLocator(uploadImageButton, '未找到“上传图片”按钮，请确认已进入图文发布页。', 15_000);
+    const visibleUploadImageButton = await requireVisibleLocator(uploadImageButton, 'Could not find the Upload Image button. Make sure the image publishing page is open.', 15_000);
     const fileChooserPromise = page.waitForEvent('filechooser', {
         timeout: 3_000
     }).catch(()=>null);
@@ -359,13 +371,13 @@ async function uploadImageFiles(page, imagePaths) {
     }
     const imageFileInput = page.locator(`${IMAGE_FILE_INPUT_SELECTOR}[accept*="image"], ${IMAGE_FILE_INPUT_SELECTOR}`);
     if (await imageFileInput.count() === 0) {
-        throw new Error('未找到图片文件输入框，请确认上传组件已正确加载。');
+        throw new Error('Could not find the image file input. Make sure the upload component finished loading.');
     }
     await imageFileInput.first().setInputFiles(imagePaths);
 }
 async function waitForImagePublishPage(page) {
     const imagePublishPage = page.locator(IMAGE_PUBLISH_PAGE_SELECTOR);
-    const visibleImagePublishPage = await requireVisibleLocator(imagePublishPage, '未等待到图文发布页，请确认图片上传成功。', 30_000);
+    const visibleImagePublishPage = await requireVisibleLocator(imagePublishPage, 'The image publishing page did not appear. Make sure the image upload completed successfully.', 30_000);
     await visibleImagePublishPage.waitFor({
         state: 'visible',
         timeout: 30_000
@@ -373,13 +385,13 @@ async function waitForImagePublishPage(page) {
 }
 async function fillImageTitle(page, title) {
     const imageTitleInput = page.locator(IMAGE_TITLE_INPUT_SELECTOR);
-    const visibleImageTitleInput = await requireVisibleLocator(imageTitleInput, '未找到图文标题输入框，请确认图文发布页已正确加载。', 15_000);
+    const visibleImageTitleInput = await requireVisibleLocator(imageTitleInput, 'Could not find the image post title input. Make sure the image publishing page finished loading.', 15_000);
     await visibleImageTitleInput.fill(title);
     await page.waitForTimeout(200);
 }
 async function fillImageContent(page, content) {
     const imageContentEditor = page.locator(IMAGE_CONTENT_EDITOR_SELECTOR);
-    const visibleImageContentEditor = await requireVisibleLocator(imageContentEditor, '未找到图文正文编辑器，请确认图文发布页已正确加载。', 15_000);
+    const visibleImageContentEditor = await requireVisibleLocator(imageContentEditor, 'Could not find the image post content editor. Make sure the image publishing page finished loading.', 15_000);
     await visibleImageContentEditor.fill(content);
     await page.waitForTimeout(200);
 }
@@ -387,19 +399,19 @@ async function openArticleEditor(page) {
     const articleNewButton = page.locator(ARTICLE_NEW_BUTTON_SELECTOR).filter({
         hasText: ARTICLE_NEW_BUTTON_TEXT
     });
-    const visibleArticleNewButton = await requireVisibleLocator(articleNewButton, '未找到“新的创作”按钮，请确认已进入长文发布页。', 15_000);
+    const visibleArticleNewButton = await requireVisibleLocator(articleNewButton, 'Could not find the New Creation button. Make sure the article publishing page is open.', 15_000);
     await visibleArticleNewButton.click();
     await page.waitForTimeout(300);
 }
 async function fillArticleTitle(page, title) {
     const articleTitleInput = page.locator(ARTICLE_TITLE_INPUT_SELECTOR);
-    const visibleArticleTitleInput = await requireVisibleLocator(articleTitleInput, '未找到长文标题输入框，请确认已进入长文编辑页。', 15_000);
+    const visibleArticleTitleInput = await requireVisibleLocator(articleTitleInput, 'Could not find the article title input. Make sure the article editor is open.', 15_000);
     await visibleArticleTitleInput.fill(title);
     await page.waitForTimeout(200);
 }
 async function fillArticleContent(page, content) {
     const articleContentEditor = page.locator(ARTICLE_CONTENT_EDITOR_SELECTOR);
-    const visibleArticleContentEditor = await requireVisibleLocator(articleContentEditor, '未找到长文正文编辑器，请确认已进入长文编辑页。', 15_000);
+    const visibleArticleContentEditor = await requireVisibleLocator(articleContentEditor, 'Could not find the article content editor. Make sure the article editor is open.', 15_000);
     await visibleArticleContentEditor.fill(content);
     await page.waitForTimeout(200);
 }
@@ -427,7 +439,7 @@ async function finalizePublish(page, draft) {
     const publishActionButton = page.locator(PUBLISH_ACTION_BUTTON_SELECTOR).filter({
         hasText: buttonText
     });
-    const visiblePublishActionButton = await requireVisibleLocator(publishActionButton, `未找到“${buttonText}”按钮，请确认发布页已正确加载。`, 15_000);
+    const visiblePublishActionButton = await requireVisibleLocator(publishActionButton, `Could not find the ${describePublishAction(draft)} button. Make sure the publish page finished loading.`, 15_000);
     await visiblePublishActionButton.click();
     await page.waitForTimeout(500);
 }
@@ -442,7 +454,7 @@ export async function openRednotePublish(session, payload) {
         const creatorServiceLink = resolved.page.locator(CREATOR_SERVICE_SELECTOR).filter({
             hasText: '创作服务'
         });
-        const visibleCreatorServiceLink = await requireVisibleLocator(creatorServiceLink, '未找到“创作服务”入口，请先打开小红书首页并确认账号已登录。');
+        const visibleCreatorServiceLink = await requireVisibleLocator(creatorServiceLink, 'Could not find the Creator Services entry. Open the Xiaohongshu home page and make sure the account is logged in.');
         const popupPromise = session.browserContext.waitForEvent('page', {
             timeout: 3_000
         }).catch(()=>null);
@@ -454,7 +466,7 @@ export async function openRednotePublish(session, payload) {
         } catch  {
             const existingCreatorHomePage = getSessionPages(session).find((page)=>isCreatorHomeUrl(page.url()));
             if (!existingCreatorHomePage) {
-                throw new Error(`点击“创作服务”后，未跳转到 ${CREATOR_HOME_URL}`);
+                throw new Error(`After clicking Creator Services, the page did not navigate to ${CREATOR_HOME_URL}`);
             }
             targetPage = existingCreatorHomePage;
             openedInNewPage = targetPage !== resolved.page;
@@ -467,7 +479,7 @@ export async function openRednotePublish(session, payload) {
     await finalizePublish(targetPage, payload.draft);
     return {
         ok: true,
-        message: payload.draft ? '已完成发布页操作并点击“暂存离开”，内容已保存到草稿。' : '已完成发布页操作并点击“发布”。'
+        message: payload.draft ? 'Publishing page actions completed and Save Draft and Leave was clicked. The content was saved as a draft.' : 'Publishing page actions completed and Publish was clicked.'
     };
 }
 export async function runPublishCommand(values) {

package/dist/rednote/search.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { printJson, runCli } from '../utils/browser-cli.js';
+import { runCli } from '../utils/browser-cli.js';
 import { resolveStatusTarget } from './status.js';
 import { createRednoteSession, disconnectRednoteSession, ensureRednoteLoggedIn } from './checkLogin.js';
-import { parseOutputCliArgs, renderPostsMarkdown, resolveSavePath, writePostsJsonl } from './output-format.js';
+import { ensureJsonSavePath, parseOutputCliArgs, renderJsonSaveSummary, renderPostsMarkdown, resolveJsonSavePath, resolveSavePath, writeJsonFile, writePostsJsonl } from './output-format.js';
 export function parseSearchCliArgs(argv) {
     return parseOutputCliArgs(argv, {
         includeKeyword: true
@@ -20,7 +20,7 @@ Options:
   --instance NAME   Optional. Defaults to the saved lastConnect instance
   --keyword TEXT    Required. Search keyword
   --format FORMAT   Output format: md | json. Default: md
-  --save [PATH]     Save posts as JSONL. Uses a default path when PATH is omitted
+  --save [PATH]     In markdown mode, saves posts as JSONL and uses a default path when PATH is omitted. In json mode, PATH is required and the posts array is saved as JSON
   -h, --help        Show this help
 `);
 }
@@ -84,6 +84,26 @@ function normalizeSearchPost(item) {
         }
     };
 }
+function toSearchJsonPost(post) {
+    return {
+        id: post.id,
+        modelType: post.modelType,
+        xsecToken: post.xsecToken,
+        url: post.url,
+        displayTitle: post.noteCard.displayTitle,
+        cover: post.noteCard.cover.urlDefault,
+        userId: post.noteCard.user.userId,
+        nickname: post.noteCard.user.nickname,
+        avatar: post.noteCard.user.avatar,
+        liked: post.noteCard.interactInfo.liked,
+        likedCount: post.noteCard.interactInfo.likedCount,
+        commentCount: post.noteCard.interactInfo.commentCount,
+        collectedCount: post.noteCard.interactInfo.collectedCount,
+        sharedCount: post.noteCard.interactInfo.sharedCount,
+        imageList: post.noteCard.imageList.map((image)=>image.infoList.find((info)=>typeof info.url === 'string' && info.url)?.url ?? null).filter((url)=>typeof url === 'string' && url.length > 0),
+        videoDuration: post.noteCard.video.duration
+    };
+}
 async function getOrCreateXiaohongshuPage(session) {
     return session.page;
 }
@@ -157,6 +177,13 @@ export async function searchRednotePosts(session, keyword) {
     };
 }
 function writeSearchOutput(result, values) {
+    if (values.format === 'json') {
+        const savedPath = resolveJsonSavePath(values.savePath);
+        const posts = result.search.posts.map(toSearchJsonPost);
+        writeJsonFile(posts, savedPath);
+        process.stdout.write(renderJsonSaveSummary(savedPath, posts));
+        return;
+    }
     const posts = result.search.posts;
     let savedPath;
     if (values.saveRequested) {
@@ -164,10 +191,6 @@ function writeSearchOutput(result, values) {
         writePostsJsonl(posts, savedPath);
         result.search.savedPath = savedPath;
     }
-    if (values.format === 'json') {
-        printJson(result);
-        return;
-    }
     let markdown = renderPostsMarkdown(posts);
     if (savedPath) {
         markdown = `Saved JSONL: ${savedPath}\n\n${markdown}`;
@@ -182,6 +205,7 @@ export async function runSearchCommand(values = {
         printSearchHelp();
         return;
     }
+    ensureJsonSavePath(values.format, values.savePath);
     const keyword = values.keyword?.trim();
     if (!keyword) {
         throw new Error('Missing required option: --keyword');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skills-store/rednote",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "private": false,
   "type": "module",
   "bin": {