# 托盘掩膜与位姿远程标注工具

已按[确认方案](pallet_pose_annotation_tool_plan.md)开发并启动，接入全部 **12,344个原人工目标**。原263帧负例不进入目标队列，保持原数据不变。新工具使用独立端口、独立数据库和独立隧道；原3389结构审核服务不替换。

## v14：同类等顶点掩膜建议

当前版本 `width-aligned-v14-mask-proposals`。首批效果经用户确认后，扫描全部1,194个兼容目标，
提供52份待复核掩膜建议（其中38份是首批之外新增），顶点数与匹配人工模板完全一致。
状态筛选新增“同类掩膜建议”；橙色虚线是尚未采用的候选，蓝色仍为当前记录。
点击“采用掩膜建议”并确认后才修改草稿并重提点云，不自动确认位姿或掩膜。
保存失败不跳转、本机采用前备份、撤销、旧历史及原位姿记录保护仍生效。
目标/模板产生新修订后旧建议自动隐藏；发布候选本身不改已保存数和固定分母12,344。
详情见 [同类等顶点掩膜补充](pallet_mask_template_transfer.md)。

## v13：240×96点云轴向修正

v13版本 `width-aligned-v13-source-axes`。本次仅修正正式数据中
`2024_11_27|(96, 240)|primary` 的300帧／295个目标；不对其他配置域统一旋转。
300帧均核对原PCD哈希及校正后像素与 `X/Z`、`Y/Z` 的投影方向。
6组距离/位置对照经用户确认后，专属配置设为 **+Z前向、+Y高度、−X宽度**。
独立策略为 `configs/pallet_pose_review_axes_v1.json`，绑定正式manifest、源策略ID和原生尺寸。
这是源坐标的显示/工作平面约定，不是工厂重标定或机器人外参。

- 正视图W/H、俯视图W/D共享正确宽度轴；不直接给两张画布各转90°。
- 原始XYZ不旋转，不重复此前图像180°网格校正；毫米→米仍乘0.001，普通微调仍0.001m。
- 旧几何另建token，仅更新轴向和候选基准；NPZ测量、预览、源点索引、面ID、多边形和源坐标剔除区域保留。
- 旧标尺中心的源坐标保留为待复核参考；错误工作平面上的宽度/角度不强行沿用，使用正确面点云生成新初值。
  原标尺、视图和位姿保存在 `axes_interpretation` 及不可变历史中。单位/轴向修订不自动确认位姿。
- `axes_normalization` 仅追加修订，不增加不同目标“已保存”数量，也不改变“跳转到最新”的人工保存顺序。
  删除对象保持删除，恢复时才转换其保留草稿。
- 旧网页对该组的保存/点云提取/删除/恢复会被轴向版本握手拦截，提示刷新。
  刷新不清网站数据：旧本机草稿先独立备份，再按原源坐标转换；只允许跨自动修订，不跨其他人工修订。
  失败保留原稿并阻止编辑、保存及跳转。草稿转换接口不写标注库。
- 该组源Y为高度，JSON使用明确的 `workplane_position`（顺序为前向、宽度）、
  `workplane_theta_degrees` 及 `source_position`（高度项为null）。不把源XY冒充水平XY。
  CSV增加工作平面位置、角度与轴向字段；旧XY接口不适用时留空，不补0。
- 历史机器建议及冻结模型包不改写，不在不同工作平面上直接叠加旧建议。

证据：`outputs/pallet_pose_review_validation_v13/`，含 `axis_comparison.png`、全300帧轴向审计、
部署前SQLite备份、单目标迁移清单、临时库浏览器检查及公网只读截图。
回退必须以独立版本停用策略并追加可追溯修订，不用旧SQLite覆盖部署后的人工编辑；旧配置、缓存和修订均保留。

## v12：所有位置统一米制

以下为v12更新记录，v13保留米制行为。用户明确要求位置单位统一米，并确认 **240×96原始单位为毫米**。
配置另存 `configs/pallet_pose_review_units_v1.json`，绑定原正式数据manifest，不改原PCD、原传感器注册表或冻结实验。

