← ClaudeAtlas

hyper3d-documentarylisted

用 Hyper3D(Rodin Gen-2.5)把一个科普题材做成可分享的单文件网页 3D 纪录片:需求问答 → 写脚本 → 生参考图 → 生成 3D 模型 → 模型库审核 → 动画成片,外加一个项目总览管理页。
xiaohuailabs/hyper3d-documentary · ★ 5 · Data & Documents · score 72
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 步:环