Knowledge Motion
参考

内容与运行参考

独立知识结构、v2 分镜、场景引用与运行命令

两份内容契约

创建项目同时需要 knowledge.json 与 story.json:

文件作用
knowledge.json受众、学习问题、适用条件、对象、模块与子过程、关系、逐节点来源及执行记录
story.jsonschemaVersion: 2;画幅、章节、场景类型、关联知识节点、时长与动作
knowledge.md可读知识结构稿
storyboard.md可读讲解分镜

知识节点使用稳定标识,包含关系、来源与场景引用必须有效;并行与条件关系不能仅靠数组顺序暗示。记录实际宿主及委派模式 native 或 sequential,顺序降级写清原因。

分镜采用内容驱动时间轴,每镜头可以有多个动作阶段。基础场景有 overview、sequence、tree、parallel、branch、state、linked、list 与 custom。自定义场景在生成项目中实现,遵循相同局部帧与画幅接口。

完整字段与限制以仓库 skills/knowledge-motion/references/story-contract.md 为准。成对示例位于 examples/browser/、examples/ports/、examples/shopping/ 和 examples/budget/。

创建与校验

node <skill>/scripts/create-project.mjs --knowledge <project>/knowledge.json --story <project>/story.json --project-root <project> --out out/knowledge-motion/my-topic

输出路径隔离于 Skill 包,并拒绝覆盖。旧版 layout + steps 分镜不再接收,需要按知识结构重建 v2;既有独立生成项目仍可保留原源码运行。

命令作用
npm run check校验知识与分镜,同步可读稿
npm run preview生成章节、机制状态和交接关键帧
npm run render导出并核验静音 MP4
npm run verify独立核验已有视频

需 Node.js 20.19+、Chromium 系浏览器和 FFprobe。默认 30 fps,画幅按关系选择,时长由镜头阅读、动作和结果停留合计。媒体报告检查规格,内容、可读性与动态质量需实际观看。

本页目录