Add files via upload

This commit is contained in:
ZhangJia
2026-01-18 21:56:39 +08:00
committed by GitHub
parent 47b5bb0eff
commit cef44fcea6
12 changed files with 1846 additions and 2 deletions

168
SKILL.md Normal file
View File

@@ -0,0 +1,168 @@
---
name: xhs-note-creator
description: 小红书笔记素材创作技能。当用户需要创建小红书笔记素材时使用这个技能。技能包含:根据用户的需求和提供的资料,撰写小红书笔记内容(标题+正文),生成图片卡片(封面+正文卡片),以及发布小红书笔记。
---
# 小红书笔记创作技能
这个技能用于创建专业的小红书笔记素材,包括内容撰写、图片卡片生成和笔记发布。
## 使用场景
- 用户需要创建小红书笔记时
- 用户提供资料需要转化为小红书风格内容时
- 用户需要生成精美的图片卡片用于发布时
## 工作流程
### 第一步:撰写小红书笔记内容
根据用户需求和提供的资料,创作符合小红书风格的内容:
#### 标题要求
- 不超过 20 字
- 吸引眼球,制造好奇心
- 可使用数字、疑问句、感叹号增强吸引力
- 示例「5个让效率翻倍的神器推荐」「震惊原来这样做才对」
#### 正文要求
- 使用良好的排版,段落清晰
- 点缀少量 Emoji 增加可读性(每段 1-2 个即可)
- 使用简短的句子和段落
- 结尾给出 SEO 友好的 Tags 标签5-10 个相关标签)
### 第二步:生成 Markdown 文档
**注意:这里生成的 Markdown 文档是用于渲染卡片的,必须专门生成,禁止直接使用上一步的笔记正文内容。**
Markdown 文件,文件应包含:
1. YAML 头部元数据(封面信息):
```yaml
---
emoji: "🚀" # 封面装饰 Emoji
title: "大标题" # 封面大标题不超过15字
subtitle: "副标题文案" # 封面副标题不超过15字
---
```
2. 用于渲染卡片的 Markdown 文本内容:
- 使用 `---` 分割线将正文分隔为多个卡片段落
- 每个分段的文字控制在 200 字左右
- 后续会将每个卡片段落渲染为一张图片
完整示例:
```markdown
---
emoji: "💡"
title: "5个效率神器让工作效率翻倍"
subtitle: "对着抄作业就好了,一起变高效"
---
# 神器一Notion 📝
> 全能型笔记工具,支持数据库、看板、日历等多种视图...
## 特色功能
- 特色一
- 特色二
---
# 神器二Raycast ⚡
\`\`\`
可使用代码块来增加渲染后图片的视觉丰富度
\`\`\`
## 推荐原因
- 原因一
- 原因二
- ……
---
# 神器三Arc 🌈
全新理念的浏览器,侧边栏标签管理...
...
```
### 第三步:渲染图片卡片
将 Markdown 文档渲染为图片卡片。提供两种渲染脚本:
#### Python 渲染脚本
```bash
python scripts/render_xhs.py <markdown_file> [--output-dir <output_directory>]
```
- 默认输出目录为当前工作目录
- 生成的图片包括封面cover.png和正文卡片card_1.png, card_2.png, ...
#### Node.js 渲染脚本
```bash
node scripts/render_xhs.js <markdown_file> [--output-dir <output_directory>]
```
功能与 Python 版本相同。
### 第四步:发布小红书笔记(可选)
使用发布脚本将生成的图片发布到小红书:
```bash
python scripts/publish_xhs.py --title "笔记标题" --desc "笔记描述" --images card_1.png card_2.png cover.png
```
**前置条件**
1. 在同目录下创建 `.env` 文件,配置小红书 Cookie
```
XHS_COOKIE=your_cookie_string_here
```
2. Cookie 获取方式:
- 在浏览器中登录小红书https://www.xiaohongshu.com
- 打开开发者工具F12
- 在 Network 标签中查看请求头的 Cookie
## 图片规格说明
### 封面卡片
- 尺寸比例3:4小红书推荐比例
- 基准尺寸1080×1440px
- 包含Emoji 装饰、大标题、副标题
- 样式:渐变背景 + 圆角内容区
### 正文卡片
- 尺寸比例3:4
- 基准尺寸1080×1440px
- 支持:标题、段落、列表、引用、代码块、图片
- 样式:白色卡片 + 渐变背景边框
## 技能资源
### 脚本文件
- `scripts/render_xhs.py` - Python 渲染脚本
- `scripts/render_xhs.js` - Node.js 渲染脚本
- `scripts/publish_xhs.py` - 小红书发布脚本
### 资源文件
- `assets/cover.html` - 封面 HTML 模板
- `assets/card.html` - 正文卡片 HTML 模板
- `assets/styles.css` - 共用样式表
## 注意事项
1. Markdown 文件应保存在工作目录,渲染后的图片也保存在工作目录
2. 技能目录 (`md2Redbook/`) 仅存放脚本和模板,不存放用户数据
3. 图片尺寸会根据内容自动调整,但保持 3:4 比例
4. Cookie 有有效期限制,过期后需要重新获取
5. 发布功能依赖 xhs 库,需要安装:`pip install xhs`