- 原登记单位已知的数据保留原始→米比例，几何坐标本来已换成米，不重复换算。
- 原未知单位中，240×96按0.001乘原始XYZ转为米；其他数据按本次用户确认采用1.0，数值不变但单位解释更新。
- 所有位置、视窗坐标、W/D、总宽度和位置读数均显示 **m**，不再切换mm/cm。
- HJKL、方向键、位置微调按钮每次 **0.001m**，Shift为 **0.01m**；Alt+H/L调整总宽度也为0.001m／0.01m。
  角度仍为度：0.1°／Shift 1°。Alt+A/D只改视图，所有原轴锁定、保存保护与删除/恢复规则保留。

### 历史与草稿兼容

旧人工记录按用户授权追加 `event_kind=unit_normalization` 修订，原事件不改写。
已有米制记录不重复转换；删除标记和历史保留，不把删除对象复活，也不增加“已保存”的不同目标数。
单位转换不推断人工位姿/轴向确认或实机标定；需要换算的旧位姿保留为待复核草稿，未知高度、完整旋转和机器人外参不补0。
“跳转到最新”忽略单位转换事件，仍以最近一次人工保存为准，不被批量单位更新打乱。

旧点云缓存以独立新token复制换算：XYZ、标尺中心/宽度、剔除范围和视窗长度同步缩放，
原始像素、面ID、每个源点索引和人工选面保持不变；不重新分割旧人工选面后擅自替换。
原缓存和附件仍保留。新目标则在正确的米制尺度下生成自动候选。

刷新前旧页面的保存/提取会被新版单位握手拒绝，提示刷新，避免旧“1原单位”步长继续写入。
本机旧草稿按原scale和新比例换算，先备份原本机条目；如果仅隔着单位迁移修订，可接续原未保存编辑，
但不会覆盖另一个人的新人工修订。转换失败会保留原稿并阻止保存/跳转，不清除网站存储。

导出的当前标注/位姿统一米制；ZIP另含 `source_review_payloads.jsonl` 供来源核验，旧原始历史仍在SQLite事件表及部署前备份。
未来研究需冻结新数据版本，不将旧未知单位实验事后改名为米制成绩，不自动重训或更新线上机器建议。

验收/迁移证据：`outputs/pallet_pose_review_validation_v12/`，含部署前SQLite备份、单位修订清单、源点索引保持测试、
旧本机草稿恢复和240×96毫米转米检查。米制比例的依据为原登记/本次用户确认，不冒充厂商标定。

## v11：Alt+A/D同步缩放正视图与俯视图

以下为v11更新记录，新版v12保留其行为。在点云面板中使用：

- **`Alt+A`**：缩小正视图和俯视图，显示范围乘1.3。
- **`Alt+D`**：放大正视图和俯视图，显示范围除1.3。
- 两图共享W轴显示范围，同步缩放；每次与点云工具栏“− / ＋”一致，可长按连续缩放。

仅改变相机显示范围，不改变标尺中心、总宽度、角度、掩膜、确认状态或目标，不触发保存；
普通 `A/D` 的上条/保存下条行为不变。`Alt+H/L`宽度、`Alt+J/K`角度及HJKL平移均保留。
输入框、弹窗、中文组合输入、加载或拖动过程中不触发；图像面板不响应这组点云缩放快捷键。
Ctrl/Meta+Alt、AltGraph不映射。缩放范围设有正有限值边界，避免长按导致无穷或0。

刷新原网址即可使用，不必清除网站数据。验收记录在 `outputs/pallet_pose_review_validation_v11/`。

## v10：Alt+H/L宽度与Alt+J/K角度

以下为v10更新记录，新版v11保留其行为。在点云面板使用新增快捷键：

|按键|操作|普通步长|加Shift|
|---|---|---|---|
|`Alt+H` / `Alt+L`|缩小 / 增大**总标尺宽度**，以中心对称伸缩|1个当前显示单位|10个显示单位|
|`Alt+J` / `Alt+K`|局部旋转角减小 / 增大|0.1°|1°|

