@skills-store/rednote 0.1.10 → 0.1.12

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.10",
+  "version": "0.1.12",
   "private": false,
   "type": "module",
   "bin": {
@@ -50,9 +50,9 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/skills-router/skills-store.git",
-    "directory": "packages/rednote"
+    "directory": "packages/rednote-cli"
   },
-  "homepage": "https://github.com/skills-router/skills-store/tree/main/packages/rednote",
+  "homepage": "https://github.com/skills-router/skills-store/tree/main/packages/rednote-cli",
   "bugs": {
     "url": "https://github.com/skills-router/skills-store/issues"
   },