# 兵马俑

**Repository Path**: sliver-ring_admin/terracotta-army

## Basic Information

- **Project Name**: 兵马俑
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-16
- **Last Updated**: 2026-09-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 俑立千年

手机横屏Three.js遗址展馆。最终交付为 `离线版.zip`，根入口是 `index.html`。页面、主程序、模型部件和纹理已拆成包内本地文件，入口约23KB，最大单文件约3.55MB；上传或复制时必须保留整个包，不能只取index.html。无需外网资源。拆分不等于降低总包体，也不代表旧版iOS兼容问题已解决。

- 游览时只保留左下摇杆、右上菜单与可点击的坑名；悬空时显示上下箭头。单指拖动画面环顾，左下摇杆沿步道行走。首次提示在完成对应操作后消失，并在本机记住。
- 点击陶俑或选择目录结果，镜头先前往展品附近，再观看展示台就地升起，最后靠近细看。单指拖动环绕，双指张开靠近、捏合拉远。
- 右上菜单统一切坑、展品目录、悬空巡视、地图、环境声与沉浸观看。地图默认隐藏，按需打开，可直接收起。
- 「展品目录」统一搜索三个坑的全部展品；支持坑号、序号、俑型和区域关键词，多个词用空格分开。选择结果后自动前往对应坑位近观。
- 点选后仅显示展品名称、序号和观看操作；轻点“展品说明”展开区域、史实与文字出处。上一件/下一件会先收回原展品，新展品的说明默认收起；轻点“收台返回”回到原位置。
- 菜单中的「沉浸观看」让界面朝最近屏边缓缓移出；拖动仍可环顾，轻点画面唤回界面。
- 「悬空巡视」可用摇杆平移，长按右侧上下箭头调节高度，双指张开沿视线靠近、捏合拉远；镜头可进入已发掘区近看，土墙、地面与陶俑会阻挡穿行。轻点“返回步道”退出，升台近观结束后回到原悬空位置与高度。
- 一号、二号、三号为独立场景；轻点左上坑名展开本坑介绍与史实来源。场景事实与示意边界见 SOURCES.md，页面没有外部链接。

## 本机复建

本机已有原始素材。一般改场景只需运行构建；仅改模型预处理时才需重新运行Blender。

```sh
/Applications/Blender.app/Contents/MacOS/Blender --background --python prepare_assets.py
ESBUILD_BINARY='/Users/yiner/视频号/vibe/视频/vibe-remotion-studio/node_modules/@esbuild/darwin-arm64/bin/esbuild' PACKAGE=1 python3 build.py
node --no-warnings verify_layout.mjs
node --no-warnings 验收/verify_package.mjs
```

构建使用本机esbuild，Three.js来自vendor。prepare_assets.py输出可复用的高/低精度几何和纹理；build.py输出唯一离线目录与ZIP。HTML按defer顺序加载数据清单、40个模型部件脚本、17个纹理脚本、主程序；纹理保留data URI，避免外部图片作为WebGL纹理时的本地来源限制。

构建先在临时目录完成与检查，再替换输出，旧产物随后清理。修改后可加 `--output-dir /tmp/yongli-review/site` 先生成验收包，同级生成离线版.zip；验收通过后再替换最终目录与ZIP。浏览器验收和平台复审是独立步骤。

预览服务器（在离线版目录运行）：`python3 -m http.server 4326 --bind 127.0.0.1`。