宽度键不改变中心、旋转角或方向反转状态；角度键不改变中心或宽度。
宽度是总长度，每端变化总步长的一半；mm时总宽一步1mm，cm时一步1cm，未知单位一步1个原始数值单位。
连续缩小最小保留0.001个显示单位的正宽度，不能减到0或负值；角度保持后端允许范围。
两类Alt操作不受平移X/Y轴锁定限制，不会因Alt漏处理而变成HJKL平移。

保留普通HJKL平移、原Q/E旋转、Shift加速、长按连调、撤销/重做与自动草稿保存。
调整后取消位姿确认，仍须人工复核；保存失败保留本机草稿，不自动跳走。
仅点云面板、有效未删除且有标尺的目标生效；输入框/文本编辑、中文组合输入、弹窗、拖动中、加载中均不触发。
其他Alt组合、Ctrl+Alt、Meta+Alt及AltGraph不映射，避免拦截文本输入和系统快捷键。
支持物理HJKL键码；浏览器/系统若先行拦截Alt组合，网页无法强行接收，仍可用原数值栏或Q/E。

刷新原网址即可使用，不要清除网站数据。验收记录在 `outputs/pallet_pose_review_validation_v10/`。

## v9：Vim风格H/J/K/L标尺调节

以下为v9更新记录，新版v10保留其行为。在点云面板（按 `2` 切换，或鼠标位于点云面板）使用：

|按键|与方向键等价|调节轴|
|---|---|---|
|`H` / `L`|左 / 右|视图X＝宽度W|
|`J` / `K`|下 / 上|视图Y＝深度D|
|`Shift`＋上述按键|同方向，10倍步长|仍遵循当前轴锁定|

普通一步为1个当前显示单位：mm时1mm、cm时1cm，未知单位为1个原始数值单位，不推断米制。
**默认仍仅宽度X**，所以 `J/K` 默认不移动；先按 `Y` 或 `B` 切换深度/双轴后再用 `J/K`。
`X/Y/B`轴选择、原方向键、撤销/重做、长按连续微调、保存与确认规则均保留。
这里是视图W/D轴平移，不是直接修改传感器原始X/Y或高度。

`H`不再打开帮助，帮助使用 `?` 或顶部问号按钮。图像面板不响应HJKL平移；
输入框、下拉框、文本编辑、中文组合输入、跳转/删除/帮助弹窗以及已删除对象不执行标尺移动。
刷新原页面即可生效，不必清除网站数据。验收证据另存 `outputs/pallet_pose_review_validation_v9/`。

## v8：删除当前托盘面对象（可恢复）

以下为v8更新记录，新版v9保留其行为。原网址、访问码、单位策略及标尺操作保留。

1. 在**图像区域**工具栏点击红色“**删除当前对象**”，不是“删选中点”。
2. 弹窗显示当前对象编号、完整目标ID和本图目标数量；选择原因，可补充说明，勾选仅操作当前对象后确认。
3. 当前未保存修改先保存，失败/冲突时不执行删除、不跳转，本机草稿保留。
4. 删除成功后优先显示同图其他有效对象，其次进入当前筛选的相邻目标；同图其他对象的标注与历史不变。
   图像上的其他有效目标框及“本图对象”按钮仍保留。若没有下一目标则停留在只读删除视图。
5. 状态筛选选择“**已删除**”可查看删除记录，点击“**恢复此对象**”，填写恢复原因并确认。
   恢复为未确认草稿，掩膜/位姿需重新核对，不自动恢复为已完成。已删除视图刷新仍可回到同一对象。

删除采用**单目标、可恢复的删除标记**，不是擦掉图像像素、删除整个采集帧或改写原检测框。
正式源标签、PCD、原始划分和旧实验不变；删除一个对象绝不把整图当负例。同图其他对象逐目标保存。
不批量删除、不自动选择要删除的真实对象。删除原因、操作人、时间、原修订、原标注及历史保留，普通保存接口不能悄悄复活已删对象。

- 顶部仍显示“已保存 N / **12,344** · 已完成 · 掩膜 · 位姿”，新增“**已删除**”。
  已保存是有服务器记录的不同目标数，包含已删记录；删除不减少固定分母、不计完成，也不保留有效确认计数。
