微排版
微排版技能 - 通过 AI 自动创建微信图文作品,支持模板搜索、配色方案、文本生成和图片替换 Skill: 微排版 Owner: weipaiban Summary: 微排版技能 - 通过 AI 自动创建微信图文作品,支持模板搜索、配色方案、文本生成和图片替换 Tags: design:1.0.0, latest:1.2.0, productivity:1.0.0, social:1.0.0, wechat:1.0.0 Version history: v1.2.0 | 2026-04-29T03:07:07.634Z | auto **v1.2.0 introduces enhanced execution safety and improved dependency transparency.** - 增加“执行门禁(安全基线)”说明,明确强制确认及受控自动连续执行动作,提升交互安全性 - 新增“写入最小化说明”,详细说明本地缓存及中间文件写入范围 - 明确 Step 9 增加“最终提交前变更摘要确认”为强制交互点
Rank
62
Safety
84
Downloads
967
Updated
Oct 12, 2026
Version
1.2.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 967 downloads reported by the source. Last updated 10/12/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 12, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 12, 2026
- Adoption signal
- 967 downloadsadoption · observed Oct 12, 2026
- Latest release
- 1.2.0release · observed Apr 29, 2026
- Handshake status
- UNKNOWNsecurity
What changed
Newest first. Only changes that point at a source are listed.
Release 1.2.0release
**v1.2.0 introduces enhanced execution safety and improved dependency transparency.** - 增加“执行门禁(安全基线)”说明,明确强制确认及受控自动连续执行动作,提升交互安全性 - 新增“写入最小化说明”,详细说明本地缓存及中间文件写入范围 - 明确 Step 9 增加“最终提交前变更摘要确认”为强制交互点 - 细化外部依赖和缓存行为,完善任务目录的写入说明 - 文档内用词及结构小幅优化,提升可读性
Observed Apr 29, 2026 · source
Install and run
Setup complexity: low.
clawhub skill install s17fbxhkd59r66jc27xkyxzkh984dbpe:weipaiban-skill- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-weipaiban-weipaiban-skill/snapshot"
Run-check
$0.02 USD1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.
Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.
Documentation
CLAWHUB
122,538 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: weipaiban-skill
description: 微排版技能 - 通过 AI 自动创建微信图文作品,支持模板搜索、配色方案、文本生成和图片替换
version: 1.2.0
user-invocable: true
metadata:
openclaw:
emoji: '🎨'
requires:
env:
- WEIPAIBAN_API_KEY
primaryEnv: WEIPAIBAN_API_KEY
optionalEnv:
- VOLCENGINE_AK
- VOLCENGINE_SK
- VOLCENGINE_TOKEN
optionalSkills:
- jimeng-ai
optionalBinaries:
- python3
- rembg
externalServices:
- weipaiban.cn
- jimeng.com
writes:
- /tmp/weipaiban-task-*/
- ~/.u2net/u2netp.onnx
---
# 微排版技能
你是微排版 AI 助手,能够帮助用户基于模板快速创建和编辑微信图文作品。
## 环境变量
- `WEIPAIBAN_API_KEY`:微排版平台 API 密钥(必须),格式为 `sk-` 开头,如果没有,需要用户去 <https://weipaiban.cn/settings/api-keys> 上进行生成
- `WEIPAIBAN_API_BASE`:微排版 API 地址(可选),默认值为 `https://weipaiban.cn`
所有 API 请求都需要在 Header 中携带认证信息:
```text
Authorization: Bearer $WEIPAIBAN_API_KEY
```
## 运行时依赖
微排版技能将依赖项按"必需 / 可选"区分,透明告知用户并支持降级执行。详细说明见 [references/runtime-dependencies.md](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 模板画像
├── c_meta.json
{
"ownerId": "kn729y74k4eyhx5ax4zzmqvd1s84decf",
"slug": "weipaiban-skill",
"version": "1.2.0",
"publishedAt": 1777432027634
}references/api-formats.md
# API 端点与响应格式参考
所有 API 请求都需要在 Header 中携带认证信息:
```
Authorization: Bearer $WEIPAIBAN_API_KEY
```
API 基础地址:`${WEIPAIBAN_API_BASE:-https://weipaiban.cn}`
---
## 模板搜索响应
`GET /api/v1/templates`
```json
{
"data": {
"items": [
{
"id": "模板ID",
"title": "模板标题",
"description": "模板描述",
"tags": ["标签1", "标签2"],
"thumbnail": "缩略图URL",
"publishedAt": "2026-01-01T00:00:00.000Z"
}
],
"total": 10,
"page": 1,
"perPage": 5
}
}
```
## 默认模板响应
`GET /api/v1/templates/default`
```json
{
"data": {
"id": "模板ID",
"title": "模板标题",
"description": "模板描述",
"tags": ["标签1", "标签2"],
"thumbnail": "缩略图URL",
"publishedAt": "2026-01-01T00:00:00.000Z"
}
}
```
## 克隆模板响应
`POST /api/v1/templates/{模板ID}/clone`
请求体:`{"title": "作品标题"}`
```json
{
"data": {
"id": "新作品ID",
"title": "作品标题",
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z"
}
}
```
## Parser 获取响应
`GET /api/v1/vectors/{作品ID}/parser`
```json
{
"data": {
"id": "作品ID",
"title": "作品标题",
"elements": [
{
"id": "元素ID",
"name": "标题文本",
"type": "text",
"text": "原始文本内容",
"charCount": 7,
"fill": "#333333"
},
{
"id": "元素ID",
"name": "背景色块",
"type": "rect",
"fill": "#d9d9d9",
"width": 750,
"height": 1200
},
{
"id": "元素ID",
"name": "背景图",
"type": "image",
"image": {
"src": "https://原始图片地址",
"width": 800,
"height": 600,
"ratio": "4:3"
}
},
{
"id": "元素ID",
"name": "轮播图",
"type": "slideshow",
"assets": [
{
"id": "asset1",
"title": "高山.jpg",
"src": "https://图片地址1",
"width": 1170,
"height": 1800,
"ratio": "13:20"
},
{
"id": "asset2",
"title": "草地.jpg",
"src": "https://图片地址2",
"width": 1170,
"height": 1800,
"ratio": "13:20"
}
]
}
]
}
}
```
## Parser 更新响应
`POST /api/v1/vectors/{作品ID}/parser`
```json
{
"data": {
"id": "作品ID",
"title": "作品标题",
"updatedAt": "2026-01-01T00:00:00.000Z"
}
}
```
## CDN 上传响应
`POST /api/v1/assets/fetch`
请求体:`{"url": "图片URL"}`
该接口基于文件内容 SHA1 哈希自动去重:相同图片重复上传返回 HTTP 200(已有记录),新图片上传返回 HTTP 201。
成功响应:
```json
{
"data": {
"id": "资源ID",
"type": "image",
"name": "存储路径",
"title": "文件名",
"src": "https://svg-cdn.creatby.com/...",
"width": 800,
"height": 600,
"size": 123456,
"createdAt": "2026-01-01T00:00:00.000Z"
}
}
```
错误响应(400/413/415/502/504):
```json
{
"error": {
"message": "错误描述",
"code": 400
}
}
```
## CDN 文件上传
`POST /api/v1/assets/upload`
请求格式:`multipart/form-data`,字段 `file` 为图片文件。
```bash
curl -s --max-time 30 -Xreferences/error-handling.md
# 错误处理 - **401 Unauthorized**:API Key 无效或过期,提示用户在微排版平台重新生成 API Key - **403 Forbidden**:用户角色权限不足,需要 admin 或 developer 角色 - **404 Not Found**:模板或作品不存在,检查 ID 是否正确 - **429 Too Many Requests**:请求频率超限(60次/分钟),等待后重试 - **模板搜索无结果**:按级联降级策略自动重试(tags+search → 仅search → 仅tags → 默认模板),全部无果时使用默认模板兜底
references/runtime-dependencies.md
# 运行时依赖与数据流参考
本文件集中说明微排版技能在运行时所需的凭据、外部服务、本地二进制、磁盘写入以及数据流向。元数据(SKILL.md / README.md 顶部)是简要声明,此处是完整释义。
---
## 依赖总览
| 类别 | 名称 | 必需 / 可选 | 用途 |
| ---------- | --------------------- | ----------- | -------------------------------------- |
| 凭据 | `WEIPAIBAN_API_KEY` | 必需 | 微排版平台 API 鉴权 |
| 凭据 | `WEIPAIBAN_API_BASE` | 可选 | 自定义微排版 API 地址(默认官方) |
| 凭据 | `VOLCENGINE_AK` | 可选\* | 火山引擎鉴权(Step 8 必需) |
| 凭据 | `VOLCENGINE_SK` | 可选\* | 永久凭证鉴权(SK/TOKEN 二选一) |
| 凭据 | `VOLCENGINE_TOKEN` | 可选\* | 临时凭证(AKTP/STS)鉴权 |
| 依赖技能 | `jimeng-ai` | 可选 | 封装即梦图片生成调用 |
| 本地二进制 | `python3`(≥3.9) | 可选 | 运行 rembg |
| 本地二进制 | `rembg` CLI | 可选 | 背景去除(仅使用 `u2netp` 轻量模型) |
| 外部服务 | `weipaiban.cn` | 必需 | 模板搜索、作品管理、素材 CDN 上传 |
| 外部服务 | 即梦 API | 可选 | 根据 prompt 生成图片 |
| 磁盘写入 | `/tmp/weipaiban-task-{workId}/` | 必需 | 任务中间文件(元信息、图片、进度) |
| 磁盘写入 | `~/.u2net/u2netp.onnx`| 可选 | rembg u2netp 模型缓存(约 4.7MB) |
> \* 整体 Step 8(图片生成)为可选阶段;一旦启用,则 `VOLCENGINE_AK` 必需,且 `VOLCENGINE_SK` 与 `VOLCENGINE_TOKEN` 至少配置其一。
---
## 数据流
### 基础流程(必需依赖)
```text
用户输入
→ 主代理
→ weipaiban.cn(模板搜索、克隆、获取 elements、更新作品)
→ 本地 /tmp/weipaiban-task-{workId}/(缓存中间 JSON)
→ 返回作品编辑链接
```
此流程仅在微排版平台和本地磁盘之间往返,不涉及第三方图片服务。
### 图片生成流程(可选阶段 Step 8)
```text
主代理
→ jimeng-ai 技能 → 即梦 API(发送 prompt / ratio,返回临时图片 URL)
→ 本地下载到 /tmp/weipaiban-task-{workId}/images/{elementId}_generated.png
→ rembg -m u2netp(若 needsTransparent=true)→ {elementId}_nobg.png
→ weipaiban.cn /api/v1/assets/upload 或 /api/v1/assets/fetch
→ 获取 CDN 永久 URL
```
> **重要**:发送给即梦 API 的 prompt 由用户主题 + 模板画像 + 配色方案拼接而成;图片内容最终会上传到 weipaiban CDN 并成为作品的一部分。用户应确认这两个服务对上传内容的隐私政策。
---
## 安装命令与副作用
### 安装 `jimeng-ai` 技能
通过 clawhub 或 find-skill 技能查找并安装。具体命令由 clawhub/find-skill 决定,不在本技能控制范围内。
### 安装 `rembg`
```bash
pip3 install "rembg[cpu,cli]~=2.0.67"
```
**副作用**:
- 安装 `rembg`、`onnxruntime`(CPU 版本)、`pymatting` 等依赖
- **首次运行时**下载 `u2netp.onnx`(约 4.7MB)到 `~/.u2net/u2netp.onnx`
- 本技能**固定**使用 `u2netp` 轻量模型(命令 `rembg i -m u2netp`),不会下载其他模型(如完整版 `u2net` 176MB)
### 版本升级流程(锁定版本维护)
为降低供应链风险,`rembg` 采用精确版本锁定。升级时按以下流程执行:
1. 在隔离环境评估新版本兼容性(命令参数、模型下载行为、处理质量)
2. 通过 Step 8 全链路回归(8a/8b/8c/8d)验证稳定性
3. 更新本文和 Step 8a 中的锁定版本号,保持文档口径一致
4. 在变更记录中注明升级理由与验证范围
### 申请 `VOLCENGINE_AK` / `VOLCENGINE_SK` / `VOLCENGINE_TOKEN`
需在火山引擎/即梦平台自行申请。本技能不会通过 API 自动生成或读取密钥文件。
- **永久凭证**:在火山引擎控制台创建访问密钥,得到 `AKLT…` 开头的 AK 与对应的 SK,配置 `VOLCENGINE_AK` + `VOLCENGINE_SK`
- **临时凭证(STS)**:通过 STS 接口换取临时凭证,得到 `AKTP…` 开头的 AK + Token,配置 `VOLCENGINE_AK` + `VOLCENGINE_TOKEN`(此时 SK 可省略)
---
## 用户同意原则
本技能严格遵循以下原则:
1. **不在未经用户同意的情况下执行安装命令**。Step 8a 的依赖检测只做"检测 + 展示结果 + 请求用户选择",不会直接运行 `pip install` 或安装其他技能
2. **降级可用**:缺失可选依赖时,用户可选择跳过 Step 8,作品保留模板原图,AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
- Card JSON
- Facts JSON
- Snapshot JSON
- Contract JSON
- Trust JSON
- Changes JSON
- Warnings JSON
- Seen by JSON
- Disagreements JSON
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/weipaiban/skills/weipaiban-skill",
"sourceUrl": "https://clawhub.ai/weipaiban/skills/weipaiban-skill",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-12T00:32:08.853Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-weipaiban-weipaiban-skill/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-weipaiban-weipaiban-skill/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-12T00:32:08.853Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "967 downloads",
"href": "https://clawhub.ai/weipaiban/weipaiban-skill",
"sourceUrl": "https://clawhub.ai/weipaiban/weipaiban-skill",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-12T00:32:08.853Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.2.0",
"href": "https://clawhub.ai/weipaiban/weipaiban-skill",
"sourceUrl": "https://clawhub.ai/weipaiban/weipaiban-skill",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-29T03:07:07.634Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-weipaiban-weipaiban-skill/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-weipaiban-weipaiban-skill/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.2.0",
"description": "**v1.2.0 introduces enhanced execution safety and improved dependency transparency.** - 增加“执行门禁(安全基线)”说明,明确强制确认及受控自动连续执行动作,提升交互安全性 - 新增“写入最小化说明”,详细说明本地缓存及中间文件写入范围 - 明确 Step 9 增加“最终提交前变更摘要确认”为强制交互点 - 细化外部依赖和缓存行为,完善任务目录的写入说明 - 文档内用词及结构小幅优化,提升可读性",
"href": "https://clawhub.ai/weipaiban/weipaiban-skill",
"sourceUrl": "https://clawhub.ai/weipaiban/weipaiban-skill",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-29T03:07:07.634Z",
"isPublic": true
}
]
}Record generated Oct 12, 2026.
For crawlers
This page is free to read. The run-check above is the only paid part, and it answers HTTP 402 until it is paid. Everything else here is public.
- One record, as JSON: card, facts, snapshot, contract, trust, changes, warnings, seen by, disagreements.
- Every agent, one feed: /.well-known/ai-catalog.json
- What this site sells, and the price: /.well-known/x402
- Paid run-check: /api/v1/agents/clawhub-weipaiban-weipaiban-skill/run-check
