@optima-chat/gen-cli 1.0.9 → 1.1.1

package/.claude/skills/gen/SKILL.md

@@ -0,0 +1,345 @@
+---
+name: gen
+description: "生成和编辑图片/语音/虚拟试穿。使用场景：生成图片(generate images/生成图片/画图)、编辑图片(edit images/编辑图片/图生图/风格转换)、文本转语音(TTS/语音合成/朗读)、语音识别(ASR/语音转文字/转录)、虚拟试穿(virtual try-on/试穿/换装/试衣)。视频生成请使用 video-gen skill。"
+version: 1.0.0
+owner_repo: Optima-Chat/optima-gen
+---
+
+# AI 内容生成工具
+
+## 图片生成
+
+### 标准工作流程
+
+```bash
+# 文生图
+gen image "提示词" -o /home/aiuser/project/result.png
+
+# 图片编辑/风格转换
+gen image "转成水彩风格" -i photo.png -o /home/aiuser/project/result.png
+
+# 读取并描述结果
+Read /home/aiuser/project/result.png
+```
+
+### gen image 命令
+
+统一的图像生成/编辑命令。
+
+```bash
+gen image <prompt> [options]
+```
+
+#### 参数
+
+| 参数 | 说明 |
+|------|------|
+| `-i, --input <path>` | 输入图像（可多次使用，最多 8 张） |
+| `-W, --width <px>` | 输出宽度（默认 1024，最大 2048） |
+| `-H, --height <px>` | 输出高度（默认 1024，最大 2048） |
+| `-o, --output <path>` | 输出目录或完整路径 |
+| `-s, --seed <number>` | 随机种子（可复现结果） |
+| `-f, --format <fmt>` | 输出格式：jpeg \| png |
+| `--provider <name>` | 供应商：grsai（默认） \| bfl |
+| `-m, --model <model>` | 模型：gpt-image-2（默认） \| nano-banana-fast \| nano-banana-pro \| flux-kontext-pro \| flux-kontext-max 等 |
+| `--aspect-ratio <ratio>` | 宽高比：1:1 \| 16:9 \| 9:16 \| 4:3 等 |
+| `--image-size <size>` | nano-banana-pro 输出尺寸：1K \| 2K \| 4K |
+
+### 工作流示例
+
+#### 文生图
+
+```bash
+gen image "a cute fluffy cat sitting on a windowsill, natural lighting" -o /home/aiuser/project/cat.png
+Read /home/aiuser/project/cat.png
+```
+
+#### 图片风格转换
+
+```bash
+gen image "watercolor painting style, artistic brushstrokes" -i photo.jpg -o /home/aiuser/project/watercolor.png
+Read /home/aiuser/project/watercolor.png
+```
+
+#### 多图风格融合
+
+将第一张图的风格应用到第二张图的内容上：
+
+```bash
+gen image "apply the artistic style from image 1 to the content of image 2" -i style.png -i content.png -o /home/aiuser/project/fusion.png
+Read /home/aiuser/project/fusion.png
+```
+
+#### 多图元素组合
+
+从多张图中提取元素组合成新图：
+
+```bash
+gen image "The person from image 1 is petting the cat from image 2, in a cozy living room" -i person.jpg -i cat.jpg -o /home/aiuser/project/combined.png
+```
+
+#### 精确颜色控制
+
+使用 hex code 指定精确颜色：
+
+```bash
+gen image "a modern logo with brand color #02eb3c as the primary accent" -o /home/aiuser/project/logo.png
+```
+
+#### 产品海报
+
+```bash
+gen image "Disney Pixar style 3D poster, [产品描述], cute character, vibrant gradient background, professional studio lighting" -W 1024 -H 1024 -o /home/aiuser/project/poster.png
+```
+
+### 提示词指南
+
+#### 结构
+
+**Subject + Action + Style + Context**
+
+词序很重要，靠前的元素优先级更高。
+
+#### 长度建议
+
+| 长度 | 词数 | 适用场景 |
+|------|------|----------|
+| 短 | 10-30 | 快速概念探索 |
+| 中 | 30-80 | 大多数项目（推荐） |
+| 长 | 80+ | 复杂场景 |
+
+#### 最佳实践
+
+| 技巧 | 说明 | 示例 |
+|------|------|------|
+| 描述想要的 | 不支持负向提示词 | "sharp focus" 而非 "no blur" |
+| 精确颜色 | 使用 hex code | `"brand color #1a1a2e"` |
+| 文字渲染 | 用引号包裹文字 | `"The text 'OPEN' in red neon"` |
+| 摄影风格 | 指定相机/镜头 | `"shot on Fujifilm X-T5, 35mm f/1.4"` |
+| 多语言 | 用原生语言更地道 | 法语描述巴黎场景 |
+
+#### 示例对比
+
+```bash
+# 简单
+gen image "a robot"
+
+# 添加风格
+gen image "a friendly AI robot, cute cartoon style, bright colors, 3D render"
+
+# 完整描述
+gen image "Disney Pixar style 3D animated robot character, friendly cheerful expression, wearing headset, surrounded by floating icons, gradient purple-blue background, professional studio lighting, vibrant colors"
+```
+
+### 分辨率选择
+
+最大 2048x2048。
+
+| 用途 | 分辨率 |
+|------|--------|
+| 社交媒体 | 1024x1024 |
+| 宽屏壁纸 | 1920x1088 |
+| 竖屏海报 | 768x1280 |
+
+### 生成规则
+
+#### 生成后
+- 使用 Read 工具查看生成的图片
+- 向用户描述图片内容（颜色、风格、构图、元素）
+- 验证是否符合用户要求
+
+#### 多图参考
+- 最多 8 张输入图
+
+## 虚拟试穿 (Virtual Try-On)
+
+使用 FASHN AI tryon-v1.6 将服装穿到人物照片上。
+
+```bash
+gen tryon <人物照片> <服装照片> [options]
+```
+
+### 参数
+
+| 参数 | 说明 | 默认值 |
+|------|------|--------|
+| `-o, --output <path>` | 输出文件路径 | `./gen-output/tryon_{timestamp}.png` |
+| `-c, --category <type>` | 服装类别：auto \| tops \| bottoms \| one-pieces | auto |
+| `-m, --mode <mode>` | 生成模式：performance \| balanced \| quality | quality |
+| `--garment-type <type>` | 服装照片类型：auto \| flat-lay \| model | auto |
+| `-n, --num-samples <n>` | 生成数量 (1-4) | 1 |
+| `--format <fmt>` | 输出格式：png \| jpeg | png |
+| `--seed <n>` | 随机种子（可复现） | - |
+
+### 示例
+
+```bash
+# 基本用法
+gen tryon person.jpg garment.jpg -o /home/aiuser/project/result.png
+Read /home/aiuser/project/result.png
+
+# 使用 URL 图片
+gen tryon https://example.com/model.jpg https://example.com/dress.jpg -o /home/aiuser/project/result.png
+
+# 指定服装类别和快速模式
+gen tryon person.jpg top.jpg -c tops -m performance -o /home/aiuser/project/result.png
+
+# 生成多张结果
+gen tryon person.jpg dress.jpg -n 4 -c one-pieces -o /home/aiuser/project/result.png
+```
+
+### 注意事项
+
+- 支持本地图片路径和 URL
+- 服装类别：auto (自动检测), tops (上装), bottoms (下装), one-pieces (连体)
+- 三种模式：performance (~7s), balanced (~9s), quality (~13s)
+- 默认保存到 `./gen-output/`
+
+## 语音合成 (TTS)
+
+使用 DashScope qwen3-tts-flash 将文本转为语音。
+
+```bash
+gen tts <文本> [options]
+```
+
+### 参数
+
+| 参数 | 说明 | 默认值 |
+|------|------|--------|
+| `-o, --output <path>` | 输出文件路径 | `./gen-output/tts_{timestamp}.wav` |
+| `--voice <name>` | 声音名称 | Cherry |
+| `--voices` | 列出可用声音 | - |
+| `--play` | 生成后自动播放 | - |
+
+### 可用声音
+
+- 女声：Cherry, Serena, Chelsie, Aria, Bella, Vivian, Jennifer, Katerina, Breeze, Maple, Sakura
+- 男声：Ethan, Aiden, Brandon, Ryan, Luke, Leo
+
+### 示例
+
+```bash
+# 中文语音合成
+gen tts "你好，欢迎使用语音合成功能" -o /home/aiuser/project/hello.wav
+
+# 指定男声
+gen tts "Hello, welcome!" --voice Ethan -o /home/aiuser/project/greeting.wav
+
+# 生成后播放
+gen tts "测试语音" --play -o /home/aiuser/project/test.wav
+```
+
+### 注意事项
+
+- 输出格式为 WAV
+- 最大 5000 字符
+- 支持中、英、日、韩、法、德等 10 种语言（自动检测）
+- 默认保存到 `./gen-output/`
+
+## 语音识别 (ASR)
+
+使用 Groq Whisper 将语音转为文字。
+
+```bash
+gen asr <音频文件> [options]
+```
+
+### 参数
+
+| 参数 | 说明 | 默认值 |
+|------|------|--------|
+| `--language <lang>` | 语言提示：zh \| en \| ja \| ko 等 | 自动检测 |
+| `--model <name>` | Whisper 模型 | whisper-large-v3-turbo |
+
+### 示例
+
+```bash
+# 自动检测语言
+gen asr /home/aiuser/project/recording.mp3
+
+# 指定语言提示（提高准确率）
+gen asr /home/aiuser/project/recording.wav --language zh
+```
+
+### 注意事项
+
+- 支持 mp3, wav, m4a, ogg, webm 格式
+- 文件大小限制 25MB
+
+## 任务管理
+
+所有生成命令会自动等待完成。如需查看历史或管理任务：
+
+```bash
+gen task list                     # 查看所有任务
+gen task list --type image        # 按类型过滤
+gen task list --status failed     # 按状态过滤
+gen task get <task_id>            # 查看任务详情
+gen task cancel <task_id>         # 取消任务
+gen task retry <task_id>          # 重试失败的任务
+```
+
+## 错误处理（重要）
+
+所有 `gen` 命令在失败时会返回结构化错误。**不要把原始 `error_message` 直接抛给用户**——根据 `error_class` 字段决定应对策略。
+
+### 失败响应示例
+
+```json
+{
+  "success": true,
+  "data": {
+    "task_id": "abc-123",
+    "status": "failed",
+    "error_code": "CONTENT_POLICY_VIOLATION",
+    "error_class": "prompt_problem",
+    "retryable": false,
+    "error_message": "生成内容被审核拒绝，请调整描述后重试（不会重复扣费）"
+  }
+}
+```
+
+注意：`success: true` + `status: "failed"` 是任务执行完成但生成失败；`success: false` 才是 CLI 调用本身失败。两者都要按 `error_class` / `error_code` 处理。
+
+### 主决策字段：`error_class`（4 值枚举）
+
+**优先看 `error_class`** 决定大方向，再看 `error_code` 决定细节话术。新增 `error_code` 时 `error_class` 不变，向后兼容。
+
+| `error_class` | 含义 | 你应该做的 |
+|---|---|---|
+| `retry_safe` | 上游瞬时问题（超时 / 限流 / 维护 / 网络） | 等会原样重试**最多 1 次**，静默或简短告知 |
+| `prompt_problem` | 用户输入被拒（违规 / 格式不对） | 调整 prompt 或换素材，**自动重试最多 1 次**；仍失败交给用户 |
+| `provider_problem` | 平台后端问题（账户额度耗尽等） | **不重试**。明确告诉用户问题不在他、不在他的余额 |
+| `unknown` | 未识别错误 | **不重试**。把通用错误信息透给用户，建议联系支持 |
+
+### 处理对照表（细分 `error_code`）
+
+| `error_code` | `error_class` | 你应该做的 | 给用户的话术（参考） |
+|---|---|---|---|
+| `UPSTREAM_MAINTENANCE` | `retry_safe` | **不立即重试**。告知用户服务维护中，建议 5-10 分钟后再试 | "图片生成服务正在维护，建议 5-10 分钟后我再帮您试一次" |
+| `UPSTREAM_TIMEOUT` | `retry_safe` | 立即重试 1 次（静默） | （重试成功就别提；连续失败再说） |
+| `UPSTREAM_RATE_LIMITED` | `retry_safe` | 等 30 秒后重试 1 次 | "请求频率过高，稍等几十秒再试" |
+| `UPSTREAM_NETWORK` | `retry_safe` | 立即重试 1 次（静默） | （同 timeout） |
+| `CONTENT_POLICY_VIOLATION` | `prompt_problem` | **改写 prompt** 去掉敏感/违规元素，自动重试**最多 1 次**。仍失败再交给用户 | "您的描述触发了内容审核，我换个说法重试：……" |
+| `INVALID_INPUT` | `prompt_problem` | **不要原样重试**。提示用户输入素材有问题（如图片格式不支持），建议更换 | "您提供的参考图格式不支持，请用 JPG/PNG/WEBP 等常见格式重试" |
+| `PROVIDER_INSUFFICIENT_CREDITS` | `provider_problem` | **不重试**。明确告诉用户问题不在他、不在他的余额 | "生成服务后端额度不足（与您账户余额无关），已记录" |
+| `PROVIDER_AUTH_FAILED` | `provider_problem` | **不重试**。配置/认证问题（API key 错或账户被封），跟用户余额无关，已交管理员处理 | "生成服务认证失败，已记录并将由管理员处理。此问题与您的账户无关" |
+| `UPSTREAM_UNKNOWN` 或字段缺失 | `unknown` | **不重试**。把 `error_message` 透传给用户 | "图片生成失败：{error_message}" |
+
+### 通用规则
+
+1. **优先按 `error_class` 决策**，遇到不认识的 `error_code` 也能正确分流
+2. **`retryable: true`** 的失败：自动重试**最多 1 次**，不要循环
+3. **`retryable: false`**：永远不重试，立即给用户结果
+4. 改写 prompt 重试时，**告诉用户你做了什么改动**（透明）
+5. `success: false`（CLI 本身报错）直接报给用户，不重试
+6. 没有 `error_class` / `error_code` 字段的旧版响应：当作 `unknown` / `UPSTREAM_UNKNOWN` 处理
+
+### 反面示例（不要这样做）
+
+❌ 把 `"维护中"` 三个字直接砸给用户
+❌ 任何失败都自动 retry 三五次造成账单浪费
+❌ `CONTENT_POLICY_VIOLATION` 时换汤不换药地原 prompt 重试
+❌ `INVALID_INPUT` 时反复用同一份格式不对的图重试
+❌ `PROVIDER_INSUFFICIENT_CREDITS` 时让用户去充值（这跟用户余额无关）

