cosercard-skill

Coser 模卡生成器 - 快速制作专业的 Cosplay/模特展示卡片

🚀 推荐工作流（最快拿到满意的模卡）

第一步：批量预览，挑选风格 -b

传入照片后，先跑批量预览，一次对比 6 种模板+风格组合：

cd skills/coser-card/scripts
python coser_card.py --photos "photos/*.jpg" --name "你的CN" -b

终端输出示例：

🔍 照片分析结果:
   构成: 4张竖图 / 1张横图 / 1张方图
   推荐模板: magazine  推荐风格: anime

🎬 正在批量生成 6 种预览组合...
  ✓ #1 magazine + anime
  ✓ #2 sidebar + elegant
  ✓ #3 wide + cyber
  ...

组合对照表:
  #1  --template magazine --style anime
  #2  --template sidebar --style elegant
  #3  --template wide --style cyber
  ...

预览图每格左上角标 #编号，底部标明模板+风格，保存在 ./output/。

第二步：选中满意的，出全尺寸

比如看中了 #2：

python coser_card.py --photos "photos/*.jpg" --name "你的CN" \
    --template sidebar --style elegant

🤖 全自动模式

完全自动（最省事）

让程序自动分析照片比例和色调，选最合适的模板和风格：

python coser_card.py --photos "photos/*.jpg" --name "你的CN" \
    --template auto --style auto

终端输出示例：

🎨 自动识别风格: anime (二次元风)
📐 自动选择模板: magazine  (照片构成: 4竖/1横/1方)

快速模式 -q（读历史数据）

根据你过去用得最多的配置自动选，不用手动指定：

python coser_card.py --photos "photos/*.jpg" --name "你的CN" -q

📋 其他使用方式

交互式输入（引导填写）

python coser_card.py -i

完整命令行

python coser_card.py \
    --photos "photos/*.jpg" \
    --name "黑皮" \
    --height 160 --weight 45 --bust 34 --waist 54 --hip 63 --shoe 34 \
    --douyin "10w粉丝" \
    --location "东京" \
    --template wide \
    --style anime \
    --formats wide

🎨 可填写的信息

基本信息（必填）

身体数据（可选）

社交账号（可选）

联系方式（可选）

📐 模板类型

自动模板选择逻辑（--template auto）

🎭 风格模板

自动风格识别逻辑（--style auto）

程序用 PIL 对照片做主色调量化（无需额外依赖），分析色温（冷/暖/中）+ 亮度 + 饱和度，按以下规则决定：

整体暗 + 冷色  →  cyber
整体暗 + 其他  →  anime
低饱和 + 亮    →  minimal
低饱和 + 暗    →  elegant
暖色 + 高饱和  →  retro
暖色 + 低饱和  →  japanese
冷色为主       →  cyber
其他混合       →  colorful

📏 输出格式

💡 智能功能说明

照片比例分析（v1.2 新增）

analyze_photos() 自动统计照片构成：

portrait  = 宽高比 < 0.82  （竖图）
landscape = 宽高比 > 1.25  （横图）
square    = 其余            （方图）

结果影响 --template auto 的选择。

主色调自动风格匹配（v1.2 新增）

auto_style_from_photos() 纯 PIL 实现，无需安装 sklearn。分析步骤：

1. 将照片缩至 80×80
2. PIL 调色板量化提取 4 种主色
3. 计算色温（冷/暖/中）和感知亮度、饱和度
4. 按决策树选择最匹配的风格

批量预览（v1.1 新增）

-b 模式一次生成 6 种组合的缩略图拼在一张对比图里，每格标注编号和配置名，底部打印对照命令，看图即可决策。

智能图片裁剪

smart_crop() 优先保留图片上半部分（人脸区域在上方），避免人脸被裁掉。

自适应字体

文字太长时自动缩小字体，不截断不遮挡。

学习系统

每次生成自动记录配置到 learning_data.json，-q 快速模式读取历史频率最高的组合作为默认。

📝 完整命令行参数

