@optima-chat/optima-agent 0.9.7 → 0.9.8

package/.claude/skills/merchant/SKILL.md

@@ -1,110 +1,110 @@
----
-name: merchant
-description: "店铺基础信息管理。使用场景：查看店铺信息、更新店铺名称/描述/联系方式/发货地址。注意：运费设置用 shipping skill。"
----
-
-# 店铺管理
-
-## 典型场景
-
-| 用户说 | 命令 |
-|--------|------|
-| "查看店铺信息" / "我的店铺" | `commerce merchant info` |
-| "修改店铺名称" / "更新店铺描述" | `commerce merchant update --name/--description` |
-| "设置联系方式" | `commerce merchant update --contact-*` |
-| "更新发货地址" | `commerce merchant update --origin-*` |
-| "设置品牌色" / "修改主题色" / "换个颜色" | `commerce merchant update --primary-color "#1a3a5c"` |
-
-## 不在此模块（重要）
-
-| 用户说 | 正确位置 |
-|--------|----------|
-| "运费设置" / "运费模式" / "运费区域" | **shipping skill**：`commerce shipping get-mode` |
-| "Easyship" / "快递公司" | **shipping skill**：`commerce easyship couriers` |
-| "Stripe/支付设置" | `commerce stripe status` |
-| "首页设置" | **homepage skill** |
-
----
-
-## 查看店铺信息
-
-```bash
-commerce merchant info
-```
-
-返回：店铺名称、描述、Logo、货币、联系信息、发货地址
-
-**注意**：此命令不返回运费设置，运费相关请用 `commerce shipping get-mode`
-
----
-
-## 更新店铺信息
-
-```bash
-commerce merchant update [选项]
-```
-
-### 基础信息
-| 选项 | 说明 |
-|------|------|
-| `--name` | 店铺名称 |
-| `--slug` | 店铺标识（影响 URL） |
-| `--description` | 店铺描述 |
-| `--default-currency` | 默认货币（USD, CNY 等） |
-| `--google-ads-customer-id` | Google Ads 客户 ID（10位数字） |
-| `--primary-color` | 品牌主色（hex 格式，如 #FF5A5F） |
-
-### 联系方式
-| 选项 | 说明 |
-|------|------|
-| `--contact-name` | 联系人 |
-| `--contact-phone` | 联系电话 |
-| `--contact-email` | 联系邮箱 |
-| `--company-name` | 公司名称 |
-
-### 发货地址
-| 选项 | 说明 |
-|------|------|
-| `--origin-country-alpha2` | 国家代码（CN, US 等） |
-| `--origin-city` | 城市 |
-| `--origin-postal-code` | 邮编 |
-| `--origin-line-1` | 地址行1 |
-| `--origin-line-2` | 地址行2 |
-| `--origin-state` | 省/州 |
-
----
-
-## 示例
-
-```bash
-# 更新名称和描述
-commerce merchant update --name "我的小店" --description "精选好物"
-
-# 更新联系方式
-commerce merchant update \
-  --contact-name "张三" \
-  --contact-phone "13800138000" \
-  --contact-email "shop@example.com"
-
-# 更新发货地址
-commerce merchant update \
-  --origin-country-alpha2 CN \
-  --origin-city 深圳 \
-  --origin-postal-code 518000 \
-  --origin-line-1 "科技园路1号" \
-  --origin-state 广东
-
-# 设置品牌色
-commerce merchant update --primary-color "#1a3a5c"
-```
-
----
-
-## 命令参考
-
-- `commerce merchant info` - 查看店铺信息
-- `commerce merchant update` - 更新店铺信息
-
-## 不确定用什么命令？
-
-运行 `commerce --help` 查看所有模块，或 `commerce merchant --help` 查看子命令。
+---
+name: merchant
+description: "店铺基础信息管理。使用场景：查看店铺信息、更新店铺名称/描述/联系方式/发货地址。注意：运费设置用 shipping skill。"
+---
+
+# 店铺管理
+
+## 典型场景
+
+| 用户说 | 命令 |
+|--------|------|
+| "查看店铺信息" / "我的店铺" | `commerce merchant info` |
+| "修改店铺名称" / "更新店铺描述" | `commerce merchant update --name/--description` |
+| "设置联系方式" | `commerce merchant update --contact-*` |
+| "更新发货地址" | `commerce merchant update --origin-*` |
+| "设置品牌色" / "修改主题色" / "换个颜色" | `commerce merchant update --primary-color "#1a3a5c"` |
+
+## 不在此模块（重要）
+
+| 用户说 | 正确位置 |
+|--------|----------|
+| "运费设置" / "运费模式" / "运费区域" | **shipping skill**：`commerce shipping get-mode` |
+| "Easyship" / "快递公司" | **shipping skill**：`commerce easyship couriers` |
+| "Stripe/支付设置" | `commerce stripe status` |
+| "首页设置" | **homepage skill** |
+
+---
+
+## 查看店铺信息
+
+```bash
+commerce merchant info
+```
+
+返回：店铺名称、描述、Logo、货币、联系信息、发货地址
+
+**注意**：此命令不返回运费设置，运费相关请用 `commerce shipping get-mode`
+
+---
+
+## 更新店铺信息
+
+```bash
+commerce merchant update [选项]
+```
+
+### 基础信息
+| 选项 | 说明 |
+|------|------|
+| `--name` | 店铺名称 |
+| `--slug` | 店铺标识（影响 URL） |
+| `--description` | 店铺描述 |
+| `--default-currency` | 默认货币（USD, CNY 等） |
+| `--google-ads-customer-id` | Google Ads 客户 ID（10位数字） |
+| `--primary-color` | 品牌主色（hex 格式，如 #FF5A5F） |
+
+### 联系方式
+| 选项 | 说明 |
+|------|------|
+| `--contact-name` | 联系人 |
+| `--contact-phone` | 联系电话 |
+| `--contact-email` | 联系邮箱 |
+| `--company-name` | 公司名称 |
+
+### 发货地址
+| 选项 | 说明 |
+|------|------|
+| `--origin-country-alpha2` | 国家代码（CN, US 等） |
+| `--origin-city` | 城市 |
+| `--origin-postal-code` | 邮编 |
+| `--origin-line-1` | 地址行1 |
+| `--origin-line-2` | 地址行2 |
+| `--origin-state` | 省/州 |
+
+---
+
+## 示例
+
+```bash
+# 更新名称和描述
+commerce merchant update --name "我的小店" --description "精选好物"
+
+# 更新联系方式
+commerce merchant update \
+  --contact-name "张三" \
+  --contact-phone "13800138000" \
+  --contact-email "shop@example.com"
+
+# 更新发货地址
+commerce merchant update \
+  --origin-country-alpha2 CN \
+  --origin-city 深圳 \
+  --origin-postal-code 518000 \
+  --origin-line-1 "科技园路1号" \
+  --origin-state 广东
+
+# 设置品牌色
+commerce merchant update --primary-color "#1a3a5c"
+```
+
+---
+
+## 命令参考
+
+- `commerce merchant info` - 查看店铺信息
+- `commerce merchant update` - 更新店铺信息
+
+## 不确定用什么命令？
+
+运行 `commerce --help` 查看所有模块，或 `commerce merchant --help` 查看子命令。

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

