3D-BOX 导演预演
SkillDev tools3D-BOX director previz workflow, build whitebox scenes, blocking, and multi-camera setups from a single sentence; match camera framing and movement against the user's words, adjust by name through conversation, and once the user is satisfied, hand the full previz to the generation stage as a refere
Use 3D-BOX 导演预演 in Claude, ChatGPT or Ahel Desktop
Free. Sign in, add 3D-BOX 导演预演 and connect your AI. About a minute.
Also: Claude Code · Cursor · Codex
Then ask your AI: use the 3D-BOX 导演预演 skill
Details
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; Ahel provides instructions and does not run this skill.
No other account needed.
Add Ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.
What this skill tells your AI
The instructions your AI receives, as published by aqm857886159/nomi in skills/director-3dbox/SKILL.md and read by Ahel’s review.
用户想先看「这场戏怎么站、怎么拍」再出片时用:他描述一场戏、一组镜头,或者对已有预演说「第二镜改成特写」。
计划只写意图(谁在哪、做什么、每一镜怎么框怎么动),坐标和机位都由 Nomi 的编译器算,再由测量模块把每一镜实测出来。
镜头语言(景别、角度、运镜的情绪含义)参考 director-cinematography 技能,这里不重复。
工作流
- 先看画布:用 look_at_canvas 找到要做预演的那一镜(视频镜头节点)。画布上已经有 3D-BOX 节点时,记下它那一行的 revision、镜头名和角色名——之后改它就用这些名字。
- 第一次搭:用 stage_shot 交一份完整的导演计划。要给某一镜做预演,就把那一镜的节点 id 放进 target;用户只是想先看看,就不给 target,做一个独立预演。
- 对照实测:结果里有每一个 cut 的实测景别和运镜、问题清单、规范化后的完整计划。逐镜和用户的原话对照;对不上的(景别量出来不对、主体出画、穿模)按名字改,最多再改两三轮,然后如实告诉用户哪里已经对上、哪里还差。
- 请用户看预演:用一句话讲清每一镜实测是什么(例如「第 1 镜全景固定,第 2 镜特写推近」),并说出动作库里没有、会写进提示词交给视频模型去演的细节动作。
- 聊着改:用户要改哪里,就只交改动的那几处,用上一次结果里的 revision;不要把整份计划重写一遍。结果说没有变化时,直接告诉用户「已经是这样了」。用户发消息时如果带着一条「director.shot」上下文(他在导演台里选中了某一镜),没说改哪一镜就是改那一镜:用那条上下文里的导演节点、修订号和镜头名。 用户在精修里亲手调过的东西默认保留。结果里 reorderedOverrides 不为空,说明这次改动直接改到了他手调过的地方、那几处手调已按新指令重算——要一条条告诉他(例如「第 2 镜的机位你手调过,已按特写重算;说撤销就能回到你调的样子」)。changedEntities 是没被点名、但跟着变了的东西(例如挪了一个人,拍他的机位跟着重算),简短说一句即可,上面的手调照样保留。
- 撤销:用户说撤销、改回去,就用 undo 撤掉上一次 stage_shot 结果里的那个 changeId。
- 出片:用户明确说「就用这个出片」之后,交给生成环节(generate)。预演还在渲染或者渲染失败时,先把原因告诉用户,等预演好了(look_at_canvas 那一行显示 ready)再来;失败的预演请用户在节点上点「重试预演」,太长的就把计划缩短。
- 让预演真正进到这一镜的草稿里:预演好了以后,look_at_canvas 那一行会给出
previewAssetId。生成环节拒绝并说「草稿没有用上预演」时,用 draft_shots 改这一镜(同一个 operationId 和 shotId):把这个素材 id 放进 references,模式换成这个模型能收参考视频的那个(用 list_models 查),只改这两件,提示词别动;改完再交给生成环节。
计划怎么写
- 用户提到的人、车、物、地点,原词抄进角色描述、场景标签或场景件,起一个看得懂的英文名字当 id(「图书管理员」→ librarian),之后所有地方都用这个名字。
- 镜头按时间排,窗口用秒,首尾相接;只有镜头要从上一镜的结尾接着走时才用连续转场。
- 两人对话的正反打,全场保持在轴线的同一侧;过肩镜头写清是越过谁的肩。
- 每一镜只要一个主要运镜;用户没要求运动就用固定机位,不要为了「有动感」加运镜。
- 预演最长 10 秒;一场戏更长时,拆成两段预演分别挂到两个镜头上。
三份范例(场景都不取自评测题库)
图书馆还书:「图书管理员把书递给学生,正反打,最后慢慢推近学生。」 场景选 room,标签写「图书馆」;两个角色 librarian、student,学生站在管理员面前;三镜——0–3 秒全景固定交代两人,3–6 秒越过学生肩膀拍管理员中景,6–9 秒越过管理员肩膀拍学生、慢速推近。
洗车店:「工人绕着一辆车擦车窗,镜头低机位跟着他横移。」 场景选 street,标签写「洗车店」;角色 worker(人)和 car(车辆,停在路面锚点上);走位是工人绕车走;两镜——0–4 秒低机位全景跟着工人横移,4–7 秒中近景固定拍他擦车窗。
公交站:「老人在站台等车,公交车进站停下,先全景再给老人中景。」 场景选 street,标签写「公交站」;角色 old_man(人)和 bus(车辆,沿路面驶入后停下);两镜——0–4 秒远景固定看公交进站,4–8 秒中景固定拍老人抬头看车。
Signals
- GitHub stars
- 550
- Forks
- 124
- Last commit
- Oct 2026
Advanced
- Item type
- skill
- Key
director-3dbox- Source
- github.com/aqm857886159/nomi