diff --git a/docs/technical/【技术方案】UI编辑器自动分离工作流-2026-09-08.md b/docs/technical/【技术方案】UI编辑器自动分离工作流-2026-09-08.md
index 5fa60277f..8089b481e 100644
--- a/docs/technical/【技术方案】UI编辑器自动分离工作流-2026-09-08.md
+++ b/docs/technical/【技术方案】UI编辑器自动分离工作流-2026-09-08.md
@@ -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。