{
  "markdown": "## 📕 Auto-Redbook-Skills（已重构版）\n\n### ⚠️ 使用此工具前情确保已悉知官方 3 月 10 日发布的公告\n\n公告地址：[关于打击AI托管运营账号的治理公告](http://xhslink.com/o/7WxTddvbmTu)\n\n### 方式一：Claude Code Plugin 安装（推荐）\n\n```bash\n# 添加本仓库为 marketplace\n/plugin marketplace add comeonzhj/Auto-Redbook-Skills\n\n# 安装插件\n/plugin install auto-redbook-skills@comeonzhj-Auto-Redbook-Skills\n```\n\n安装后运行 `/reload-plugins` 即可使用。\n\n### 方式二：一句话安装\n\n跟你的 Agent 说：\n\n> 拉取下面的项目，安装其中的技能：https://github.com/comeonzhj/Auto-Redbook-Skills\n\n### 方式三：手动安装\n\n详见下方[使用方式总览](#-使用方式总览)。\n\n---\n\n\n> 自动撰写小红书笔记、生成多主题卡片、可选自动发布的 Skills  \n> 当前版本对渲染脚本和样式系统做了**一次完整重构**，感谢 Cursor 的辅助开发 🙌\n\n---\n\n## ✨ 本次重构亮点\n\n- **🎨 8 套主题皮肤**：默认简约灰 + Playful Geometric / Neo-Brutalism / Botanical / Professional / Retro / Terminal / Sketch\n- **📐 4 种分页模式**：\n  - `separator`：按 `---` 分隔手动分页\n  - `auto-fit`：固定尺寸，自动整体缩放内容，避免溢出/大面积留白\n  - `auto-split`：根据渲染后高度自动拆分为多张卡片\n  - `dynamic`：根据内容动态调整图片高度\n- **🧱 统一卡片结构**：外层浅灰背景（`card-container`）+ 内层主题背景（`card-inner`）+ 纯排版层（`card-content`）\n- **🧠 封面与正文一体化**：封面背景、标题渐变和正文卡片背景都按主题自动匹配\n\n---\n\n## 🖼 主题效果示例\n\n> 所有示例均为 1080×1440px，小红书推荐 3:4 比例\n> 更多示例去 [demo](/demos) 中查看  \n\n|||\n|---|---|\n|![Playful Geometric](demos/playful-geometric/card_1.png)|![Retro](demos/retro/card_1.png)|\n|![Sketch](demos/Sketch/card_1.png)|![Terminal](demos/terminal/card_1.png)|\n\n### Auto-fit 模式示例（自动缩放）\n\n![Auto Fit](demos/auto-fit/card_1.png)\n\n---\n\n## 🚀 使用方式总览\n\n### 1. 克隆项目\n\n```bash\ngit clone https://github.com/comeonzhj/Auto-Redbook-Skills.git\ncd Auto-Redbook-Skills\n```\n\n可以将本项目放到支持 Skills 的客户端目录，例如：\n\n- Claude：`~/.claude/skills/`\n- Alma：`~/.config/Alma/skills/`\n- TRAE：`/your-path/.trae/skills/`\n\n### 2. 安装依赖\n\n**Python：**\n\n```bash\npip install -r requirements.txt\nplaywright install chromium\n```\n\n**Node.js：**\n\n```bash\nnpm install\nnpx playwright install chromium\n```\n\n> Node.js 18+ 同时用于图片渲染和内置的小红书 Creator 请求签名。\n\n---\n\n## 🎨 渲染图片（Python）\n\n核心脚本：`scripts/render_xhs.py`\n\n```bash\n# 最简单用法（默认主题 + 手动分页）\npython scripts/render_xhs.py demos/content.md\n\n# 使用自动分页（推荐：内容长短难控）\npython scripts/render_xhs.py demos/content.md -m auto-split\n\n# 使用固定尺寸自动缩放（auto-fit）\npython scripts/render_xhs.py demos/content_auto_fit.md -m auto-fit\n\n# 切换主题（例如 Playful Geometric）\npython scripts/render_xhs.py demos/content.md -t playful-geometric -m auto-split\n\n# 自定义尺寸和像素比\npython scripts/render_xhs.py demos/content.md -t retro -m dynamic --width 1080 --height 1440 --max-height 2160 --dpr 2\n```\n\n**主要参数：**\n\n| 参数 | 简写 | 说明 |\n|------|------|------|\n| `--theme` | `-t` | 主题：`default`、`playful-geometric`、`neo-brutalism`、`botanical`、`professional`、`retro`、`terminal`、`sketch` |\n| `--mode` | `-m` | 分页模式：`separator` / `auto-fit` / `auto-split` / `dynamic` |\n| `--width` | `-w` | 图片宽度（默认 1080） |\n| `--height` |  | 图片高度（默认 1440，`dynamic` 为最小高度） |\n| `--max-height` |  | `dynamic` 模式最大高度（默认 2160） |\n| `--dpr` |  | 设备像素比，控制清晰度（默认 2） |\n\n> 生成结果会包含：封面 `cover.png` + 正文卡片 `card_1.png`、`card_2.png`...\n\n---\n\n## 🎨 渲染图片（Node.js）\n\n脚本：`scripts/render_xhs.js`，参数与 Python 基本一致：\n\n```bash\n# 默认主题 + 手动分页\nnode scripts/render_xhs.js demos/content.md\n\n# 指定主题 + 自动分页\nnode scripts/render_xhs.js demos/content.md -t terminal -m auto-split\n```\n\n---\n\n## 📤 发布到小红书\n\n### 1. 配置 Creator Cookie\n\n```bash\ncp env.example.txt .env\n```\n\n编辑 `.env`：\n\n```env\nXHS_CREATOR_COOKIE=your_creator_cookie_string_here\n```\n\n> 获取方式：浏览器登录[小红书创作服务平台](https://creator.xiaohongshu.com)\n> → F12 → Network → 刷新页面 → 选择发往 `creator.xiaohongshu.com` 的请求\n> → 复制 Request Headers 中的完整 Cookie。\n\n### 2. 发布图文笔记（可选）\n\n```bash\npython scripts/publish_xhs.py \\\n  --title \"笔记标题\" \\\n  --desc \"笔记描述内容\" \\\n  --images cover.png card_1.png card_2.png\n```\n\n**可选参数：**\n\n| 参数 | 说明 |\n|------|------|\n| `--public` | 公开发布（默认仅自己可见） |\n| `--post-time \"2026-08-14 10:00:00\"` | 按本机时区定时发布，也支持 13 位毫秒时间戳 |\n| `--topics AI 效率工具` | 添加一个或多个话题，不要带 `#` |\n| `--location \"上海\"` | 添加地点 |\n| `--proxy http://127.0.0.1:7890` | 使用 HTTP/HTTPS 代理 |\n| `--dry-run` | 仅做本地参数验证，不登录、不上传、不发布 |\n\n发布脚本已内置 Creator 纯 HTTP 签名、素材上传和发布链路，不依赖浏览器自动化、\n外部 API 服务或其他项目目录。运行发布命令前请确保已经执行 `pip install -r requirements.txt`\n和 `npm install`。\n\n---\n\n## 📁 项目结构（重构后）\n\n```bash\nAuto-Redbook-Skills/\n├── SKILL.md              # 技能描述（Agent 使用说明）\n├── README.md             # 项目文档（你现在看到的）\n├── requirements.txt      # Python 依赖\n├── package.json          # Node.js 依赖\n├── env.example.txt       # Cookie 配置示例\n├── vendor/xhs_publish_runtime/ # 内置 Creator 鉴权、签名与发布运行时\n├── references/           # 技能参考文档\n│   └── params.md         # 完整参数参考（主题/模式/发布参数）\n├── assets/\n│   ├── cover.html        # 封面 HTML 模板\n│   ├── card.html         # 正文卡片 HTML 模板\n│   ├── styles.css        # 共用容器样式（cover-inner / card-inner 等）\n│   └── example.md        # 示例 Markdown\n├── assets/themes/        # 主题样式（只控制排版 & 内层背景）\n│   ├── default.css\n│   ├── playful-geometric.css\n│   ├── neo-brutalism.css\n│   ├── botanical.css\n│   ├── professional.css\n│   ├── retro.css\n│   ├── terminal.css\n│   └── sketch.css\n├── demos/                # 各主题示例渲染结果\n│   ├── content.md\n│   ├── content_auto_fit.md\n│   ├── auto-fit/\n│   ├── playful-geometric/\n│   ├── retro/\n│   ├── Sketch/\n│   └── terminal/\n└── scripts/\n    ├── render_xhs.py     # Python 渲染脚本（8 主题 + 4 分页模式）\n    ├── render_xhs_v2.py  # Python 渲染脚本 V2（7 渐变色彩风格）\n    ├── render_xhs.js     # Node.js 渲染脚本\n    └── publish_xhs.py    # 自包含的小红书 Creator 发布脚本（默认仅自己可见）\n```\n\n---\n\n## ⚠️ 注意事项\n\n1. **Cookie 安全**：不要把 `.env` 提交到 Git 或共享出去；请使用创作服务平台 Cookie。\n2. **Cookie 有效期**：过期后发布失败是正常现象，重新抓一次 Cookie 即可。\n3. **发布频率**：避免短时间内高频发布，以免触发平台风控。\n4. **图片尺寸**：默认 1080×1440px，符合小红书推荐比例。\n\n---\n\n## 🙏 致谢\n\n- [Playwright](https://playwright.dev/) - 浏览器自动化渲染\n- [Marked](https://marked.js.org/) - Markdown 解析\n- ~~[xhs](https://github.com/ReaJason/xhs) - 原小红书 API 客户端（发布实现已停用）~~\n- [Spider_XHS](https://github.com/cv-cat/Spider_XHS) - 当前 Creator 纯 HTTP 登录、签名、上传与发布实现参考（基于提交 `2030f5d` 提取并内置）\n- **Cursor** - 本次重构过程中提供了极大帮助 ❤️\n\n---\n\n## 📄 License\n\nMIT License © 2026\n",
  "bytes": 5747,
  "sha": "02cf9d87266aafac467fa382ea191b2dec9e0a44711e3ca0c86edf6413b4da8e",
  "repo_slug": "comeonzhj/auto-redbook-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_comeonzhj_auto_redbook_skills_xhs_note_c_d37c304f/readme"
}