v0.2.0 to v0.2.0

---

name: xiaohongshu-ego

description: >

Publish one Xiaohongshu (小红书) note — video or image-text (图文) — through the

creator web UI in Ego Lite. Login-check first. Soft-fail with exit 2 when

ego-browser is missing, the creator site is logged out, or --expect-account

does not match the header nickname. Nothing is uploaded without --yes: that

run only inspects login and prints a plan. Video notes accept --cover: with

preview does not change, the run refuses to publish. Without --cover the

platform keeps the video first frame. Image-text notes take 1-18 images

(--images) through the 上传图文 tab; the first image becomes the cover and

--cover is rejected. Ego Lite only, not MCP. Use when the user asks to post a

video or image-text note to 小红书 or creator.xiaohongshu.com.

metadata:

version: "0.2.0"

requires:

bins:

- ego-browser

- node

ego:

min_skill_guide: "2.1.0"

---

# xiaohongshu-ego

用 Ego Lite 里已经登录的创作者会话，发**一条**小红书笔记：视频笔记或图文笔记。只走 creator 网页，不走 MCP。

Publish **one** note — a video note or an image-text note — through the logged-in creator site. Ego Lite and `ego-browser` only. Not MCP.

成功标准是 stdout 打出 `https://www.xiaohongshu.com/explore/<noteId>`，页面曾出现「发布成功」。没有这条链接就不算成功。

Success is `https://www.xiaohongshu.com/explore/<noteId>` after 「发布成功」.

## 先装 Ego

先装 **Ego Lite**，保证 `ego-browser` 在 `PATH`。非交互 shell 找不到时，再试 `~/.local/bin/ego-browser`。仍然缺失则 soft-fail（退出码 `2`），**不要**改用 Playwright、Puppeteer 或云端浏览器。

Install **Ego Lite** and put `ego-browser` on `PATH`. A non-interactive shell also tries `~/.local/bin/ego-browser`. If it is still missing, soft-fail with exit `2`. Do not switch to Playwright, Puppeteer, or a cloud browser.

## 封面

PK 封面槽不能代替主封面。只上传 PK 时，主封面和笔记管理缩略图仍是视频首帧，角标「封面待PK」，要等约 72 小时 PK 结束才会换。因此 `--cover` 不走 PK 槽。

不传 `--cover` 时，平台默认就是视频首帧。技能不会自己造一张封面。

图文笔记没有 `--cover`：第一张图就是封面，传了 `--cover` 直接校验失败。图文走「上传图文」tab，见下面的图文一节。

PK slots are not this path. Uploading only a PK cover leaves the main cover and the note-manager thumbnail as the video's first frame (badge 封面待PK) until the 72-hour PK ends. `--cover` does not use the PK slots.

Without `--cover`, Xiaohongshu keeps the first frame. This skill does not invent a cover.

Image-text notes have no `--cover`: the first image is the cover, and passing `--cover` fails validation. Image-text publishes through the 上传图文 tab, see the image-text section below.

## 图文笔记

`--images` 接受逗号分隔的绝对路径（1–18 张，`.jpg` `.jpeg` `.png` `.webp`，单张不超过 32MB），和 `--video` 互斥。发布走「上传图文」tab：

1. 点文案恰好为「上传图文」的叶子元素。切过去之后 URL 会带 `target=image`。

2. 找到图片上传框。它和视频上传框**同类名** `input.upload-input`，只能靠 `accept` 区分：图文是 `.jpg,.jpeg,.png,.webp` 且 `multiple`，视频是 `.mp4,...`。绝不能把视频 accept 的输入当图片输入。

3. 一次 `setInputFiles` 传入全部路径（数组）。

4. 等所有缩略图出现（`blob:` 或 `sns-img` 的 `img` 数量 ≥ 张数，或计数 N/18 ≥ 张数），且没有「上传中 N%」「上传失败」，才继续。

5. 图文页的「发布」按钮在 **closed shadow root** 里，DOM 选择器摸不到，要用无障碍快照里的 `button [ref=N]`（精确文本「发布」）点 `ref=N`。**不要**点 `.btn-wrapper`——那是侧边栏「发布笔记」菜单，点了会把草稿存进草稿箱。详见 `references/imagetext-flow.md`。

6. 之后与视频相同：标题、正文、账号闸门、发布成功。

第一张图就是封面，没有确认环节。`--cover` 在图文模式下校验直接失败。

`--images` takes comma-separated absolute paths (1-18 images, `.jpg` `.jpeg` `.png` `.webp`, max 32MB each) and is mutually exclusive with `--video`. The flow clicks the 上传图文 tab (the URL gains `target=image`), finds the upload input — same class `input.upload-input` as the video input, told apart only by the accept `.jpg,.jpeg,.png,.webp` with `multiple` — sets all files in one `setInputFiles` call, waits until every thumbnail is counted (blob:/sns-img images ≥ count, or the N/18 counter ≥ count) with no 上传中/上传失败 text, then continues like a video: title, body, account gate, 发布, 发布成功. The first image is the cover; `--cover` fails validation on this mode.

