Nyxera0x/cutaway

项目介绍

Cutaway 是一个 Claude Code 技能：给它一张机械动物、机器或设备的参考图，它会在 three.js 里用代码重建这个物体——每个外壳、齿轮和尖牙都是代码写出来的，而不是导入的素材。随后物体在镜头前拆解：光标按下一个按钮，某个零件在自己的镜头下分离，最后整体爆开再合拢。适合想要一张静帧或一段机械物体短动画、但不想手动建模的人。

流程围绕评审展开。Claude 读取图片后，会为这张图生成 10–12 条检查项，每轮对每条打「是 / 部分 / 否」；暗色机械占比和比例这两项会与图片做可量化的比对。第 2 轮结束后 Claude 会停下来输出静帧，等你确认后才开始渲染影片。

快速使用

环境要求：Node.js 20 或更高版本；输出视频需要 ffmpeg，生成声音需要 Python 3。

1. 为 Claude Code 全局安装该技能：

   npx skills add Nyxera0x/cutaway -g -a claude-code
   

2. 在安装目录中安装依赖与用于截帧的 Chromium：

   npm install && npx playwright install chromium
   

3. 在 Claude Code 中给出图片并用自然语言描述需求，例如：「这是一只机械螳螂。把它做成可以拆开的 3D 物体，先停在静帧让我检查。」确认静帧后再让它出片。

如果暂时没有自己的图片，可以先构建自带示例：

node sims/build.mjs tarantula-film

这会把物体打包成单个自包含 HTML 文件，输出到 cutaway-out/dist/tarantula-film.html。piranha-film 和 wasp-film 用法相同。生成这些示例所用的提示词在 docs/PROMPTS.md 中。

文件与流程

SKILL.md 记录 Claude 遵循的工作顺序、视觉规则和评审循环。docs/JOB_DESCRIPTION.md 是每个物体开工前读取的任务说明，你的修正应当写进这里。docs/ 下还有 CHECKLIST.md、PROMPTS.md 和 LESSONS.md。

每个示例在 sims/ 下拆为 -shared（物体本身）、-film（完整影片）和 -demo（10 秒版本）。运行时、舞台和 shader 预热在 sims/kit/；周边页面与绿色外观在 sims/green/，附带三个检查工具（残留颜色探针、相机轨迹、零件锚点）。sims/build.mjs 将 three.js 和字体内联进 HTML；sims/capture.mjs 逐帧渲染 60 fps mp4 或静帧检查表。sfx/ 与 run_sfx.py 生成与时间线同步的程序化音效，响度母带处理到 −14 LUFS。

使用约束

• 视频输出依赖 ffmpeg，声音生成依赖 Python 3。
• 渲染依赖 Playwright 的 Chromium，需单独安装。
• 方法针对具体图片：Claude 不会导入参考图，所以还原度取决于生成的检查项和量化比对，而不是自动图像匹配。
• 项目采用 MIT 许可证。运行时、帧截取、声音引擎和评审规则来自 claude-motion（MIT）；录音采样为 Freesound 的 CC0 素材，出处见 sfx/samples/SOURCES.md。

HotRepo 点评

该项目在 2026-11-08 的 JavaScript 新项目榜上有记录，当时 103 星、19 个 fork，在记录到的一小时窗口内新增 3 星、1 个 fork。样本只有一小时，也未进入全语言日榜，说明不了太多热度问题。更值得关注的是设计上的确认节点：第 2 轮就停在静帧，让人先核对模型与参考图是否一致，确认后才进行成本更高的影片渲染。

项目源码与说明