asc-app-shots

asc-app-shots 是 App Store 截图设计器，围绕三条工作流组织：A 模板式、B 图集模板式、C 主题化。整体流程为「浏览 → 套用 → 生成」，图集模板可一次性覆盖全部屏幕，模板可结合 ThemeDesign 后套用。截图形式支持单屏、多屏（hero + features）以及逐页（per-slide）。AI 使用是可选的（Gemini 增强），主题化流程中仅设计阶段调用 1 次 AI，其余步骤为确定性处理。

工作流 A — 单模板浏览模板、套用到截图，可选使用 Gemini AI 增强。

第 1 步 — 浏览并套用：

asc app-shots templates list --output table
asc app-shots templates get --id top-hero --preview > preview.html && open preview.html

# 套用到截图 → HTML 预览
asc app-shots templates apply \
  --id top-hero --screenshot screen.png --headline "Ship Faster" \
  --preview html > composed.html && open composed.html

# 套用到截图 → PNG 导出
asc app-shots templates apply \
  --id top-hero --screenshot screen.png --headline "Ship Faster" \
  --preview image --image-output marketing.png

第 2 步 — 使用 Gemini AI 增强（可选）：

asc app-shots generate --file marketing.png
asc app-shots generate --file marketing.png --device-type APP_IPHONE_67
asc app-shots generate --file marketing.png --style-reference inspiration.png
asc app-shots generate --file marketing.png --prompt "warmer colors, deeper shadows"

工作流 B — 图集模板协调的多屏套图（hero + 功能屏）。

# 浏览图集模板
asc app-shots gallery-templates list --output table

# 以横向长条预览所有屏幕
asc app-shots gallery-templates get --id neon-pop --preview > gallery.html && open gallery.html

# 获取图集详情（含 shots、template、palette 的 JSON）
asc app-shots gallery-templates get --id neon-pop --pretty

图集模板自带示例内容（标题、徽章、信任标识），可直接自定义。

工作流 C — 主题化截图在模板之上套用视觉主题。两步流程：先一次性生成 ThemeDesign（1 次 AI 调用），再确定性地套用到任意数量截图。

第 1 步 — 浏览主题：

asc app-shots themes list --output table
# → Cartoon, Joyful, Holiday, Zen, Neon, Nature, Retro, Space, Luxury

asc app-shots themes get --id luxury --pretty
asc app-shots themes get --id luxury --context   # AI 提示词字符串

第 2 步 — 生成 ThemeDesign（1 次 AI 调用，可复用）：

asc app-shots themes design --id luxury > design.json

返回包含调色板（background + textColor）与装饰元素（带动画的浮动元素）的 JSON。

第 3 步 — 套用 ThemeDesign（确定性，不用 AI）：

# HTML 预览
asc app-shots themes apply-design \
  --design design.json --template top-hero \
  --screenshot screen.png --headline "Ship Faster" \
  --preview html > themed.html

# PNG 导出
asc app-shots themes apply-design \
  --design design.json --template top-hero \
  --screenshot screen.png --headline "Ship Faster" \
  --preview image --image-output themed.png

备选：全 AI 重绘（回退方案）

asc app-shots themes apply \
  --theme luxury --template top-hero \
  --screenshot screen.png --headline "Ship Faster"

逐页 AI 重绘速度较慢但更具创意。当 design 不可用时回退到此方式。

命令参考完整参数表见 references/commands.md。

模板

asc app-shots templates list [--size portrait] [--preview] [--output table]
asc app-shots templates get --id <ID> [--preview]
asc app-shots templates apply --id <ID> --screenshot <FILE> --headline <TEXT> [--preview html|image]

图集模板

asc app-shots gallery-templates list [--output table]
asc app-shots gallery-templates get --id <ID> [--preview]

主题

asc app-shots themes list [--output table]
asc app-shots themes get --id <ID> [--context]
asc app-shots themes design --id <ID>
asc app-shots themes apply-design --design <FILE> --template <ID> --screenshot <FILE> --headline <TEXT>
asc app-shots themes apply --theme <ID> --template <ID> --screenshot <FILE> --headline <TEXT>

生成（Gemini AI）

asc app-shots generate --file <FILE> [--device-type <TYPE>] [--style-reference <FILE>] [--prompt <TEXT>]

导出与配置

asc app-shots export --html <FILE> --output <PNG>
asc app-shots config --gemini-api-key <KEY>

可用模板

按类别划分：

Bold：Top Hero、Bold CTA、Tilted Hero
Minimal：Minimal Light、Device Only
Elegant：Dark Premium、Sage Editorial、Cream Serif、Ocean Calm、Blush Editorial
Professional：Top & Bottom、Left Aligned、Bottom Text
Playful：Warm Sunset、Sky Soft、Cartoon Peach、Cartoon Mint、Cartoon Lavender
Showcase：Duo Devices (2)、Triple Fan (3)、Side by Side (2)

可用主题

Cartoon：粗描边、明亮纯色、俏皮形状
Joyful：彩纸、闪光、暖色渐变
Holiday：节日装饰、雪花
Zen：平静、极简、飘落的叶子
Neon：深色背景、发光霓虹点缀
Nature：有机形状、花瓣、水彩
Retro：复古调色板、几何、80/90 年代风
Space：宇宙背景、闪烁星星
Luxury：金色点缀、深色背景、优雅

Gemini API Key 解析顺序

--gemini-api-key 参数
$GEMINI_API_KEY 环境变量
~/.asc/app-shots-config.json（通过 asc app-shots config 设置）

设备尺寸

APP_IPHONE_69：1320 × 2868（必需）
APP_IPHONE_67：1290 × 2796（必需）
APP_IPHONE_65：1260 × 2736（必需）
APP_IPAD_PRO_129：2048 × 2732（必需）

限制与未提供信息：资料未说明该工具的价格、收费模式、具体平台依赖、性能指标与隐私处理方式，暂未提供。

技能介绍