把古诗词做成逐句或两句一景的竖屏中国画动态视频。
诗意分镜 · 中国画风格分化 · 画中物象真实运动 · 毛笔字逐字题写 · 原环境声与 BGM 并行 · 最终成片质检
这不是“给一张古画做慢速推镜”的模板。Skill 会把诗句拆成独立意象，用静态锚点限制图生视频重画，让水纹、飞鸟、马蹄、柳枝、衣袍等画中物象真正动起来。
⚡ 一句话安装进 Agent
把下面整段话发给 Codex、Claude Code 或其他支持 SKILL.md 的 Agent：
请从 https://github.com/Mr-funny/hbg-classical-poem-silk-video 安装
classical-poem-silk-video skill。
请自动识别当前 Agent 的全局 skills 目录；如果已经存在旧版本，请先备份再更新。
安装后检查 SKILL.md、agents、references、scripts 和字体资产是否完整，
运行 shell 语法检查、Python 编译检查与 skill 校验。
不要读取、打印或上传任何 API Key、Cookie、Chrome Profile、本地视频、音频或生成素材。
验证完成后，告诉我如何使用 $classical-poem-silk-video
把一首中国古诗制作成 1080×1920 的国风动态视频。
安装后直接说：
使用 $classical-poem-silk-video 制作《枫桥夜泊》。
四句诗一行一景，画面色调跟随诗意变化；镜头固定，
让月光、水纹、乌鸦、霜雾和渔火在画中自然运动。
保留 AI 环境原声，毛笔字逐字出现，场景之间自然交叉溶解。
🎯 它解决的不是“古画会动”，而是“古画不会乱动”
| 常见问题 | Skill 的处理方式 |
|---|---|
| 每张图都是同一种泛黄古绢色 | 保持中国画 DNA，一景一条风格通道：水墨、工笔、青绿、人物鞍马等 |
| 用后期推镜冒充图生动态 | 默认锁定镜头，只允许已有物象做局部、可解释的动作 |
| 云雾一动就变成祥云，寺庙被重新搭建 | 声明建筑、山体、树干、岸线、人物躯干为静态锚点 |
| 鸟越动越多，枝条凭空生长 | 固定主体数量与身体中心，明确禁止复制、合并、长枝和新增剪影 |
| 马匹走动时多腿、悬空或换身体 | 限制为一次重心变化或小步，检查四蹄、地面接触和身体一致性 |
| 所有动作同时发生导致整幅画重构 | 每景只设一个主动作，加一到两个环境辅助动作 |
| 转场时黑一下，环境声突然断掉 | 画面用 xfade，原环境声用 acrossfade，BGM 连续播放 |
| 白色 Gemini 星标和传统红印一起被删 | 只处理右下角白色星标，红色方印作为画面内容保留 |
| 字幕像普通视频字体 | 内置 Ma Shan Zheng，右列先写、左列后写，逐字出现 |
| 浏览器预览没问题，最终 MP4 却有黑帧 | 对最终编码视频重新抽帧、检查转场中点、末帧、黑帧和音轨 |
✨ 核心能力
| 模块 | 能力 |
|---|---|
| 诗词解析 | 识别时代、地点、季节、时间、意象、动作和情绪弧线 |
| 分镜分组 | 四句以内默认逐句；长诗默认连续两句一景 |
| 画面风格 | 在统一中国画品质下，按诗意切换水墨、工笔、青绿、鞍马等支线 |
| 静帧生成 | 使用 Codex 内置 ImageGen，预留竖排题字安全区 |
| 图生视频 | 通过 Docker 调用 Gemini I2V，不在生成阶段操控用户浏览器 |
| 动作提示词 | 静态锚点、局部动作区、稳定收尾、反幻觉禁令四段式结构 |
| 字幕 | Ma Shan Zheng 毛笔字体，两列竖排，按字揭示 |
| 音频 | 保留每个 I2V 镜头的模型环境声，可叠加连续 BGM |
| 转场 | 画面和环境声同步交叉溶解，避免黑场与音频重启 |
| QA | 检查主体数量、动物肢体、建筑稳定、题字安全区、编码规格与末帧 |
🚀 快速开始
方法一：让 Agent 自动安装（推荐）
复制 README 首屏的自然语言安装提示，让 Agent 完成下载、备份、安装和验证。
方法二：安装到 Codex
curl -fsSL https://raw.githubusercontent.com/Mr-funny/hbg-classical-poem-silk-video/main/install.sh | sh默认安装到：
${CODEX_HOME:-~/.codex}/skills/classical-poem-silk-video
方法三：安装到 Claude Code
curl -fsSL https://raw.githubusercontent.com/Mr-funny/hbg-classical-poem-silk-video/main/install.sh | sh -s -- --claude方法四：手动安装
git clone https://github.com/Mr-funny/hbg-classical-poem-silk-video.git mkdir -p ~/.codex/skills/classical-poem-silk-video cp -R hbg-classical-poem-silk-video/skill/classical-poem-silk-video/. \ ~/.codex/skills/classical-poem-silk-video/
🐳 Docker 运行时
静帧由 Agent 的内置 ImageGen 生成。图生视频与可选星标清理依赖：
- Mr-funny/hbg-gemini-flow-suite
- Docker 容器名：
gemini-flow-suite - 工作区在容器内挂载为
/workspace - 输出目录在容器内挂载为
/data/outputs
先按运行时仓库 README 完成一次用户控制的授权，再运行：
skill/classical-poem-silk-video/scripts/check_prerequisites.sh
Skill 不包含、不上传、也不会打印 Cookie、API Key 或浏览器 Profile。详细约定见 runtime-contract.md。
🤖 使用示例
四句逐句成画
使用 $classical-poem-silk-video 制作《枫桥夜泊》。
每句一景，夜色从冷蓝过渡到渔火暖色。
不要做后期推镜，动态来自月光、水纹、乌鸦、霜雾和钟声的可见原因。
长诗两句一景
使用 $classical-poem-silk-video 制作《钱塘湖春行》。
两句一景，共四景；水墨湖寺、工笔花鸟、人物鞍马、青绿长堤分别对应诗意。
保留 AI 原环境声，BGM 与原声并行，转场使用 1.2 秒自然溶解。
修复已有国风视频
使用 $classical-poem-silk-video 检查这四段图生视频。
重点排查建筑重构、鸟类复制、马腿畸形、柳叶脱落、白色星标、字幕安全区和黑帧转场。
只重做不合格镜头，不要用后期推镜掩盖问题。
🧠 工作原理
flowchart LR
A["完整古诗词"] --> B["意象与情绪弧线"]
B --> C["逐句 / 两句一景"]
C --> D["中国画风格通道"]
D --> E["ImageGen 静帧"]
E --> F["Docker I2V"]
F --> G["早中晚抽帧验收"]
G --> H["白色星标清理"]
H --> I["毛笔字逐字字幕"]
I --> J["原环境声 + BGM"]
J --> K["画面与声音交叉溶解"]
K --> L["最终 MP4 QA"]
四条动作原则：
- 镜头锁定。 图生视频的动态来自画中物象，不来自后期缩放。
- 动作有锚点。 翅膀围绕身体中心，水纹从接触点扩散，柳叶不能离开枝条。
- 一景一主动作。 动作过多会诱发模型重新构图。
- 最终 MP4 才是交付对象。 必须从编码后的成片重新抽帧验收。
🖼️ 实际项目：钱塘湖春行
- 8 句诗，连续两句一景，共 4 景
- 水墨湖寺、工笔花鸟、人物鞍马、青绿长堤四条视觉通道
- 每景约 9 秒，3 次 1.2 秒交叉溶解
- 最终规格：1080×1920、30fps、H.264 + AAC
- 成片时长：32.44 秒
- 保留 I2V 原环境声，支持 BGM 低铺底或 100% 并行混音
完整复盘文章：
✅ 最终媒体质检
skill/classical-poem-silk-video/scripts/final_media_qa.sh \ final.mp4 qa/final
输出包括：
ffprobe.jsonblackdetect.logsilencedetect.logvolumedetect.log- 10%、25%、50%、75%、90% 与末帧
- 最终编码视频联系表
如需检查马蹄、鸟数或转场中点，准备 TSV：
8.400\ttransition-1-mid
16.200\ttransition-2-mid
20.100\thorse-contact
24.000\ttransition-3-mid
skill/classical-poem-silk-video/scripts/final_media_qa.sh \ final.mp4 qa/final qa-timestamps.tsv
📁 仓库结构
skill/classical-poem-silk-video/ Agent Skill 本体
docs/article.md 当前项目完整复盘文章
docs/showcase/ README 视觉预览
examples/ 脱敏示例分镜与提示词
tools/ CI 校验与隐私扫描
install.sh Codex / Claude Code 安装器
🔐 隐私与合规
- 不提交 API Key、Cookie、
.env、Chrome Profile、Docker 数据卷或生成账号数据。 - 不提交用户原始聊天、私人文案、本地项目路径或未授权素材。
- 只在用户要求且适用条款允许时处理白色模型星标；传统红印与有意画面标记必须保留。
- 运行时授权由用户本人完成，Skill 的生成流程只调用 Docker。
📄 License
- Skill、脚本与文档：MIT License
- Ma Shan Zheng 字体：SIL Open Font License 1.1，见
skill/classical-poem-silk-video/assets/OFL.txt - HBG Gemini Flow Suite：独立项目与独立许可证，本仓库不重复分发
欢迎提交 Issue 和 PR，一起把“这次终于改对了”变成“下一次默认不会再错”。