批量商品图需要生产系统，不只是提示词
电商视觉团队既要保证商品外观和事实准确，又要覆盖主图、尺寸图、场景图、细节图和对比图，还要管理组合配件、参考图、候选版本、审核决策和正式交付。零散文件夹与一次性 Prompt 很难保留这些边界，也无法解释一张图为什么被生成、保留或删除。
把 AI 生图流程做成可运行的本地工作站
项目覆盖 React 19 / TypeScript / Vite 工作台、Zustand 状态、Konva 编辑画布、FastAPI / Pydantic API、SQLite 与本地工作区文件、异步生成运行记录，以及内置 generate-product-images Skill 的受控执行边界。
Product Screens
当前本地运行系统真实截图
Capabilities
核心模块
01
商品事实与参考门禁
生成前校验商品身份、事实约束、参考角色、数量和 manifest 一致性，不把临时素材默认当作可信证据。
02
五类商品图矩阵
主图、尺寸图、场景图、细节图和对比图拥有独立规则，并按单品或配件组合展开为明确工作项。
03
异步批量生成
FastAPI 先持久化完整运行计划，再交给后台执行器；浏览器通过真实运行记录和结构化事件查看进度。
04
候选暂存与人工审核
生成结果先进入 run 级临时目录，审核者明确保留后才原子移动到正式资产库，被拒候选可安全清理。
05
Konva 精修画布
图片与文字图层支持拖拽、缩放、旋转、多选、吸附、对齐、分布、锁定、排序、撤销和干净导出。
06
上下文隔离与恢复
每个 product + task + shot 使用独立画布文档，通过 SQLite、会话缓存和串行保存队列降低覆盖与丢稿风险。
07
本地工作区契约
源商品、配件、组合任务、Prompt、参考图、临时候选和正式输出拥有明确目录边界，可由内置 Skill 增量准备。
08
受控执行与文件安全
API 绑定 loopback，脚本路径由服务端配置，子进程使用参数数组；路径穿越、隐藏目录、越界文件和目标覆盖会被拒绝。
Architecture
从商品资料到正式交付资产
Truth & References
工作区扫描商品、配件、Prompt 和参考清单，建立生成前的事实与视觉边界。
Task Matrix
用户选择任务、图型、候选数和并发，服务端重新验证范围与 readiness 后创建运行。
Stage & Review
Skill 生成的候选先留在私有暂存区，结构化事件更新进度，人工决定保留或删除。
Refine & Deliver
保留候选原子晋升为正式资产，再进入对应任务画布完成构图、文案和最终导出。
当前工作站已实际运行
- React 工作台已完成本地访问验证。
http://localhost:38120/api/health返回status: ok，workspace 与 workflow 均 ready。- 演示工作区当前扫描到 1 个商品、1 个配件、2 个任务和 10 份结构化 Prompt。
- 已验证项目概览、素材与事实、任务矩阵、精修画布和本地 API 数据链路。
- 本页四张产品图均重新采集自当前本地运行页面。
生成能力默认关闭，候选不等于资产
- 实时图片调用需要服务端显式打开开关并配置 Provider，当前本地实例保持关闭。
- 生成候选只保存在临时 run 目录，只有人工确认保留的文件才进入正式资产库。
- 浏览器不能指定脚本、任意命令或输出目录，也不能通过通用素材路由读取暂存文件。
- 当前版本定位是单机本地工作站，多用户权限、远程 worker 和对象存储属于后续部署层。
Roadmap
后续方向
参考清单在线编辑
把 reference manifest 的编辑、校验和发布完整纳入工作台，减少文件系统往返。
运行取消与重试
补齐持久 worker、心跳、租约、取消、失败项重试和更完整的运行诊断时间线。
画布生产能力
继续加入裁切与适配、蒙版、行内文字、复用组、标尺、安全区和渠道模板。
本地伴侣与云端审核
通过只出站的本地 companion 同步事件和决策，仅上传被保留的资产，保留本地文件与密钥边界。