@@ -0,0 +1,192 @@
+---
+name: multigrid-poster
+description: "为商家生成小红书 2×2 四宫格 / 3×3 九宫格封面图。触发场景:做小红书封面 / 小红书首图 / 种草帖封面 / 爆款封面 / 四宫格 / 九宫格。一句话指令产出 1242×1660 成片,支持自然语言迭代(换版式 / 重抽某格 / 改文案)。本 skill 只生成封面图,搜索小红书笔记 / 分析博主请用 'xhs' skill。"
+---
+
+# 小红书多宫格封面生成
+
+帮电商商家用 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"}
+      ]
+    }
+  }
+}

package/.claude/skills/multigrid-poster/scripts/compose.py

@@ -0,0 +1,116 @@
+#!/usr/bin/env python3
+"""multigrid-poster compose — Pillow 版渲染器
+
+输入：layout.json + N 张 cell 图片 + 标题文字 + caption 文字
+输出：1242×1660 PNG（小红书封面标准）
+
+用法：
+  python compose.py \
+    --layout <SKILL_DIR>/layouts/2x2.json \
+    --cells cell_0.png cell_1.png cell_2.png cell_3.png \
+    --title-line "26岁一个人创业" \
+    --title-line "跨境电商月入10w+" \
+    --caption-line "只需要一部手机就可以完成！" \
+    --caption-line "跨境人的必备app推荐" \
+    --output cover.png
+
+依赖：Pillow (容器自带，无需额外安装)
+字体：从 SKILL_DIR/shared/fonts/ 加载（layout.json 里指定）
+"""
+import argparse
+import json
+import sys
+from pathlib import Path
+from PIL import Image, ImageDraw, ImageFont
+
+
+def compose(layout_path: Path, cell_paths: list[Path],
+            title_lines: list[str], caption_lines: list[str],
+            output_path: Path) -> Path:
+    """根据 layout.json 渲染海报。
+
+    layout.json 字段：
+      canvas_size       [w, h]
+      cells.positions   [[x,y], ...] cell 左上角
+      cells.sizes       [[w,h], ...] cell 尺寸
+      text_zones.title  {lines: [...], size, color, stroke_w, stroke_color, font}
+      text_zones.caption {同上}
+    """
+    layout = json.loads(layout_path.read_text(encoding="utf-8"))
+    # 约定:layout 必须放在 <skill>/layouts/ 下,字体路径相对 <skill>/ 解析
+    skill_dir = layout_path.parent.parent
+
+    # 文本行数 vs layout 配置行数:行多了 zip 会静默截断,显式 fail-fast
+    # 错误信息用英文 — sys.exit 走 stderr,Windows GBK locale 下中文会乱码
+    for zone_key, lines in [("title", title_lines), ("caption", caption_lines)]:
+        zone = layout.get("text_zones", {}).get(zone_key)
+        if not zone:
+            continue
+        max_lines = len(zone["lines"])
+        if len(lines) > max_lines:
+            sys.exit(f"too many {zone_key} lines: got {len(lines)}, layout supports {max_lines}")
+
+    # Canvas
+    canvas = Image.new("RGB", tuple(layout["canvas_size"]), "white")
+
+    # Cells
+    cell_count = len(layout["cells"]["positions"])
+    if len(cell_paths) != cell_count:
+        sys.exit(f"cell count mismatch: layout expects {cell_count}, got {len(cell_paths)}")
+    for cp, pos, size in zip(cell_paths,
+                              layout["cells"]["positions"],
+                              layout["cells"]["sizes"]):
+        img = Image.open(cp).convert("RGB").resize(tuple(size), Image.LANCZOS)
+        canvas.paste(img, tuple(pos))
+
+    draw = ImageDraw.Draw(canvas)
+
+    # Text zones (title + caption 通用绘制)
+    for zone_key, lines in [("title", title_lines), ("caption", caption_lines)]:
+        if zone_key not in layout["text_zones"]:
+            continue
+        zone = layout["text_zones"][zone_key]
+        font_path = skill_dir / zone["font"]
+        font = ImageFont.truetype(str(font_path), zone["size"])
+        for text, line_cfg in zip(lines, zone["lines"]):
+            if not text:
+                continue
+            draw.text(
+                tuple(line_cfg["position"]), text,
+                fill=zone["color"], font=font,
+                stroke_width=zone.get("stroke_w", 0),
+                stroke_fill=zone.get("stroke_color", zone["color"]),
+                anchor=line_cfg.get("anchor", "la"),
+            )
+
+    canvas.save(output_path, optimize=True)
+    return output_path
+
+
+def main():
+    ap = argparse.ArgumentParser(description=__doc__,
+                                  formatter_class=argparse.RawDescriptionHelpFormatter)
+    ap.add_argument("--layout", required=True, type=Path,
+                    help="layout.json 路径（如 SKILL_DIR/layouts/2x2.json）")
+    ap.add_argument("--cells", required=True, nargs="+", type=Path,
+                    help="N 张 cell 图片路径，顺序对应 layout.cells.positions")
+    ap.add_argument("--title-line", action="append", default=[],
+                    help="标题行（可重复）")
+    ap.add_argument("--caption-line", action="append", default=[],
+                    help="底部 caption 行（可重复）")
+    ap.add_argument("--output", required=True, type=Path,
+                    help="输出 PNG 路径")
+    args = ap.parse_args()
+
+    out = compose(
+        layout_path=args.layout,
+        cell_paths=args.cells,
+        title_lines=args.title_line,
+        caption_lines=args.caption_line,
+        output_path=args.output,
+    )
+    print(f"saved {out} ({out.stat().st_size // 1024} KB)")
+
+
+if __name__ == "__main__":
+    main()