列出三个模型家族及已有2k/4k变体（共7个标识）、API格式、目录与限制；不联网、不返回密钥。

免费生成可审阅的主图/详情页/场景/海报绘图计划。

scene: main 主图；detail 详情模块；scene 家居场景；poster 营销海报。 selling_points: 已核实事实，可为空列表；不自动编造商品信息。 count: 图片项数，详情页推荐 6 项；比例由用户决定。 reference_images: 原样传入计划，真正出图前才读取/下载并校验。 resolution: 可选显式 width/height 像素尺寸，原样传入每项用于模型路由。

批量登记1–20个后台图像任务并立即返回，不等待绘图/下载（会在后台收费）。

每项task_id在checkpointer/thread_id内唯一且稳定，同内容复用；任何冲突全批不新增。 每项可选model/api_format(auto)/endpoint(auto)；变体按显式resolution路由。 Flash-lite仅Gemini/Chat；nano-banana-pro仅DALL·E；gemini-nano仅DALL·E Generations/Gemini/Chat。 查询get_image_tasks；queued/preparing/running是正常状态，unknown不能盲目重交。 MCP进程关闭时未发送任务可在重启后继续，已可能发送任务不自动重试。

同步生成/编辑1–20项（会收费）：等待本组全部终态且成功图片落盘后返回。

任务参数与submit_image_tasks相同，支持同样的模型、比例和本机/URL参考图。 与异步入口共用三元组、防重、队列和并发限额；相同任务不重复提交。 wait_timeout_seconds默认600，严格整数1–1200，包含排队时间。 全部成功才isError=false；失败保留所有结果。等待到期返回isError=true、 wait_timed_out=true及当前状态，不取消后台任务。Host超时/取消也不保证停止上游。 请保留原三元组，用get_image_tasks查询或wait_image_tasks继续等，不换编号重交。

等待1–100个已有任务，不提交、不重新出图；所有指定任务终态后返回结果。

task_ids必填且不重复；不存在或错误命名空间报错。 等待时限默认600秒，严格整数1–1200；到期isError=true、wait_timed_out=true， 保留当前状态和已完成图片，后台继续。客户端取消只停止本次等待。 终态failed/unknown/cancelled是isError；查询get_image_tasks不等待。

按原幂等键重排1–20项安全阶段；不会重发结果不明的收费请求。

safe_to_retry表示存在原响应可恢复，或确定未发送；成功/进行中的项直接复用。 有响应时只重新下载/落盘；连接前失败可按同一供应商Idempotency-Key重试。 文件校验失败需repair_files=True，保留损坏文件后从原响应修复，绝不重画修复。 任一不安全项使本批全不重排；POST已可能发送且无检查点时先核对费用，禁止换ID盲目重提。

查询持久任务与图片绝对路径，不重新提交上游。可按task_ids筛选或用next_cursor分页。

queued/preparing/running正常返回；failed/unknown/cancelled返回isError并保留全部状态。 checkpointer是本地SQLite字符串命名空间，不是路径、LangGraph对象或认证凭据。

取消指定任务；queued/preparing不发图，running只停止本地等待并标unknown，不保证远端停止/退款。

读取已登记批次及保存路径，不调用上游、不重发请求；未完成/失败返回 isError。

免费读取1–4张产品图/对标图并以MCP图片内容交给Host观察，不调用视觉或绘图模型。

输入本机绝对路径或公开图片直链；沿用格式/大小/公网URL检查，不抓网页。 Host应记录可见外形、配色、比例、布局；不得从图推断性能参数或照搬竞品事实。

免费保存主图/详情页/SKU设计底稿；按需求→参考→文案与排版研讨推进，不出图。

新建expected_revision=0，修改须传当前revision、完整brief和可选逐图edits；每次产生新版本，需重新确认。 先查看产品实图，填写visual_observations和有source的已核实facts；对标填写benchmarks， 或向用户索取参考，或记录用户明确不用参考的理由。缺信息返回needs_input和questions。 main默认5张、detail默认10屏、sku一版本一图且需各自实图。尺寸/比例按平台与用户确认，非自动合规。 返回逐图标题、正文、事实引用、主体与排版；先展示用户研讨，不得把底稿视为批准。

仅在用户明确确认当前商品事实、逐图文案与排版后记录方案确认；不收费、不提交。

必须传本次展示的revision/digest及用户确认说明，user_confirmed=True；旧稿/缺信息拒绝。 Host不能自行替用户确认，任何改稿须再次展示并确认。收费授权另在提交时提供。

将已确认方案中明确选择的1–20图提交后台收费绘图；需用户明确收费授权。

所有图使用批准版本的商品图副本、文案、排版和模型；当前revision/digest必须匹配。 固定映射checkpointer=ecommerce-design、thread_id=design_id、task_id=r{revision}-{panel_id}， 可分批提交超过20图的方案；重复同图复用原任务，不新增收费请求。 用get_ecommerce_design获取落盘路径；wait_image_tasks等待原任务。失败/超时勿换设计编号重提。

只读查询当前/历史版本、待补信息、未提交图片及已有任务/图片绝对路径，不重新出图。

已落盘结果包含尺寸、字节数、SHA256；失败/unknown/cancelled返回isError并保留所有结果。 没有任务或queued/running不代表设计已完成。继续等待/取消用返回的原队列三元组。

