nnnotes 0.1.1__tar.gz → 0.1.2__tar.gz

{nnnotes-0.1.1/src/nnnotes.egg-info → nnnotes-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nnnotes
-Version: 0.1.1
+Version: 0.1.2
 Summary: Offline data toolkit for BanG Dream! Our Notes game files: catalogs, bundles, master data, stories, Live2D, audio and live charts
 Author: MetaMiku, emptysekai
 License-Expression: MIT
@@ -105,13 +105,13 @@ Based on all data of the Taiwan server, version 1.0.1 (zh-Hant):
 | catalog / bundle decryption / dependency closure | working |
 | master data decoding | working |
 | stories, `adv` | 946 / 946 episodes |
-| stories, `story` (full directory) | 946 / 946 episodes have all their resources in the catalog and of supported kinds (the resource closure equals the game's own per-episode download list); 759 exported one by one, the other 187 (with frames, effects, post effects, stills and the like) not yet one by one |
+| stories, `story` (full directory) | 946 / 946 episodes have all their resources in the catalog and of supported kinds (the resource closure equals the game's own per-episode download list); 946 / 946 exported and checked one by one: the files, models and audio the output refers to exist, every JSON parses and every path it refers to resolves; the 235 episodes with frames, effects, post effects, stills, chats, talk windows or videos are byte-identical across two exports except for the models directory path |
 | Live2D models | 239 / 239 (every model of the catalog; episodes use 185 of them) |
 | CRI audio | 681 / 681 cue sheets |
 | charts, `live` | 336 / 336 (music, difficulty) pairs |
-| web site, `web` | 336 / 336 charts, 239 / 239 Live2D models, 946 / 946 story episodes (two full builds in English without audio are byte-identical and 946 / 946 pass the data validation; a 27-episode sample in five languages with AAC audio is likewise identical across two builds and valid) |
-| spots, `spot` / `room` | one spot verified, the others not individually checked |
-| other regions (en / kr) and languages | checked: the regions serve the same catalog for a language and the same bundles, and the keys are shared; the master tables the charts use are the same in the three regions, and the text tables have all five languages; the chart exports checked match the Taiwan server's. A full multi-region site build is not verified yet |
+| web site, `web` | 336 / 336 charts, 239 / 239 Live2D models, 946 / 946 story episodes (two full builds in English without audio are byte-identical and 946 / 946 pass the data validation); two full builds of the three regions in five languages with AAC audio (`--all-regions`, with the live master data: 340 charts of 85 musics) are likewise byte-identical and pass the data validation in full |
+| spots, `spot` / `room` | 39 / 39 spots, every reference resolves; `room` exports 20 / 20 room backgrounds of the catalog. Every glb passes the Khronos glTF-Validator with 0 errors |
+| other regions (en / kr) and languages | checked: the regions serve the same catalog for a language and the same bundles, and the keys are shared; the master tables the charts use are the same in the three regions, and the text tables have all five languages; the chart exports checked match the Taiwan server's. A full multi-region site build is verified (the row above) |
 
 ## Requirements
 

{nnnotes-0.1.1 → nnnotes-0.1.2}/README.en.md

@@ -74,13 +74,13 @@ Based on all data of the Taiwan server, version 1.0.1 (zh-Hant):
 | catalog / bundle decryption / dependency closure | working |
 | master data decoding | working |
 | stories, `adv` | 946 / 946 episodes |
-| stories, `story` (full directory) | 946 / 946 episodes have all their resources in the catalog and of supported kinds (the resource closure equals the game's own per-episode download list); 759 exported one by one, the other 187 (with frames, effects, post effects, stills and the like) not yet one by one |
+| stories, `story` (full directory) | 946 / 946 episodes have all their resources in the catalog and of supported kinds (the resource closure equals the game's own per-episode download list); 946 / 946 exported and checked one by one: the files, models and audio the output refers to exist, every JSON parses and every path it refers to resolves; the 235 episodes with frames, effects, post effects, stills, chats, talk windows or videos are byte-identical across two exports except for the models directory path |
 | Live2D models | 239 / 239 (every model of the catalog; episodes use 185 of them) |
 | CRI audio | 681 / 681 cue sheets |
 | charts, `live` | 336 / 336 (music, difficulty) pairs |
-| web site, `web` | 336 / 336 charts, 239 / 239 Live2D models, 946 / 946 story episodes (two full builds in English without audio are byte-identical and 946 / 946 pass the data validation; a 27-episode sample in five languages with AAC audio is likewise identical across two builds and valid) |
-| spots, `spot` / `room` | one spot verified, the others not individually checked |
-| other regions (en / kr) and languages | checked: the regions serve the same catalog for a language and the same bundles, and the keys are shared; the master tables the charts use are the same in the three regions, and the text tables have all five languages; the chart exports checked match the Taiwan server's. A full multi-region site build is not verified yet |
+| web site, `web` | 336 / 336 charts, 239 / 239 Live2D models, 946 / 946 story episodes (two full builds in English without audio are byte-identical and 946 / 946 pass the data validation); two full builds of the three regions in five languages with AAC audio (`--all-regions`, with the live master data: 340 charts of 85 musics) are likewise byte-identical and pass the data validation in full |
+| spots, `spot` / `room` | 39 / 39 spots, every reference resolves; `room` exports 20 / 20 room backgrounds of the catalog. Every glb passes the Khronos glTF-Validator with 0 errors |
+| other regions (en / kr) and languages | checked: the regions serve the same catalog for a language and the same bundles, and the keys are shared; the master tables the charts use are the same in the three regions, and the text tables have all five languages; the chart exports checked match the Taiwan server's. A full multi-region site build is verified (the row above) |
 
 ## Requirements
 

{nnnotes-0.1.1 → nnnotes-0.1.2}/README.md

@@ -59,13 +59,13 @@ nnnotes config check             # 每项设置的来源和格式是否有效，
 | catalog / 资源包解密 / 依赖闭包 | 可用 |
 | masterdata 解码 | 可用 |
 | 剧情 `adv` | 946 / 946 集可导出 |
-| 剧情 `story`（完整目录） | 946 / 946 集的资源都在 catalog 中且类型均受支持（资源闭包与游戏自带的每集下载清单一致）；已逐集导出验证 759 集，其余 187 集（用到 Frame / Effect / PostEffect / Still 等资源）未逐一验证 |
+| 剧情 `story`（完整目录） | 946 / 946 集的资源都在 catalog 中且类型均受支持（资源闭包与游戏自带的每集下载清单一致）；946 / 946 集已逐集导出验证：输出中引用的文件、模型与音频均存在，JSON 均可解析，引用的路径均可解析；其中 235 集用到 Frame / Effect / PostEffect / Still / Chat / TalkWindow / 视频资源，两次导出除模型目录路径外逐字节一致 |
 | Live2D 模型 | 239 / 239 个可导出（catalog 中的全部模型，剧情用到其中 185 个） |
 | CRI 音频 | 681 / 681 个 cue sheet 可解码 |
 | 谱面 `live` | 336 / 336 个（曲目, 难度）组合可导出 |
-| 网页站点 `web` | 336 / 336 张谱面，239 / 239 个 Live2D 模型，946 / 946 集剧情（英语、无音频的全量构建两次结果逐字节一致，946 / 946 集通过数据校验；五种语言含 AAC 音频的 27 集抽样同样一致，并通过数据校验） |
-| 据点 `spot` / `room` | 已验证单个据点，其余未逐一验证 |
-| 其他区服（en / kr）与其他语言 | 已核对：各区服同一语言的 catalog 相同、资源包相同，密钥通用；谱面用到的 masterdata 表在三个区服间一致，文本表五种语言齐全；抽查的谱面导出与台服一致。多区服整站构建未做全量验证 |
+| 网页站点 `web` | 336 / 336 张谱面，239 / 239 个 Live2D 模型，946 / 946 集剧情（英语、无音频的全量构建两次结果逐字节一致，946 / 946 集通过数据校验）；三个区服、五种语言、含 AAC 音频的全量构建（`--all-regions`，用线上 masterdata：85 首曲目的 340 张谱面）两次结果同样逐字节一致，全部通过数据校验 |
+| 据点 `spot` / `room` | 39 / 39 个据点可导出，引用均可解析；catalog 中 20 / 20 个房间背景可由 `room` 导出。生成的 glb 均通过 Khronos glTF-Validator，0 个错误 |
+| 其他区服（en / kr）与其他语言 | 已核对：各区服同一语言的 catalog 相同、资源包相同，密钥通用；谱面用到的 masterdata 表在三个区服间一致，文本表五种语言齐全；抽查的谱面导出与台服一致。多区服整站已全量构建验证（见上一行） |
 
 ## 需要准备
 

{nnnotes-0.1.1 → nnnotes-0.1.2}/src/nnnotes/__init__.py

@@ -4,4 +4,4 @@ Reads Addressables catalogs, fetches and decrypts asset bundles, decodes master
 models, spots, shaders, CRI audio and live charts as JSON and common file formats. Game files, keys and server
 addresses are supplied by the user through the configuration; nothing of the game is included.
 """
-__version__ = "0.1.1"
+__version__ = "0.1.2"

{nnnotes-0.1.1 → nnnotes-0.1.2}/src/nnnotes/room.py

@@ -258,23 +258,29 @@ class _Glb:
                            "extras": {"unityActive": active}})
 
     def write(self, path: Path, extras: dict):
+        """glTF requires the arrays it has to be non-empty and a buffer to hold bytes: an empty array is left out,
+        and a room without geometry is a scene without nodes and a file without the BIN chunk."""
+        scene = {"nodes": list(range(len(self.nodes)))} if self.nodes else {}
         gltf = {
             "asset": {"version": "2.0", "generator": "nnnotes/room", "extras": extras},
-            "scene": 0, "scenes": [{"nodes": list(range(len(self.nodes)))}],
+            "scene": 0, "scenes": [scene],
             "nodes": self.nodes, "meshes": self.meshes, "accessors": self.accessors,
-            "bufferViews": self.bufferViews, "buffers": [{"byteLength": len(self.bin)}],
+            "bufferViews": self.bufferViews, "buffers": [{"byteLength": len(self.bin)}] if self.bin else [],
             "materials": self.materials, "textures": self.textures,
             "images": self.images, "samplers": self.samplers,
         }
+        gltf = {k: v for k, v in gltf.items() if v != []}
         if self.ext_used:
             gltf["extensionsUsed"] = sorted(self.ext_used)
         js = dumps(gltf, separators=(",", ":")).encode("utf-8")
         js += b" " * (-len(js) % 4)
         self.bin.extend(b"\0" * (-len(self.bin) % 4))
+        size = 12 + 8 + len(js) + (8 + len(self.bin) if self.bin else 0)
         with open(path, "wb") as f:
-            f.write(struct.pack("<III", 0x46546C67, 2, 12 + 8 + len(js) + 8 + len(self.bin)))
+            f.write(struct.pack("<III", 0x46546C67, 2, size))
             f.write(struct.pack("<II", len(js), 0x4E4F534A)); f.write(js)
-            f.write(struct.pack("<II", len(self.bin), 0x004E4942)); f.write(self.bin)
+            if self.bin:
+                f.write(struct.pack("<II", len(self.bin), 0x004E4942)); f.write(self.bin)
 
 
 # ---- extraction ---------------------------------------------------------

{nnnotes-0.1.1 → nnnotes-0.1.2}/src/nnnotes/unity.py

@@ -327,18 +327,23 @@ def _head_node(node: TypeTreeNode) -> TypeTreeNode | None:
     return head
 
 
-def script_class(obj) -> str:
-    """Class name of a MonoBehaviour (needs the monoscript bundle loaded). Reads the header up to m_Script with the
-    object's own typetree (not its fields); the whole object when that is not possible."""
+def script_class(obj) -> str | None:
+    """Class name of a MonoBehaviour (needs the monoscript bundle loaded); None for a missing script (null m_Script).
+    Reads the header up to m_Script with the object's own typetree (not its fields); the whole object when that is
+    not possible."""
     try:
         head = _head_node(obj._get_typetree_node())
         if head is not None:
-            ms = deref(obj, obj.read_typetree(head, check_read=False)["m_Script"])
-            if ms is not None:
-                return ms.read().m_ClassName
+            pptr = obj.read_typetree(head, check_read=False)["m_Script"]
+            if not pptr["m_PathID"]:
+                return None
+            return deref(obj, pptr).read().m_ClassName
     except Exception:
         pass
-    return obj.read().m_Script.read().m_ClassName
+    script = obj.read().m_Script
+    if not script.m_PathID:
+        return None
+    return script.read().m_ClassName
 
 
 def strip_pptrs(tt: dict) -> dict:

{nnnotes-0.1.1 → nnnotes-0.1.2}/src/nnnotes/webmodel.py

@@ -321,7 +321,13 @@ def source_entry(address: str, doc: dict, where: str) -> dict:
 class ModelDir:
     """The models of `root`: each model in <root>/<id>/, the files of a model manifest (read_files; the shader index
     reduced to the listed GLES3 programs as web.collect reduces it) in the layout export_model writes. ensure exports
-    a model whose directory does not exist, or every model once when `force`; `built` / `skipped`: the ids."""
+    a model whose directory does not exist, or every model once when `force`; `built` / `skipped`: the ids (a model
+    another process installed meanwhile is skipped).
+
+    Processes may share `root` (several `nnnotes story` at once): a model directory appears in one rename, whole, and
+    the first process to install a model wins; the others drop their export (the same bytes: exports are
+    deterministic) and use it. `force` moves a previous directory aside before installing; a process that finds the
+    directory gone in between exports the model itself."""
 
     def __init__(self, cat, player, root: Path, force: bool = False):
         self.cat, self.player, self.root, self.force = cat, player, Path(root), force
@@ -333,32 +339,42 @@ class ModelDir:
         mid = model_id(address)
         if mid not in self._done:
             d = self.root / mid
-            if self.force or not d.exists():
-                self._export(address, d)
-                self.built.append(mid)
-            else:
-                self.skipped.append(mid)
             index = d / MODEL_INDEX
-            if not index.is_file():
+            built = (self.force or not d.exists()) and self._export(address, d)
+            if not index.is_file() and not d.exists():     # moved aside by a forced export of another process
+                built = self._export(address, d)
+            (self.built if built else self.skipped).append(mid)
+            try:
+                doc = json.loads(index.read_text(encoding="utf-8"))
+            except FileNotFoundError:
                 raise RuntimeError(f"{d}: no {MODEL_INDEX} (not a model directory); remove it or export again "
-                                   f"(--force)")
-            self._done[mid] = source_entry(address, json.loads(index.read_text(encoding="utf-8")), str(index))
+                                   f"(--force)") from None
+            self._done[mid] = source_entry(address, doc, str(index))
         return self._done[mid]
 
-    def _export(self, address: str, d: Path) -> None:
-        """The model into a temporary directory next to `d`, then renamed to `d` (a previous `d` removed)."""
+    def _export(self, address: str, d: Path) -> bool:
+        """The model into a temporary directory in `root`, then renamed to `d`; False when another process's `d` is
+        there instead (kept: without `force` any `d`, with `force` one installed after the previous `d` was moved
+        aside)."""
         self.root.mkdir(parents=True, exist_ok=True)
         work = Path(tempfile.mkdtemp(prefix=f".{d.name}-", dir=self.root))
         try:
             summary = export_model(self.cat, self.player, address, work / "export")
             text, binary = collect(work / "export", summary["files"])
             files = {**{p: t.encode("utf-8") for p, t in text.items()}, **binary}
+            model = work / "model"
             for rel, data in sorted(files.items()):
-                (work / "model" / rel).parent.mkdir(parents=True, exist_ok=True)
-                (work / "model" / rel).write_bytes(data)
-            if d.exists():
-                shutil.rmtree(d)
-            (work / "model").rename(d)
+                (model / rel).parent.mkdir(parents=True, exist_ok=True)
+                (model / rel).write_bytes(data)
+            if _install(model, d):
+                return True
+            if not self.force:
+                return False
+            try:
+                d.rename(work / "previous")
+            except FileNotFoundError:                     # moved aside by another process
+                pass
+            return _install(model, d)
         finally:
             shutil.rmtree(work, ignore_errors=True)
 
@@ -367,6 +383,18 @@ class ModelDir:
         return {"modelsDir": Path(os.path.relpath(os.path.abspath(self.root), os.path.abspath(story_dir))).as_posix()}
 
 
+def _install(src: Path, d: Path) -> bool:
+    """Rename the directory `src` to `d`; False when `d` exists (a non-empty directory: POSIX refuses to replace it,
+    Windows any directory)."""
+    try:
+        src.rename(d)
+        return True
+    except OSError:
+        if not d.exists():
+            raise
+        return False
+
+
 class SiteModels:
     """The models of the site at `site`: ensure reads model.json from the model manifest models/<id>.json (the models
     are built before the stories: storysite.build)."""

{nnnotes-0.1.1 → nnnotes-0.1.2/src/nnnotes.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nnnotes
-Version: 0.1.1
+Version: 0.1.2
 Summary: Offline data toolkit for BanG Dream! Our Notes game files: catalogs, bundles, master data, stories, Live2D, audio and live charts
 Author: MetaMiku, emptysekai
 License-Expression: MIT
@@ -105,13 +105,13 @@ Based on all data of the Taiwan server, version 1.0.1 (zh-Hant):
 | catalog / bundle decryption / dependency closure | working |
 | master data decoding | working |
 | stories, `adv` | 946 / 946 episodes |
-| stories, `story` (full directory) | 946 / 946 episodes have all their resources in the catalog and of supported kinds (the resource closure equals the game's own per-episode download list); 759 exported one by one, the other 187 (with frames, effects, post effects, stills and the like) not yet one by one |
+| stories, `story` (full directory) | 946 / 946 episodes have all their resources in the catalog and of supported kinds (the resource closure equals the game's own per-episode download list); 946 / 946 exported and checked one by one: the files, models and audio the output refers to exist, every JSON parses and every path it refers to resolves; the 235 episodes with frames, effects, post effects, stills, chats, talk windows or videos are byte-identical across two exports except for the models directory path |
 | Live2D models | 239 / 239 (every model of the catalog; episodes use 185 of them) |
 | CRI audio | 681 / 681 cue sheets |
 | charts, `live` | 336 / 336 (music, difficulty) pairs |
-| web site, `web` | 336 / 336 charts, 239 / 239 Live2D models, 946 / 946 story episodes (two full builds in English without audio are byte-identical and 946 / 946 pass the data validation; a 27-episode sample in five languages with AAC audio is likewise identical across two builds and valid) |
-| spots, `spot` / `room` | one spot verified, the others not individually checked |
-| other regions (en / kr) and languages | checked: the regions serve the same catalog for a language and the same bundles, and the keys are shared; the master tables the charts use are the same in the three regions, and the text tables have all five languages; the chart exports checked match the Taiwan server's. A full multi-region site build is not verified yet |
+| web site, `web` | 336 / 336 charts, 239 / 239 Live2D models, 946 / 946 story episodes (two full builds in English without audio are byte-identical and 946 / 946 pass the data validation); two full builds of the three regions in five languages with AAC audio (`--all-regions`, with the live master data: 340 charts of 85 musics) are likewise byte-identical and pass the data validation in full |
+| spots, `spot` / `room` | 39 / 39 spots, every reference resolves; `room` exports 20 / 20 room backgrounds of the catalog. Every glb passes the Khronos glTF-Validator with 0 errors |
+| other regions (en / kr) and languages | checked: the regions serve the same catalog for a language and the same bundles, and the keys are shared; the master tables the charts use are the same in the three regions, and the text tables have all five languages; the chart exports checked match the Taiwan server's. A full multi-region site build is verified (the row above) |
 
 ## Requirements
 

{nnnotes-0.1.1 → nnnotes-0.1.2}/tests/test_room.py

@@ -332,6 +332,39 @@ def test_textures_with_the_same_png_bytes_share_one_image():
     assert [im["name"] for im in glb.images] == ["a", "c"] and len(glb.bufferViews) == 2
 
 
+def glb_chunks(path):
+    data = path.read_bytes()
+    magic, version, size = struct.unpack_from("<III", data, 0)
+    assert (magic, version, size) == (0x46546C67, 2, len(data))
+    chunks, at = [], 12
+    while at < len(data):
+        n, kind = struct.unpack_from("<II", data, at)
+        chunks.append((kind, data[at + 8:at + 8 + n]))
+        at += 8 + n
+    return chunks
+
+
+def test_a_room_without_geometry_is_a_valid_empty_gltf(tmp_path):
+    """No empty arrays (glTF requires the arrays it has to be non-empty), no buffer and no BIN chunk."""
+    room._Glb().write(tmp_path / "room.glb", {"backgroundKey": "k"})
+    chunks = glb_chunks(tmp_path / "room.glb")
+    assert [kind for kind, _ in chunks] == [0x4E4F534A]
+    doc = json.loads(chunks[0][1])
+    assert doc == {"asset": {"version": "2.0", "generator": "nnnotes/room", "extras": {"backgroundKey": "k"}},
+                   "scene": 0, "scenes": [{}]}
+
+
+def test_a_room_with_geometry_keeps_its_arrays_and_bin_chunk(tmp_path):
+    glb = room._Glb()
+    glb.texture(b"png-1", "a", room._sampler({}))
+    glb.write(tmp_path / "room.glb", {})
+    chunks = glb_chunks(tmp_path / "room.glb")
+    assert [kind for kind, _ in chunks] == [0x4E4F534A, 0x004E4942]
+    doc = json.loads(chunks[0][1])
+    assert doc["buffers"] == [{"byteLength": 5}] and len(chunks[1][1]) == 8   # the chunk is padded to 4 bytes
+    assert list(doc) == ["asset", "scene", "scenes", "bufferViews", "buffers", "textures", "images", "samplers"]
+
+
 def test_mesh_components_are_keyed_by_file_and_game_object():
     bundle = SimpleNamespace(files={})
     a, b = File("CAB-a", bundle), File("CAB-b", bundle)

{nnnotes-0.1.1 → nnnotes-0.1.2}/tests/test_speed_exact.py

@@ -137,6 +137,19 @@ def test_head_node_cut_after_script():
     assert unity._head_node(TypeTreeNode(0, "X", "Base", -1, 1, m_Children=kids[:2])) is None
 
 
+def test_script_class_missing_script_is_none():
+    kids = [TypeTreeNode(1, t, n, 0, 0) for t, n in (("PPtr<GameObject>", "m_GameObject"), ("UInt8", "m_Enabled"),
+                                                       ("PPtr<MonoScript>", "m_Script"))]
+    node = TypeTreeNode(0, "MonoBehaviour", "Base", -1, 1, m_Children=kids)
+    null = {"m_FileID": 0, "m_PathID": 0}
+    obj = SimpleNamespace(_get_typetree_node=lambda: node,
+                          read_typetree=lambda *a, **k: {"m_GameObject": null, "m_Enabled": 1, "m_Script": null})
+    assert unity.script_class(obj) is None
+    whole = SimpleNamespace(_get_typetree_node=lambda: None,
+                            read=lambda: SimpleNamespace(m_Script=SimpleNamespace(m_PathID=0)))
+    assert unity.script_class(whole) is None
+
+
 # ---------------------------------------------------------------- typetree values
 def ref_value(ex, owner, v):
     if unity.is_pptr(v):

{nnnotes-0.1.1 → nnnotes-0.1.2}/tests/test_webmodel.py

@@ -642,6 +642,47 @@ def test_model_dir_exports_each_model_once(tmp_path, monkeypatch):
         webmodel.ModelDir(None, player, root).ensure(KEY_B)
 
 
+@pytest.mark.parametrize("force", [False, True])
+def test_model_dir_shared_by_processes_keeps_one_whole_model(tmp_path, monkeypatch, force):
+    """Another process (another ModelDir on the same root) installs the model while this one exports it: without
+    force the first installed copy is kept and this export dropped, with force this export replaces it; either way
+    one whole model directory and no temporary directory is left."""
+    player = fake_export(monkeypatch, motion_sync=True)
+    root, real, other = tmp_path / "live2d", webmodel.export_model, []
+
+    def racing(*a):
+        if not other:
+            other.append(webmodel.ModelDir(None, player, root, force=force))
+            other[0].ensure(KEY_A)
+        return real(*a)
+    monkeypatch.setattr(webmodel, "export_model", racing)
+    a = webmodel.ModelDir(None, player, root, force=force)
+    assert a.ensure(KEY_A) == {"id": "adv_model_a", "motionSync": True}
+    assert (a.built, a.skipped) == ((["adv_model_a"], []) if force else ([], ["adv_model_a"]))
+    assert other[0].built == ["adv_model_a"]
+    assert [p.name for p in root.iterdir()] == ["adv_model_a"]
+    assert dir_files(root) == [f"adv_model_a/{f}" for f in model_files("adv_model_a")]
+
+
+def test_model_dir_exports_a_model_moved_aside_after_the_check(tmp_path, monkeypatch):
+    """The model directory existed when checked but is gone when read (a forced export of another process moved it
+    aside): exported here."""
+    player = fake_export(monkeypatch, motion_sync=True)
+    root = tmp_path / "live2d"
+    d, real, seen = root / "adv_model_a", webmodel.Path.exists, []
+
+    def exists(p):
+        if p == d and not seen:
+            seen.append(p)
+            return True
+        return real(p)
+    monkeypatch.setattr(webmodel.Path, "exists", exists)
+    a = webmodel.ModelDir(None, player, root)
+    assert a.ensure(KEY_A) == {"id": "adv_model_a", "motionSync": True}
+    assert seen and (a.built, a.skipped) == (["adv_model_a"], [])
+    assert dir_files(root) == [f"adv_model_a/{f}" for f in model_files("adv_model_a")]
+
+
 def test_story_command_exports_its_models_next_to_the_story(tmp_path, capsys, monkeypatch):
     from nnnotes import story
     player = fake_export(monkeypatch)