## 不能带链接

小红书笔记不能出现链接。`--title`、`--desc`、`--topics` 里的 `http(s)://`、`www.`、裸域名（如 `github.com/xxx`、`x.com/xxx`）和 `t.co` 默认直接失败，退出码 `4`，并列出片段。不要发布。把链接从文案里删掉，或加 `--strip-links`：删掉链接，并去掉同一行上因此悬空的「项目地址：」「链接：」，收掉多余空行，同时打印删了什么。没有 `--yes` 的预检也做同样的检查。

Xiaohongshu notes must not contain links. By default, `http(s)://`, `www.`, bare domains such as `github.com/xxx` or `x.com/xxx`, and `t.co` in `--title`, `--desc`, or `--topics` fail with exit `4` and the offending fragments. Delete them from the copy, or pass `--strip-links` to remove the links, drop a dangling label such as `项目地址：` or `链接：` on that line, trim leftover blank lines, and print what was removed. The dry run without `--yes` uses the same check.

已经发出的笔记可以事后改封面，但那是尽力而为：`edit-cover.mjs`。保存可能重新进入「审核中」，并出现「封面PK中」。笔记管理里找不到、或更新页「加载失败」时不要重试。优先在第一次发布前换封面。

## 每次发布前：登录闸门

```bash

node scripts/check-login.mjs

node scripts/check-login.mjs --expect-account "听懂AI"

node scripts/check-login.mjs --keep

```

| 退出码 | 含义 | Agent 做什么 |

|--------|------|----------------|

| `0` | 已登录，且昵称匹配（若传了 `--expect-account`） | 把 `login_tip` 告诉用户，继续 |

| `2` | 未登录 / 昵称不符 / 无 ego-browser | 展示 `how_to_login`，**停** |

| `4` | 文案里有链接 | 把片段给人看。删掉链接，或改用 `--strip-links` 后再跑。不要加 `--yes` 硬发 |

| `1` | 其它错误 | 报告 JSON `error`，不要假装已经发出 |

`www.xiaohongshu.com` 上的账号可能和创作者平台不是同一个。只看创作者页眉昵称。不要代填密码，不要粘贴 Cookie。

默认 `finish({ keep: [] })`。`--keep` 才把页面留着并 `handOff()`。

## 确认规则

## 命令

仓库根目录。每次只发一条。调用方传绝对路径，不要写死产品目录。

```bash

node skills/xiaohongshu-ego/scripts/check-login.mjs --expect-account "听懂AI"

node skills/xiaohongshu-ego/scripts/post-video.mjs \

--video /absolute/path/to/video.mp4 \

--title "标题" \

--desc "正文" \

--topics "#话题1 #话题2" \

--cover /absolute/path/to/cover-3x4.png \

--expect-account "听懂AI"

node skills/xiaohongshu-ego/scripts/post-video.mjs \

--video /absolute/path/to/video.mp4 \

--title "标题" \

--desc "正文" \

--topics "#话题1 #话题2" \

--cover /absolute/path/to/cover-3x4.png \

--expect-account "听懂AI" \

--yes --json

node skills/xiaohongshu-ego/scripts/post-images.mjs \

--images /absolute/path/to/1.jpg,/absolute/path/to/2.jpg,/absolute/path/to/3.jpg \

--title "标题" \

--desc "正文" \

--topics "#话题1 #话题2" \

--expect-account "听懂AI"

node skills/xiaohongshu-ego/scripts/post-images.mjs \

--images /absolute/path/to/1.jpg,/absolute/path/to/2.jpg \

--title "标题" \

--desc "正文" \

--topics "#话题1 #话题2" \

--expect-account "听懂AI" \

--yes --json

node skills/xiaohongshu-ego/scripts/edit-cover.mjs \

--note-id <noteId> --cover /absolute/path/to/cover-3x4.png

node skills/xiaohongshu-ego/scripts/cleanup.mjs

```

| 退出码 | 含义 |

|--------|------|

| `0` | 已登录，或已发出并打印 explore 链接，或 cleanup 关掉了本机空间 |

| `3` | 计划已打印，拒绝上传 |

| `2` | 未登录、昵称不符，或没有 `ego-browser` |

| `4` | 标题、正文或话题里有链接。没有 `--strip-links` 时不上传 |

| `1` | 参数、封面未确认、或浏览器错误 |

`--json` 打出摘要 JSON。不加 `--json` 且发布成功时，stdout 只有 explore 链接。

`cleanup` 关掉名称以 `xiaohongshu-ego` 开头的任务空间。它不删笔记。

## 不做

定时发布、一次跑多条、MCP、删笔记。图文只支持一次性传齐 1–18 张，不支持追加、排序或删图。发布后改封面不是主路径。

## 测试

```bash

npm test

```

`npm test` 用 c8 统计 `scripts/lib/**/*.mjs`（不含 `ego-deps.mjs`），行覆盖率不低于 80%。单测不访问小红书。

界面步骤见 `references/publish-flow.md`（视频）与 `references/imagetext-flow.md`（图文）。登录见 `references/login.md`。