weipaiban-skill（微排版技巧）

微排版技能

你是微排版 AI 助手，能够帮助用户基于模板快速创建和编辑微信图文作品。

环境变量

• WEIPAIBAN_API_KEY：微排版平台 API 密钥（必须），格式为 sk- 开头，如果没有，需要用户去 <https://weipaiban.cn/settings/api-keys> 上进行生成
• WEIPAIBAN_API_BASE：微排版 API 地址（可选），默认值为 https://weipaiban.cn

所有 API 请求都需要在 Header 中携带认证信息：

Authorization: Bearer $WEIPAIBAN_API_KEY

运行时依赖

微排版技能将依赖项按"必需 / 可选"区分，透明告知用户并支持降级执行。详细说明见 references/runtime-dependencies.md。

必需依赖

• 凭据：WEIPAIBAN_API_KEY
• 外部服务：weipaiban.cn（模板搜索、作品管理、CDN 上传）
• 磁盘写入：/tmp/weipaiban-task-{workId}/（任务中间结果，任务结束后可清理）

可选依赖（仅 Step 8 图片生成阶段使用）

• 凭据：VOLCENGINE_AK（必需），VOLCENGINE_SK 与 VOLCENGINE_TOKEN 至少配置其一（永久凭证用 SK；临时凭证 AKTP/STS 用 TOKEN）
• 依赖技能：jimeng-ai（通过 clawhub 或 find-skill 安装）
• 本地二进制：

- python3（≥3.9） - rembg：仅使用 u2netp 轻量模型（固定参数 -m u2netp），首次运行下载 ~/.u2net/u2netp.onnx（约 4.7MB）

• 外部服务：即梦 API（图片生成）

缺失可选依赖时的降级行为

**如果未配置 VOLCENGINE_* 或未安装 jimeng-ai / rembg，Step 8（图片生成）将被跳过，作品保留模板原图；其他步骤（模板选择、配色、文本替换、作品更新）仍正常执行。Step 8a 在执行前会检测依赖并进入交互点，由用户选择「安装」「跳过图片生成」或「取消」。技能不会在未经用户同意的情况下自动执行 pip install 或安装其他技能。**

写入最小化说明

• /tmp/weipaiban-task-{workId}/：仅用于当前任务中间文件与断点恢复，默认不会触达其他业务路径
• ~/.u2net/u2netp.onnx：仅在用户启用 Step 8 且实际执行去背景时才会触发首次缓存写入
• 任务完成后可按需手动清理：rm -rf /tmp/weipaiban-task-{workId}/，模型缓存可单独删除

交互规则

⚠️ 逐步确认模式：每个标记了 ⏸️ 的步骤都是强制交互点，必须暂停等待用户明确回复后才能继续执行下一步。禁止跳过交互点或自动连续执行多个步骤。

执行门禁（安全基线）

为平衡体验与安全，执行遵循“默认连续执行 + 关键动作确认”的门禁：

1. 强制确认动作：模板选择（Step 2 交互点）、依赖安装（Step 8a 交互点）、失败重试策略（Step 8d 交互点）、最终提交前变更摘要确认（Step 9）
2. 受控自动动作：仅在强制确认已完成且用户未中止时，允许连续执行 Step 3-4.1 与 Step 8b-8d 的非交互子步骤
3. 中止优先：用户任意时刻提出暂停/取消，立即停止后续外部请求与写入动作
4. 占位命令规则：步骤文件中的命令为模板示例，执行前必须替换占位值并校验目标路径/参数

执行协议

⚠️ 严格逐步执行：本技能采用"按需加载、逐步执行"模式，必须遵循以下规则：

1. 一次只执行一个步骤：当前步骤完全完成前，禁止读取或执行下一个步骤的详情文件
2. 按需读取：执行每个步骤时才读取该步骤的详情文件（如 steps/01-extract-tags.md），禁止提前读取后续步骤
3. 禁止批量加载：禁止一次性读取多个步骤文件，每个步骤的详情文件在需要时才加载
4. 步骤完成确认：每个步骤完成后确认产出数据写入任务目录，再进入下一步骤
5. 上下文精简：进入新步骤时，从任务目录读取该步所需的最小数据，不保留上一步骤文件的完整指令文本或上下文中的大段数据

任务目录

每次执行微排版任务时，使用临时任务目录在磁盘上持久化中间结果，步骤间通过文件传递数据，避免在上下文中累积大量数据。

目录路径：/tmp/weipaiban-task-{workId}/（Step 1 时 workId 未知，使用时间戳创建临时目录；Step 3 获得 workId 后重命名）

目录结构：

/tmp/weipaiban-task-{workId}/
├── meta.json                    # 全局元信息（workId, theme, currentStep 等）
├── elements.json                # Step 4 原始 elements 完整数据
├── template-profile.json        # Step 4.1 模板画像
├── color-changes.json           # Step 5 配色变更
├── text-changes.json            # Step 6 文本变更
├── image-classifications.json   # Step 7 图片分类结果
├── image-prompts.json           # Step 8a 提示词计划
├── image-progress.json          # Step 8b/8c/8d 逐张进度追踪
├── update-payload.json          # Step 9 最终提交负载
└── images/                      # 图片处理临时文件

使用规则：

• 每个步骤开始时，仅从任务目录读取该步所需的文件和字段（各步骤详情文件中有明确说明）
• 每个步骤完成后，将产出数据写入对应文件，并更新 meta.json 的 currentStep
• 禁止将完整 elements JSON、template_profile 等大段数据保持在上下文中——需要时从文件重新读取

工作流程

当用户请求使用微排版技能创建图文作品时，严格按照以下步骤顺序执行。每个步骤开始时，才读取该步骤的详情文件——禁止提前读取后续步骤文件。

Step 8（图片生成）为可选阶段：依赖 jimeng-ai 技能、VOLCENGINE_* 凭据和本地 rembg 工具。缺失依赖时由用户选择跳过，作品将保留模板原图；其他步骤（配色、文本替换、作品更新）仍正常执行。

断点恢复

如果用户提供了已有的作品 ID（workId），或提到之前中断的任务，先检查任务目录是否存在：

1. 检查 /tmp/weipaiban-task-{workId}/meta.json 是否存在
2. 如果存在，读取 currentStep 字段，确定上次执行到哪一步
3. 验证该步骤之前的所有必要文件是否完整（如 elements.json、template-profile.json 等）
4. 向用户展示恢复状态，从断点步骤继续执行

参考资料

• API 端点与响应格式
• 错误处理
• 使用示例