Jacky Motion 2.0 SRT

把中文口播稿与对应的 .srt 字幕，变成可直接录屏的 16:9 自动播放信息动画 HTML。

Jacky Motion 是一个面向中文内容创作者的 Agent Skill。它会先审稿、拆分镜、确认视觉风格与 SRT 时间轴，再装配成自动全屏、倒计时播放的单文件 HTML，并通过静态校验和真实浏览器检查完成验收。

它不是 PPT 模板，也不直接输出 MP4。它更像一位“信息动画导演”：以 SRT 作为唯一主时钟，先判断观众这一秒应该看哪里、理解什么关系，再决定版式、动画和 B-roll 窗口怎么服务表达。

它能做什么

• 根据真实 SRT 毫秒时间自动切换分镜，不按字数或语速猜时间。
• 把一条口播拆成主轨信息动画与 B-roll 展示区间，并完整覆盖字幕时间轴。
• 自动请求全屏并倒数 3 秒开播，支持暂停、继续、前后跳转和从头重播。
• 输出浏览器可直接打开的单文件 HTML，不依赖视频剪辑软件播放动画。
• 提供 6 个重点视觉风格、登记制版式骨架、信息原语和定格帧质量门禁。
• 检查时间轴断档、Beat 属性、布局溢出、元素重叠、字体和图片加载情况。

本次更新了什么

• 新增 SRT 主时钟与 P3.5 时间轴确认门，分镜、步骤和收束页都绑定真实毫秒点。
• 新增正式 B-roll Beat：不需要信息动画的区间会显示带短标题的录屏画框。
• 新增“准备录屏”入口、自动全屏、3 秒倒计时、暂停/继续、±5 秒跳转和确定性重播。
• 新增 parse-srt.mjs，并强化 HTML 校验器对时间覆盖、重叠和空档的检查。
• 浏览器验收新增时间轴抽样与 SRT 自动播放状态检查。
• 修复 paper-collage 红色标题标签被 Grid 拉成长条的问题，现在会按文字内容自动收口。

2.0 混合架构基础

• 从旧版 6 阶段调整为 5 阶段、3 个确认门：审稿 → 分镜 → 锁风格 → 装配 HTML → 视觉验收。
• 引入固定的运行时基座，生成时只装配内容、风格和时间线，降低交互失效与版本漂移。
• 默认重点风格从 4 个扩展到 6 个，新增 paper-collage 和 sketch-note。
• 增加 L01-L10 登记制版式骨架、信息原语、Beat Contract 和 Hybrid 质量门禁。
• 动效统一为 glance → reconstruct → push → lock 四段式镜头编排。
• 强制 final-state-first：静止态就是最终帧，动画结束后必须完全静止、可截图。
• 新增静态校验脚本和可选的 Playwright 浏览器布局检查。
• 不包含 TTS / audio / voice 流程，专注于与现有口播和 SRT 同步的信息动画 HTML。

适合谁

• AI 工具、产品机制和抽象概念讲解
• 教程、科普、新手向知识内容
• 商业分析、财经结构和指标关系
• 新闻、历史、案例与证据链
• 深度观点、文化与商业洞察
• 小红书、短视频清单、经验总结与种草内容

如果你的核心目标是“把一件事讲清楚”，Jacky Motion 会比套 PPT 模板更合适。

核心工作流

口播稿
  ↓
P1 审稿：判断通过 / 轻改 / 重写
  ↓ 确认
P2 分镜：拆 Beat、信息原语、视觉动词和屏幕文字
  ↓ 确认
P3 锁风格：选择全片唯一风格，填写 Beat Contract
  ↓ 确认
P3.5 锁时间轴：映射 SRT、Beat、Step 与 B-roll 区间
  ↓ 确认
P4 装配 HTML：固定基座 + 风格层 + 版式层 + 内容层 + SRT 时间线层
  ↓
P5 视觉与同步验收：静态校验 + 浏览器检查 + 关键帧截图

前四个确认门都会停下来等待确认。这样可以在写代码前先解决稿件、信息结构、审美方向和时间覆盖问题。

六个重点风格

仓库中还保留了 apple-light-blue-glass、ink-framework 和 manifesto-poster 的兼容资产，但它们不进入默认推荐和测试闭环。

安装

方式一：Skills 安装器

npx skills add https://github.com/Jackywxsz/jacky-motion

如果需要明确指定 Skill 和 Codex：

npx skills add https://github.com/Jackywxsz/jacky-motion --skill jacky-motion2-0-srt -a codex -g -y

方式二：手动安装

安装到你使用的 Agent Skills 目录。以 CC Switch 为例：

