RedNote 图片系列 (rednote-images)

参考图片（重要）

如果你使用参考图片（图生图 / 系列参考 / 一致性参考）：

• 参考图片必须是公开的 URL。
• 强烈建议使用 HTTPS。
• http:// 可能可以工作，但不安全，可能被某些网络屏蔽。
• WeryAI 网关不支持本地文件路径和 data: URL。

生成 RedNote 图片卡片、RedNote 封面卡片以及社交信息图系列，采用稳定的逐卡工作流程。

此 RedNote 图片技能将 RedNote 图片系列请求转换为更稳定的卡片提示词，并生成结果序列。用它可以根据一个主题创建 RedNote 图片卡片、RedNote 封面卡片或社交信息图系列。

依赖项： scripts/scaffold.ts、scripts/build-prompts.ts、scripts/build-batch.ts、位于 scripts/vendor/ 下的捆绑运行时、IMAGE_GEN_API_KEY 以及 Node.js + npm。无需其他技能。

身份验证与首次设置

首次实际生成之前：

1. 创建一个 WeryAI 账号。
2. 打开 API 密钥页面：https://www.weryai.com/api/keys。
3. 创建一个新 API 密钥并复制密钥值。
4. 将其添加到所需环境变量 IMAGE_GEN_API_KEY，或者让设置流程将其持久化到 .image-skills/rednote-images/.env 下。
5. 确保 WeryAI 账号有可用余额或积分，再进行付费生成。

OpenClaw 友好设置

• 此技能已在 metadata.openclaw.requires.env 和 primaryEnv 中声明了 IMAGE_GEN_API_KEY。
• 安装后，如果安装程序或运行时询问所需的环境变量，请将密钥粘贴到 IMAGE_GEN_API_KEY 中。
• 如果你在手动配置运行时，请在运行命令前导出该变量：

export IMAGE_GEN_API_KEY="your_api_key_here"

快速验证

在首次付费运行前，进行一次安全检查：

cd {baseDir} && npm run doctor -- --project . --workflow rednote
cd {baseDir} && npm run ensure-ready -- --project . --workflow rednote --dry-run
cd {baseDir} && npm run generate -- --prompt "RedNote layout smoke test" --image ./out/rednote-smoke.png --ar 1:1 --dry-run

• doctor 是只读操作，用于确认密钥和本地工具是否准备就绪。
• ensure-ready --dry-run 确认引导设置路径，但不修改工作区。
• generate --dry-run 打印最终的请求体，而不调用 WeryAI 或消耗积分。

脚本：

• scripts/scaffold.ts
• scripts/build-prompts.ts
• scripts/build-batch.ts

安全与范围

• 网络：此技能通过 HTTPS（https://api.weryai.com）调用 WeryAI 网关。
• 认证：使用 IMAGE_GEN_API_KEY。密钥不会打印输出。密钥仅在你显式运行 npm run setup -- --persist-api-key 时才会被持久化。
• 密钥处理：将 IMAGE_GEN_API_KEY 视为运行时秘密。不要将其提交到仓库中，也不要粘贴到生成的提示或输出文件中。
• 参考图片：必须是公开的 URL（建议使用 https://）。http:// 可能可以工作，但不安全。本地文件路径和 data: URL 会被拒绝。
• 无任意 shell：生成运行时不执行任意 shell 命令。
• 写入的文件：输出图片和可选的本地配置文件位于 .image-skills/rednote-images/（项目目录）和/或 ~/.image-skills/rednote-images/（用户主目录）。

示例提示词

• Create 5 RedNote image cards that summarize this product comparison
• Make a RedNote cover card plus 4 follow-up cards for this skincare topic
• Turn this outline into a social infographic series for RedNote

使用场景

• RedNote 卡片系列
• 社交知识卡片序列
• 产品推荐卡片、总结卡片和对比卡片
• 需要拆分为 1 到 10 张关联图片的内容

不适合用于：

• 单篇文章封面图
• 多页知识漫画
• 信息密度极高的单张信息图

核心维度

先选择两个核心维度，然后拆分系列：

1. style
2. layout

参见：

• [references/dimensions.md](references/dimensions.md)
• [references/outline-template.md](references/outline-template.md)
• [references/presets.md](references/presets.md)

命令

工作流程

第 1 步：理解内容

提取：

• 主要主题
• 目标受众
• 理想的卡片数量（通常为 3 到 7 张）
• 每张卡片最重要的 1 到 3 个要点
• 用户的语言（尤其是卡片包含画布上文字时）

第 2 步：选择 style 和 layout

默认优先级：

• style: notion
• layout: balanced

推荐规则：

• 知识总结和实用说明 -> notion、chalkboard 或 minimal
• 情感或推荐驱动型分享 -> warm、cute 或 fresh
• 强烈观点、警告或对比 -> bold 或 retro
• 海报风格且视觉冲击力强 -> editorial

如果用户明确指定了样式、密度或系列感觉，则遵循其偏好。

第 3 步：映射到捆绑运行时

绑定的图片运行时当前暴露了一个结构化的样式参数 --style，因此：

• 将 style 映射到 --style
• 将 layout 写入提示正文
• 为每张卡片创建一个提示
• 优先对整个系列进行批量生成

推荐映射：

第 4 步：搭建 outline.md 和提示文件

Skill: 小红书图片

版本: 1.0.6

分块: 2/3

初始化工作目录：

${BUN_X} {baseDir}/scripts/scaffold.ts \
  --output-dir rednote-images/topic-slug \
  --theme "主题或论文" \
  --style notion \
  --layout balanced \
  --lang zh \
  --cards 5

这会创建：

• outline.md
• prompts/01-cover.md
• prompts/02-content.md
• ...

然后根据需要完善 outline.md 和生成的提示文件。