--photos          照片路径（支持通配符 *.jpg）
--name            CN名称（必填）
--cn              英文名/罗马音
--height          身高 cm
--weight          体重 kg
--bust            胸围 cm
--waist           腰围 cm
--hip             臀围 cm
--shoe            鞋码
--douyin          抖音账号/粉丝数
--weibo           微博账号
--bilibili        B站账号
--xiaohongshu     小红书账号
--contact         联系方式
--location        所在城市
--template        排版模板（默认: grid4，支持 auto）
--style           风格模板（默认: minimal，支持 auto）
--formats         输出格式（默认: mobile）
--output          输出目录（默认: ./output）
--interactive, -i 交互式输入
--batch-preview, -b  批量生成6种组合预览图（推荐首次使用）
--quick, -q       快速模式：自动用历史最优配置
--watermark       添加水印
--demo            生成演示图片

📚 使用示例

示例 1：最快工作流

# 先看预览
python coser_card.py --photos "photos/*.jpg" --name "黑皮" -b

# 选中满意的出图
python coser_card.py --photos "photos/*.jpg" --name "黑皮" \
    --template magazine --style anime --formats wide

示例 2：完全自动

python coser_card.py --photos "photos/*.jpg" --name "黑皮" \
    --template auto --style auto --formats wide

示例 3：完整信息 + 多格式

python coser_card.py \
    --photos "D:\cosplay\*.jpg" \
    --name "赤西夜夜" --cn "Akane" \
    --height 168 --weight 50 --bust 86 --waist 62 --hip 88 --shoe 37 \
    --douyin "100w粉丝" --location "东京" \
    --template magazine --style auto \
    --formats wide,mobile

示例 4：打印版

python coser_card.py \
    --photos "highres*.jpg" \
    --name "CN名称" --height 170 --weight 53 \
    --template grid4 --style minimal --formats a4

📁 文件说明

coser-card/
├── SKILL.md                    # 本文档
├── README.md                   # 项目说明
├── requirements.txt            # 依赖：Pillow
├── learning_data.json          # 学习数据库（自动生成）
├── examples/
│   └── output/                 # 示例输出
└── scripts/
    └── coser_card.py           # 主程序

⚙️ 安装依赖

pip install Pillow

无需安装 sklearn、dlib、face_recognition 等重型依赖。

🤖 系统提示（AI Agent 使用）

当用户使用此 Skill 时，推荐按以下流程引导：

引导用户提供信息

你好！我来帮你制作 Coser 模卡。

请提供以下信息（不想填的可以直接回车跳过）：

【基本信息】
- CN名称: （如：赤西夜夜）
- 英文名/罗马音: （可选）

【身体数据】（可选）
- 身高/体重/三围/鞋码

【社交账号】（可选）
- 抖音/微博/B站/小红书

【联系方式】（可选）
- 微信/QQ/邮箱、所在城市

【照片】
- 照片路径: （支持通配符，如：D:\photos\*.jpg）

首次使用，推荐批量预览

建议先跑批量预览看效果：

python coser_card.py --photos "路径" --name "CN" -b

会生成一张包含 6 种组合的对比图，你选一个满意的再出全尺寸。

若用户图省事，推荐全自动

python coser_card.py --photos "路径" --name "CN" --template auto --style auto

程序会自动分析照片比例和色调，选最合适的组合。

保存用户偏好

当用户告知最佳配置后，调用：

from coser_card import mark_as_best
mark_as_best(profile, template, style, format_type)

下次使用 -q 快速模式时会自动使用该配置。

Changelog

v1.2 (2026-03-23)

• 新增 magazine 杂志风黄金比例布局模板
• 新增 --template auto 根据照片比例构成自动选模板
• 新增 --style auto 根据照片主色调自动匹配风格（纯PIL，无额外依赖）
• 新增 analyze_photos() 照片比例分析模块
• 新增 auto_style_from_photos() 色调分析模块
• -b 批量预览增加照片分析摘要输出，magazine 进入候选优先位
• 修复 smart_select_template() 现在接受照片分析结果，更准确

v1.1 (2026-03-23)

• 新增 -b / --batch-preview 批量预览模式
• 新增 -q / --quick 快速模式
• 修复 verify_card 函数逻辑错误

v1.0 (2026-03-23)

• 初始版本

版本: v1.2
更新日期: 2026-03-23
功能: 12种模板（含auto）、8种风格（含auto）、6种格式、批量预览、色调自动匹配、纯PIL无重型依赖