﻿简顿科技视觉工作台：跨电脑更新说明（2026-10-15）
开发源目录：E:\产品图片库\产品视觉工作台
使用电脑程序目录：D:\产品视觉工作台
运行环境选择顺序：D:\Python313 → 程序目录/runtime → D:\产品视觉运行环境\Python312。
开发机无需把Python312伪装成Python313。目标机已有Python313及requirements依赖即可，无需改脚本。

首次升级必须：
1. 关闭目标电脑正在运行的工作台。将新版解压至独立临时目录，不要先覆盖原安装目录。
2. 双击“安装或更新到D盘.cmd”。它先备份D:\产品视觉工作台及已有本机数据，再迁移原设置、提示词库和风格数据，然后更新程序代码。
3. 继续使用原桌面快捷方式，或双击D:\产品视觉工作台\启动工作台.cmd。
备份位置：D:\视觉工作台升级备份\时间戳。
若目标安装目录不是D:\产品视觉工作台，可运行启动工作台.cmd --deploy 自己的目标目录。

迁移后的本机数据：
D:\简顿科技视觉数据\settings.json：本机模型、API地址、产品库路径等
D:\简顿科技视觉数据\风格数据：本机店铺模板、规则、参考资源
D:\简顿科技视觉数据\提示词模板库.json：单行提示词库
D:\简顿科技视觉数据\credentials\gemini-key.dpapi：本机加密密钥
密钥自动兼容本机原D盘路径或%LOCALAPPDATA%/ProductVisualStudio，不携带开发机密钥。

后续更新：
首次迁移成功后，可覆盖程序文件夹；仍推荐双击安全更新入口，它会自动备份。
绝不要从开发电脑复制“D:\简顿科技视觉数据”到使用电脑。
同ID同版本模板、已有店铺规则与默认选择始终保留使用电脑内容；随程序新增的模板只补充缺失项。
原程序目录内settings.json及风格数据迁移后不是日常编辑的数据源。
产品图片、视觉工作台.json、计划版本及历史保留在本机配置的产品库中，升级不移动或覆盖。

验证范围：
开发机Python3.12：49项回归、GUI烟测、启动检查通过；
模拟升级：配置保留、模板冲突保留、默认店铺保留、代码更新与后续覆盖保护通过。
尚未在另一台电脑的Python3.13上现场复测；首次更新后运行启动工作台.cmd --check。
本包不包含Python运行环境，目标电脑使用已有D:\Python313。

2026-10-15 补充：
“编辑风格规则”直接修改左侧选中的已保存模板；不创建新ID或新版本。调整所属店铺会移动该模板。内置基础计划不可原位修改。
更新脚本会把桌面“简顿科技视觉工作台”快捷方式改为无窗口启动（wscript→pythonw）；存在旧名“产品视觉工作台”快捷方式时也一并更新。直接运行启动工作台.cmd仍会显示命令行窗口，属于批处理脚本的正常行为。若自动更新快捷方式失败，可双击程序目录的“更新桌面快捷方式.vbs”重试。
