viettranx/3dviz-pro-max

3Dviz Pro Max – AI 驱动的 3D 场景创作

是什么 – 一个为 Claude Code、Codex 及类似 LLM 代理设计的 独立技能，可将自然语言意图（例如 “构建一个带有移动生物的小型幻想村庄”）转化为完整且可渲染的 Three.js 场景。该技能提供 10 步工作流、可搜索的 223 个“食谱”目录、440 条知识记录、22 个现成的套件蓝图、风格配置文件，以及 Python 辅助工具，用于捕获渲染帧，供代理检查。

如何工作

1. 意图 → 推理 – 代理解析用户请求，决定所需对象、风格和行为。
2. 复用/适配套件 – 从目录中选择套件蓝图（例如地形、小屋、齿轮组），或自行编写新蓝图。
3. 构建首帧视图 – 使用选定的资产、照明装置、相机设置等填充 Vite + Three.js 模板。
4. 运行并捕获 – scripts/capture.py 启动无头 Chromium 实例（通过 Playwright），在真实 GPU 上渲染场景，并写入 PNG 帧和日志。
5. 优化 – 代理将观察到的帧与预期描述进行比较，调整参数，重复直到报告与证据匹配。
6. 报告 – 最终输出为构建内容的简要描述，以及捕获的图像。

包含内容

项目	数量	说明
食谱	223	24 个主题方向（环境、解剖学、机器人学等）
知识记录	440	风格、照明、相机、材质的默认设置
套件蓝图	22	经 SHA‑256 验证的已验证 Three.js 模块（T0–T3 层级；T4 未提供）
风格配置文件	37	带数值默认值的命名外观
示例研究	37	完全可运行的演示（心脏解剖、齿轮机械、幻想村庄等）
展示帧	21	实际 GPU 捕获（1920×1080）存储在 docs/demos/

安装 – skills/3dviz-pro-max/ 文件夹整体即为插件。

# Claude Code（插件目录）
ln -s $(pwd)/skills/3dviz-pro-max ~/.claude/skills/3dviz-pro-max
# 或作为 zip 加载
claude --plugin-dir 3dviz-pro-max-0.1.0-plugin.zip

对于 Codex，将文件夹复制到 Codex 的技能目录中。仅捕获步骤需要 Playwright（用于 Chromium）和可选的 Blender 4.2+；其余部分使用普通 Node 即可运行。

运行演示

cd examples
pnpm install          # 安装 Vite + Three.js 依赖
pnpm dev               # 提供 http://localhost:4180/<demo-id>/

每个演示文件夹包含提示、生成的场景、源参考和限制。

典型用例

• 快速原型设计：仅用一句话构建游戏关卡资产或科学可视化。
• 教学：学生让 LLM 描述一个概念（例如 “展示一个 3:2 比例的齿轮对”），并获得一个可交互的 Three.js 模型进行探索。
• LLM 接地性评估：技能内置的检索案例测试使研究人员能够衡量代理将意图转化为可观测图形的能力。

诚实的限制

• 该技能仅 捕获 帧，不保证每个食谱都成功渲染。
• 知识记录是编辑审核的，而非从运行时观察中推导。
• 未提供 T4 级别蓝图；最高保真度资产为两个 Blender 烘焙的 GLB（T3 级别）。
• 评估分数基于每条件单次运行，因此为指示性而非结论性。
• 若无 Playwright/Chromium 或 Blender，捕获步骤将中止，代理需报告缺失帧。

许可证 – 仓库代码、数据和原创媒体采用 MIT 许可证。第三方资产保留其原始许可证（例如 BodyParts3D 网格采用 CC BY‑SA 2.1 JP）。

---

所有细节均直接来自仓库的 README；未添加任何外部假设。