1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | threejs-architecture-effects |
| 作者/维护者 | Hailey(GitHub:lhlGitHub) |
| 来源链接 | https://github.com/lhlGitHub/threejs-architecture-effects |
| 许可证 | MIT |
| GitHub Stars / Forks | 509 / 63(GitHub API) |
| 最新版本 | 1.0.0(SKILL.md 元数据),2026-09-22 发布 |
| 安装方式 | 复制目录到各 agent 的 skills 目录 |
| 运行要求 | Node.js 22.13+、npm、支持 WebGL2 的浏览器;无需 API Key |
项目自述名称与正式名称一致。
2. 功能介绍与亮点
用 Three.js 生成可旋转的真实三维古建筑逐层搭建动画(亭、塔、钟楼等),不是把图片贴到平面上揭幕。
- 由单一 0–1 进度值驱动全部构件,支持播放、暂停、倒拖、重放,结果确定可复现
- 施工顺序固定为:地基 → 承重框架 → 砖砌 → 楼板 → 上层墙体 → 斗拱/飞檐/瓦 → 装饰
- 砖、木、灰泥、瓦、石、铜均为程序化 PBR 材质,不依赖付费模型
- 附带可直接运行的 Vite + React + Three.js 起步工程(含钟楼示例、飞檐与石狮近观相机)
- 内置渲染统计(调用数、三角形数、帧率)与性能约束:阴影缓存、按需渲染、GPU 位移
3. 适用场景
分类:前端与设计。适合做官网/展示页中的建筑生长特效、文旅与古建主题可视化、教学演示的前端开发者与设计师。已有项目时,它要求先检查现有场景、保留原有造型再修改,不覆盖现有代码。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | README 给出 ~/.claude/skills/ 安装路径,标准 SKILL.md |
| Codex | 原生支持 | 附带 agents/openai.yaml 界面元数据,README 给出 ~/.codex/skills/ 路径 |
| OpenClaw | 未验证 | 标准 SKILL.md 格式,无专门说明 |
| Hermes Agent | 未验证 | 同上 |
5. 推荐理由
古建筑搭建动画有明确的方法门槛:施工顺序、构件关系、材质分层、深度/颜色着色器同步,缺少方法时模型容易生成“整层缩放”或“透明度淡入”的假效果。该 skill 把这些经验写成可执行步骤,并配一个能直接跑起来的示例,降低了从零写 3D 场景的成本。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 5 | 509 stars、63 forks,建仓不满一个月;skills.sh 安装量 2;暂未发现独立第三方讨论 |
| 可用性 | 8 | 步骤清晰,附带示例工程与三份参考文档;需 Node 22.13+ 与 WebGL2 浏览器;2026-09-22 发布后尚无后续提交 |
| 安全性 | 8 | 见下方检查清单 |
综合 = 三项均值 = 7.0。
安全检查清单:
- shell 命令:仅一个
scaffold.mjs,把起步工程复制到新目录,目标已存在则拒绝,不安装依赖、不启动服务 - 联网外发:源码与脚本中未发现网络请求或外部链接;运行时仅本地开发服务器
- 凭据:不需要
- 可疑指令:SKILL.md 与脚本中无提示注入迹象,还明确要求不得复制作者私有会话、路径或环境文件
- 作者信誉:个人开发者,GitHub 账号 2017 年创建;fork 者账号年龄分散,未见异常聚集
- License:MIT,LICENSE 文件存在
- 维护:2026-09-22 发布,尚属新项目
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 差异 |
|---|---|---|
| threejs-architecture-effects | 古建逐层搭建动画 + 起步工程 | 垂直于建筑生长,含施工顺序方法与示例 |
| cloudai-x/threejs-skills | 通用 Three.js 模块(着色器、光照、后处理) | 覆盖面广,不含建筑搭建流程 |
| linegel/threejs-complete-set-of-skill | 大型 Three.js 技能集合 | 含程序化建筑/城市等多个方向,粒度更分散 |
| 通用 3D 站点生成类 skill | 按参考图生成网页 3D 场景 | 偏图像到场景,不强调构件搭建时序 |
核心差异:它不是通用 Three.js 手册,而是把“古建怎么一块块搭起来”这一件事讲透,并交付可运行的示例。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
README 提供中英文说明,另有 20 秒演示视频与 GIF 预览。
10. 安装使用方式
git clone https://github.com/lhlGitHub/threejs-architecture-effects.git
cp -R threejs-architecture-effects ~/.claude/skills/
重启会话后提示,例如:“Use $threejs-architecture-effects to make a Chinese pavilion like the starter”。不借助 agent 时:
node threejs-architecture-effects/scripts/scaffold.mjs ./my-building
cd my-building && npm ci && npm run dev
11. 注意事项
- 示例钟楼是参考而非历史复原,不应宣称历史准确性
- 默认无音频;如需配乐须使用有授权的素材
- 项目较新,接口与示例后续可能变动
- 动画性能受设备 GPU 影响,单次截图不能代表所有设备帧率