MotionCraft — 通用技能:解说视频与16类Shorts制作
独立技能(零应用依赖),将一句话创意故事转化为:视觉方向建议、分步剧本(开篇钩子 → 场景1 → 场景2 → ... 最长10分钟)、独立 <slug>.html 文件(双击即可在浏览器中运行,内置9:16 ↔ 16:9比例切换按钮和WebAudio音效)、源代码包 <slug>-source.zip 以及 MP4视频渲染。
必遵工作流程(5步)
第1步 — 视觉建议与剧本规划(开篇钩子 → 场景1..N)
当用户提供一个故事创意时(如果未指定比例或时长,默认使用9:16竖屏 30–45秒 用于短篇事实,或16:9横屏 60–600秒 用于深入讨论):
- 从16个官方类别中选择最匹配的1个:
3D·等距视图·房屋拆解·3D棍棒人·天文学·动物世界·海洋·科学与自然·历史·地图·伊斯兰·地理·解剖学·民间传说·卡通·2D动画。 - 制定具体的视觉建议:
- 物体与道具(
objects):有纹理/关节的主要主体 + 至少3个用于尺度/证据比较的道具。 - 摄像机与转场(
camera):多镜头模式(远景→特写细节→环绕/快速摇摄/拉远)。 - 氛围与光照(
atmosphere):天空/空间氛围、雾气/体积光、调色板以及叙事基调。
- 物体与道具(
- 编写分步剧本(
0到最终时长秒,无空白间隙):- 第一部分必须是
开篇钩子(3–10秒,激发好奇心的开场)。 - 接着是
场景1、场景2等,并以一个强有力的事实性结论收尾(约2.2字/秒)。 - 对于长视频(>60秒至
600秒/10分钟),请阅读 10分钟长视频指南。
- 第一部分必须是
第2步 — 阅读类别食谱与黄金标准代码示例(必须!)
不要凭猜测编写 sceneCode! 在编写动画代码之前:
- 阅读 16类别目录 中的类别表格和
styleID,以及 引擎v4 API参考 (MF) 中的运行时函数列表。 - 阅读最相关的官方源代码示例 黄金标准代码参考。
- 质量等同法则: 物体密度、纹理细节(
CanvasTexture/ 多层SVG /world-atlas海岸线 / GLSL着色器)、光照和摄像机流畅度必须与golden-showcases.md中的示例等同。禁止绘制无纹理或道具的纯色方块/圆形!
第3步 — sceneCode 编写黄金规则
sceneCode 作为 (MF, stage, tl, W, H, DUR) 的函数体执行:
- 双响应式(
9:16竖屏 &16:9横屏): 始终使用W和H的比例(W * 0.5、H * 0.45、size: W < H ? 50 : 56、labelX: W < H ? W * 0.08 : W * 0.54),确保动画在1080×1920和1920×1080下均完整显示且不被裁剪。 - 不要覆盖变量
H: 切勿编写const { H } = MF;,因为这会覆盖舞台高度H!始终通过MF.前缀调用(MF.H、MF.S、MF.T)。 - 100% 确定性: 禁止使用
Math.random()、Date.now()、setTimeout或setInterval。请使用MF.rng('固定种子')、tl上的时间线动画,以及MF.onTick((t) => ...)作为时间t的纯函数。 - 第0帧立即活跃: 舞台元素和
开篇钩子的开场标题必须使用at: 0,以确保第一帧不为空或黑屏。 - 反PPT风格: 同一时间最多显示1个标题(
MF.highlightHeadline)+ 1个标注/数字(MF.leaderCallout/MF.bigStat)。故事必须由世界/物体的动态变化和摄像机运动驱动,而非一堆文字卡片!
第4步 — 构建独立文件(.html、-source.zip、-naskah.md)
创建JSON规格文件(例如 spec.json):
{
"title": "视频标题",
"idea": "用户原始故事创意",
"style": "stickman-3d",
"aspectRatio": "9:16",
"duration": 30,
"visualRecommendation": {
"objects": "...",
"camera": "...",
"atmosphere": "..."
},
"scenes": [
{ "label": "开篇钩子", "title": "...", "start": 0, "end": 7, "narration": "...", "visualBeat": "..." },
{ "label": "场景1", "title": "...", "start": 7, "end": 18, "narration": "...", "visualBeat": "..." }
],
"sceneCode": "const view = MF.H('div', { className: 'mf-view' }, stage); ..."
}
然后运行独立构建脚本(纯原生Node.js,零 npm 依赖!):
node "<技能路径>/scripts/build.mjs" --spec path/to/spec.json --out-dir path/to/output
该脚本会验证 sceneCode 的语法和确定性,嵌入 ./assets/motion-engine.js、./assets/sfx-synth.mjs 以及 ./assets/land-110m.json(如果使用地图),然后生成:
<slug>.html— 一个独立文件,可在任何浏览器中观看(自动循环 + 进度条 +9:16↔16:9切换按钮 + WebAudio音效)。<slug>-source.zip— 完整源代码归档(index.html、src/scene.js、src/project.json、NASKAH-DAN-STORYBOARD.md、engine/)。<slug>-naskah.md— 包含剧本和视觉建议的文档。
无Shell/Web聊天的回退方案: 如果代理环境没有Node.js终端访问权限,请直接复制
./assets/starter-template.html的内容,替换其中的/*__MOTION_ENGINE__*/、/*__SFX_SYNTH__*/和/*__PROJECT_JSON__*/ null占位符,以生成完整的index.html文件。
第5步 — 帧验证与MP4视频导出(可选/当Headless浏览器可用时)
如果环境中有Chrome/Edge和 puppeteer-core(或 puppeteer),可运行自动验证以确保 0 个运行时错误,并检查截图结果:
# 快速验证(检查0错误并保存开篇钩子和中间帧截图):
node "<技能路径>/scripts/export-mp4.mjs" --html path/to/output/<slug>.html --verify-only
# 完整渲染为MP4视频(H.264 + AAC音效自动生成,可选带上 --vo narration.mp3):
node "<技能路径>/scripts/export-mp4.mjs" --html path/to/output/<slug>.html --fps 30 --scale 1
如果验证截图中发现错误或文字重叠,请修正 sceneCode,使用 scripts/build.mjs 重新构建,然后将结果提交给用户。