logamee/logamee-film-forge

---

---

目录

• 这是什么
• 两个 Skill
• 三种制作模式
• 完整流程
• 归档与清理
• 两者如何配合
• 快速开始
• 使用方式
• 依赖边界
• 仓库结构
• 贡献
• 开源协议

这是什么

它把「把内容做成视频」和「检查视频画面是否合格」拆成两个平行 Skill。主 Skill 内部再按最终产物区分制作模式：

• logamee-film-forge — 生产流程：文章 → Storyboard → HTML/Canvas Motion → TTS → 字幕 → MP4
• logamee-html-constraint — 质量门：检查字体、间距、动画、字幕、越界等最低质量标准

演示效果见：微信公众号文章。

仓库提供 Skill 文档、检查规则、参考材料、可复用的 Motion Runtime 资源和增量渲染辅助脚本。浏览器、ffmpeg、TTS、模型权重和私人声音/角色 素材仍由具体项目按需配置。

两个 Skill

logamee-film-forge

主流程 Skill，负责把文章、脚本或口播材料制作成带字幕的 HTML 视频和 MP4。它同时支持：

• deck：独立页面、逐页审核、逐页缓存，适合 PPT 型知识视频。
• motion：Canvas/SVG/HTML 驱动的连续动画，适合真正的视频化表达。
• remotion：预留模式，目前只保留规划边界，尚未实现渲染器。
• film：旧版连续 HTML/GSAP 时间线，仅为兼容已有项目。

三种制作模式

Motion 能力

motion 不是给 PPT 增加几个特效，而是一套独立的代码动画制作模式。 它融合了 Canvas、SVG、HTML 和可选生成素材，支持：

• 35 种可复用的视觉材质方向：岩洞浮雕、壁画、马赛克、手稿、印象派、点彩、剪纸、像素、蒸汽波、橡皮管卡通、皮影、明暗舞台等；
• 9 类动画语法：尺度穿行、信息拼贴、白板生长、故事场景、动态排版、结构变形、界面序列、数据场和讲解员构图；
• 8 个参数化动画片段和可复用的示例 spec；
• 程序化绘制、分层素材、首尾帧视频板、混合路线；
• 角色/精灵帧合成、长卷穿越、镜头运动、材质化转场和稳定锚点；
• 确定性时间定位、字幕/Cue 时钟、碰撞与安全区检查；
• 以 Motion Unit 为边界的缓存、局部重渲染和完整视频合成。

Motion 的用户流程仍然遵循映画的审核节奏：先确认来源和口播，再定视觉 方向、分镜和关键帧，然后依次审核静态画面、无音频动画、本地音频同步、 正式音画同步，最后按单元增量渲染。具体项目可以只使用其中一部分能力， 不需要为了使用一个风格而启用全部效果。

用户只需要关心下面十五个节点：

1. 确认项目范围与工作目录
2. 检测制作环境
3. 确认并保存来源材料
4. 审核内容理解
5. 审核口播稿
6. 审核视觉方向与主题
7. 审核 Storyboard
8. 审核静态排版
9. 审核无音频动画
10. 审核配合本地音频的真实动画
11. 选择并生成正式音频
12. 根据正式音频生成精确字幕与时间轴
13. 审核正式音画同步预览
14. 增量渲染并合成
15. 验证并交付

前 13 步是素材、设计、音频与审核，后 2 步是渲染、验证与交付。缓存、 哈希、冻结规格和诊断清单属于内部机制，不会额外增加用户审批节点。

交付后可以把项目转为 archived-editable。归档默认保留能够继续修改 单页、复用正式音频并重新合成完整视频的源链；渲染缓存、临时语音、旧版 审核稿和截图只能作为清理候选，必须先按路径列出用途、可再生性和删除 代价，再获得用户对具体路径的确认。完整约束见 归档与清理参考。

logamee-html-constraint

辅助约束 Skill，负责检查 HTML 页面和视频 Deck 是否达到最低质量标准。它不负责生成内容，也不负责替换主题设计。

它检查：

• 字体、字号、行高和 clamp() 响应式尺寸
• 间距、舞台尺寸和 16:9 录制安全区
• 文本、字幕、页码、品牌标识之间的碰撞
• 颜色对比度和主题 Token 使用
• GSAP 动画的 0%、25%、50%、75%、100% 状态
• 父容器内部越界和视觉边界穿透
• 字幕是否压缩或遮挡页面内容
• 屏幕文字是否重复字幕
• 二维码、截图、传播图旁是否出现多余解释文字
• 页面是否只是没有语义的「卡片加标题」
• 页面是否有清晰的视觉关系、动作和最终状态
• 一个页面发现的问题是否触发整套 Deck 的同类问题扫描

两者如何配合

推荐配合流程：

加载 logamee-film-forge
  ↓