- “全部有效目标”和“未完成”默认排除已删对象；采集组/划分/搜索、序号跳转与最新保存定位沿用当前有效队列。
  在“已删除”筛选中，定位仅在已删除队列内进行。原263帧负例不变。
- 当前对象删除与恢复接口为 `POST /api/delete-object/{target_key}`、`POST /api/restore-object/{target_key}`，
  均要求登录、原CSRF防护、数据binding、当前修订、`confirm_target`精确匹配目标及非空原因/标注人。
- ZIP的 `annotations.jsonl` 保留审计；`effective_annotations.jsonl` 只含未删除的已保存记录；
  `deleted_targets.jsonl` 单列删除标记。已删目标不生成LabelMe、多边形掩膜、RLE或点索引标签。
  CSV新增 `deleted`、`deletion_reason`，删除记录的当前位姿为空；保留的旧标注仅供审计/恢复，不作为有效GT。
- 字体已补齐新操作中文并保留旧字形；电脑和手机都提供原因选择、确认和恢复，不为对象删除添加容易误触的快捷键。

验收：`outputs/pallet_pose_review_validation_v8/`，包括部署前真实库只读备份、临时库单目标删除/恢复与保存失败测试、
桌面/手机截图、原跳转与键盘回归、上线只读保护核查。实机iPhone Safari仍未验收。
刷新原页面即可使用，**不要清除网站数据**，以保留本机草稿。

## v7：跳转到最新

以下为v7更新记录，新版v8保留其行为。打开顶部“跳转”后，点击“**跳转到最新**”，
无需填写序号或名称，定位到**当前筛选内最近一次保存过标注的目标**（含草稿）。
这里“最新”按服务器实际保存顺序计算，不是队列最后一条、图像采集时间或已保存数量。
重新修改并保存旧目标后，该目标会成为最新。

按钮沿用已经应用的筛选；当前筛选内没有保存记录时提示并留在原目标，不擅自清除筛选。
先定位最新目标，再保存当前修改并跳转，避免本次保存将跳转目的地误改成当前目标；
保存失败时仍留在原目标、本机草稿保留。未编辑浏览不会产生保存或增加进度。
原序号/名称跳转、进度显示、快捷键、图像及点云操作不变。
更新后刷新原网址即可使用，不必清除网站数据。验收证据另存`outputs/pallet_pose_review_validation_v7/`。

## v6：跳转到指定图像 / 目标

以下为v6更新记录，新版v7保留其行为。顶部原进度旁增加“**跳转**”，电脑和手机均可用。
“已保存 / 12,344 · 已完成 · 掩膜 · 位姿”等统计完整保留，不用跳转序号替代。

- **当前队列序号**：输入1开始的整数，如2000。范围取当前筛选队列，和队列位置`x / n`一致，
  不是“已保存数量”；筛选后不会使用全局序号误跳到其他组或划分。
- **图像文件名 / 帧ID / 目标ID**：切换方式后输入图像名、原PCD文件名、帧ID、目标ID或目标key；
  支持部分名称，优先精确匹配。输入纯数字图像名时选择此方式，避免与序号混淆。
- 同一图像有多个框或重名图像时，列出队列序号、帧ID、框号（从1开始）及图像名，选择后跳转；
  不自动把多个目标中的第一项当作答案。超过50个匹配时提示补全名称以缩小范围。
- 查询沿用**已经应用**的筛选，不会自动清除采集组、原划分或状态条件；查不到时提示调整筛选。
  还未点击“筛选”的搜索文本不影响当前队列的跳转。
- 跳转前保存当前修改，失败/版本冲突时留在原目标并保留本机草稿；未编辑目标仅浏览跳转不产生保存记录，
  不增加已保存数，也不自动确认GT。关闭定位弹窗不会触发跳转，迟到的查询结果会被忽略。
- 跳转后保留图像/点云选页、默认宽度拖动规则，URL更新为当前目标；刷新可恢复。
  弹窗内输入不触发A/D等全局标注快捷键。