免费保存Agent完成的竞品拆解、跨类目适配与目标frames；不代替Agent识图，不出图。

新方案优先build_reference_replica_prompts，以共享风格保持同款图组统一；本工具兼容旧replica。

先inspect_design_images查看参考和商品；分析风格/构图/光色/细节/互动/文案/信息顺序， 给出源/目标类目及保留/适配/替换/舍弃理由。frames是Agent写出的完整目标控制结构， 不自动复制源文案。open_questions使方案needs_input，阻止确认/出图。 每项图1仅风格，图2+为商品；商品事实只能引用brief.facts，SKU须明确绑定本版本。 frames决定图片数，支持单张详情图。brief.replica可省略，由独立replica参数给出。 修改传当前expected_revision、完整brief/replica；旧确认失效。 下一步export_reference_replica展示完整提示→confirm_ecommerce_design→授权后submit_ecommerce_design。 Resource nanobanana://reference-replication 和Prompt reference_replication_brief说明完整循环。

免费导出1–20项完整可执行Markdown和附图顺序，用于研讨并适配本服务三个模型；不提交、不批准。

严格保留Visual Schema/Scene Configuration/Layout Configuration/Textual Contents， 可选Logical Structure，实际提交共用相同编译器。input_images必须按角色顺序附上。 prompt_target/execution_model均按本服务实际模型及分辨率选档；api_format/endpoint展示真实接口。 实际出图后用inspect_design_images查看结果、review_reference_replica记录证据，再由用户决定停止或修订。

保存Host Agent观察真实出图后的六维复核，不是服务器识图评分，也不自动重新出图。

新reference_replica同时核对共享style及已观察的同组其他图片，证据写入style_fidelity。

先get_ecommerce_design取路径/hash，再inspect_design_images看图；与参考/商品逐项比较： 产品忠实度、风格、目标类目、布局光感、实际文字、事实。每项需具体证据，revise/uncertain需修正动作。 校验图片属于本设计版本任务且当前文件哈希相同。结果和next_steps可从get_ecommerce_design读取。 agent_passed仍需向用户展示验收；修改后重新plan/confirm/授权，不能自动换ID重画。

免费构造同一商品主图+详情+SKU整套绘图提示词，Pydantic校验后保存新版本；不收费出图。

先读nanobanana://templates/product-suite和styles/main/detail/sku，或product_suite_brief。 Agent先观察实图、分析需求/对标、策划文案和构图。suite.style是全套唯一风格来源： 颜色角色、画面/光线、文案语气/术语、字体家族/字重、排版层级比例；brief.style不参与整套编译。 frames选择模板并填写本图内容，不接受逐图style覆盖。1–8张主图、8–15屏详情、每个SKU一图。 主图一图一信息；详情opening→solution→产品/证据→closing；SKU需真实独立实图/相同属性字段。 画幅按suite.canvases分类型设置；未设分辨率继承brief.resolution；仅使用list_models中三类模型。 返回design/统一style_digest/逐图task.prompt及执行参数，缺需求返回needs_input和questions，无提示词。 修改传当前expected_revision和完整brief，旧确认失效；不要用普通edits修改整套。 展示并研讨→confirm_ecommerce_design锁定版本→明确收费授权后submit_ecommerce_design。 实际提交从保存的类型化方案重新校验编译，与返回提示词相同；不回填或替换task.prompt。

只读重新导出整套的已校验提示词、统一风格摘要和实际执行配置；不改版本、不确认、不出图。

默认当前版，可查看历史版；历史版不能用于当前提交。与实际执行共用DrawingPrompt/ImageTask校验和编译器。 prompts.task给出商品冻结图及SHA256、三模型实际选档、接口与分类型画幅；不得绕过确认/收费流程直接回填通用出图入口。

免费构造新版竞品复刻提示词：单图/同类系列或主图+详情+SKU整套，Pydantic校验后保存；不出图。

先读取nanobanana://templates/reference-replica、reference-analysis或reference_replica_brief。 Agent分别观察源图和商品，写analysis/跨类目adaptations；reference_replica.style统一颜色/画面/光线/ 文案/字体/层级比例，frames只写本图内容与composition，不接受scene/style等逐图覆盖。 scope=series时brief.kind与各frame.kind一致；product_suite时brief.kind=main，主图/详情/SKU三类齐全。 frame使用已有12模板的信息目的，但composition由Agent适配参考；SKU需自身实图/真实属性/合法事实ID。 返回design、共享style_digest与每图task.prompt/实际三模型配置/input_images角色和SHA；缺信息无可执行提示。 导出与实际执行共用ReplicaDrawingPrompt→ImageTask校验和编译器。下一步只读导出研讨→confirm_ecommerce_design →明确收费授权后submit_ecommerce_design。新版本须重新确认，不能用普通edits或替换task.prompt。 原plan_reference_replica/export_reference_replica保留兼容历史replica，不原地转换旧任务。

只读导出新版共享复刻的已校验完整Markdown、统一风格摘要、实际任务配置与有序图像角色；不批准、不收费。

当前/历史版本可查，只有当前已确认版本能提交；最多71项的整套可导出，执行分批每次最多20项。 每项task.prompt保持原Visual Schema/Scene/Layout/Text/可选Logical结构，input_images按图1风格、图2+商品顺序。 与真实提交使用同一编译器；不要将task回填通用出图入口绕过版本确认或收费授权。