Id Photo Maker

• 询问尺寸、底色、构图范围。
• 确认是否需要 AI 生图。对纯文字输入，通常答案是“需要”。
• 如需 Liblib，检查 AK / SK；缺失就向用户要，并询问是否保存到本地。
• 将中文需求整理为简洁英文 prompt，再运行：
  • scripts/generate_via_liblib.py text2img ...
• 生图完成后，再运行：
  • scripts/process_local_photo.py ...
  • scripts/render_print_sheet.py ...

Prompt construction rules for Liblib

• Liblib 的 prompt 使用纯英文。
• 先保留用户的真实意图，再转成简洁英文，不要塞太多花哨画风词。
• 对证件照场景，默认强调：
  • clean studio lighting
  • front-facing person
  • realistic face
  • formal ID photo
  • centered composition
  • plain background
  • high detail
  • no watermark
• 如果用户给了参考图或想保持姿态 / 构图，再按需加：
  • controlType: depth | pose | line | IPAdapter
  • controlImage: <public URL>

Credential handling

• 只在需要调用 Liblib 时才检查凭证。
• 优先从以下位置读取：
  1. 命令行参数
  2. ~/.copilot/skills/id-photo-maker/.env.local
  3. 当前 shell 环境变量
• 如果仍缺失：
  • 向用户索要 AccessKey 与 SecretKey
  • 只有在用户明确同意时，才以 LIBLIB_ACCESS_KEY=... / LIBLIB_SECRET_KEY=... 的形式写入 .env.local
• 不要在普通输出里回显 SecretKey。

Recommended commands

如果 skill 目录有 .venv/bin/python，优先用它；否则用 python3。

文生图

python3 ~/.copilot/skills/id-photo-maker/scripts/generate_via_liblib.py \
  text2img \
  --prompt "front-facing young woman, formal chinese id photo, clean studio light, realistic face, centered composition, plain background, high detail, no watermark" \
  --aspect-ratio portrait \
  --output-dir /tmp/id-photo-run/generated

图生图

python3 ~/.copilot/skills/id-photo-maker/scripts/generate_via_liblib.py \
  img2img \
  --prompt "formal id photo, realistic face, centered composition, clean studio light, no watermark" \
  --source-image-url "https://example.com/reference.png" \
  --output-dir /tmp/id-photo-run/generated

照片处理

python3 ~/.copilot/skills/id-photo-maker/scripts/process_local_photo.py \
  /tmp/id-photo-run/generated/liblib-1.png \
  --size 1寸 \
  --background white \
  --framing standard \
  --output-dir /tmp/id-photo-run/processed

打印排版

python3 ~/.copilot/skills/id-photo-maker/scripts/render_print_sheet.py \
  --photo /tmp/id-photo-run/processed/id-photo.png \
  --size 1寸 \
  --pages a4,6inch \
  --output-dir /tmp/id-photo-run/print

Output expectations

默认交付：

• id-photo.png：标准尺寸成片
• metadata.json：尺寸、背景、构图、来源与导出信息
• print-a4.html
• print-6inch.html
• index.html：打印页入口

Resources in this skill

• scripts/id_photo_common.py - shared size presets, color parsing, and download helpers
• scripts/credential_store.py - .env.local credential read/write
• scripts/liblib_client.py - Liblib API signing, request, polling, and download
• scripts/generate_via_liblib.py - CLI for text2img / img2img
• scripts/process_local_photo.py - local / URL photo processing, background replacement, and export
• scripts/render_print_sheet.py - A4 / 6寸 printable HTML sheet generation
• references/size-presets.md - supported presets and physical dimensions
• references/workflow-rules.md - routing, prompt, and questioning rules
• references/liblib-auth.md - AK/SK signing model and request rules
• assets/print.css - print-safe stylesheet
• requirements.txt - Python dependencies