只读定位接口为`GET /api/locate?mode=position|image&value=...`；v7增加`mode=latest`（无需value），要求原访问码登录，沿用队列筛选参数。
它不写人工标注库。浏览器序号跳转直接使用当前队列快照，避免其他窗口新增保存改变队列后错位。

本轮验收证据位于`outputs/pallet_pose_review_validation_v6/`：
`jump_regression.json`（临时库的定位/保存保护及手机触摸）、`deployment_verification.json`（公网只读及历史数据保护）。
132项相关回归、10项跳转专项、原6项导航与14项快捷键浏览器检查通过；
390×664、390×844及844×390触摸布局无横向溢出。
公网手机实测序号/ID跳转及原进度显示通过，未发送任何人工标注保存请求，
见`public_browser_verification.json`和[手机跳转截图](../outputs/pallet_pose_review_validation_v6/public-mobile-jump.png)。
部署前1,901个人工目标、3,665条历史事件保持可追溯，期间用户新增记录继续保留。
仅重载位姿应用，原Cloudflare隧道及3389结构审核服务未重启；实机iPhone Safari仍未验收。
更新后刷新即可使用，**不要清除网站数据**，以保留本机草稿。

## v5：人工修正研究模型与新版待审标签

以下为v5更新记录，新版v6保留其行为。已基于用户授权的有效草稿完成两路模型训练；PointNet在原train分组CV中未优于几何基线，因此默认使用CV选中的几何方法，**不宣称神经网络取得提升**。完整记录见[人工修正模型v2](pallet_pose_refinement_v2.md)。

原1,216条已保存人工记录及2,541条历史事件保持原样；其余11,128个目标有新版机器处理记录，5,031个有可用新版建议。未覆盖传感器域、水平主候选或缺平面的项不强行生成位姿。

更新入口为`configs/active_pose_refinement.json`，不向真实人工库导入预测。只有无服务器人工记录且无本机草稿的目标才使用新版建议初始化标尺；加载不会增加“已保存/已完成”数。手动编辑区域后不会反复套用旧机器初值。原字段中的draft/pending和确认状态没有被批量升级。原网址、访问码、快捷键及默认仅宽度拖动保持不变，刷新页面即可使用。

[米制新版公网截图](../outputs/pallet_pose_refinement_v2/validation/public-new-metric.png) · [未知单位新版公网截图](../outputs/pallet_pose_refinement_v2/validation/public-new-native_unknown.png) · [公网人工优先级验收](../outputs/pallet_pose_refinement_v2/validation/public_deployment.json)

## v4：键盘快捷键

以下快捷键在前端v4加入，除v9将H改为标尺左移、帮助保留问号外，其他行为保留。原公网地址和访问码不变。顶部“?”按钮或`?`显示快捷键速查表。

| 快捷键 | 操作 |
|---|---|
| **A / D** | 上一个 / 保存当前状态并下一个 |
| **S**、Ctrl/⌘+S | 保存草稿或当前勾选的确认状态 |
| Z、Ctrl/⌘+Z | 撤销 |
| Shift+Z、Ctrl+Y、⌘+Shift+Z | 重做 |
| Ctrl/⌘+Enter | 确认完成，仍保留条件检查及人工确认提示 |
| **1 / 2** | 图像区域 / 点云配准 |
| F | 当前面板聚焦目标 |
| + / − | 当前面板放大 / 缩小（等号键也可放大） |
| X / Y / B | 仅宽度 / 仅深度 / 双轴拖动 |
| 方向键、Shift+方向键 | 标尺平移1、10个显示单位，遵循当前轴锁定 |
| Q / E、Shift+Q / Shift+E | 标尺旋转−/+0.1°；Shift为1° |
| R / G | 按标尺重对齐 / 重新提取点云 |
| Delete | 删除图像中选中的多边形顶点 |
| ?、Esc | 显示速查表、关闭速查表或信息确认面板（v9：H用于标尺左移） |

F和缩放作用于鼠标所在面板或用1/2选择的面板。方向键、Q/E、R/G只在点云面板生效；默认宽度锁定时上下键不会改变深度。未知单位仍使用原始数值单位，不因快捷键推断比例。