package/.claude/skills/multigrid-poster/SKILL.md

@@ -0,0 +1,194 @@
+---
+name: multigrid-poster
+description: "为商家生成小红书 2×2 四宫格 / 3×3 九宫格封面图。触发场景:做小红书封面 / 小红书首图 / 种草帖封面 / 爆款封面 / 四宫格 / 九宫格。一句话指令产出 1242×1660 成片,支持自然语言迭代(换版式 / 重抽某格 / 改文案)。本 skill 只生成封面图,搜索小红书笔记 / 分析博主请用 'xhs' skill。"
+version: 1.0.0
+owner_repo: Optima-Chat/optima-gen
+---
+
+# 小红书多宫格封面生成
+
+帮电商商家用 AI 图 + 通用网格布局合成小红书封面。**一句话从意图到 1242×1660 成片**,支持 4 宫格 / 9 宫格两种版式。
+
+## Global Rules
+
+优先级高于任何 pipeline 步骤。
+
+1. **User-facing 不出现模型名 / 服务名**
+   status / 成本 / 进度统一用"封面生成中 / 素材生成中 / 合成封面中"。`gen image` 作为 CLI 字面值可以,但不要把整条命令原文回显给用户。
+
+2. **花钱前必走 COST-GATE**
+   任何 `gen image` 批量调用之前必走一次成本确认。**Fast-path、迭代、重试均无例外**。2×2 = 4 张,3×3 = 9 张,SKU 拉图 = 0 张。rate 按 `gen image` 每次 1 积分估。
+
+3. **Per-post init 是任何 pipeline 第一步**
+   出图 / 合成执行前先建目录 + cd。否则 write 写错位置。迭代场景用 `{旧id}-vN`。
+
+4. **Anti-fabrication**
+   未在本 skill 显式列出的命令 / flag / 参数,不允许凭印象拼。`gen image` / `commerce` / `compose.py` 子命令同样适用。
+
+5. **不自动发帖**
+   只产 PNG,**绝对不调用**任何自动登录 / 发帖 / 上传命令。完成后给路径,用户自己下载手动发。
+
+## 工作目录
+
+```
+~/multigrid-poster/
+├── preferences.md
+├── history.md
+└── posters/{post-id}/
+    ├── intent.md             # 用户意图 + layout + 文案
+    ├── cells/cell_0..N.png   # 4 或 9 张素材
+    ├── cover.png             # 成片
+    └── cost.md
+```
+
+整个 `~/multigrid-poster/` 是一个 git repo。每步完成后 `git add -A && git commit`。
+
+## 启动流程
+
+1. **首次** (`ls ~/multigrid-poster/preferences.md` 不存在) → `mkdir -p ~/multigrid-poster/posters && cd ~/multigrid-poster && git init -b main`,创建空的 `preferences.md` (字段:merchant_id / brand_name / category / xhs_account_id / default_layout) 和 `history.md` (表头:date | post-id | layout | title | parent | status)。`.gitignore` 加 `posters/**/cells/*.png` 和 `posters/**/cover.png`。
+2. **扫未完成**:`posters/` 下有 `intent.md` 但无 `cover.png` 且 < 7 天 → 提一次"你有 N 个封面没完成"。
+3. **读 preferences.md / history.md**,继续主流程。
+
+## 主流程
+
+### Step 1: 选 layout
+
+| 用户原话 | layout | cells |
+|---|---|---|
+| 含"九宫格 / 9 格 / 9 张 / 清单 / N 款 / 礼物推荐 / 榜单" | **3×3** | 9 |
+| 其他(包含"四宫格 / 4 格 / 4 张" 或没指定) | **2×2** | 4 |
+
+### Step 2: Per-post init
+
+```bash
+# slug = 用户意图前 20 字内的 kebab-case
+POST_ID="$(date +%Y%m%d-%H%M)-<slug>"
+mkdir -p ~/multigrid-poster/posters/$POST_ID/cells
+cd ~/multigrid-poster/posters/$POST_ID
+```
+
+迭代("换版式 / 重抽 / 改文案")时:轻迭代沿用旧目录,重迭代新建 `{旧id}-vN`。
+
+### Step 3: 写文案
+
+agent 自己写,不调外部生成器。约束:
+- **title**:2 行 × 8-12 字 / 行(2×2 适合)或 2 行 × 6-10 字 / 行(3×3 标题挤)
+- **caption**:2 行 × 15-20 字 / 行
+- 硬禁:医疗 / 保健 / 绝对化用语(最 / 第一 / 唯一 / 100%)
+
+写到 `intent.md`:
+
+```markdown
+# Intent
+| 项目 | 值 |
+|---|---|
+| 用户原话 | <原话> |
+| layout | 2x2 / 3x3 |
+| title 行 1 | <8-12 字> |
+| title 行 2 | <8-12 字> |
+| caption 行 1 | <15-20 字> |
+| caption 行 2 | <15-20 字> |
+```
+
+展示给用户:"标题'XXX / YYY',副标题'AAA / BBB'。OK 吗?"
+- Fast-path(意图明确):告知,用户喊停才停
+- 意图模糊:必须等确认
+
+### Step 4: COST-GATE
+
+**生成前必做**(包括 Fast-path / 迭代 / 重试):
+
+> 即将生成封面(布局: 2x2 / 3x3),预计:
+> - 素材调用: N 次(2×2=4 / 3×3=9 / SKU 拉图=0)
+> - 预估耗时: ~X 分钟
+> - 预估成本: ~Y 积分
+>
+> 继续?
+
+用户说"继续 / 好" → 执行。"太贵 / 换便宜的" → 提议降级 (3×3 → 2×2,或 SKU 拉图)。不回应 → 等。
+
+### Step 5: 出图
+
+**默认走 AI 生图**。每个 cell 并行调一次:
+
+```bash
+# 2×2: cell 尺寸 621×830;3×3: cell 尺寸 414×420
+gen image "<subprompt>" -W <W> -H <H> -o ./cells/cell_<i>.png -s <seed> -f png
+```
+
+`<subprompt>` 由 agent 根据用户意图为每格独立设计(不同视角 / 不同 step / 不同场景 / 不同 SKU 等)。`<seed>` 用确定性 hash(POST_ID + cell_index),迭代复用同格 seed。
+
+**SKU 拉图模式**(用户明确说"用我店里商品图"做 listicle):
+
+```bash
+commerce product list --limit 9
+```
+
+下载到 `./cells/cell_0..8.png`。商品 < 9 → 降级 2×2 取前 4。商品 < 4 → 报错。
+
+**失败容忍**:单格生图失败 → 重试 1 次(换 seed)。两次失败 → 用 `${CLAUDE_SKILL_DIR}/scripts/placeholder.png` 占位,告知用户"第 N 格失败,先占位,要重抽直接说"。
+
+### Step 6: 合成
+
+```bash
+python3 $CLAUDE_SKILL_DIR/scripts/compose.py \
+  --layout $CLAUDE_SKILL_DIR/layouts/2x2.json \
+  --cells ./cells/cell_0.png ./cells/cell_1.png ... \
+  --title-line "<title 行 1>" \
+  --title-line "<title 行 2>" \
+  --caption-line "<caption 行 1>" \
+  --caption-line "<caption 行 2>" \
+  --output ./cover.png
+```
+
+依赖:Pillow(容器自带)。失败常见原因:
+
+| 错误 | 处理 |
+|---|---|
+| `cell 数量不对` | layout 要求 4 / 9,检查 `--cells` 参数 |
+| `font not found` | 检查 `$CLAUDE_SKILL_DIR/shared/fonts/` 完整 |
+| 中文显示方块 | 同上,字体没加载 |
+
+### Step 7: 交付
+
+写 `cost.md`,追加 `~/multigrid-poster/history.md` 一行,告知用户:
+
+> 封面在 `~/multigrid-poster/posters/<POST_ID>/cover.png`,可以下载发帖了。
+> 换版式 / 改文案 / 重抽某格直接告诉我。
+
+用户说"好 / 完美" → preferences.md `Learned` 追加一条 → commit。
+
+## 迭代
+
+| 类型 | 重跑步骤 | 新目录 | 成本 |
+|---|---|---|---|
+| 换 layout(2×2 ↔ 3×3) | 文案 → 出图 → 合成 | 是(`-vN`) | 全成本 |
+| 重抽全部 | 出图 → 合成 | 是 | 全素材 |
+| 重抽单格 N | 出图(单格) → 合成 | 否 | 1 素材 |
+| 改文案 | 合成 | 否 | 0 |
+
+**每次迭代也走 COST-GATE**,即使 0 积分。
+
+## 错误处理
+
+| 故障 | 处理 |
+|---|---|
+| `gen image` 返回 failed | 重试 1 次换 seed → 仍失败用占位图 |
+| 超配额 / 余额不足 | 告知用户,不自动降级 |
+| `commerce product list` < 9 | 降级 2×2 取前 4 |
+| 会话关闭 | 状态在文件系统 + git,下次接续 |
+
+## 相关工具
+
+- `gen image` — 文生图(详见 `gen` skill)
+- `commerce merchant get` / `commerce product list` — 商家档案 / 商品(详见 `merchant` skill 和 `product` skill)
+- `compose.py` — 本 skill 自带的 Pillow 渲染器
+
+## 流程偏好
+
+- **信息够就直接做(Fast-path)**
+- **`intent.md` 是可追溯产物**
+- **每步完成立刻 git commit**
+- **生成过程零打扰**
+- **迭代用 `-vN` 不覆盖**
+- **新会话有未完成先告知一次**

