关于 tesseract-3d
tesseract-3d 是指导助手使用 Tesseract CLI 创建和交付可编辑 3D 场景的 Agent Skill,面向场景制作任务。它强调按模式核验属性、分批编辑、渲染检查和独立评审。
主要功能
- 01按场景配方构建 3D 内容
- 02核验 CLI 版本与场景模式
- 03选择路径追踪或光栅渲染
- 04通过胶片条检查动画
- 05执行评估并迭代评审
- 06交付可编辑场景与预览
适用场景
- 01制作可编辑的 3D 场景
- 02检查动画关键时刻的画面
- 03评估并交付渲染结果
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ mirage-hq/ tesseract --skill tesseract-3d安装后在 Claude Code 中输入/tesseract-3d确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/ad-hooks.mdaudio-and-timing.mdcli-version.txtcolor-grading.mdcritic-instructions.mdcritic-review.mdcustom-shader.mdeditorial-decisions.mdfilmstrip-review.mdfx-authoring.mdhdr-blend-modes.mdhdr.mdinstall-cli.mdinstallation.mdlocal-operation.mdmedia-import.mdmotion-design.mdmotion.mdnative-authoring.mdreview-and-delivery.mdscene3d-basics.mdscene3d-blender.mdscene3d-properties.mdscene3d-recipes.mdsound-design.mdspeech-cleanup.mdtelemetry.mdwaveform-editing.mdscripts/tesseract_media.py详细介绍
使用 Tesseract 设计可编辑的 3D 场景
对于某些命令,CLI 可能会发送基本使用情况遥测数据。你可以通过 TESSERACT_SKILL=tesseract-3d 和其他归因变量选择提供归因信息。请遵守 CLI 的遥测退出设置;绝不要代替用户启用遥测。
- 从此
SKILL.md所在目录解析此技能的根目录。阅读 CLI 安装,并在每个会话中检查一次所需的 Tesseract 版本。整个任务中使用解析出的可执行文件路径。Scene3D 需要支持 3D 的 CLI 构建:将tsrct project schema保存到文件,并搜索其中的createFxScene3DLayer(绝不要打印完整架构)。如果找不到该项,请停止并告知用户此 CLI 无法创作 3D 场景;不要改用 2D 图层,也不要重试这些操作。阅读本地操作和原生创作。 - 阅读 Scene3D 基础知识,包括其验证器规则。从匹配的制作方案开始。当用户用 Blender 术语描述工作时,使用 面向 Blender 用户的 Scene3D 选择最接近的控制项,并指出哪些内容没有对应项。确定画布、预期的相机视图、比例(
pixelsPerMeter)和时间安排。对于--hdr、HDR 交付、hdrGraphicsWhiteNits、大于 1 的 RGB 值或 HDR 静帧,请阅读 HDR;Radiance.hdr环境贴图只需阅读 Scene3D 基础知识。修改场景时保留现有标识、动画和打包资源。 - 选择渲染器:逼真的光照、反射和折射优先使用路径追踪器;风格化图形以及快速布局或运动检查则使用光栅渲染器。
- 构建原生可编辑项目,而非预渲染图像。编写每项操作前,先在
tsrct project schema中查找其准确字段;不要臆造属性名、枚举拼写或命令。分小批次应用;遇到被拒绝的批次时,停止操作,不要渲染。对于导入的模型,阅读转换诊断,并在poseStack中列出片段、变形和节点覆盖项(参见导入的模型)。 - 在功能关键时刻使用胶片条审查。只有采样帧的画面确实不同,才能确认动画有效;存储的关键帧或绑定不能作为证明。结构性编辑后检查已保存的 JSON,并在交付前重新加载文档。使用最终渲染器和设置检查代表性帧,并在长时间导出前估算成本。第 6 步之前,遵循审查与交付,并运行 Scene3D 基础知识中的相关
tsrct evaluate --checks方案,修复可操作的发现并重新运行检查。只有在还需要逐项测量时才使用scene3d.items;它本身不会运行检查。 - 阅读并遵循评审者审查:安排两位独立评审者——一位艺术总监,以及一位针对场景用途的专业人士,例如负责产品可视化的主管来评审产品镜头——为渲染预览打分,并在各轮之间修改,直到两人都给出至少 8.5/10 的评分,最多进行三轮审查。对于路径追踪场景,使用最终渲染器标志渲染提供给评审者的视图,并在他们的 Renderer 行中写明这些标志。告知用户审查计划、每轮的评分和反馈,以及最终分数。
- 交付可编辑的
.tsrct文件和渲染预览。说明哪些渲染使用了路径追踪器,以及使用了哪些标志。对于不支持的控制项、导入损失、近似处理和未经验证的输出,都应明确说明,不要悄悄替换设计。按照存储中的说明,精简检查点、转储和审查渲染;详细场景的每份完整副本都会占用大量空间。
评论
支持 Markdown