输入框、下拉框、可编辑文本和中文输入法组合输入时不触发全局快捷键，保留文本编辑的原生撤销。长按A/D只执行一次，不连续跳目标；目标加载或鼠标/触摸拖动期间不接受标注快捷键，保存失败时D不会跳转。快捷键沿用按钮的保存、版本冲突和确认逻辑，不能自动将草稿升级为GT。

[键盘专项验收](../outputs/pallet_pose_review_validation_v4/keyboard_regression.json)覆盖14项原生键盘、输入保护、失败重试及手机外接键盘模拟；177项相关回归、此前导航及鼠标/触摸轴锁定回归均通过。所有测试写入仅在临时库进行；本次前端更新不重启服务、不写真实人工标注。实机Safari仍待验收。

## v3：标尺拖动轴选项

点云工具栏新增“拖动”选项：**X：仅宽度（默认）**、Y：仅深度、XY：宽度＋深度。这里X/Y指视图的W/D轴，不是原始传感器XYZ轴。

默认拖动中心或标尺线时深度D保持不变，避免手指上下偏移误改深度。旋转手柄、宽度端点、视图平移、框选剔除及数值微调不受该选项限制。选择会沿用到同一页面中的后续目标；刷新后恢复安全默认“仅宽度”。

该功能在前端v3加入，已保留在当前v6；原网址和访问码不变，刷新页面即可使用。

## v2修复：进度与点云页切回图像

以下为数据服务 `width-aligned-v2-navigation` 的修复记录；当前前后端已更新到上方v6。原地址和访问码保持不变。请刷新页面加载新版，**不必清除网站数据**，以免丢弃本机草稿。

- 顶部显示“**已保存 N / 12,344 · 已完成 M · 掩膜… · 位姿…**”。已保存按不同目标统计，重复保存同一目标不重复计数；已完成仅计入明确确认的掩膜＋位姿，分母始终固定。
- “保存 / 下条”保证当前目标落库，即使没有移动初始四角，也可保存为草稿。它不自动将草稿变成人工真值。
- 新增顶部“**确认完成**”入口：核对坐标轴、叉取面、中心和方向后，明确确认两项并保存；条件不足时打开确认面板，不会偷偷补确认。
- 修复点云页加载下一目标时，隐藏图像画布按0尺寸初始化的问题。图像只在可见且有有效尺寸时建立相机；切回图像页重新适配，旧目标的迟到图像事件不会覆盖当前目标。
- 图像失败/超时会显示“重试图像”，请求不再无限等待；导航期间避免重复点击提交。

本次部署前备份了真实位姿库，重载后核实原 **9个草稿、28条修订事件**均保留且未改写，没有自动将旧草稿批量确认为完成。备份及核验位于 `outputs/pallet_pose_review_validation_v2/`。

177项相关回归、6项专项浏览器回归通过；专项覆盖连续“点云页保存/下条→图像页”、未改动目标保存、两类进度、明确确认、刷新恢复及图像失败重试。另在原公网地址只读验证恢复显示，未发送真实标注写入请求。实机Safari仍待验收。

[修复后公网手机截图](../outputs/pallet_pose_review_validation_v2/public-mobile-recovered.png) · [专项回归](../outputs/pallet_pose_review_validation_v2/navigation_regression.json) · [数据保护核验](../outputs/pallet_pose_review_validation_v2/preservation_verification.json)

## 访问