package/.claude/skills/multigrid-poster/layouts/2x2.json

@@ -0,0 +1,34 @@
+{
+  "_comment": "通用 2×2 网格布局 — 适合 4 张 cell 的所有 intent (创业故事/对比测评/教程/场景)",
+  "canvas_size": [1242, 1660],
+  "cells": {
+    "positions": [[0, 0], [621, 0], [0, 830], [621, 830]],
+    "sizes": [[621, 830], [621, 830], [621, 830], [621, 830]]
+  },
+  "text_zones": {
+    "title": {
+      "_comment": "中央偏上 2 行标题 - 8-12 字 / 行最佳",
+      "font": "shared/fonts/MaShanZheng-Regular.ttf",
+      "size": 110,
+      "color": "#FFB940",
+      "stroke_w": 8,
+      "stroke_color": "#D63D3D",
+      "lines": [
+        {"position": [621, 480], "anchor": "mm"},
+        {"position": [621, 620], "anchor": "mm"}
+      ]
+    },
+    "caption": {
+      "_comment": "底部 2 行 caption - 15-20 字 / 行最佳",
+      "font": "shared/fonts/MaShanZheng-Regular.ttf",
+      "size": 78,
+      "color": "#FFB940",
+      "stroke_w": 6,
+      "stroke_color": "#D63D3D",
+      "lines": [
+        {"position": [621, 1340], "anchor": "mm"},
+        {"position": [621, 1450], "anchor": "mm"}
+      ]
+    }
+  }
+}

