hyper3d-documentarylisted
Install: claude install-skill xiaohuailabs/hyper3d-documentary
# hyper3d-documentary:从一句话想法到 3D 网页纪录片
> 本文档使用自然语言 + 代码片段混合编写。代码部分按其语言语义执行;代码块只写���辑骨架,判断标准写在代码块外面的正文里。
## 定位
用户说"我想做一个 ×× 的 3D 纪录片",本技能带着用户走完整条线,最终交付一个**双击就能打开、可以直接发给别人的单文件 HTML**:自动播放的分镜动画 + 片尾自由旋转、拆解、点零件看说明。3D 模型由 Hyper3D 的 Rodin Gen-2.5 从参考图生成,渲染引擎(three.js)已经打包在技能里,成片不依赖任何网络资源。
技能是原子的:生参考图的方式由用户在 `config.json` 里配置(任何能"提示词 → 图片文件"的命令都行),不依赖其他技能。
## 运行环境
- Python 3.10+(所有脚本),无第三方依赖
- Node 18+(只在压缩模型时用,首次运行自动 `npm install` 到 `tools/`)
- 可选:`pip install playwright && playwright install chromium`,用来给成片自动截图验收
- Hyper3D API Key:在 hyper3d.ai 后台申请。按优先级从环境变量 `HYPER3D_API_KEY` → 本目录 `config.json` 的 `hyper3d_api_key` → 项目目录 `.env` 读取
## 配置
第一次用时把 `config.example.json` 复制成 `config.json` 再填。`config.json` 含真实 Key,只在本地用;分享技能时只分享 `config.example.json`。各字段含义写在 example 文件的 `_说明` 里。
## 项目落盘结构
所有项目放在 `config.json` 的 `root` 下,一个项目一个目录,产物全部是用户能直接打开看的文件:
```
<root>/
├── 管理页.html 所有项目的总览(每做完一步重新生成)
├── 共享缓存/ 地球贴图、星表等跨项目复用的下载
└── <项目名>/
├── 需求.md 第 1 步:问答定下来的需求
├── 脚本.md 第 2 步:分镜脚本(人读)
├── 素材清单.json 第 2 步:模型表 + 关键帧表(脚本读)
├── 参考图/M1-<名>/1-四分之三.png … 第 3 步:每个模型四个视角;<视角>-提交.png 是去掉文字标识后送 Hyper3D 的版本
├── 参考图/K1-<名>.png 第 3 步:分镜关键帧概念图(只给人看,不建模)
├── 参考图.html 第 3 步:审图页
├── 模型/M1-<名>/ 第 4 步:Hyper3D 回包、原始 glb、零件/、web-4096.glb
├── 模型库.json 第 5 步:每个模型的状态、积分、体积、备注
├── 模型.html 第 5 步:模型库页(3D 预览 + 审核)
├── 素材/贴图/ 第 6 步:环