SKILL.md — XHS Toolkit 操作手册

本文档面向 AI Agent。指导你如何使用本工具包制作、截图、发布小红书图文笔记。

---

工作流程

选题 → 调研素材 → 写 slide HTML → 截图 → 发 Telegram 审核 → 发布

每一步的具体操作如下。

---

1. 创建帖子目录

在 workspace 下建目录，命名格式 xhs_<话题>/：

xhs_deepseek/
├── slide1.html    # 封面
├── slide2.html    # 内容页
├── ...
├── snap.js        # 可选，也可用 scripts/snap.js
└── output/
    ├── slide1.jpg
    └── ...

2. 写 HTML Slides

2.1 排版规范

项目	规范
尺寸	1080 × 1920px（9:16竖屏）
字体	'Noto Sans SC', sans-serif
标题 weight	900（Black）
正文 weight	700（Bold）
背景色	#FDF8F3（暖白）

2.2 字号（手机可读性优先，宁大勿小）

元素	字号
封面大标题	56-110px
页内标题	42-56px
副标题/区块标题	28-34px
正文	24-28px（不低于24px）
标签/badge	18-22px
页脚水印	20-22px

2.3 模板使用

三个模板在 templates/ 目录，复制后修改：

• cover.html — 封面页。改 .badge、.title（用 <span class="highlight"> 高亮）、.sub、.tag
• content.html — 内容页。改 .page-title、复制 .card 块。变体：.card.warn（黄）、.card.danger（红）、.card.info（蓝）
• opinion.html — 观点/总结页。改观点内容，用 .divider 分隔

主题色通过 CSS 变量 --accent 切换，每篇帖子用不同颜色：

:root { --accent: #7C3AED; --accent-light: #EDE9FE; }

2.4 ⚠️ 字体注意

• ✅ Noto Sans SC — headless 可渲染
• ❌ Google Fonts @import — headless 无网络会卡死
• ❌ 得意黑 — 安装了但 headless Chromium 不加载

2.5 文件写入

必须用 OpenClaw write 工具写 HTML 文件。PowerShell Set-Content 会把 UTF-8 转成 GBK，中文全乱码。

---

3. 截图

node scripts/snap.js --dir ./xhs_deepseek
# 或指定张数
node scripts/snap.js --dir ./xhs_deepseek --slides 5

自动检测 slide1.html ~ slideN.html，输出到 output/slide*.jpg。

配置在 scripts/config.js：

browserPath: 'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe',
screenshot: { width: 1080, height: 1920, type: 'jpeg', quality: 90 },

---

4. 审核

截图后发送给用户审核：

• 用 message 工具发 Telegram，附带每张 slide 的 JPG
• 说明帖子主题、结构、内容来源
• 提醒敏感话题风险（如果有的话）
• 等待用户确认后再发布

---

5. 发布

5.1 前提

• 浏览器已启动 CDP 调试模式（--remote-debugging-port=9222）
• 已在浏览器中登录小红书创作者中心

5.2 命令

node scripts/publish.js --dir ./xhs_deepseek --title "标题" --desc "正文"
# 或从文件读取正文
node scripts/publish.js --dir ./xhs_deepseek --title "标题" --desc-file desc.txt
# 试运行（不实际发布）
node scripts/publish.js --dir ./xhs_deepseek --title "标题" --desc "正文" --dry-run

5.3 ⚠️ 发布踩坑

坑	说明
标题限20字	超了发布按钮无效但不报错！脚本已内置校验
多图必须一次性上传	input.uploadFile(...allFiles) 展开数组。逐张上传会覆盖，只剩最后一张
默认是视频tab	脚本自动点"上传图文"切换
发布成功标志	URL 含 published=true
发布失败标志	URL 含 from=tab_switch 表示失败

---

6. 回复评论

node scripts/reply.js --replies replies.json

replies.json 格式：

[
  "回复第1条评论",
  "回复第2条评论",
  null,
  "回复第4条（跳过第3条）"
]

按通知页（xiaohongshu.com/notification）评论顺序，逐条点击 .action-reply → 输入 textarea → 点击"发送"。

注意：每条评论只回复一次，避免重复。

---

7. 内容创作指南

7.1 选题来源

来源	URL	说明
36氪快讯	36kr.com/newsflashes	国内AI实时新闻，可scrape
The Verge AI	theverge.com/ai-artificial-intelligence	海外AI新闻
Hacker News	news.ycombinator.com	技术社区热点
百度搜索	baidu.com/s?wd=...	中文内容调研（Google/Bing 常被拦截）

7.2 帖子结构（推荐5-7张）

1. 封面（cover模板）— 抓眼球的大标题
2. 背景/事件（content模板）— 发生了什么
3. 深度解析（content模板）— 技术/数据/对比
4. 影响/争议（content模板）— 多方观点
5. Bear观点（opinion模板）— 独立判断 + 预测

7.3 正文（desc）写作

• 开头用 emoji 抓注意力
• 核心数据/事实放前面
• 结尾加 hashtag（10个左右）
• 带一点观点和判断，不要纯搬运

---

参考

• 完整运营指南和历史踩坑记录：GUIDE.md
• 示例帖子：examples/deepseek-claude/