mcpField
T
tesseract-3d

tesseract-3d

github.com/mirage-hq创意与媒体304715 次安装2 天前更新
代码仓库

关于 tesseract-3d

tesseract-3d 是指导助手使用 Tesseract CLI 创建和交付可编辑 3D 场景的 Agent Skill,面向场景制作任务。它强调按模式核验属性、分批编辑、渲染检查和独立评审。

主要功能

  1. 01按场景配方构建 3D 内容
  2. 02核验 CLI 版本与场景模式
  3. 03选择路径追踪或光栅渲染
  4. 04通过胶片条检查动画
  5. 05执行评估并迭代评审
  6. 06交付可编辑场景与预览

适用场景

  1. 01制作可编辑的 3D 场景
  2. 02检查动画关键时刻的画面
  3. 03评估并交付渲染结果

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/mirage-hq/tesseract --skill tesseract-3d

安装后在 Claude Code 中输入/tesseract-3d确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
ad-hooks.md
audio-and-timing.md
cli-version.txt
color-grading.md
critic-instructions.md
critic-review.md
custom-shader.md
editorial-decisions.md
filmstrip-review.md
fx-authoring.md
hdr-blend-modes.md
hdr.md
install-cli.md
installation.md
local-operation.md
media-import.md
motion-design.md
motion.md
native-authoring.md
review-and-delivery.md
scene3d-basics.md
scene3d-blender.md
scene3d-properties.md
scene3d-recipes.md
sound-design.md
speech-cleanup.md
telemetry.md
waveform-editing.md
scripts/
tesseract_media.py

详细介绍

使用 Tesseract 设计可编辑的 3D 场景

对于某些命令,CLI 可能会发送基本使用情况遥测数据。你可以通过 TESSERACT_SKILL=tesseract-3d 和其他归因变量选择提供归因信息。请遵守 CLI 的遥测退出设置;绝不要代替用户启用遥测。

  1. 从此 SKILL.md 所在目录解析此技能的根目录。阅读 CLI 安装,并在每个会话中检查一次所需的 Tesseract 版本。整个任务中使用解析出的可执行文件路径。Scene3D 需要支持 3D 的 CLI 构建:将 tsrct project schema 保存到文件,并搜索其中的 createFxScene3DLayer(绝不要打印完整架构)。如果找不到该项,请停止并告知用户此 CLI 无法创作 3D 场景;不要改用 2D 图层,也不要重试这些操作。阅读本地操作和原生创作。
  2. 阅读 Scene3D 基础知识,包括其验证器规则。从匹配的制作方案开始。当用户用 Blender 术语描述工作时,使用 面向 Blender 用户的 Scene3D 选择最接近的控制项,并指出哪些内容没有对应项。确定画布、预期的相机视图、比例(pixelsPerMeter)和时间安排。对于 --hdr、HDR 交付、hdrGraphicsWhiteNits、大于 1 的 RGB 值或 HDR 静帧,请阅读 HDR;Radiance .hdr 环境贴图只需阅读 Scene3D 基础知识。修改场景时保留现有标识、动画和打包资源。
  3. 选择渲染器:逼真的光照、反射和折射优先使用路径追踪器;风格化图形以及快速布局或运动检查则使用光栅渲染器。
  4. 构建原生可编辑项目,而非预渲染图像。编写每项操作前,先在 tsrct project schema 中查找其准确字段;不要臆造属性名、枚举拼写或命令。分小批次应用;遇到被拒绝的批次时,停止操作,不要渲染。对于导入的模型,阅读转换诊断,并在 poseStack 中列出片段、变形和节点覆盖项(参见导入的模型)。
  5. 在功能关键时刻使用胶片条审查。只有采样帧的画面确实不同,才能确认动画有效;存储的关键帧或绑定不能作为证明。结构性编辑后检查已保存的 JSON,并在交付前重新加载文档。使用最终渲染器和设置检查代表性帧,并在长时间导出前估算成本。第 6 步之前,遵循审查与交付,并运行 Scene3D 基础知识中的相关 tsrct evaluate --checks 方案,修复可操作的发现并重新运行检查。只有在还需要逐项测量时才使用 scene3d.items;它本身不会运行检查。
  6. 阅读并遵循评审者审查:安排两位独立评审者——一位艺术总监,以及一位针对场景用途的专业人士,例如负责产品可视化的主管来评审产品镜头——为渲染预览打分,并在各轮之间修改,直到两人都给出至少 8.5/10 的评分,最多进行三轮审查。对于路径追踪场景,使用最终渲染器标志渲染提供给评审者的视图,并在他们的 Renderer 行中写明这些标志。告知用户审查计划、每轮的评分和反馈,以及最终分数。
  7. 交付可编辑的 .tsrct 文件和渲染预览。说明哪些渲染使用了路径追踪器,以及使用了哪些标志。对于不支持的控制项、导入损失、近似处理和未经验证的输出,都应明确说明,不要悄悄替换设计。按照存储中的说明,精简检查点、转储和审查渲染;详细场景的每份完整副本都会占用大量空间。

评论

支持 Markdown