简顿科技视觉工作台升级使用说明
更新日期：2026-10-14

启动
双击项目中的“启动工作台.cmd”。已打开的旧窗口需先保存并关闭，再重新启动。
运行环境：D:\产品视觉运行环境\Python312
皇冠执行依赖：项目内 vendor\product_visuals
密钥：D:\产品视觉运行环境\credentials（Windows DPAPI加密）
关闭Codex不影响独立启动的工作台。关闭工作台本身时，应等待在途任务结束。

新界面
01加载产品 → 02分类与颜色 → 03风格选择 → 04生图任务 → 05全部抽卡历史。
雅述店铺风为默认风格，左侧提供基础计划。其余店铺的名称和提示词尚未收到，
可通过“新增店铺”添加；程序不虚构另外三个店铺的风格。
修改店铺规则后，在新计划或新的AI优化中生效，已保存计划保持原快照。

整套风格模板
选择店铺和模板，预览后应用到任务区。默认计划10张；已有11张模板恢复11张。
任务区可新增、复制、删除行，也可修改用途、行名、图片文件名、提示词、比例和尺寸。
点击“保存整套模板”保存全部行，与生成勾选状态无关。
模板可另存或保存新版本，03立即可见；可以重命名、归档和设为默认。
不同店铺的计划保存在同一产品工作台文件中，从03“已保存计划”恢复。
模板保存前请检查自由文本中的旧货号、尺寸、人物描述。程序替换已知变量，
但无法保证自由文本中的所有产品特征都能自动识别。
模板通用参考图复制到风格数据目录，产品实物图不作为共享模板素材。

表格导入（已修订为AI直接理解）
选择.xlsx/.csv，按需补充整体要求，点击“AI直接分析 → 生成计划”。
无需指定表头、行范围或逐列对应字段。AI读取全部工作表，自行识别提示词、
说明、数量和风格；张数由实际内容确定，不以物理行数代替图片数。
跨工作表的同一风格合并理解，多套风格分别列出。结果可编辑、填入任务并整套保存模板。
Excel读取已改为标准库实现，不再需要openpyxl。公式只读取缓存值，不执行宏或外部链接。
嵌入图片暂不自动读取。过大文件会明确提示拆分，不静默截断。

AI分析与优化
API设置独立配置识别、生图、推理三个角色。
推理默认gemini-4-argon / medium / Interactions，可切换gemini-3.8-flash等型号。
“编辑上游优化指令”可以修改规划规则，并按店铺保留版本。
“AI分析生图”支持保留结构优化与重新创建计划，张数可调。
输入每类图数量、整体风格要求，检查将发送的图片列表，明确产品图与风格参考图角色。
AI结果先在预览窗口审阅，可修改、删增、重排、保留原稿，再应用到04或保存模板。
锁定行在保留结构的AI优化中保持原内容。重新创建计划会明确生成新计划。
优化不等于出图；正式出图仍在04执行。重复抽卡不自动再次优化。
关闭分析窗口会保存输入草稿；取消只停止结果应用，已发送的请求仍可能计费。
已保存草稿可从03恢复。
当前分析单次最多24张参考图，超过时须人工精简；不静默丢弃图片。
多工作表、多分组可以分别处理并通过计划追加合并。

图片规格
普通品类支持界面列出的比例及1K/2K/4K档位，实际可用性取决于所选模型。
输出按目标尺寸等比留边处理，保留不同尺寸的原始返回图，并记录实际尺寸。
皇冠保护遮罩流程保持3:4、2K请求、1340×1785交付，避免破坏锁形坐标；
界面和生成前校验都会拒绝其他皇冠规格。
保存任务不等于已通过锁形检查，多色皇冠布局仍需人工确认。

数据与验证
原有代码备份：升级备份\20261014-175422
整套风格库：风格数据\店铺与模板.json
产品计划：各产品目录内视觉工作台.json；旧计划快照：计划版本
已有生成记录和输出图片不因升级而批量修改。
验收记录：升级验收记录.json
回归入口：D:\产品视觉运行环境\Python312\python.exe -B -X utf8 verify_upgrade.py

本次验证：49项本地测试通过，包含皇冠原流程，完整GUI烟测通过。
独立启动器在移除Codex环境变量后检查通过。
真实推理连接和“测试图片→结构化计划”请求通过；未对真实产品调用生图API。
实际商品生图质量与各店铺风格仍需用你的真实图片和提示词验收。
原有单行模板仍可使用，整套模板优先绑定当前计划，历史提示词保持原记录。