- [公网工具](https://deserve-organizations-abroad-miscellaneous.trycloudflare.com)
- [打开与方案图相同的训练样本](https://deserve-organizations-abroad-miscellaneous.trycloudflare.com/?target=51146063f60534e0d7130f7c)
- 本机：`http://127.0.0.1:3390`
- 访问码保存在 `outputs/pallet_pose_human_review_v1/access_key.txt`，以单独交付的访问码登录。
- 最新公网地址以 `outputs/pallet_pose_review_managed_v1/public_access.json` 为准。Quick Tunnel重建后地址可能变化。

### 实际运行截图

[桌面界面](../outputs/pallet_pose_review_validation_v1/public-desktop.png) · [手机点云页](../outputs/pallet_pose_review_validation_v1/public-mobile.png)

截图来自已登录的真实公网服务，只读查看，未写入真实人工标注。图中多边形为原框四角初始化，橙色面和绿色标尺为几何建议，不是人工确认结果。

## 一次标注的操作

### 1. 编辑区域掩膜

1. 打开目标后，用原检测框的四个角点初始化多边形。
2. 点击“目标放大”，拖动圆点调整轮廓；点击边插入顶点，选中顶点后点击“删选中点”。
3. 支持适应、缩放＋/−、滚轮缩放、平移、撤销/重做、重置框。手机使用同样的触摸顶点操作和缩放按钮。
4. 区域语义为**粗外轮廓**，叉孔等内部空隙保留在粗区域内，穿孔后的背景由点云步骤排除。
5. 自交、越界、重复相邻顶点及面积退化会拒绝保存并提示修改。

编辑后自动重新提取点云。更改区域会撤销原掩膜/位姿确认，重新选择候选与标尺，避免旧位姿被误认为仍然有效。

### 2. 选择叉取面

1. 点击“提取点云”，或等待自动处理完成。
2. 距离/法向约束连通聚类、多平面RANSAC/SVD及共面片合并产生候选面。
3. 默认推荐候选不等于已确认叉取面。打开“信息 / 确认”，检查并勾选候选面；可多选共面片合并，或在俯视点云中点击候选面。
4. 自动失败可选“手动全部区域”，再使用“框选剔除”移除误选点。“恢复剔除”可清空剔除区域，撤销也能恢复。

灰色是原场景上下文、蓝色是粗区域内点云、橙色是选定叉取面、绿色是标尺。切换“场景/全景/聚焦目标”查看背景关系。

显示最多采样18,000个上下文点、30,000个区域点；**确认、框选剔除和点索引导出在完整分辨率的实测点上执行**，不使用显示采样代替最终标签。

### 3. 配准标尺

- 上方正视图：**W—H（宽度—高度）**；下方俯视图：**同一W—D（宽度—深度）**。
- W沿所选叉取面长边建立；上下视图共享横轴零点、方向、尺度和横向平移。俯视图等比例显示，窗口尺寸不改变角度含义。
- 拖圆形中心手柄平移；拖菱形手柄绕中心旋转；拖左右方形端点调整对称参考宽度。
- 标尺中心为零刻度，单位有来源时可切换mm/cm；未知单位显示原始数值，不猜比例。
- 正视图中中心及两端参考线同步显示，用托盘腿、叉孔和外轮廓辅助判断宽度中心。
- 操作期间锁定视图基。完成后可点击“按标尺重对齐”，两个视图同步重新沿当前宽度展开，保存的原坐标位置和方向保持不变。
- “信息 / 确认”中可直接输入W/D/旋转角/总宽度，或用按钮微调。方向箭头可反转，明确180°朝向。
- 参考点定义为 **叉取面宽度中心**，不是托盘整个体积的几何中心。

### 4. 核对坐标与确认保存

1. 检查传感器单位/坐标配置。默认高度轴和前向轴是待核对配置，不自动宣称重力或机器人标定已确认。
2. 未登记比例时可保留原始单位进行人工标注；要填写新比例，必须同时填写依据，不能凭数值大小猜米/毫米。手工填写的比例单独记录来源，不修改原传感器注册表。
3. 核对轴向后勾选“我已核对前向轴和高度轴”。修改传感器配置会重新提取点云并撤销位姿确认。
4. 分别勾选“多边形区域掩膜已确认”“叉取面、中心和方向已确认”。位姿确认要求有效标尺、选定面中至少3个完整分辨率实测点及轴向确认。
5. 点击保存，或“保存 / 下条”；无法判断可标记待处理。

草稿先在浏览器本机保留，再自动保存到服务器。顶部明确显示“本机草稿/保存中/已保存rN/保存失败”。保存失败时不会悄悄跳到下一目标。刷新会恢复当前目标；修订历史可以恢复为新草稿。多个窗口冲突返回409，不覆盖另一窗口已保存的修改。

进度分母固定为12,344，分别显示已保存的不同目标数、掩膜确认数、位姿确认数及两者均确认的已完成数。筛选采集组、原train/val/test及状态只改变队列，不改原始划分。

## 导出和数据资格

“信息 / 确认”提供当前目标ZIP、全部已保存目标ZIP、CSV、JSONL。全量ZIP使用后台快照任务生成，按修订版本固定快照并流式下载，避免大批量导出挤占单次请求。

ZIP包含：

- 原图尺寸LabelMe多边形JSON。
- PNG粗区域掩膜、COCO未压缩RLE（列优先，显式原尺寸）。
- 位姿及完整标注JSONL、CSV。
- NPZ：`mask`、`region_source_indices`、`face_source_indices`、`region_uv`，仅确认内容生成持久点索引附件。
- 数据绑定、原目标身份、原划分、PCD哈希、单位、轴向、视图基和审核来源。

原图/PCD不重复打包。原目标框与正式检测入口不修改；旧位姿真值与机器预标注不替换。`human_mask_confirmed`、`human_pose_confirmed`分别区分真正确认和草稿，未知单位记录不冒充米制真值。人工新参考点与旧源表参考点也不自动视为相同。

输出不是完整6D，z/roll/pitch/四元数没有补0；全部`automatic_training_eligible=false`、`robot_command_eligible=false`。后续训练需要另建经过审核的冻结版本，原val/test不能回流train。

## 运维

```bash
.venv/bin/python scripts/serve_pose_review.py start
.venv/bin/python scripts/serve_pose_review.py status
.venv/bin/python scripts/serve_pose_review.py stop
```

上述命令只管理新位姿服务及其隧道。后台守护器会自动重启退出的子进程；没有配置机器/容器开机自启，机器重启或守护器本身退出后需重新start。

- 真实人工库：`outputs/pallet_pose_human_review_v1/annotations.sqlite3`
- 几何缓存：同目录`geometry/`；原始点身份保留，不是原数据副本替代品。
- 确认附件：同目录`artifacts/`。
- 后台导出：同目录`exports/`。
- 进程状态、访问地址和日志：`outputs/pallet_pose_review_managed_v1/`。
- 不要用测试脚本的写入操作访问真实库。备份运行中的SQLite应使用SQLite backup API，再连同artifacts和geometry保存，不能仅复制可能含WAL的主库文件。

## 验收与限制

- **176项相关回归通过**；[回归记录](../outputs/pallet_pose_review_validation_v1/regression_final.json)。
- [浏览器验收](../outputs/pallet_pose_review_validation_v1/browser_acceptance.json)：真实鼠标顶点拖动、边上增点/撤销、标尺平移/旋转、坐标重对齐前后位姿一致、框选剔除/恢复、确认/刷新恢复、上下条后刷新、导出，以及CDP原生触摸拖标尺。
- 手机390×844、390×664及844×390布局中上下W轴同列、比例一致，主要操作可见；[实际公网手机截图](../outputs/pallet_pose_review_validation_v1/public-mobile.png)。
- 13种原train传感器域/单位/多目标组合的真实几何处理通过；[记录](../outputs/pallet_pose_review_validation_v1/domain_geometry_smoke.json)。这是可处理性检查，不是自动面分割准确率。
- [公网接口验收](../outputs/pallet_pose_review_validation_v1/deployment_verification.json)和[公网浏览器验收](../outputs/pallet_pose_review_validation_v1/public_browser_verification.json)：HTTPS登录、鉴权、跨站提交拒绝、图像哈希、ETag/304、真实点云传输通过。
- 原20,768份检测标签/元数据保持一致，原3389服务健康；测试未访问原结构审核数据库，未向新真实人工库写入测试标注。
- 当前环境GPU浏览器路径不可用，实际交互/截图验收覆盖**Canvas2D回退渲染**。前端有WebGL点绘制路径，但尚未在真实设备上验收WebGL，也未做实机iPhone Safari验收。
- 几何候选可能混入背景、顶面或其他托盘，必须人工检查；单位/轴向和参考点语义仍需按实际传感器核对。

入口配置：`configs/active_pose_review.json`；实现：`pallet/pose_review.py`、`pallet/pose_review_geometry.py`及`pallet/assets/pose_review/`。
