# 图册在线掩膜修改

**当前版本10**：[369张新增机器候选复核](https://lovely-ask-garmin-labeled.trycloudflare.com/?revision=10#new-batch)，累计1,061张覆盖，支持全部22类筛选。
上批51项人工均已保存；[下一批50张直接人工任务](https://lovely-ask-garmin-labeled.trycloudflare.com/template-requests/?batch=remaining-direct-v1)
为Class 4、5、7、14、22各10张新图，不要求重画已保存四点轮廓。详见 [扩展及保护说明](pallet_mask_remaining_expand.md)。
以下为先前发布历史，不代表当前待办数量。

剩余17类首批任务已上线：[每类3张，共51张人工描绘](https://lovely-ask-garmin-labeled.trycloudflare.com/template-requests/?batch=remaining17-v1)。
此前五类500张图册保持版本9不变；新任务保存前不计完成。详见 [剩余类别标签构建](pallet_mask_remaining_classes.md)。

**当前版本9**：[五类各100张、共500张覆盖图册](https://lovely-ask-garmin-labeled.trycloudflare.com/?revision=9)。
本轮66张复核及最后25项人工任务均已保存。旧45张确属此前84张，已按用户说明登记无需修改，不需重复复核。
详情见 [最终500张汇总](pallet_mask_quota_100_complete.md)。以下版本8及更早链接均保留作历史。

最新版本8：[66张新增候选](https://lovely-ask-garmin-labeled.trycloudflare.com/?revision=8#new-batch)，累计475张覆盖。
Class 1、2、15各100张；[Class 9十张、Class 10十五张人工补充任务](https://lovely-ask-garmin-labeled.trycloudflare.com/template-requests/)。
“保存 / 下条”现在也会保存未改动机器候选草稿，失败不跳转。详见 [续批与保存保护](pallet_mask_quota_100_continue.md)。

历史版本7：[当时84张候选复核](https://lovely-ask-garmin-labeled.trycloudflare.com/?revision=7#new-batch)，当时累计378张覆盖；同域现在加载活动版本。
目标已提高至五类各100张，尚缺122张；[24张补充人工模板](https://lovely-ask-garmin-labeled.trycloudflare.com/template-requests/)。
详见 [五类各100张续批](pallet_mask_quota_100.md)。下方保留历史版本记录。

历史版本6：[当时累计237张图册](https://lovely-ask-garmin-labeled.trycloudflare.com/?revision=6#new-batch)（同域现加载活动版本）。
四类达到50张覆盖，Class 10为37张；[最后13张人工描绘任务](https://lovely-ask-garmin-labeled.trycloudflare.com/template-requests/)。
详见 [24份模板保存后的续批](pallet_mask_quota_saved_templates.md)。人工源与机器候选分开统计，不自动确认GT。

历史版本5入口记录：<https://lovely-ask-garmin-labeled.trycloudflare.com/?revision=5#new-batch>（当时累计140张；同域入口现在加载活动版本）。
原服务停止后已恢复，临时公网域名变化；沿用原访问码和人工修订库。历史入口见下方记录，当前地址以 `public_access.json` 为准。

入口：<https://lesson-leslie-criteria-result.trycloudflare.com/?revision=3&editor=1#new-batch>。
公网地址仍为临时Quick Tunnel，以 `outputs/pallet_mask_gallery_managed_v1/public_access.json` 为准。

## 使用

1. 浏览图册无需登录；每张图下点击 **修改掩膜 / 在线复核**。
2. 输入原 **托盘位姿标注访问码**（不另外生成或公开新密码）。
3. 编辑框显示原分辨率图像和编号顶点：拖动顶点，点击边增点，选中点后删除。
   至少3点、最多128点；手工编辑允许改变原模板顶点数，原建议和原顶点数另存保留。
4. 支持适应原图、目标放大、＋/−、滚轮缩放、平移、撤销和重做。手机可直接触屏拖点，
   缩放/平移按钮可用；本轮尚未在真实iPhone Safari上验收。
5. 点击 **保存修订**，或 **保存 / 下条**。未修改时浏览/关闭不自动保存；明确点击保存也可
   把未改动的建议保存为人工编辑草稿，仍不是确认GT。
6. 历史修订可恢复为新草稿，再保存时追加修订，不覆盖原事件。
   可下载已保存的LabelMe和原分辨率PNG掩膜，也可单独导出未保存的本机草稿。

键盘：Ctrl/⌘+S或S保存；Z / Ctrl+Z撤销；Shift+Z / Ctrl+Y重做；A / D上条、保存下条；
Delete删点；F目标放大；＋/−缩放。输入框、中文组合输入及Alt组合不触发图像快捷键。
原位姿标注页面的HJKL、Alt宽度/角度/缩放等快捷键未更改。

图像编辑中的位置为 **原图像素坐标**，不是三维米制位置；位姿工具的米制配置没有变化。
图册原对照图始终保留机器建议；再次点击“修改掩膜”会读取当前已保存人工复核修订。
按钮上的 `已存 rN` 标记表示独立复核库已保存，不是正式位姿确认数。

## 保存与保护

- 独立SQLite：`outputs/pallet_mask_gallery_reviews_v1/mask_reviews.sqlite3`。
  仅存当前目标的掩膜、标注人、备注和版本来源；`events` 追加不可变修订历史。
- 不写 `outputs/pallet_pose_human_review_v1/annotations.sqlite3`，不更改位姿、选面、源点索引，
  不改原始框/图像/点云、正式划分、56份机器建议或冻结ZIP。
- 保存一律 `human_edited=true`、`human_mask_confirmed=false`、
  `automatic_training_eligible=false`、`robot_command_eligible=false`。不自动将复核结果投入生成或训练。
- 拖动和输入即时保留本机草稿；服务器保存失败时停留当前目标，关闭/跳转都受保存保护。
  刷新后可恢复兼容草稿。**不要清除网站数据**。
- 若其他窗口先保存，版本冲突会拒绝覆盖。先导出本机草稿，或点击
  **备份本机并加载服务器版本**；仅在本机备份成功后才释放冲突，不做自动合并。
- 旧图册/机器建议变化时保存需通过版本握手；原图/目标绑定变化时拒绝把旧修订套到新源上。
- 删除按钮只删选中顶点，不删除目标或整图；同图其他目标不变。
  单目标LabelMe导出标记 `annotation_scope=single_target_mask_review_not_full_frame`，不能视作全图负例/全图标注替换。

## 权限与运维

编辑、私有历史、导出均需登录。Cookie为HttpOnly / SameSite=Strict；公网HTTPS下为Secure。
保存接口限制同源、JSON及请求标识；无目录浏览或数据库下载接口。
编辑静态资源位于 `pallet/assets/mask_gallery/`，仅在服务器响应中注入，不改写原HTML交付文件。

`configs/active_mask_gallery.json` 的 `editing_enabled` 控制是否启用编辑；设为false并仅重载
图库子进程可回到只读。已保存复核数据库保留，**不要用旧SQLite覆盖部署后人工编辑**。
图库进程还支持 `--read-only`、`--reviews <独立目录>`；守护器命令保持
`.venv/bin/python scripts/serve_mask_gallery.py start|status|stop`。

验收：`outputs/pallet_mask_editor_validation_v1/`；151项回归、24项隔离库桌面/手机编辑检查，
以及公网只读验收。公网验收不提交真实标注，仅登录、查看、缩放及关闭；写入路径在临时库验证。
原图册/位姿/结构服务及所有隧道各自独立，只重载图库应用。