mkdir -p ~/.cc-switch/skills
git clone https://github.com/Jackywxsz/jacky-motion.git ~/.cc-switch/skills/jacky-motion2-0-srt

更新现有安装：

git -C ~/.cc-switch/skills/jacky-motion2-0-srt pull

不同宿主读取 Skill 的目录和调用符号可能不同，请以当前宿主的 Skills 列表为准。

使用

在支持 Agent Skills 的环境里调用 jacky-motion2-0-srt，同时提供口播稿与对应的 SRT 文件。

使用 Jacky Motion 2.0 SRT，把这篇口播稿和 SRT 做成可直接录屏的 16:9 自动播放信息动画 HTML。先审稿，按完整流程推进。

如果已经确定风格，可以直接说明：

使用 Jacky Motion 2.0 SRT，按 sketch-note 风格处理这篇教程口播稿和 SRT。先审稿，不要跳过确认门。

如果没有指定风格，Skill 会根据内容给出风格选择表，并只推荐一个最适合的方向。

输出与控制

默认输出为单文件 HTML：

• 标准画幅：1920×1080，16:9
• 可选画幅：1440×1080，4:3
• 点击“准备录屏”：请求全屏并倒数 3 秒自动播放
• Space：暂停 / 继续
• ← / →：前后跳转 5 秒
• R：回到开头并重新倒数播放
• F：全屏

用浏览器打开 HTML，点击“准备录屏”，即可使用 QuickTime、OBS 或系统录屏工具录制。

质量规则

Jacky Motion 2.0 把“信息是否讲清楚”放在视觉装饰之前：

• 每个 Beat 只保留一个核心信息关系。
• 屏幕文字必须短于口播，不把整段稿子搬上屏幕。
• 每个 Beat 必须登记版式、信息原语和核心表达。
• 核心 Beat 必须使用四段式镜头编排，并在最后形成可独立截图的定格帧。
• 每个 Beat 最多 1 个结构运动、2 组辅助出现和 1 次锁定强调。
• 清单内容按口播节奏逐项揭示，不能一次性全部涌入。
• SRT 是唯一主时钟，所有时间区间必须归属信息动画或 B-roll，空档不能超过 500ms。
• 暂停后时钟必须冻结；切出浏览器再回来时，画面必须追上正确的字幕时间。
• 验收以真实截图为准，出现重叠、溢出或裁切即视为失败。

完整规则见 SKILL.md 和 references/。

校验生成结果

先把 SRT 解析为毫秒 cue JSON：

node scripts/parse-srt.mjs path/to/input.srt

再校验生成的 HTML：

node scripts/validate-motion-html.mjs path/to/output.html

本机已安装 Playwright 时，可继续运行浏览器布局检查：

node scripts/check-layout-browser.mjs path/to/output.html

浏览器检查不可用时，仍需用真实浏览器打开并检查首屏、信息最密 Beat、多步 Beat 最终帧和收束页。

仓库结构

.
├── SKILL.md
├── agents/openai.yaml
├── assets/
│   ├── base-template.html
│   └── styles/*.css
├── styles/*.md
├── references/
│   ├── script-audit.md
│   ├── storyboard.md
│   ├── beat-contract.md
│   ├── hybrid-quality-gate.md
│   ├── information-primitives.md
│   ├── layout-skeletons.md
│   ├── motion-language.md
│   ├── html-production.md
│   ├── srt-autoplay.md
│   └── quality-check.md
├── scripts/
│   ├── parse-srt.mjs
│   ├── validate-motion-html.mjs
│   └── check-layout-browser.mjs
├── CHANGELOG.md
├── CONTRIBUTING.md
└── LICENSE

常见问题

它会直接生成视频吗？

不会。Jacky Motion 输出可交互、可录屏的 HTML，不直接渲染 MP4。

它会生成配音吗？

不会。SRT 只提供时间和文本索引，不会生成或嵌入 TTS、audio 和 voice。

一定需要 SRT 吗？

需要。这个版本以 SRT 作为自动播放的唯一主时钟；如果只有口播稿，请先生成并校对 SRT。

为什么不能直接跳到 HTML？

因为脚本逻辑、信息结构、风格方向或时间映射一旦没有锁定，后面的动画越复杂，返工成本越高。四个确认门用于在生成前解决这些关键问题。

可以混用多个风格吗？

不建议。单条内容只使用一个主风格；内容不适合当前风格时，应更换风格，而不是混搭。

反馈与共建

如果这个项目对你有帮助，欢迎给仓库一个 Star。使用中遇到问题、希望增加新的信息原语或版式，可以通过 Issues 提交反馈。

付费知识库与答疑群

我的付费知识库与答疑群欢迎加入： https://mp.weixin.qq.com/s/x924y3O9-nWda5OTHArKKg

License

MIT