完成十五步中的内容、Storyboard、静态排版和动画审核
  ↓
加载 logamee-html-constraint
  ↓
执行视觉约束和动画状态检查
  ↓
根据检查结果修正 deck.html
  ↓
用户确认正式同步预览
  ↓
增量渲染、合成并验证 MP4

logamee-film-forge 是生产流程，logamee-html-constraint 是质量门。辅助 Skill 不应该被复制进主 Skill，也不应该被当成主题模板使用。

如果只需要检查已有的 HTML PPT 或视频 Deck，可以单独使用 logamee-html-constraint，不需要加载完整的视频生产流程。

仓库结构

logamee-film-forge/
├── README.md
├── LICENSE
├── assets/
│   ├── logo.svg
│   └── scan-follow.webp
├── logamee-film-forge/
│   ├── SKILL.md
│   └── references/
│       ├── FORM-MAP.md
│       ├── TOOLKIT.md
│       ├── index.md
│       ├── project-setup-and-source.md
│       ├── storyboard-and-freeze.md
│       ├── approval-preview-workflow.md
│       ├── audio-review-and-sync.md
│       ├── render-and-delivery.md
│       ├── incremental-rendering.md
│       ├── archive-and-cleanup.md
│       ├── deck-art-direction.md
│       ├── deck-visual-design-standard.md
│       ├── deck-design-and-html.md
│       ├── film-mode.md
│       ├── motion-mode.md
│       ├── motion-production-workflow.md
│       ├── motion-capability-catalog.md
│       ├── motion-runtime-contract.md
│       ├── motion-provenance.md
│       ├── motion-integration-map.md
│       ├── hyperframes-adaptation.md
│       ├── cloned-voice-video-production.md
│       └── tts-source-selection.md
│   ├── resources/
│       └── motion-runtime/       # 引擎、风格、片段、示例与字体许可
│   └── scripts/
│       ├── render_deck_incrementally.mjs
│       ├── render_motion_incrementally.mjs
│       ├── inspect_motion_reference.py
│       ├── qa_motion.py
│       ├── check_motion_subtitle_band.py
│       ├── subzone_gate.py
│       ├── validate_motion_contract.py
│       ├── verify_motion_capabilities.py
│       └── verify_motion_incremental_fixture.mjs
└── logamee-html-constraint/
    ├── SKILL.md
    └── references/
        └── demo.html

完整流程

四种审核预览必须保持语义不同：

静态排版和无音频动画都可以显示字幕，但不使用字幕节点驱动动画。正式 音频生成后，必须从当前音频重新生成字幕时间、Cue 和总时间线。

对 deck 模式，页面内容按稳定 unitId 独立缓存。修改单页时只重渲染 受影响页面及必要的边界，最后重新合成完整视频；不会因为最终要得到一个 MP4 就重新录制所有页面。

归档与清理

归档不是把项目压缩成一个 MP4。默认的可编辑归档至少保留项目配置、来源 与口播稿、Storyboard、冻结规格、当前 HTML、正式音频、字幕与时间轴、素材、 渲染清单、诊断报告和最终成片，并生成 archive-manifest.md 记录恢复方式。 只有在用户明确确认精确路径后，才可以删除缓存、临时音频、旧审核稿、截图 或其他中间文件。

快速开始

请把下面这句话复制给你的 Agent：

请从 GitHub 仓库 https://github.com/logamee/logamee-film-forge 获取并安装「映画」Skill。

手动安装（可选）：

# 把 Skill 复制到对应 Agent 的技能目录
cp -R logamee-film-forge ~/.hermes/skills/       # Hermes
cp -R logamee-film-forge ~/.claude/skills/       # Claude Code
cp -R logamee-film-forge ~/.codex/skills/        # Codex
cp -R logamee-html-constraint ~/.hermes/skills/
cp -R logamee-html-constraint ~/.claude/skills/
cp -R logamee-html-constraint ~/.codex/skills/

使用方式

使用「映画」Skill，把这篇内容制作成一个视频。

依赖边界

仓库只提供 Skill 文档、检查规则、参考材料和渲染辅助脚本，不捆绑 浏览器、TTS 引擎、ffmpeg、GSAP 文件、模型权重或声音资产。

具体项目需要哪些工具，由 Agent 根据当前环境检查并向用户报告。没有经过用户确认，不应静默安装大型模型、下载浏览器或切换 TTS 服务。

Whisper 等时间戳工具应优先安装在用户级共享环境，由多个项目复用；不要把模型或虚拟环境复制到每个视频项目里。

贡献

欢迎提交 Issue 和 Pull Request。改进建议请说明动机和效果，不要只改措辞。

• 报告问题：GitHub Issues
• 提交代码：Pull Requests

关注逻辑帧

开源协议

MIT License

Copyright © 2026 Logamee contributors