4dgspl.at — 4D Gaussian Splatting

4dgspl-tools

用于通过 4dgspl.at 创建 4D Gaussian Splatting (4DGS) 内容的开源工具。将 3D 模型、动画角色（例如来自 Mixamo 的角色）或 Blender 场景转换为同步的多摄像机渲染，生成精确的 COLMAP 标定，进行验证，并转换为可在浏览器中播放的 4DGS 序列。

这些工具既适用于 AI 编码 Agent（Claude Code、Codex、……），也适用于普通用户。Agent：请从 AGENTS.md 开始。

工具	功能
tools/4dgspl_blender_rig.py	Blender：在场景周围构建一个包含 4–16 台摄像机的环形布局（推荐 8 台，分为两个高度），从每台摄像机渲染 cam00.mp4 …，并写入 COLMAP cameras.txt + images.txt（kalibrasyon.zip）。默认使用纯黑色世界背景。
tools/4dgspl_yukle.py	无依赖项的 Agent 密钥上传客户端（DGSPL_ANAHTAR）。它会验证、创建项目、上传、提交、等待并下载逐帧 3DGS 结果：--gonder --bekle --indir result。
tools/4dgspl_mcp.py	无依赖项的 MCP 服务（stdio）。Claude Code、Codex、Cursor 或 Claude Desktop 可将 4dgspl.at 用作工具：get_4dgs_guide、check_delivery、upload_project、submit_project、project_status、list_projects、download_result。
tools/4dgspl_kontrol.py	无依赖项的上传前检查工具。它会检查视频名称、分辨率、fps 和帧数、标定格式和像素单位、摄像机是否朝向共同中心、高度多样性和环形布局间隙，以及背景是否为黑色。支持 --json 输出；出错时退出码为 1。

快速开始

# 1. Camera ring + render + calibration (Blender 4.x)
blender -b scene.blend -P tools/4dgspl_blender_rig.py -- --kamera 8 --yaricap 3.5 --cikti //teslim --render

# 2. Validate
python3 tools/4dgspl_kontrol.py teslim

# 3. Upload, process and download with your agent key (4dgspl.at → Projelerim → Ajan anahtarları)
export DGSPL_ANAHTAR=4dg_…
python3 tools/4dgspl_yukle.py teslim --gonder --bekle --indir result

没有标定文件的实景视频：添加 --colmap（至少 8 台摄像机，彼此间隔不超过 45°，场景需有纹理）。

最重要的规则：

• **背景：**纯黑色世界背景（0, 0, 0）。
• **材质：**哑光。
• **摄像机：**至少 6 台，推荐 8 台；摄像机不得移动。
• **时长：**关键动作应出现在前 10 秒内。
• **构图：**主体占画面高度的 70–85 %。

详细信息：Agent 指南 · 拍摄指南 · 示例 · llms.txt

Agent 技能

skills/4dgs-blender/SKILL.md 将整个工作流打包为一项 Agent 技能：通过一个 Blender 场景创建 GLB 3D 动画、视频、静态图像和 4DGS 视频。要在 Claude Code 中安装，请将该文件夹复制到 ~/.claude/skills/。能够从自身技能文件夹读取 SKILL.md 的 Agent 可以使用相同文件。

MCP 服务

mkdir -p ~/.4dgspl && cd ~/.4dgspl && curl -O https://4dgspl.at/araclar/4dgspl_mcp.py \
  -O https://4dgspl.at/araclar/4dgspl_yukle.py -O https://4dgspl.at/araclar/4dgspl_kontrol.py
claude mcp add 4dgspl --env DGSPL_ANAHTAR=4dg_… -- python3 ~/.4dgspl/4dgspl_mcp.py   # Claude Code
codex mcp add 4dgspl --env DGSPL_ANAHTAR=4dg_… -- python3 ~/.4dgspl/4dgspl_mcp.py    # Codex

• Claude Desktop：从最新发布版本安装 4dgspl.mcpb，并在设置中输入密钥。
• 其他客户端：命令为 python3，参数为 4dgspl_mcp.py 的路径，环境变量为 DGSPL_ANAHTAR。
• 没有密钥时，get_4dgs_guide 和 check_delivery 仍可使用。
• 已列入 MCP Registry，名称为 io.github.snmzzcenk/4dgspl（server.json）。使用 python3 mcpb/build.py 构建软件包。

输出

4dgspl.at 会将每一帧重建为 3D Gaussian Splatting 场景（gsplat）。输出包括：

• PlayCanvas 格式的 compressed.ply 序列；
• 包含帧数、fps、起始摄像机和指标的 sahne.json；
• MP4 预览视频。

使用 PlayCanvas 在浏览器中播放序列，或在 SuperSplat 中打开单帧。

土耳其语

用于通过 4dgspl.at 创建 4D Gaussian Splatting 内容的开源工具。Blender rig 脚本会搭建一个包含 4–16 台摄像机的环形布局，从每台摄像机进行渲染并写入 COLMAP 标定文件。检查工具会根据引擎规则，在上传交付内容前进行检查（--dil tr）。面向 AI Agent 的工作流：https://4dgspl.at/ajan.html

此仓库中的工具是 https://4dgspl.at/araclar/ 的副本；网站是源站，二者会保持同步。MIT 许可证。