package/.claude/skills/multigrid-poster/layouts/3x3.json

@@ -0,0 +1,43 @@
+{
+  "_comment": "通用 3×3 网格布局 - 适合 9 张 cell (商品清单 / 多角度展示)",
+  "canvas_size": [1242, 1660],
+  "cells": {
+    "_comment": "9 格 414×420。顶部 200px 标题区,cells y=200..1460,底部 200px caption 区。3×420 + 200×2 = 1660 = canvas_h ✓",
+    "positions": [
+      [0, 200],   [414, 200],   [828, 200],
+      [0, 620],   [414, 620],   [828, 620],
+      [0, 1040],  [414, 1040],  [828, 1040]
+    ],
+    "sizes": [
+      [414, 420], [414, 420], [414, 420],
+      [414, 420], [414, 420], [414, 420],
+      [414, 420], [414, 420], [414, 420]
+    ]
+  },
+  "text_zones": {
+    "title": {
+      "_comment": "顶部白边 2 行标题(y < 200 区间)",
+      "font": "shared/fonts/MaShanZheng-Regular.ttf",
+      "size": 78,
+      "color": "#FFB940",
+      "stroke_w": 6,
+      "stroke_color": "#D63D3D",
+      "lines": [
+        {"position": [621, 60], "anchor": "mm"},
+        {"position": [621, 150], "anchor": "mm"}
+      ]
+    },
+    "caption": {
+      "_comment": "底部白边 2 行 caption(cells 结束于 y=1460,留 200px)",
+      "font": "shared/fonts/MaShanZheng-Regular.ttf",
+      "size": 60,
+      "color": "#FFB940",
+      "stroke_w": 5,
+      "stroke_color": "#D63D3D",
+      "lines": [
+        {"position": [621, 1530], "anchor": "mm"},
+        {"position": [621, 1610], "anchor": "mm"}
+      ]
+    }
+  }
+}