Foodie 全景自动处理（Windows）

2026-10-21 更新：加入自动选接缝、亮度匹配和分层融合，减轻货架、招牌被直接切断的情况。
下载的旧版工具需要重新下载并解压完整文件夹。新版本需要同时保留 stitch.py、seam_blend.py 和 worker.py。
这只能减轻接缝，无法保证消除拍摄时移动造成的视差；仍需预览后发布。

这台电脑：直接双击“打开全景自动处理.cmd”，会复用已有重建工具的 Python 环境。
其他电脑：安装 Python 3.11 或 3.12，解压整个文件夹，先运行 Install_once.cmd，再打开全景自动处理.cmd。
安装程序只在当前文件夹创建环境，从 PyPI 下载 OpenCV、NumPy、Pillow。不要只保存一个启动文件。

日常使用
1. 打开处理工具，用现有网站管理员账号登录。密码与登录会话只保留在内存，不写入文件。
2. 打开 https://foodie-westgate-demo.pages.dev/admin#panoramaAdmin。
3. 选择新增位置，或选择要更新的已有位置；填写分区、位置名称和实际拍摄日期。
4. 上传同一站位的 3–24 张照片。可在电脑或手机后台上传。
5. 电脑工具会自动接收照片并拼接。网页会显示处理进度；完成后打开全景预览，检查接缝和缺口。
6. 勾选确认，点击“发布此全景 / 更新此位置”。此操作单独生效，无需顶部“保存并发布”。
7. 前台入口位于“店内实景”照片下方的“店内全景”。同一位置的旧版本可以在后台换回。

需要保持电脑联网、工具开启且电脑不休眠。关闭工具或电脑后，云端排队任务仍保留。
未完成任务在处理租约到期（约 3 分钟）后，可由重新开启的处理工具接手。
本次处理会话最多 24 小时，到期请重新登录。不使用无人值守的永久密码或公开处理接口。
一次最多排队 5 组。单组处理上限 30 分钟。失败结果不会替换线上内容。

拍摄建议
站在同一位置，保持手机镜头位置和高度，竖拍转一圈。相邻照片重叠约一半，通常 12–15 张。
不要边走边拍，也不要把几条通道混成一组。需要不同位置，就分别上传不同的照片组。
尽量避开近距离货架、行人和曝光差异大的区域；这些情况容易出现接缝或错位。
请不要上传顾客、收银屏幕或内部资料。上传副本和结果使用现有公开图片空间。

结果说明
只使用实拍照片，没有用 AI 补造未拍到的商品。深色区域代表没有照片覆盖。
不足一圈的结果会标为“部分全景”，不会强行拉伸为一圈。
“水平覆盖”仅说明拍到了多少视角，不能证明接缝质量。发布前务必自己环视检查。
照片上的价格和库存只是拍摄时记录，不能当作门店实时售价。
最长边 2400 像素的上传副本会移除原文件拍摄信息；原照片不修改。全景输出为 4800×2400。

取消与恢复
“取消此任务”会让电脑停止处理；任务状态保留，已上传文件不会自动删除。
旧全景保留在版本记录中。“隐藏此位置”可以恢复，不删除原图。
jobs 文件夹保存本机任务缓存和诊断文件，不包含账号密码；本机缓存不会自动清理。
不要手动清理仍在处理的任务缓存。需要释放空间时，请在工具关闭后按任务文件夹整理。
