@autoaiai/aicut 0.1.11 → 0.1.13

package/skills/guofeng-paper-video/style/prompts/03-/351/205/215/351/237/263/350/204/232/346/234/254.md

@@ -1,27 +0,0 @@
-# 提示词 · 配音脚本 + 编排
-
-## 1. 整理配音脚本
-
-```
-把分镜表里每镜的旁白，整理成一份配音脚本：
-每句一行，按镜顺序编号 vo-01、vo-02……
-语气 {{沉稳讲述 / 轻松 / 古意}}，语速适中，句子短、上口。
-```
-
-## 2. 生成配音（MiniMax）
-
-用 **MiniMax** 语音把每句合成一条 wav：`vo-01.wav … vo-0n.wav`，放 `public/audio/{{slug}}/`。
-（MiniMax 的具体调用按你手上的方式来，Agent 不代管密钥。）
-
-## 3. 接进时间线（对 Claude 说）
-
-```
-配音已放在 public/audio/{{slug}}/，环境音和音效放在公共音频目录。
-在这条片的 StoryAudio 里：
-- ambient 环境音 loop、低音量(~0.12)铺全片
-- 每条 vo-0x 用 Sequence 卡在对应镜的起始帧，跟字幕对齐
-- 转场配 paper-whoosh，撞击/落点配 thump/lock 卡在动作帧
-render 前确认音频文件都在，别漏。
-```
-
-音频编排的字段细节见 [../分镜与图层规范.md](../分镜与图层规范.md#音频编排storyaudio)。

package/skills/guofeng-paper-video/style//345/210/206/351/225/234/344/270/216/345/233/276/345/261/202/350/247/204/350/214/203.md

@@ -1,67 +0,0 @@
-# 分镜与图层规范
-
-从"一首诗"到"一条片"，中间这层是：**分镜表 → 每镜的纸片清单 → 每张纸片的图层参数**。这份讲参数怎么填。
-
-## 时间轴
-
-- 30 fps。**帧数 = 秒 × 30**。总时长是一个常量（示例 `IDIOM_SHOU_ZHU_DAI_TU_DURATION = 765` = 25.5 秒）。
-- 一条片 = 若干镜，每镜一个 `<Sequence from={起始帧} durationInFrames={帧数}>`。一镜默认 **120 帧（4 秒）**，落点镜可长些。
-- 每个 Sequence 建议 `premountFor={30}`：提前 30 帧预挂载，避免入场卡顿。
-
-## 一镜的构成
-
-1. **背景**：`<FieldPlate src={plate} camera={clamp(frame,[0,120],[0,1])} />`——camera 从 0 缓推到 1。荒芜镜加 `mood="dry"`。
-2. **纸片**：若干 `<PaperCollageLayer spec={...} />`，spec 见下。
-3. **标签**（可选）：`<PaperTag title="..." note="..." from={帧} x y width />`——贴一句说明。
-4. **字幕**：`<StoryCaption from={帧}>这一镜的旁白</StoryCaption>`——底部居中，跟配音对齐。
-5. **重音**（可选）：印章 / 楷体大字 / 特效，配一声音效。
-
-## 图层参数 `PaperCollageLayerSpec`
-
-每张纸片一份（类型定义在 [`src/components/PaperCollageLayer.tsx`](../src/components/PaperCollageLayer.tsx)）：
-
-| 字段 | 类型 | 意思 |
-|---|---|---|
-| `id` | string | 唯一名 |
-| `src` | string | `staticFile()` 的纸片路径 |
-| `x` `y` | number | 左上角落位 |
-| `width` | number | 宽（高自动） |
-| `delay` | number | 第几帧入场（同镜内错开，别一起进） |
-| `role` | `primary`/`secondary`/`tertiary` | **决定运动幅度**，见下 |
-| `direction` | `-1`/`1` | 入场从左(-1)还是右(1)滑入 |
-| `zIndex` | number | 叠放层级 |
-| `opacity?` | number | 整体透明（远景压淡用） |
-| `flipX?` | boolean | 左右翻转 |
-| `phase?` | number | 呼吸相位偏移（避免多片同步浮动） |
-
-### role 决定层次（关键）
-
-| role | 位移 | 起始缩放 | 入场时长 | 给谁 |
-|---|---|---|---|---|
-| `primary` | 大（104px） | 0.84 | 42 帧 | 这一镜的主角 |
-| `secondary` | 中（72px） | 0.90 | 36 帧 | 中景、配角 |
-| `tertiary` | 小（44px） | 0.95 | 30 帧 | 远景、陪衬 |
-
-主角给 `primary`、远景给 `tertiary`，层次感是这一条自动拉开的。**别把所有纸片设成同一个 role**——那样画面会"整体平移"，失去拼贴的纵深。运动（入场回弹、呼吸浮动、纸投影）全在 `PaperCollageLayer` 里算好，你只填这张"参数单"。
-
-### 一个真实 spec（示例片里的守株农夫，节选）
-
-```tsx
-const waiting: PaperCollageLayerSpec = {
-  id: 'farmer-waiting',
-  src: staticFile(layer('farmer-waiting')),
-  x, y, width,
-  delay: 5,
-  role: 'primary',
-  direction: -1,
-  zIndex,
-};
-// 用：<PaperCollageLayer spec={waiting} />
-```
-
-## 音频编排（`StoryAudio`）
-
-- **环境音**打底：一条 ambient `loop`、低音量（~0.12）铺全片。
-- **配音**：每句旁白一个 `vo-0x.wav`，用 `<Sequence from={该镜起始帧}>` 卡在对应镜，跟字幕对齐。**配音用 MiniMax 生成**（见 [prompts/03-配音脚本.md](prompts/03-配音脚本.md)）。
-- **音效**：转场配 `paper-whoosh`（~0.52），撞击 / 落点配 `thump` / `lock` / `magnetic` 卡在动作帧。
-- 素材放 `public/audio/{slug}/`（片子专属）+ 复用的环境音单独放公共目录。**换素材时音频目录整个别落下**，否则 render 报错找不到文件。

package/skills/guofeng-paper-video/style//347/272/270/347/211/207/347/264/240/346/235/220/350/247/204/350/214/203.md

@@ -1,29 +0,0 @@
-# 纸片素材规范
-
-一条片的视觉料 = 一张背景大图 + 若干张纸片。这份讲怎么把它们做出来、放哪、怎么命名。
-
-## 两类素材
-
-### 1. 背景大图 field-plate
-- 一张满幅墨线山水 / 场景图，作为最底层（`FieldPlate` 组件用）。
-- 尺寸 ≥ 1920×1080（组件会放大到 1980×1140 留推镜余量）。
-- 可带纸纹、淡赭染。**不要**把主体人物 / 动物画死在背景里——主体要单独做成纸片，才能各自动。
-- 放 `public/style/{slug}/field-plate.png`。
-
-### 2. 纸片 layers
-- 每张纸片 = **一个语义单位**：一个人、一只动物、一件道具、一座山、一团云。
-- **透明背景 PNG**、白描线稿风、主体居中留边、长边 ≥ 1000px。
-- **不带写实阴影**（投影由代码 `drop-shadow` 统一加，自带阴影会脏）。
-- **不带文字**（文字交给代码，纸片上写字等于把"零错字"优势丢了）。
-- 放 `public/style/{slug}/layers/`，语义英文短名：`farmer-working.png` / `rabbit-fallen.png` / `stump.png`。同一角色多个状态就多做几张（`farmer-holding` / `farmer-waiting`）。
-
-## 生成 → 抠边流程
-
-1. **生图**：用即梦 / Lovart / MJ 出白描线稿。提示词模板见 [prompts/02-生成纸片.md](prompts/02-生成纸片.md)（要点：白描、线稿、浅色底、单个主体、无文字、无写实光影）。
-2. **抠透明底**：AI 出的图常带底色 → 用去背工具（remove.bg / 即梦自带去背 / PS）抠成透明 PNG。边缘干净、保留白描线。
-3. **验收**：贴到深色背景上看——描边是否连续、有没有残留底色、主体是否完整。
-4. **命名归位**：按上面的命名放进 `public/style/{slug}/layers/`。
-
-## 一条片大概要几张
-
-一镜通常 2–5 张纸片（1 主角 + 1–2 中景 + 1–2 远景陪衬）。整条 5–6 镜的片，10–20 张纸片 + 1 张背景够用。宁可复用，别每镜全新。

package/skills/hand-drawn-explainer-video-nikola/SKILL.md

@@ -1,113 +0,0 @@
----
-name: hand-drawn-explainer-video-nikola
-description: "制作、修改和验收中文手绘知识讲解视频，交付配音、字幕、时间轴、可编辑工程和真实 MP4。支持两条不可混淆的制作路线：同一画布持续落墨的逐笔故事动画，以及用 SVG/HTML/GSAP 编排流程卡片、关系图和知识图形的程序动画。逐笔路线可选择自然肤色 Q 版人物、小黑风格或其他手绘风格，并可采用单场景、多幕故事、左右双语义岛等画面结构。用户说“边讲边画”“一笔一笔画出来”“白板手绘”“先画左边再画右边”“知识讲解动画”或希望把文稿、SRT、人物故事做成手绘视频时使用。也支持只输出生图/图生视频提示词。不用于写实数字人或假装已经完成无法验证的成片。 Runs in AICUT: the film is film.html, a page per shot, drawn by `aicut look` and `aicut render`."
-license: Apache-2.0
-source: "hi-nikola/hand-drawn-explainer-video-nikola"
----
-
-# Nikola 手绘讲解视频
-
-## Running it in AICUT
-
-AICUT's film is `film.html`: it cuts pages, footage, pictures and sound together on tracks. A page is a web page that
-sets `window.film = { frame(t) }` and draws that moment — no framework, no build step, no composition object, no
-`registerRoot`. Five shots are five pages cut together, not one page that changes scene, so each shot stays trimmable
-and replaceable in Studio.
-
-```sh
-npx -y @autoaiai/aicut@latest          # the manual: the format and the commands, always current
-npx -y @autoaiai/aicut@latest open .   # make this folder a film and print Studio's address
-npx -y @autoaiai/aicut@latest look     # a contact sheet of the whole film, its sound, and a determinism check
-npx -y @autoaiai/aicut@latest look 4.5 # one frame, full size — look at the PNG, not at the code
-npx -y @autoaiai/aicut@latest render   # the MP4, beside film.html
-```
-
-Run the manual before the first film: it is authoritative for the format, and this skill is about the method above it.
-
-Where the words below name another program's part, it becomes this:
-
-| elsewhere | in AICUT |
-|---|---|
-| composition, timeline, project file | `film.html`; tracks and clips inside it |
-| a scene, a sequence, a slide | a page (`pages/<name>.html`) cut onto a track |
-| `useCurrentFrame()`, `interpolate()` | `frame(t)` — the picture depends only on `t`, never on state or `Date.now()` |
-| a still, a screengrab | `aicut look <t>` |
-| `render` / `build` / `export` | `aicut render` (the person can also export from Studio) |
-| a dev server, a preview window | `aicut open` and the Studio address it prints |
-
-Hard rules that hold whatever the method says: the picture depends only on `t`; every value in the person's prompt is
-binding; look at the frames `look` writes before saying a film is done.
-
-
-把中文主题、文稿或 SRT 变成真正可播放、可检查、可继续编辑的手绘讲解视频。先识别用户要的是“画面被逐笔画出来”，还是“手绘风独立元素运动”；不能为了方便把一种效果冒充另一种效果。
-
-提示词模式无本地依赖；逐笔渲染器已随仓库打包，首次使用需创建隔离 Python 环境；程序动画模式需 Node.js、HyperFrames、浏览器和 FFmpeg。成片配音默认使用火山引擎刘飞音色，需用户自己的已授权账号或复用已有音轨；图像生成和视频模型为可选能力，可能产生费用。
-
-## 先选择交付范围
-
-- **只要提示词**：读 [prompt-workflow.md`prompt-workflow.md`，输出自包含提示词，不调用收费接口。
-- **样片**：制作用户指定片段；未指定时用 10–15 秒代表镜头验证人物、笔迹、字幕和节奏。
-- **完整视频**：先读 [安装与预检](references/preflight-and-recovery.md) 和 [完整流程](references/automation-workflow.md)。先内部验证代表镜头，再继续全片；只有用户要求逐步确认或存在关键选择时才暂停。
-- **修改已有视频**：保留未被要求修改的音轨、时间轴和素材，只重做受影响阶段。
-
-## 先选两条制作路线之一
-
-| 用户真正想要的效果 | 制作路线 | 必读 |
-|---|---|---|
-| “画面被画出来”“边讲边画”“逐笔落墨”“笔尖跟着线走” | 逐笔故事动画 | [stroke-story-workflow.md`stroke-story-workflow.md` |
-| 流程卡片、概念关系、独立元素组合、确定性文字 | 程序动画 | HyperFrames + SVG/HTML + GSAP，读 [automation-workflow.md](references/automation-workflow.md) |
-
-逐笔故事动画选定后，再分别选择画面结构与视觉风格：
-
-- **画面结构**：单场景、多幕连续故事，或“先左后右并保留前文”的左右双语义岛。双语义岛只是逐笔故事的一种画面组织方法，参考 [semantic-island-storytelling.md`semantic-island-storytelling.md`。
-- **视觉风格**：自然肤色 Q 版人物、小黑风格，或用户指定的其他手绘风格。Q 版适合人物传记与历史；小黑适合抽象观点、方法论和隐喻。两种风格都能采用双语义岛，也都能采用其他画面结构。
-
-场景视频与“只输出 Flow/Nano Banana 提示词”是可选交付方式，不是本 Skill 的第三条手绘制作路线。自然连续人物动作或复杂运镜需要先核实视频模型、成本和一致性限制；只要提示词时读 [prompt-workflow.md`prompt-workflow.md`。
-
-逐笔路线使用 `vendor/srt-whiteboard-animation/` 中随仓库发布的 MIT 后端快照。它不包含第二份 `SKILL.md`，不会单独触发或要求重复确认；主 Skill 统一负责路由、配音、字幕、渲染和验收。运行环境不可用时保存已完成资产并报告缺口；除非用户明确同意，不以 SVG 动画冒充真实逐笔绘制。
-
-## 可选视觉风格
-
-- **Q 版人物故事**：自然肤色、人物身体、年龄和服装锚点清楚，适合传记、历史和人物观点。参考 [q-human-story-style.md`q-human-story-style.md` 与 [乔布斯案例`README.md`。
-- **小黑风格**：纯白、稀疏黑线、少量红橙蓝、留白和冷幽默动作主体，适合方法、系统、状态和隐喻。它是本仓库内置、可直接点选的公开预设；使用时必须读取 [完整视觉 DNA、来源说明与提示词骨架`xiaohei-style.md`。该风格借鉴 Ian 的开源项目，应始终称为“小黑风格”。
-
-程序化知识图形是制作路线，不是视觉风格。参考 [“什么是 Skill”程序动画案例`README.md`。逐笔案例见 [《约法三章》`README.md` 与 [《乔布斯的一生》`README.md`。
-
-参考图只影响当前项目，除非用户明确要求保存为新预设。人物、画风、动效和声音分别记录，不把换画风等同于换音色或重做旁白。
-
-## 公开默认与本地配置
-
-仓库中的 [preferences.json`preferences.json` 只含无密钥默认值。用户指令和项目 `DESIGN.md` 优先。成片默认使用火山引擎 `seed-tts-2.0` 的刘飞音色 `zh_male_liufei_uranus_bigtts`；用户明确要求时可选择火山引擎其他已授权音色，已有与文稿一致的合格音轨优先复用。不要自动改用电脑系统朗读、edge-tts 或其他低质量本地 TTS；缺少授权音轨时可以继续提示词、画面和无配音阶段，但必须把配音列为未完成项。
-
-首次使用先读 [安装说明`INSTALL.md` 和 [配置说明](docs/CONFIGURATION.md)，再运行：
-
-```text
-python scripts/setup_check.py
-```
-完整视频在首次配音或长渲染前还要运行路线对应的预检。预检失败只阻止依赖该能力的阶段，不重做已经通过的音频、插画或字幕。
-```
-
-## 核心制作规则
-
-1. **保留内容**：分别保存原稿、合成读音稿和字幕；未经授权不删观点、数字和限定词。
-2. **声音先行**：优先复用内容一致的完整音轨；新音轨尽量整段或按自然章节合成。
-3. **时间来自真实音频**：使用有效时间戳、强制对齐或复核后的句级停顿；不能把平均分配说成逐字对齐。
-4. **动画服务于解释**：逐笔路线按语义区域持续落墨；程序路线拆成可控元素。整图平移、缩放或淡入淡出只能辅助。
-5. **控制可画性**：真实笔迹速度取决于区域时间和源图复杂度；`hand-follow` 只平滑手部，不能让线条真正减速。
-6. **精确文字后期生成**：日期、专名、Logo、长中文和关键数字使用字幕或确定性文字层，不交给图片模型猜写。
-7. **先验证代表镜头**：检查人物一致性、抬笔、补色、遮挡、关键词和字幕，再批量渲染。
-8. **成片必须真实验收**：完整解码 MP4，检查全部场景、语义边界、切点、音轨和最后 0.3–0.5 秒。
-
-## 安全、费用和准确性
-
-- 不把 API Key、Token、Cookie、请求头、本机绝对路径或私有模型目录写入仓库、命令参数、报告或工程 ZIP。
-- 账号型配音、生图和视频服务可能收费；先复用缓存，不盲目重试状态不明的请求。
-- 真实人物、公司、Logo、日期和数字需要可靠来源或确定性资产。风格参考不能保证实体准确。
-- 用户要求完整视频时，最少交付真实 MP4；工具支持时同时保留 SRT、旁白、时间轴、源图、标注和可编辑工程。
-
-质量与交付细节见 [quality-and-delivery.md`quality-and-delivery.md`。仓库结构、贡献和许可见 [README`README.md`。
-
-## Source
-
-Rewritten for AICUT from [`hi-nikola/hand-drawn-explainer-video-nikola`](https://github.com/hi-nikola/hand-drawn-explainer-video-nikola)
-(Apache-2.0), SKILL.md. The method is that skill's own; the way it runs is AICUT's.

package/skills/hand-drawn-explainer-video-nikola/docs/ARCHITECTURE.md

@@ -1,18 +0,0 @@
-# 架构
-
-```text
-用户内容 / SRT / 参考图
-        ↓
-单一 Skill 路由与脚本设计
-   ┌────┴────────────┐
-逐笔故事             程序动画
-vendor MIT 后端       HTML/SVG/HyperFrames
-   └────┬────────────┘
-旁白 + 时间轴 + 确定性字幕/关键词
-        ↓
-最终 MP4 + 可编辑资产 + 验证报告
-```
-
-`vendor/srt-whiteboard-animation/` 是运行时库，不是第二个 Skill：没有 `SKILL.md`、agent 元数据或独立触发规则。这样既保留连续笔迹能力，也避免上游交互流程与主 Skill 冲突。来源和修改边界见其 `UPSTREAM.md` 与 MIT `LICENSE`。
-
-样式层、音频层和渲染层彼此独立。换画风不应自动换声音；重做一幕也不应重新生成已经通过的旁白。

package/skills/hand-drawn-explainer-video-nikola/docs/CONFIGURATION.md

@@ -1,22 +0,0 @@
-# 配置
-
-公开仓库提供刘飞音色 ID 作为成片默认值，但不提供密钥或个人绝对路径。复制 `config/runtime.example.json` 到项目目录并按项目修改；项目 `DESIGN.md` 和用户当次指令优先。
-
-## 配音
-
-首选顺序：复用稿件一致的合格已有音轨 → 火山引擎刘飞 `zh_male_liufei_uranus_bigtts` → 用户明确选择的其他火山音色。电脑系统朗读和 edge-tts 不作为默认成片方案。火山脚本通过环境变量读取密钥：
-
-```powershell
-$env:VOLCENGINE_TTS_API_KEY = '仅在当前终端设置，不写入仓库'
-pwsh -File scripts/volcengine_tts.ps1 -TextFile project/narration.txt -OutputFile project/assets/narration.mp3 -DryRun
-```
-
-确认 DryRun 后再移除 `-DryRun`。只有用户明确改选音色时才增加 `-Speaker '<其他火山音色ID>'`。接口、资源 ID 和音色可用性会变化，调用前核对服务商当前官方文档。不要把密钥写进 `.env.example`、截图、日志或问题单。
-
-## 画面
-
-默认 1920×1080、30fps。竖屏或方屏必须同时更新源图、标注 `canvas`、字幕安全区和最终清单。手部尺寸与 `hand-follow` 分开调；后者只改变手的缓动，不改变笔迹速度。
-
-## 付费与缓存
-
-执行任何云调用前明确提供商、模型、预计次数和缓存策略。网络中断且结果未知时先检查输出与服务记录，不盲目重试。音频缓存必须匹配原稿摘要、声音、模型和文件摘要。

package/skills/hand-drawn-explainer-video-nikola/docs/STYLES.md

@@ -1,28 +0,0 @@
-# 两条制作路线、画面结构与视觉风格
-
-不要把制作路线、画面结构和视觉风格混为一谈：
-
-```text
-制作路线
-├─ 逐笔故事动画
-│  ├─ 画面结构：单场景 / 多幕故事 / 左右双语义岛
-│  └─ 视觉风格：Q版人物 / 小黑风格 / 其他手绘风格
-└─ 程序动画
-   ├─ HTML / SVG / GSAP
-   └─ 流程卡片 / 关系图 / 精确文字 / 知识图形
-```
-
-| 类型 | 选项 | 适用内容 | 推荐触发说法 |
-|---|---|---|
-| 视觉风格 | 自然肤色 Q 版人物 | 人物传记、历史、创业故事 | “用 Q 版人物逐笔讲完他的一生，不要黑脸，年龄要变化” |
-| 视觉风格 | 小黑风格 | 方法、观点、抽象系统、冷幽默隐喻 | “用小黑风格边讲边画，白底少量彩色批注” |
-| 画面结构 | 左右双语义岛 | 左右因果、问题/答案、前后转折 | “先画左边边讲，再画右边，并保留左边内容” |
-| 制作路线 | 程序动画 | 流程、规则、关系、精确标签 | “用 HTML/SVG/GSAP 做手绘风流程卡片动画，文字必须准确可控” |
-
-左右双语义岛只规定叙事与绘制顺序：先画左边、讲完一部分，再画右边，并保留前面内容。它不是第三条制作路线，也不是一种画风。Q 版人物和小黑风格都可以采用左右双语义岛，也可以采用单场景或多幕连续故事。
-
-“手绘风”不自动等于逐笔绘制。用户说“一笔一笔”“笔尖跟随”“边讲边画”时使用逐笔模式；用户强调独立卡片、箭头、精确标签和元素变换时使用程序动画。
-
-《商用Skills_完整手绘视频》属于程序化知识图形：独立 SVG/HTML 人物、卡片、箭头和文字由 GSAP/HyperFrames 驱动。它的“手绘”来自视觉造型和描边风格，不是画笔沿同一幅位图持续落墨。逐笔路线则从源图提取线稿，在语义区域内执行 skeleton/stream 笔迹并逐步补色；两者可以共享旁白、字幕和最终验收，但不能互相冒充。
-
-详见 [自然肤色 Q 版人物](../references/q-human-story-style.md)、[小黑风格](../references/xiaohei-style.md) 和 [双语义岛](../references/semantic-island-storytelling.md)。对应案例：[《约法三章》逐笔样片](../examples/stroke-story/yuefa-sanzhang/README.md)、[《乔布斯的一生》逐笔双语义岛](../examples/stroke-story/steve-jobs/README.md)、[“什么是 Skill”程序动画](../examples/program-animation/skill-demo/README.md)。

package/skills/hand-drawn-explainer-video-nikola/docs/TROUBLESHOOTING.md

@@ -1,35 +0,0 @@
-# 常见问题
-
-## 逐笔预检找不到 Python
-
-先运行 `python vendor/srt-whiteboard-animation/scripts/prepare_env.py`。若使用自建环境，将解释器显式传给 `scripts/stroke_story_preflight.py --backend-python <路径>`。
-
-如果 pip 报代理、证书或“找不到版本”，先确认 Python 3.10+，再检查本机/公司网络的 pip 代理和镜像设置。也可以在可联网环境中按 `requirements-media.txt` 创建虚拟环境；不要把 `.venv` 提交到仓库。
-
-如果日志先连续出现 `ProxyError`，最后才显示 `No matching distribution found`，优先判断为包源/代理不可达，不要据此随意降低依赖版本。修复网络或切换到可信镜像后重新运行准备脚本；已创建但依赖不全的 `.venv` 可以复用，脚本会继续补齐缺失包。
-
-## 手移动太快
-
-降低 `hand-follow` 只能让手更平滑，不会降低落墨速度。增加区域时长、拆分语义区域或简化源图线条；确保主要轮廓、补色和至少 0.5 秒完成停留都能看清。
-
-## 后一区域提前露出
-
-检查区域框、跨岛连通线和 `protectedRegions`。双岛之间保留 6%–10% 留白，禁止背景线跨岛。
-
-## 最后一帧漏色或突然放大
-
-比较幕尾 0.3–0.5 秒和批准源图。只有确认漏色时才启用源图淡入；正常情况下使用 `--source-overlay never`。
-
-## 程序动画缺少 GSAP
-
-进入示例工程运行 `npm install`；`predev`、`precheck` 和 `prerender` 会把 npm 包中的浏览器文件复制到本地 `assets/`。不要把来历不明的压缩脚本提交到仓库。
-
-## HyperFrames 找不到 FFmpeg 或 FFmpeg 无法启动
-
-`setup_check.py` 只把当前命令行可发现的 FFmpeg/FFprobe 视为就绪。若机器已有未加入 PATH 的可运行版本，可在当前任务的本地运行配置中填写绝对路径，或按 HyperFrames 支持的 `HYPERFRAMES_FFMPEG_PATH`、`HYPERFRAMES_FFPROBE_PATH` 临时环境变量传入。不要为了一个项目永久改写系统 PATH。
-
-“找到文件”不等于“编码器可运行”：Windows 返回 `STATUS_DLL_NOT_FOUND` 时通常是该 FFmpeg 构建缺少配套 DLL；精简版 FFmpeg 也可能不能读取 WAV 或编码 AAC。换成完整、可独立运行的 64 位发行版，并分别执行版本检查和短音频/短视频测试后再渲染。
-
-## 有图但无法完成视频
-
-保存源图、旁白、SRT、时间轴和标注，说明缺少的是 FFmpeg、浏览器、账号还是模型。不能把静态图或 SVG 淡入假称为逐笔成片。

package/skills/hand-drawn-explainer-video-nikola/examples/program-animation/skill-demo/DESIGN.md

@@ -1,24 +0,0 @@
-# Skill 手绘动效完整版
-
-## Style Prompt
-9:16 中文知识讲解。暖白纸面、粗而略不规则的深色线条、蓝衣办公人物和黄色小机器人。通过独立元素的移动、铰链式手势、书页与步骤组合表达含义。保持轻松、清晰，不模仿博主个人 IP。
-
-## Colors
-- Paper #F8F6EF
-- Ink #24251F
-- Cobalt #2855C7
-- Sunflower #F0C541
-- Tomato #D64B36
-
-## Typography
-Microsoft YaHei for Chinese. Georgia for large Skill wordmark. Chinese text remains deterministic and separate from illustration.
-
-## Motion
-36-second complete narration. Eight scenes: repeated requests, organizing instructions, definition, weekly report procedure, supporting materials, reuse, permissions and checking, final definition. Paper crossfades between scenes. Character forearm rotates independently; document components move independently. Hold the final definition after the narration. Do not imply precise lip sync.
-
-## What NOT to Do
-- No full-image pan/zoom as the principal animation.
-- No AI-generated text or new voice.
-- No dark background, gradients, or drifting paper color.
-- No decorative motion that obscures the explanation.
-- No promise of photorealistic or fully articulated character animation.

package/skills/hand-drawn-explainer-video-nikola/references/automation-workflow.md

@@ -1,67 +0,0 @@
-# 完整成片流程
-
-## 1. 确定输入与复用资产
-
-检查现有原稿、完整配音、样片意见、角色/配色参考、输出目录和工具。先按 [preflight-and-recovery.md](preflight-and-recovery.md) 实测所选路线：渲染必需能力与可选独立语音复核分别检查，复用本地已验证配置。已有批准就是继续工作的依据；不要每个镜头都问确认。原稿变更与读音调整留痕。
-
-项目保存：`script.txt`（原稿）、`narration.txt`（合成输入，可有明确读音处理）、`assets/`、`DESIGN.md`、`timeline.json`、`index.html`、渲染日志和检查报告。项目按当前指令放置。
-
-使用简短的项目状态文件记录稿件摘要、配音资产与来源、样片批准范围、每镜头素材/动画/检查状态、最近成功渲染路径。修改时从受影响阶段继续：仅改字重或配色不动配音；改口播后重新合成或剪辑相应音轨，并重新对齐受影响字幕和后续镜头。失败日志不保存密钥或原始请求头。
-
-## 2. 先配音，再定时长
-
-遵循 [voiceover.md](voiceover.md)。时长由实际音频决定；镜头常为 4–6 秒但不是硬约束。用户有时长上限时，通过经授权的稿件调整或适度语速调整解决，不截断最后一句。
-
-时间轴至少保存以下字段，单位为秒：
-
-```json
-{
-  "duration": 36.0,
-  "audio_duration": 34.848,
-  "narration_text": "完整原稿，必须与下面各段拼接一致",
-  "alignment": "sentence_pause_estimate",
-  "scenes": [
-    {"n": 1, "start": 0.0, "end": 4.0, "caption": "对应原文"}
-  ]
-}
-```
-
-上面是字段说明，不是可直接通过检查的完整数据。实用值必须替换为真实全稿与所有镜头。字幕与合成读音文本不同时记录差异原因，不能静默把 ASR 错字覆盖原稿。
-
-## 3. 做视觉编排表
-
-每镜头记录：起止时间、旁白原文、类型（人物情景/知识图形/实际素材）、最终构图、第一/第二/第三次变化、转场、素材来源、待验证项。不为凑数强加三次变化。画面应在对应概念被讲到时出现。
-
-人物负责引入疑惑、体验和提醒；流程、关系和对比优先用知识图形。屏幕操作与事实截图用真实素材。只按“每句换一张图”安排视频不能保证解释质量。
-
-先按主 Skill 的路线表确认视觉意图。用户要求画面被逐笔画出时，改读 [stroke-story-workflow.md](stroke-story-workflow.md)，视觉编排表以“共享画布 + 语义区域 + 开始时间”为主，不再按 SVG 独立场景设计。只有流程卡片、关系图和独立元素动画继续使用本页后续的 HyperFrames 规则。
-
-## 4. 制作可控素材与动画
-
-程序动画模式默认使用已安装的 HyperFrames 技能；制作前读它的作者规范、CLI 和相关动画参考。工具缺失先报告可行安装/替代，不把技能文件存在当作运行环境正常。
-可复制 `examples/program-animation/skill-demo/` 到新工作目录参考：人物独立手臂、气泡依次出现、卡片收拢到书、分步流程、材料归集、复用箭头、闭合权限锁、放大镜检查。先运行 `npm install` 获取固定版本依赖；换主题时重做文稿与语义关系，不能只改标题。
-
-工程细节：
-- 使用本地素材与本地 GSAP；字体声明明确，系统中文字体可使用 `@font-face` 的 `local()`，可移植交付时注明依赖或嵌入有授权字体。
-- SVG 外层固定构图坐标，内层命名组做动画，避免父子坐标混淆导致手臂飞走。
-- 未来场景的初始隐藏状态写在明确 CSS ID 规则中；不要只依靠暂停时间轴 t=0 的 `set()`。
-- 动态手臂替代原手臂，不能保留两份形成多手人物。放大镜、卡片、气泡不得误挡角色或字幕。
-- 同一属性不同时被多个动画控制；用有限重复、确定性的时间轴和框架规定的同步注册。
-- 把最长标题、字幕和最终同时可见元素排好，再加进入动作。合法的短暂转场交叠需实际查看，不能批量忽略所有碰撞。
-- 结尾留适量阅读停顿，结束后不突然跳回首帧或留黑画面。
-
-复杂自然动作才使用视频模型。此前生成的图片不一定可直接拆成透明图层；需要拆层/重新生成或改为 SVG 时，说明质感变化。用户已批准的简化手绘方式无需再次确认。
-
-## 5. 环境和渲染
-
-先检查 Node、可工作的完整 FFmpeg/FFprobe 和渲染浏览器。先运行版本检查、音频探测和 H.264 编码器检查，再长时间渲染。
-已验证 HyperFrames 0.8.20；新项目按当前工具帮助选择并固定版本，不机械升级旧工程或批量改全局设置。用官方 CLI 初始化可用项目，保留它的项目指令；初始化的远程技能下载失败不等于本地已有插件失效，分别核实。
-
-本次实测坑：某些剪辑软件内置 FFmpeg 能解码但无 `libx264`/`crf` 支持；复制共享版 exe 会因缺 DLL 无法启动。不要反复拿同一不完整组件重试。使用完整发行版，或当前可用的 `imageio_ffmpeg.get_ffmpeg_exe()`；后者不保证附带 FFprobe，需要单独查找有效 FFprobe。
-可在进程范围指定 `HYPERFRAMES_FFMPEG_PATH` / `HYPERFRAMES_FFPROBE_PATH`，不要改系统 PATH；本机缓存的浏览器路径也不是可移植配置。
-
-先检查代表场景、最长字幕和转场，再运行当前 CLI 的 `check`（或对应版本的 lint/validate/inspect）。修复完成后验证 3–5 秒内部样段，再导出完整 MP4；不在排版检查尚未完成时启动全片。初次一般 2 个渲染 worker，按机器资源调节。长命令保存日志并反馈实质进展。编码失败只修环境/重新渲染，不重新请求 TTS 或所有图片。
-
-## 6. 检查和交付
-
-执行 [quality-and-delivery.md](quality-and-delivery.md)。先样片的请求只交样片；样片已批准且要求全片时一直做到全片完成。完整成片应带可编辑工程及音频，不能让用户自己从代码导出才能观看。

package/skills/hand-drawn-explainer-video-nikola/references/output-example.md

@@ -1,79 +0,0 @@
-# 输出示例：AI CapEx 七镜头
-
-这是 1.0 的格式示例，严格使用当前 AI CapEx 文案的 7 个镜头，不加入无关人物或额外风格测试镜头。完整测试输出见项目 `outputs/q-doodle-flow-skill-v1-ai-capex-test.md`。
-
-## 镜头索引
-
-| 镜头 | 对应口播 | 时长 | 视觉隐喻 | 后期关键词 |
-|---|---|---:|---|---|
-| 01 模型榜失宠 | “谁发了最强模型”已经没人看了。 | 6 秒 | 分析师把冠军奖杯推开，用放大镜盯电表 | 模型榜失宠 |
-| 02 开始算账 | 现在华尔街死盯着大厂的电费单和折旧表。 | 6 秒 | 电费单与折旧账本压在天平两端 | 开始算账 |
-| 03 财报试金石 | 四大巨头的财报将是 AI 赛道真正的试金石。 | 6 秒 | 四位 Q 版商业人物参加财报考试 | 财报试金石 |
-| 04 算力豪赌 | 大厂合计要砸下约 7000 亿美元买算力。 | 6 秒 | 四辆 GPU 手推车推向会吞硬件的机器 | 约7000亿美元 |
-| 05 三张压力单 | 自由现金流、云毛利、能源成本都承压。 | 6 秒 | 三张卡片分别漏水、被压扁、被电表拖拽 | 成本反噬 |
-| 06 收入与成本赛跑 | AI 商业化赚的钱跑输了资本开支和电费。 | 6 秒 | 黄色收入硬币被三头成本怪物追赶 | 收入跑得赢吗 |
-| 07 革命还是吞金兽 | 你觉得 AI 是生产力革命还是吞金兽？ | 6 秒 | AI 机器站在生产力与吞金岔路口 | 你站哪边 |
-
-## 完整镜头示例：01
-
-```text
-镜头 01
-对应口播：“谁发了最强模型”已经没人看了。
-建议时长：6 秒
-视觉隐喻：模型冠军奖杯被推到一旁，分析师用放大镜改盯电表。
-后期关键词：模型榜失宠
-
-【Flow 生图提示词】
-Create a vertical 9:16 modern Q-version hand-drawn crayon illustration on clean warm-white sketchbook paper. A natural Q-version market analyst in the center pushes a golden blank champion trophy toward the left while raising an oversized cobalt-blue magnifying glass toward a simplified gray electricity meter on the right. Use thick imperfect black hand-drawn outlines, sunflower yellow, cobalt blue and tomato red, 3–5 large visual groups, a central subject group occupying about 65% of the width, and generous blank space above and below. Keep all faces illustrated and restrained. No readable text, model names, numbers, logos, watermark, photorealism, 3D, cyber HUD, vintage newspaper style or extra decorations.
-
-【Flow 图生视频提示词】
-Create a 6-second vertical 9:16 tactile 10–12 fps paper stop-motion assembly. Start from the supplied completely blank warm-white paper frame and end on the supplied final illustration. Use a locked flat frontal camera. The golden blank trophy slides in from the left, the Q-version analyst pops into the center and pushes it aside, then raises the cobalt-blue magnifying glass. The gray electricity meter slides in from the right; the glass swings once and locks over its dial. Preserve the exact final character, paper texture, thick black crayon linework and sunflower-yellow/cobalt-blue/tomato-red palette. Hold the exact end frame for the final 0.8 seconds. No camera drift, zoom, parallax, lip sync, face morphing, new characters, text, logos, watermark or audio.
-```
-
-## 完整镜头示例：04
-
-```text
-镜头 04
-对应口播：2026 年这些大厂合计要砸下约 7000 亿美元买算力。
-建议时长：6 秒
-视觉隐喻：四位 Q 版商业人物推着 GPU 手推车，集体把硬件送进一台贪吃的红色算力机器。
-后期关键词：约7000亿美元
-
-【Flow 生图提示词】
-Create a vertical 9:16 modern Q-version hand-drawn crayon illustration on clean warm-white sketchbook paper. Four restrained Q-version business leaders push four cobalt-blue carts filled with blank sunflower-yellow GPU chips toward one giant tomato-red compute machine with a playful open mouth. Keep the people natural rather than distorted; let the carts and machine carry the exaggeration. Arrange the leaders and carts on the left and the machine on the right, centered in the middle 65%–70% with clean upper and lower breathing space. Use thick imperfect black hand-drawn outlines and bold crayon blocks. No readable text, currency figures, logos, watermark, photorealism, 3D, factory background or cyber HUD.
-
-【Flow 图生视频提示词】
-Create a 6-second vertical 9:16 tactile 10–12 fps paper stop-motion assembly from the supplied completely blank warm-white paper frame to the supplied final illustration. Lock the flat frontal camera. The tomato-red compute machine slides in from the right, then four cobalt-blue carts roll in from the left, followed by the four Q-version leaders pushing together. Blank yellow hardware bounces gently in the carts; the machine mouth opens once. Preserve exact faces, proportions, crayon texture and color palette. Settle into the supplied end frame and hold for the final 0.8 seconds. No camera drift, zoom, parallax, walking cycle, face morphing, new people, text, numbers, logos, watermark or audio.
-```
-
-## 完整镜头示例：05
-
-```text
-镜头 05
-对应口播：亚马逊自由现金流逼近归零，微软云毛利承压，谷歌能源成本飙升。
-建议时长：6 秒
-视觉隐喻：三张空白压力卡片分别漏水、被重物压扁、被红色电表拖住。
-后期关键词：成本反噬
-
-【Flow 生图提示词】
-Create a vertical 9:16 modern Q-version hand-drawn crayon illustration on clean warm-white sketchbook paper. Show three large blank finance cards side by side: a blue cash tank with one yellow drop remaining on the left, a blue cloud squeezed by a yellow weight in the center, and a small data-center block pulled by a tomato-red electricity meter and cable on the right. Add three imperfect red grading circles around the problem objects. Use thick black hand-drawn crayon lines, sunflower yellow, cobalt blue and tomato red, with the three-card group occupying about 88% of the width and clean margins. No words, letters, numerals, tables, logos, watermark, 3D, realistic machinery or UI.
-
-【Flow 图生视频提示词】
-Create a 6-second vertical 9:16 tactile paper stop-motion infographic. Start from the supplied completely blank warm-white paper frame and end on the supplied final three-card illustration. Lock the flat frontal camera. Slide in the three blank cards from left to right. Pop in the cash tank and let one yellow drop fall, drop the yellow weight onto the blue cloud once, then slide in the data-center block and red meter so the cable pulls taut. Draw the three red grading circles one after another. Preserve rigid flat paper pieces, exact layout, crayon texture and final palette; hold the end frame for 0.8 seconds. No zoom, UI animation, numbers, words, logos, extra cards, morphing, watermark or audio.
-```
-
-## 完整镜头示例：07
-
-```text
-镜头 07
-对应口播：你觉得 AI 是生产力革命还是吞金兽？
-建议时长：6 秒
-视觉隐喻：AI 机器站在生产力符号与吞金嘴的岔路口，等待观众按下选择开关。
-后期关键词：你站哪边
-
-【Flow 生图提示词】
-Create a vertical 9:16 minimal modern Q-version hand-drawn crayon illustration on clean warm-white sketchbook paper. Place one friendly white AI machine at a fork in the center. On the left, a cobalt-blue gear, sunflower-yellow rocket and tomato-red upward arrow form one productivity group. On the right, the machine opens a playful red mouth toward a short stack of yellow coins. A human hand reaches from the bottom toward a small muted-green switch. Use thick imperfect black hand-drawn outlines, bold crayon blocks, 3–5 large groups and generous blank space. No words, letters, numbers, logos, watermark, photoreal robot, glossy 3D, cyberpunk, UI panels or background room.
-
-【Flow 图生视频提示词】
-Create a 6-second vertical 9:16 tactile 10–12 fps paper stop-motion assembly. Start from the supplied completely blank warm-white paper frame and end on the supplied final illustration. Lock the flat frontal camera. Draw the two forked path lines upward, drop in the rigid white AI machine, then pop out the blue gear, yellow rocket and red arrow on the productivity side. Open the red mouth once and slide the yellow coin stack toward it. A hand rises from the bottom and presses the green switch once. Preserve exact shapes, crayon linework, paper texture and palette, then hold the exact end frame for the final 0.8 seconds. No camera movement, zoom, parallax, smooth 3D motion, morphing, new symbols, text, logos, watermark or audio.
-```

package/skills/hand-drawn-explainer-video-nikola/references/preflight-and-recovery.md

@@ -1,49 +0,0 @@
-# 运行预检与故障恢复
-
-完整制作第一次进入配音或长渲染前读取本页；同项目仅改文案/颜色且环境未变时复用已有检查。提示词模式不执行环境检查。
-
-## 用执行结果选环境
-
-不按默认 `python`、包可被搜索到、文件夹存在来判断能力。先选已验证的独立环境；运行库升级、模型路径变动或环境被清理后重新实测。机器路径放在本地配置（Windows 可放 `%LOCALAPPDATA%/CodexVideo/runtime.json`），不要写进可分发技能或工程 ZIP。配置不是成功证明。
-
-`scripts/preflight.py` 只做本地检查，不读密钥、不调用配音、不安装依赖。配置字段：`node`、`hyperframes_cli`（CLI 的 JS 入口绝对路径）、`chrome`、`ffmpeg`、`ffprobe`、`media_python`；独立语音复核另加 `asr_python`、`asr_model`（实际模型快照目录）。按当前机器发现文件并填入，不复制别人的路径。
-
-逐笔故事模式另外运行 `scripts/stroke_story_preflight.py`。它检查仓库内置的 `vendor/srt-whiteboard-animation`、隔离 Python、`skeleton`/`contour-wipe` 参数，并在临时目录完成一个无网络的小型 MP4 渲染与解码。它不会安装依赖或调用收费接口；具体命令见 [stroke-story-workflow.md](stroke-story-workflow.md)。
-
-```text
-python <skill>/scripts/preflight.py --config <local-runtime.json> --mode render --report <project>/preflight-render.json
-python <skill>/scripts/preflight.py --config <local-runtime.json> --mode asr --audio <existing-local-audio> --report <project>/preflight-asr.json
-```
-
-渲染检查会真实编码三帧 H.264、探测生成文件、通过当前 CLI 依赖启动 Chrome 并截图。ASR 检查会先核实非空模型权重、配置和词表，再在独立子进程中实际加载模型并推理；提供已有音频时只用前五秒。不能把导入成功或空模型缓存当成可运行。
-
-本机本次验证通过的是 Python 3.12 独立环境、faster-whisper 1.2.1 / CTranslate2 4.8.1；完整依赖组合见 `scripts/asr-requirements-tested.txt`。这是可复现组合，不是所有机器都必须升级到该版本。建立独立环境时依照安装技能，不改系统 PATH 或其他项目环境。先用已有音频测试，不为预检重新收费配音。
-
-## 选择当前发行版支持的检查工具
-
-优先运行当前 HyperFrames CLI 的 `check` / `inspect` / `snapshot`。部分技能附带的动画映射脚本直接依赖开发包 `@hyperframes/producer`，CLI 发行版不一定提供这个独立包；不能把“CLI 能运行”推导成“所有附带脚本依赖齐全”。
-
-需要细粒度动画映射且工程是单页、内联 SVG/HTML/GSAP 时，可使用本技能的兼容入口（参数均取本地配置）：
-
-```text
-node <skill>/scripts/animation-map.mjs <project> --cli <hyperframes-cli-entry> --browser <chrome-executable> --width 1080 --height 1920 --frames 2 --out <project>/animation-map
-```
-
-它沿用原映射逻辑，通过 CLI 所在依赖树发现 Puppeteer，不要求单独安装开发包，也不硬编码 npm 缓存目录。此入口不模拟 HyperFrames 嵌套合成/视频同步，遇到外部子合成或视频会明确拒绝；改用官方 CLI 检查与实际 MP4 验证，不把缩减版映射冒充完整引擎检查。
-
-## 按失败类型恢复
-
-- DLL 初始化失败、访问违规：记录解释器和依赖版本，将该组合标记为本次不可用。切换经预检的隔离环境；无任何变化不再重跑同一命令。仅凭另一个环境成功，不能断言具体哪个 DLL 或单个版本就是根因。
-- 模型只有目录、权重缺失：不启动加载。选择已完整可用的模型；确需下载时先核实体积、磁盘和网络，不为了可选加强检查自动下载数 GB。
-- 检查脚本缺开发依赖：使用上述兼容入口或当前 CLI 的公开能力；不临时修改全局插件文件。
-- 浏览器检查超时：保存阶段和日志，先查看进程是否仍有进展；确认停滞后终止本次子进程，允许切换 `--no-browser-gpu` 后做短片/截图测试。软件模式不是普遍更快，不强制套用。
-- UTF-8 中文文件被系统 GBK 解码：文件读写显式指定 UTF-8，必要时对子进程设置 `PYTHONUTF8=1`，不修改系统区域设置。
-- 布局错误：修画面，保留已通过的音轨。固定眉题、角标尽量放在场景外共享层；转场标题叠化与正常场景文本冲突分别判断，禁止批量忽略碰撞。
-
-预检失败只阻止依赖该能力的阶段。原生有效词时间戳可用于字幕对齐；独立 ASR 是额外复核，失败不等于配音失败，但必须披露复核缺口，不能改用静音分析后宣称已逐词验收。没有工具可以证明语气自然或英文读音完全正确时，保留待试听状态。
-
-## 长渲染之前与之后
-
-顺序为：确定最终静态构图 → 代表场景、长字幕和转场检查 → 完整工程检查通过 → 长渲染。不要一边仍改布局、一边先启动全片渲染。用 3–5 秒内部样段覆盖人物动作与至少一次转场，确认有画、有声后继续全片；不重复向用户索要已确认风格。
-
-最终仍需实际 MP4 全解码、逐场景/转场抽检与结尾核对。修复工具、代码返回 0、HTML 通过检查，都不等于成片已经验收。保存实际工具路径、版本、预检结果和已成功阶段，下一次从记录继续，但在环境改变后重新验证。