一句话介绍:ThreeJSON 支持使用 JSON 文本描述构建 3D 场景的一切。
本项目使用 MIT 协议开源。
GitHub 仓库地址: https://github.com/nnrj/threejson
Demo 页面: https://nnrj.github.io/threejson/
Npm: https://www.npmjs.com/package/threejson
可使用 VSCode 打开后,用 Live Sever 插件打开其中的 示例 html 页面体验。
ThreeJSON 的哲学浓缩成四句话:
Scene as Data —— 场景即数据
Runtime as Engine —— 运行时即引擎
Domain as Extension —— 业务域即扩展
Agent as Operator —— Agent 即操作者
说人话就是:
你负责描述世界,AI 负责创造和修改世界,ThreeJSON 渲染和运行世界。
目前项目已开源,欢迎 V 友 们围观、试玩、提 Issue 。
[开始念经]
ThreeJSON 是一个 JSON 驱动的 Three.js 声明式场景运行时与 Web3D 引擎。它不是对 Three.js 的简单 API 包装或替代品,而是建立了一条完整的数据驱动链路:场景描述 统一解析 → 对象创建 → 场景装配 → 实时运行 → 增量修改 → 场景持久化。
通过将 3D 场景抽象为结构化数据,ThreeJSON 解耦了业务逻辑与底层渲染,让开发者无需重复编写冗长的初始化代码,即可高效构建复杂的 3D 交互世界。
核心架构与技术特性
1. 规范真源:JSON 为王 (Single Source of Truth)
在 ThreeJSON 中,JSON 是场景的唯一规范真源。
2. 完备的声明式对象与组件体系
内置丰富的声明式对象,支持位置、旋转、缩放、材质、纹理、动画和事件的完整参数化配置:
3. 高效的对象管理与运行时变更
4. 动态交互、动画与扩展机制
面向 AI 与 Agent 的下一代设计
ThreeJSON 为大语言模型( LLM )和自主 Agent 提供了天然契合的 3D 场景表达方式。AI 不必尝试去生成晦涩且容易出错的 Three.js 源码,只需输出高度结构化的场景 JSON 。Agent 可以通过稳定的对象 ID 、JSON Patch 、动态命令接口和运行时变更为场景注入智能。
其核心设计哲学可完美概括为:
Scene as Data + Runtime as Engine + Domain as Extension + Agent as Operator
当前( 2026 年 7 月 6 日),GitHub Pages 页面加载不出场景,可在 Clone 本地体验,预计近几天会修复该问题。
[2026.07.06] 在线 Demo 页面 资源 404 的问题已修复,若仍然遇到,可清除页面缓存或使用其他浏览器打开。感谢大家的反馈。

