修复远程素材文件名碰撞

为原始稳定素材 ID 添加确定性摘要文件名写入前拒绝批次内重复目标路径补充碰撞与重复路径测试并同步更新技术方案 Co-authored-by: Junie <junie@jetbrains.com>
2026-08-20 13:59:56 +08:00
parent b155cd5705
commit b3c70e9e15
2 changed files with 62 additions and 11 deletions
@@ -46,7 +46,7 @@ UI Editor 当前把“识别界面结构”定义为结构草稿阶段，而不

 `merge_ui` 的 Tauri 命令参数继续保持 `State`，不新增前端字符串 payload 或 IPC 参数上限。命令进入 Rust 后、构建 LLM 请求前，按每棵源树独立限制 `512` 个节点和 `32` 层，不跨树求和；序列化投影超过 `2 MiB` 时同样拒绝。本边界不宣称覆盖 Tauri 自身的入参反序列化阶段。

-UI Editor 的图片、字体和远程素材导入采用增量提交合同：输入先完成各入口已有的预检，随后按顺序逐项写入和登记；前面已成功的项目在后续写入或登记失败时保持有效，调用方必须重新读取 manifest 取得已提交集合。该入口不提供整批事务回滚，也不承诺失败后“零文件、零 manifest 变化”；后续如需原子批量导入，必须新增明确的 transaction / reconciliation 合同，不能把当前入口静默改成另一种语义。
+UI Editor 的图片、字体和远程素材导入采用增量提交合同：输入先完成各入口已有的预检，随后按顺序逐项写入和登记；前面已成功的项目在后续写入或登记失败时保持有效，调用方必须重新读取 manifest 取得已提交集合。远程素材目标文件名必须同时包含清洗后的可读 ID 与原始稳定 ID 的确定性摘要，不能让不同 ID 因清洗结果相同而覆盖已有文件；同一批次计算出的重复目标路径必须在写入前拒绝。该入口不提供整批事务回滚，也不承诺失败后“零文件、零 manifest 变化”；后续如需原子批量导入，必须新增明确的 transaction / reconciliation 合同，不能把当前入口静默改成另一种语义。

 作为 LLM 参考图使用的 UI 设计图单张文件上限为 `5 MiB`，不设置多图合计大小上限。前端设计图 AssetImporter 对本地和远端入口使用相同单文件限制；结构识别与界面语义建议在 Rust 中先检查文件元数据、再有限读取，并把读取与 base64 编码放在 blocking worker，避免阻塞 Tokio async worker。本阶段不新增图片像素数限制或命令超时。