补充文字遮罩状态字段契约

明确 text_mask_areas 为当前 separation state 必选字段保持开发阶段 v1 且不提供旧 sidecar 迁移回退
2026-09-10 10:49:07 +08:00
parent 761d32cebf
commit c84df3d88f
1 changed files with 1 additions and 0 deletions
@@ -54,6 +54,7 @@
 - sidecar 目录按 UI manifest `asset_id` 生成，复用 `generated_file_stem(asset_id)` 的安全字符替换和 SHA-256 摘要规则，位于项目 `ui/` 下。
 - 目录只保存一份当前 separation state，而不是每 batch 一个状态文件。
 - state 文件只保留 `schema_version`、separation trees、bound 结果和 problematic 节点，不重复保存 `projectId / assetId / uiStateRevision`。
+- `SeparationNode.text_mask_areas` 是 separation tree 的必选字段，当前开发阶段继续使用 `ui-editor-separation-state.v1`，不提供旧 sidecar 迁移或回退。
 - sidecar 只在 separation 未完成期间存在；完成后删除 state JSON。
 - 当前只持久化已经完成的 batch；正在执行 batch 的恢复语义列 TODO。
 - 临时图片可跨重启保留。raw image-edit 返回图、绿色/紫色标记图、处理图和 cut 图片当前都保留用于 debug；理论上只应在内存中，清理/归档策略列 TODO。