¿Qué hace agy2image?
/AGY2IMAGE 无参数、help / --help / ? 或只有能力询问时，运行 python3 scripts/agy2image_runtime.py --help-panel 并原样输出动态 HELP，不询问封面、不创建任务目录。任务中输入 HELP 只展示帮助并返回原状态。references/help.md 只记录样式规范。/AGY2IMAGE STYLE、/AGY2IMAGE STYLE LIST 或“我想看所有风格列表”进入独立的开关管理流程，不路由到 IMAGE、ICON 或 EDIT。
先运行 python3 scripts/agy2image_runtime.py --self-test 确认资源可用。风格资源包是风格内容源，references/style_switches.json 是开关源；references/style_catalog.json 和 STYLE_CATALOG.html 是确定性派生物。不要向用户显示旧名称、style_id 或稳定 key。
STYLE LIST
- 列表必须显示绑定 57 套全集固定顺序的稳定序号、正式中文名称和
ON/OFF状态；关闭风格仍在 LIST 中可见。 - 用户查看后可说“关闭 02、05”或“开启【正式名称】”。内部使用
LIST ON / LIST OFF，同时支持批量序号和正式名称。 - 开关是可逆操作；目标唯一时直接执行，不二次确认。序号失效、名称歧义、目标不存在或风格尚未通过完整审计时，只报告对应错误，不部分写入。待修复风格必须保持 OFF。
- 关闭后仅从推荐池和公共 HTML 隐藏，不删除资源、Prompt、图片或验证记录。本轮不支持 STYLE ADD，也不修改已有风格。
路由
模式词不区分大小写，显式模式覆盖自动判断并保留原始需求：参考图加修改意图 → EDIT；图标、App 入口或视觉标识概念 → ICON；其余从零生图 → IMAGE。公开 MODE 和 IMAGE 七场景判断，允许自然语言纠正。
IMAGE
- 未表达封面意图时只问：
生成封面？[Y/N]。收到回复后调用python3 scripts/agy2image_runtime.py --cover-choice "用户输入"；接受Y/y/N/n，后台兼容“要/不要”；其他输入只回复请输入 Y 或 N。 - 推荐按固定顺序执行：开关过滤 → IMAGE/ICON 与封面/配图角色过滤 → 主体策略硬淘汰 → 内容结构与场景硬淘汰 → 对剩余风格排序。固定角色与用户主体冲突时必须排除，不得通过隐喻、换角色或改写 Prompt 绕过。零候选时明确报告没有合格风格，不推荐近似但冲突的风格。
- 仅从开启、审计通过、角色合格且满足结构前提的风格中推荐，最多 3 套，按真实数量展示；不得用关闭或待修复资源补数。
R仅在还有未展示候选时出现。 - 有封面先选合格配图，再搭配封面。候选列表顶部运行一次
--catalog-entry，将面板标题和完整资料库入口合并为一行。每项的组合名称只显示文本，不提供组合链接；封面行和配图行分别链接到STYLE_CATALOG.html的稳定风格锚点。不得显示内部键。 - 配置模板统一为：
方案/风格：
版型：
配图：
- 配图 1～9 张；封面固定额外 1 张；所有图片共用版型。原生比例：
1:1 / 16:9 / 9:16 / 3:2 / 2:3 / 4:3 / 3:4。非原生比例公开映射到最近值后继续。 - 模板前必须给参数与数字选项说明：方案选当前
PICK编号，或填单个【正式名称】，或填封面【正式名称】 + 配图【正式名称】；版型编号为[1] 1:1 [2] 16:9 [3] 9:16 [4] 3:2 [5] 2:3 [6] 4:3 [7] 3:4，也接受直接比例；配图填 1～9 且不包含额外封面。 - 唯一解析后回显模式、场景、风格、版型、数量和
01 …配图计划，立即调用generate_image，不增加确认。 - 已展示候选时，支持
2 16:9 1（方案/版型/配图数）；兼容2 2并只追问缺失版型。 - 推荐链接与模板不得自行手写。每套 IMAGE 候选必须传
--scene "已判定场景" --structure "步骤/层级/对比/关系/短句等真实结构" --number N --reason "与当前主题相关的一句话理由"；用户指定了人物、动物或角色时还必须传--subject "用户原始主体"。有封面再加--recommend "配图正式名" "封面正式名"；无封面只传配图名；ICON 加--zone ICON。运行时拒绝候选即表示硬边界冲突，不得绕过脚本手写推荐。全部候选结束后只调用一次--config-template cover|body|icon。
ICON
固定无封面、1 张、1:1。只从 public ICON 池推荐或解析正式中文名；不接受 IMAGE 风格。输出定位为图标或视觉标识概念，不承诺生产级 Logo、SVG、商标唯一性或品牌规范。
风格资料库
STYLE_CATALOG.html 只有一个浏览视图，只展示审计通过且开关开启的风格。不启动本地服务，不提供网页管理、单风格模式、组合浮层或查询参数路由。风格卡的“选作封面/选作配图”只更新页面底部的临时选择条；复制结果必须精确为 封面【正式名称】 + 配图【正式名称】，刷新后清空，不写入文件。
EDIT
不推荐风格。必须有明确修改意图和 1～3 张存在、可读的本地绝对路径；每次输出 1 张。第一条路径是主构图，其余是素材来源。未给版型时读取主参考图方向，选择最接近其宽高比的原生比例。连续修改默认以上次结果为新主参考图，标记 EDIT v1/v2…，不覆盖旧文件。
执行与交付
用 scripts/prompt_schema.py 渲染 Prompt；只调用宿主提供的 generate_image，不使用 HTML、截图或本地绘图库冒充生成结果。生成前必须在用户发起任务时的当前目录调用 python3 <Skill绝对路径>/scripts/agy2image_runtime.py --cwd "$PWD" --create-batch MODE "主题"，采用它返回的批次目录。每张生成前调用 --next-file "批次目录" MODE --ratio 比例（IMAGE 按需加 --cover / --index N；EDIT 版本由清单自动递增），保存返回的唯一目标路径。generate_image 返回真实 Artifact 源文件后，必须调用 --materialize "源文件" "目标路径"；不得手写 cp、自行拼接目标或覆盖路径。生成失败时调用 --mark-failed "目标路径" "原因"。最终只给已物化的命名文件链接和批次目录链接；失败时保留清单与已完成文件，可只重试失败序号。