# 循环档案阵列验证

开发分支：codex/looping-archive，基于查看器光照修订 6d01e1f。

## 逻辑与实际场景

- scripts/check-loop.mjs：正反两个方向合计 20,000 次切换，检查跨首尾始终沿操作方向移动一个位置、内容对应正确、负坐标周期映射、窗口无重复和缺列；通过。
- reference/loop-review.html：使用实际 ArchiveScene 完成 61 次移动，反复跨过上下、左右边界；固定实例池为 288，归位副本最终归零；通过。
- 在循环位置进入详情可获得 4.05 的完整抬起与旋转净空；收回期间在原高度先转正，快速重新选中恢复归位副本的高度；通过。
- 将逻辑位置推至数千行列后进行坐标重置，实际位置、速度和呼吸相位保持不变，误差小于 1e-9；通过。
- 循环后重播原片，检查原片 27.60、29.16、31.56、39.00 秒的阵列：159 个背景位置加一个抽出模型，额外列全部隐藏，位置误差最大约 5.48e-7；通过。

## 页面实测

- 从机构档案第一份按上键，选中第八份 X-018，物理行由 12 前进到 11。
- 连续向左跨过第一列，选中特别项目 X-008，物理列为 -1，阵列仍覆盖画面。
- 向右返回机构档案，恢复 X-018 的选择；连续向下八次仍按同一方向运行并回到相同内容。
- 点击画面中的卡片可正确选中 X-013；向右循环五列后仍保留该档案，详情页和 360° 查看器均显示相应编号与标题。
- 实际截图检查了初始、越界后和循环后的阵列，未出现可见队列尽头。

## 回归

- check-archive.mjs、check-appearance.mjs、check-motion.mjs 通过。
- TypeScript 与 Vite 构建通过；仍有既有的包体积提示。
- 原有 Blender 模型资源未修改。