diff --git a/apps/ai-game-creator-shell/src-tauri/src/export/draft/xhs_minitool/registry.rs b/apps/ai-game-creator-shell/src-tauri/src/export/draft/xhs_minitool/registry.rs
index 6453ccd13..9a00a6027 100644
--- a/apps/ai-game-creator-shell/src-tauri/src/export/draft/xhs_minitool/registry.rs
+++ b/apps/ai-game-creator-shell/src-tauri/src/export/draft/xhs_minitool/registry.rs
@@ -44,6 +44,13 @@ pub(crate) fn save(
     base_hash: &str,
 ) -> Result<RegistrySnapshot, XHSMiniToolExportSaveError> {
     let path = registry_path(root);
+    // 读 `load_or_create` 与下面的 `write_registry` 之间没有锁，两步不是原子的：并发写（用户保存
+    // 撞上 code agent 改同一个 `.export/xhs-minitool.json`）存在「后写覆盖先写」的窗口。
+    //
+    // 这里明确接受这个窗口，不加 compare-and-swap：保存一律由用户手动触发（点保存 / 停手后的
+    // 自动落盘 / 点打包前的 flush），用户本来就知道 code agent 在同一项目里改文件；真撞上时重新
+    // 读一次注册表就能看到最新内容，不需要写入门禁级别的并发保证。把 `base_hash` 比较下沉进共享的
+    // `crate::export::save`（原子重读 + 比较 + rename）会改掉所有导出目标的写契约，成本高于收益。
     let current = load_or_create(&path, &XHSMiniToolExportRegistry::default())?;
     let form = form.normalized();
     if !current.created && current.content_hash != base_hash {