Ozon Studio

完整解压到可写目录，双击根目录的 OzonWorkbench.exe。双击“创建桌面快捷方式.bat”可创建带图标的桌面入口；“启动工作台.bat”仍可使用。Windows x64，使用系统 WebView2 Runtime；不需要 Python、Node.js 或 Rust，不打开外部浏览器。

若单独解包 npm 更新载荷，先运行“启动工作台.bat”，首次启动会补出根目录 EXE。

本地扫描、识图、生成表格与任务均在本机运行。预检上架时才将媒体发布到所选的服务器或 ImageKit。每台电脑拥有独立工作区。

默认在同一个便携目录中保存程序与 workspace，版本程序位于 versions。workspace/config.json 保存业务配置，templates、designs、output、tasks、reports 和 private 分别保存模板、原图、输出、任务、报表与私有文件。关闭程序后可整体移动或改名该目录，程序会重定位工作区内的路径引用；未提交的旧预检需重新预检。ImageKit 的 imagekit-workspace.json 是持久云端目录标识，随 workspace 一起保留，不作为临时缓存清理。移动后从目录内的 OzonWorkbench.exe 启动，可重新运行“创建桌面快捷方式.bat”更新桌面入口。可用 OZON_WORKSPACE 环境变量指定独立的绝对工作区目录。

从旧本地版迁移时，在“本地工作区”中选择导入旧目录，导入会复制数据并保留源目录。未能确认的外部路径需手动定位；旧上架计划需要重新预检。首次使用可在配置中心选择模板、图片、输出和任务目录，再配置店铺与模型。

模型密钥使用当前 Windows 用户的 DPAPI 加密，独立保存在 workspace/private/provider-keys.dpapi.json；同机同 Windows 用户重启、更新和整体搬迁后保留，换电脑或 Windows 用户需重新填写。旧版只保存在内存的模型 Key 首次升级后需重新填写一次。店铺凭据和 ImageKit 密钥保存在 workspace/private 内的私有文件，不随软件更新包分发。分享安装包时不要加入 workspace、私有配置或浏览器数据。

软件更新只替换程序文件，不清理工作区、已保存凭据、业务数据或缓存；缓存清理作为独立操作。非默认工作区选择也会保存，重启优先恢复上次选择。软件自动检查新版本。用户选择下载后，校验完整性并准备新版本，下一次启动生效；不会替换正在运行的程序或删除工作区。更新时保留 current.txt 与 versions 的完整目录结构。