xhs-longform-private-publisherlisted
Install: claude install-skill cnfjlhj/ai-collab-playbook
# 小红书长文私密发布技能
这个 skill 面向“已有原文、已有配图、不要改写、直接发布”的场景。
它的核心目标不是重新创作小红书文案,而是把现成的 Markdown 长文尽量无损地搬到小红书长文编辑器里,按图片占位顺序插图,使用“一键排版”,并默认以“仅自己可见”的方式发布,再做一次可视化验收。
如果用户要的是“帮我改写成更像小红书的风格”“帮我做封面卡片”“帮我生成图文卡片”,优先使用 `xhs-note-creator`;这个 skill 更适合“忠实发布现有长文”。
## 适用场景
- 用户说“帮我发小红书长文”
- 用户强调“不要改原文”“不要改原先样子”
- 用户要求“图片按顺序插进去”
- 用户要求“用一键排版”
- 用户要求“先私密发布,我来验收”
- 用户提供的是 `Markdown` 文件而不是最终可直接上传的图片卡片
## 输入
最少需要以下输入:
- `<markdown_path>`:原文 Markdown 文件
- `<image_dir>` 或 `<image_paths...>`:正文插图,顺序与文中的图片占位一致
常见可选项:
- 是否强制“仅自己可见”(默认是)
- 是否允许图片数量与占位数量不一致(默认不允许)
- 是否允许最多重试 3 次(默认允许)
- 是否覆盖标题(默认从 Markdown 的第一个 H1 提取)
## 输出
- 已发布的小红书长文,默认是“仅自己可见”
- 发布验收证据:至少一张笔记管理页截图
- 一个调试载荷 JSON,供重复执行或排查问题时复用
## 工作原则
1. 保留原文措辞,不自行改写。
2. 保留原始结构,包括标题层级、列表、引用、强调、分隔线。
3. 图片必须按占位顺序插入,不允许随意重排。
4. “一键排版”在正文和图片全部插完之后再点。
5. 默认发布为“仅自己可见”,不要误发公开。
6. 结果验收以创作者平台的可见页面为准,不以控制台日志为准。
7. 若版式、图片顺序或可见性不对,最多重做 3 次,每次都要更换假设,而不是机械重试。
## 推荐流程
### 1. 预检
- 确认已经登录小红书创作者平台
- 打开长文入口:`https://creator.xiaohongshu.com/publish/publish?target=article`
- 如果用户明确说“不能走代理”,不要切代理或依赖代理页面
- 如果页面上存在旧草稿或脏状态,优先新建一篇长文,而不是在未知草稿上硬改
### 2. 生成发布载荷
优先使用内置脚本把 Markdown 转成一个稳定的 JSON 载荷:
```bash
python scripts/build_payload.py <markdown_path> --image-dir <image_dir> --output /tmp/xhs_payload.json
```
这个脚本会做几件事:
- 提取第一个 H1 作为标题
- 以 Markdown 图片语法行为分界,把正文切成 `图片数 + 1` 段
- 把每一段 Markdown 转成 HTML,避免把原始 Markdown 符号直接贴进编辑器
- 对图片文件名按数字顺序排序,如 `1.png`、`2.png`、`10.png`
- 默认要求“图片数量 = 图片占位数量”
如果用户是显式给定图片路径列表,也可以改用:
```bash
python scripts/build_payload.py <markdown_path> -