步骤 5：完善 outline.md，然后构建提示

根据大纲生成提示文件：

${BUN_X} {baseDir}/scripts/build-prompts.ts \
  --outline rednote-images/topic-slug/outline.md \
  --output-dir rednote-images/topic-slug/prompts

然后按顺序生成卡片：

• 01-cover
• 02-content
• 03-content
• ...

每个卡片提示可参考 [references/prompt-template.md](references/prompt-template.md)。

要求：

• 每张卡片应承载一个主要信息焦点
• 在该卡片提示中明确说明 layout
• 如果图片包含文字，说明目标语言
• 默认小红书建议比例为 3:4 或 1:1
• 对于多卡片集，优先创建共享系列参考图，然后在所有卡片中重复使用

步骤 6：先生成共享系列参考图

在生成最终卡片批次之前，先生成标准系列参考图：

cd {baseDir} && npm run generate -- \
  --promptfiles rednote-images/topic-slug/references/series-reference.md \
  --style flat-illustration \
  --image rednote-images/topic-slug/references/series-reference.png \
  --ar 3:4 \
  -m "$M"

对于多卡片集，此步骤为默认操作。当一致性重要时，请勿跳过。

步骤 7：构建 batch.json 并运行生成

从提示目录构建批次文件：

${BUN_X} {baseDir}/scripts/build-batch.ts \
  --prompts rednote-images/topic-slug/prompts \
  --output rednote-images/topic-slug/batch.json \
  --images-dir rednote-images/topic-slug \
  --model "$M"

然后运行捆绑的图片生成器：

在新项目中首次使用时，在生成前运行 cd {baseDir} && npm run ensure-ready -- --project <your-project> --workflow rednote。这会读取诊断报告，如果本地脚本依赖仍然缺失，则自动运行 bootstrap。如果报告显示缺少 IMAGE_GEN_API_KEY 且用户同意，则在密钥已在环境变量中时运行 cd {baseDir} && npm run setup -- --project <your-project> --workflow rednote --persist-api-key，或者代表用户将其持久化到 .image-skills/rednote-images/.env，然后继续，不退出此工作流。

当此技能首次连接时，告知用户默认生成模型为 Nano Banana 2 (GEMINI_3_1_FLASH_IMAGE)。同时也告知他们，当其他模型更适合任务时，以后可以切换。

cd {baseDir} && npm run generate -- --batchfile rednote-images/topic-slug/batch.json --json

如果只需要单张封面卡片，直接调用即可：

cd {baseDir} && npm run generate -- \
  --promptfiles prompts/01-cover.md \
  --style flat-illustration \
  --image rednote-images/topic-slug/01-cover.png \
  --ar 3:4 \
  -m "$M"

如果用户尚未选择模型，请先遵循此技能的模型选择规则。

多卡片集的一致性策略：

1. 首先创建一张标准 references/series-reference.png
2. 将该图片视为色彩调色板、重复主题、排版风格和布局节奏的真实来源
3. 为每个卡片任务重复使用同一共享参考图
4. 在每个提示中保留卡片特定的连续性锚点以及前后卡片的上下文
5. 如果共享参考图缺失，不要继续执行最终批次生成

输出规范

建议的输出目录：

rednote-images/<topic-slug>/

建议的最小文件集合：

• outline.md
• batch.json
• prompts/01-cover.md
• prompts/02-content.md
• 01-cover.png
• 02-content.png

重新运行行为

• scaffold.ts 在已有目录上运行会按请求的卡片数量覆盖 outline.md 和起始提示文件。
• build-prompts.ts 根据当前 outline.md 覆盖 prompts/ 中的提示文件。
• build-batch.ts 覆盖 batch.json。
• 使用 --batchfile 重新运行基础生成器会重新生成所有列出的卡片；如果希望保留好卡片，请先从 batch.json 中移除其任务。
• 重新运行共享参考步骤会覆盖 references/series-reference.png。

完成标准

• 输出目录中存在 outline.md 和每张卡片的提示文件。
• 所有卡片已生成并按顺序向用户展示。
• 交付摘要中说明了卡片数量、风格、布局和模型。
• 生成压缩的 webp 集合用于交付。

迭代

当用户看到生成的卡片后希望进行更改：

• 风格不匹配（“更改风格”）→ 更改所有卡片的 style / --style，重新构建批次，重新生成。询问是否针对所有卡片还是特定卡片。
• 色彩/色调问题（“太冷”、“颜色暗淡”）→ 在提示正文中调整 palette 和 mood。仅重新生成受影响的卡片。
• 内容分割错误（“卡片3内容过多”）→ 修改 outline.md 以重新分配内容，重新构建受影响的卡片的提示和批次。
• 想要更多/更少卡片→ 在 outline.md 中调整卡片数量，重新构建脚手架和批次。
• 单张卡片重做→ 通过针对特定提示运行捆绑生成器 --promptfiles，仅重新生成该卡片。

重新生成子集时，保留已有的好图片，仅替换需要更改的图片。

交付

当卡片系列准备好时：

1. 直接按顺序展示每张卡片图片（封面 → 内容 → 摘要）。不要仅列出文件路径。
2. 简要说明：卡片数量、风格、宽高比。
3. 询问是否需要更改任何卡片，或者用户是否希望继续。
4. 自动压缩：确认后，对输出目录运行捆绑的压缩运行时，生成用于社交上传的 webp 版本。

${BUN_X} {baseDir}/scripts/vendor/compression-runtime/scripts/main.ts rednote-images/topic-slug/ -r -f webp -q 80

对于包含多张卡片的系列，在完成后立即显示前 2-3 张，然后批量显示其余卡片。

内部检查清单（供代理使用）：卡片数量、style / layout、模型、批量执行、目标语言、压缩完成。