xhs-skills
⚠️ 使用此工具前请确保已悉知官方 3 月 10 日发布的公告
公告地址：关于打击AI托管运营账号的治理公告
仓库地址：https://github.com/tensorslab/xhs-skills.git
本项目基于 Skills 工作流重新组织了小红书内容创作、图片生成与发布能力。当前仓库相对于原上游仓库在目录结构、技能拆分、提示词协作方式、发布流程和方案展示细节上都已发生较大变化；原上游仓库已移入致谢列表。
项目包含两个小红书创作技能，各司其职，并共享同一套发布能力：
| 技能 | 定位 | 适用场景 |
|---|
| xhs-note-creator | 文字类小红书创作与发布 | 撰写文案 → 专业化排版渲染卡片 → 私密推送到小红书 |
| xhs-images-design | 图片类小红书图文卡片生成与发布 | AI 生成插画/卡通/手绘风格原创配图 → 私密推送到小红书 |
核心能力：
- 扫码登录小红书后，可将生成内容自动推送到小红书。
- 发布默认采用「仅自己可见」，不会直接公开；用户可在小红书中确认后再自行公开。
- 文字类与图片类内容分别由两个 skill 处理，提示词已调整为更协调的协作关系。
- 方案展示细节经过专业化改造，更适合内容确认、风格选择和后续复用。
合规与使用边界
本项目定位为创作辅助与私密草稿推送工具，不鼓励也不支持无人值守的托管运营、批量发布或绕过平台规则的行为。所有内容默认仅自己可见，需由用户在小红书端确认后自行公开。
本仓库不是 GitHub fork，而是在 MIT License 允许范围内基于相关项目重新组织、改造和扩展。原始来源已在致谢中列出，并在 LICENSE 中保留对应版权声明。
安装
方式一：Claude Code Plugin 安装（推荐）
# 添加本仓库为 marketplace
/plugin marketplace add tensorslab/xhs-skills
# 安装插件
/plugin install xhs-skills@tensorslab-xhs-skills
安装后运行 /reload-plugins 即可使用。
方式二：一句话安装
跟你的 Agent 说：
拉取下面的项目，安装其中的技能：https://github.com/tensorslab/xhs-skills.git
方式三：手动安装
git clone https://github.com/tensorslab/xhs-skills.git
cd xhs-skills
可以将本项目skills 目录中所有skill 放到支持 Skills 的客户端目录，例如：
- Claude：
~/.claude/skills/
- Alma：
~/.config/Alma/skills/
- TRAE：
/your-path/.trae/skills/
安装依赖
Python：
pip install -r requirements.txt
playwright install chromium
Node.js：
npm install
npx playwright install chromium
技能一：xhs-note-creator（文字类小红书创作与发布）
以文字内容为主的笔记场景：干货分享、知识科普、清单排行、教程步骤等。
工作流程
- 撰写小红书笔记文案（标题 + 正文 + 标签）
- 生成渲染用 Markdown 文档
- 通过本地脚本渲染专业化图片卡片（9 种主题 + 多种分页模式）
- 扫码登录后，可自动推送到小红书（默认仅自己可见）
渲染图片（Python）
核心脚本：skills/xhs-note-creator/scripts/render_xhs.py
# 最简单用法（默认主题 + 手动分页）
python skills/xhs-note-creator/scripts/render_xhs.py demos/content.md
# 使用自动分页（推荐：内容长短难控）
python skills/xhs-note-creator/scripts/render_xhs.py demos/content.md -m auto-split
# 使用固定尺寸自动缩放（auto-fit）
python skills/xhs-note-creator/scripts/render_xhs.py demos/content_auto_fit.md -m auto-fit
# 切换主题（例如 Playful Geometric）
python skills/xhs-note-creator/scripts/render_xhs.py demos/content.md -t playful-geometric -m auto-split
# 自定义尺寸和像素比
python skills/xhs-note-creator/scripts/render_xhs.py demos/content.md -t retro -m dynamic --width 1080 --height 1440 --max-height 2160 --dpr 2
主要参数：
| 参数 | 简写 | 说明 |
|---|
--theme | -t | 可用主题：default、playful-geometric、neo-brutalism、botanical、professional、retro、terminal、sketch、glassmorphism |
--mode | -m | 分页模式：separator / auto-fit / auto-split / dynamic |
--width | -w | 图片宽度（默认 1080） |
--height | | 图片高度（默认 1440，dynamic 为最小高度） |
--max-height | | dynamic 模式最大高度（默认 2160） |
--dpr | | 设备像素比，控制清晰度（默认 2） |
生成结果：封面 cover.png + 正文卡片 card_1.png、card_2.png...
渲染图片（Node.js）
脚本：skills/xhs-note-creator/scripts/render_xhs.js，参数与 Python 基本一致：
# 默认主题 + 手动分页
node skills/xhs-note-creator/scripts/render_xhs.js demos/content.md
# 指定主题 + 自动分页
node skills/xhs-note-creator/scripts/render_xhs.js demos/content.md -t terminal -m auto-split
发布到小红书
发布脚本会始终以「仅自己可见」方式发布，内容不会直接公开。用户可在小红书 App 或网页中确认效果后，再手动调整为公开。
1. 扫码登录 / 配置 Cookie
cp env.example.txt .env
编辑 .env：
XHS_COOKIE=your_cookie_string_here
获取方式：运行 python skills/xhs-note-creator/scripts/quick_login.py，扫码登录后自动获取。
2. 发布
# 从方案文件读取文案（推荐）
python skills/xhs-note-creator/scripts/publish_xhs.py \
--title "笔记标题" --note note.md --images cover.png card_1.png card_2.png
# 手动指定标题和描述
python skills/xhs-note-creator/scripts/publish_xhs.py \
--title "笔记标题" --desc "笔记描述" --images cover.png card_1.png
可选参数：
