create-dwy 0.16.1 → 0.17.1

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-flow//346/211/247/350/241/214/346/270/205/345/215/225.template.md

@@ -0,0 +1,60 @@
+---
+version: 7
+topic: "{主题}"
+date: "{YYYY-MM-DD}"
+episode_dir: "episodes/{YYYY-MM-DD}-{主题}"
+work_dir: "media"
+updated: "{YYYY-MM-DD}"
+next_stage: ideation
+# 因果：主题 → 0010(竞品+AI地图) → 0030事实 → 0040脚本
+run_mode: ""
+factory_choice: null
+---
+
+# 执行清单 · {主题}
+
+> 跨集：`.dwy/uc-media/channel-profile.md` · `topic-backlog.md`  
+> **0010** = 竞品 + **AI 推荐演讲地图**（已合并原 0020）
+
+## 进度
+
+| # | stage | skill | status | 主文档 | summary | updated |
+|---|-------|--------|--------|--------|---------|---------|
+| — | channel | uc-media-0010-product | pending | `.dwy/uc-media/channel-profile.md` | 跨集 | |
+| 0 | ideation | uc-media-0005-ideation | pending | `.dwy/uc-media/topic-backlog.md` | 可 skipped | |
+| 1 | product | uc-media-0010-product | pending | `0010-product/产品卡-*.md` | 竞品+AI地图 | |
+| 2 | facts | uc-media-0030-facts | pending | `0030-facts/事实-*.md` | 按地图扩展 | |
+| 3 | script | uc-media-0040-script | pending | `0040-script/脚本-*.md` | | |
+| 4 | design | uc-media-0050-design | pending | `0050-design/design-lock.md` | | |
+| 5 | assets | uc-media-0060-assets | pending | `0060-assets/素材清单.md` | fast 连跑 | |
+| 6 | package | uc-media-0070-package | pending | `0070-package/成片包.md` + shots | | |
+| 7 | factory | uc-media-0080-factory | pending | `0080-factory/适配说明.md` | | |
+| 8 | packaging | media-platform-packaging | pending | `0070-package/` 包装 | 可选 | |
+
+status：`pending | in_progress | ready_for_confirm | done | stale | failed | skipped`
+
+## 工厂选型（0080）
+
+| 项 | 值 |
+|----|-----|
+| 用户选择 | remotion / hyperframe / （未选） |
+| 工程目录 | |
+| 确认日期 | |
+
+## 硬停记录
+
+| 节点 | 确认 | 日期 |
+|------|------|------|
+| 0005 人选 | | |
+| 0010 产品卡（地图） | | |
+| 0030 事实 | | |
+| 0040 脚本 | | |
+| 0050 design | | |
+| 0070 成片包 | | |
+| 0080 工厂 | | |
+| render | | |
+| 0090 包装 | | |
+
+## 备注
+
+-

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-knowledge-town/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: uc-media-knowledge-town
+description: |
+  将科普脚本制作成“知识小城”纸片电影：固定 LLM-S01-ChatDoor 的贴纸视觉系统，允许不同主题自由设计场景、道具和镜头，并生成可由 Remotion 渲染的素材、镜头与对轨数据。用于 0050 锁定视觉、0060 生成和验收角色/道具/档案贴纸、0070 组装 cue-timeline 或 0080 Remotion 制作；适用于二维纸片拼贴、边讲边展示、字幕/口播/BGM/音效同步的知识视频。
+---
+
+# 知识小城纸片电影制作标准
+
+使用本 skill 时，保留现有流水线分工：0040 决定说什么，0050 选风格，0060 管素材，0070 生成机读对轨包，0080 生成 Remotion 工程。不要另建平行视频流程。
+
+本 skill 分成两层：**频道贴纸系统固定**，以 LLM `S01PaperFilmPreview` 的纸张、描边、阴影、强调色、名牌、档案框和底部对白框为母版；**主题叙事世界可变**，每期可自由选择空间、道具、构图与镜头。不要把 LLM 的聊天门、手机或 AI 主题当作跨集必需元素。
+
+## 风格锁定
+
+在 `0050-design/design-lock.md` 写入：
+
+```yaml
+style_id: knowledge-town-paper-film-v1
+production_stack: remotion
+sync_source: media/0070-package/cue-timeline.json
+```
+
+读取 [`references/style-guide.md`](./references/style-guide.md)、[`references/sticker-asset-production.md`](./references/sticker-asset-production.md)、[`references/cinematic-direction.md`](./references/cinematic-direction.md) 和频道角色真源 `docs/知识小城频道角色规范.md`，再把 [`assets/knowledge-town-paper-film-v1.json`](./assets/knowledge-town-paper-film-v1.json) 复制到本集 `0060-assets/` 作为可改预设。品牌图标必须先从 `shared/icons/brands/` 取正式文件。
+
+0060 先按贴纸规范生成或采购素材，再在深海军蓝与暖米纸底色检查透明边缘。通过后才可登记 `shared/` 并复制进本集；真实截图保持原貌，必须放入统一档案贴纸框。不得为某一主题另起描边、阴影、卡片、箭头或字幕体系。
+
+## 对轨工作流
+
+1. 用 0040 的定稿口播产生配音和逐句字幕；配音真实时长是唯一时长基准。
+2. 为每句字幕指定一个 `cueId`、一个 `visualAction` 和零到多个 SFX。
+3. 运行 `scripts/build_cue_timeline.py` 合并字幕、视觉 beats 与预设，生成 `0070-package/cue-timeline.json`。
+4. 运行 `scripts/validate_cue_timeline.py`；失败时回到 0040/0060 修正，禁止在 0080 私自改时码。
+5. 在 Remotion 使用 `assets/remotion/` 的组件模板：一个 timeline 同时驱动旁白、字幕、动作和音效。
+
+```bash
+python3 scripts/build_cue_timeline.py \
+  --captions media/0040-script/captions-remotion-strict.json \
+  --beats media/0070-package/caption-visual-beats.json \
+  --preset media/0060-assets/knowledge-town-paper-film-v1.json \
+  --voice audio/voice/s01-cn-v1.wav \
+  --output media/0070-package/cue-timeline.json
+python3 scripts/validate_cue_timeline.py media/0070-package/cue-timeline.json
+```
+
+## 硬规则
+
+- 一个 `cueId` 只讲一个新信息；视觉动作在字幕开始后 2–4 帧预备，关键词在本 cue 的 40%–55% 出现。
+- 先为每个 cue 写 `事实来源 → 主问题 → 主动作 → 可见结果 → 术语揭示`；画面中出现的文字、年份、因果和示例必须可回溯至 0030 facts 或已批准口播。类比必须标明是类比，不能把道具名称当成技术事实。
+- 一个 cue 最多 `1 主角 + 1 道具 + 1 信息对象`，最多一条从原因到结果的运动路径。下一 cue 改讲新事时，先将旧元素收拢、淡出或转成转场物，禁止叠加成信息板。
+- **cue 场景图（硬门槛）**：实现前必须为每个 cue 列出 `elementId / 角色 / 文字来源 / 入场 / 落点 / 退场 / z-index 层`。当前 cue 只能保留本 cue 的对象，或最多一个已声明的转场物；上一 cue 的普通对象必须在新 cue 主动作开始前退场，禁止隐式继承造成叠字或残留道具。
+- **层级与依赖（硬门槛）**：层级固定为 `背景 0–9 → 舞台 10–19 → 连线/光束 20–29 → 道具 30–39 → 可读文字卡 40–49 → 前景贴纸 50–59 → 字幕 60+`。连线必须低于它指向的卡片，且只能在两个对象的空隙中存在；箭头线、箭头尖、发光和说明标签必须继承同一可见性与退场状态，禁止出现孤立线条、孤立箭头或标签滞留。
+- **文字白名单（硬门槛）**：屏幕上的每一段文字必须是“当前口播术语、事实例子、当前 cue 关键词或必要的操作标签”之一；不在 cue 场景图中的文字、数字、装饰性标签和重复术语一律不得出现。顶部关键词已表达的术语，内容区不得再重复。
+- **视觉语义（硬门槛）**：每个圆圈、箭头、光晕、线条和图标都必须在场景图中写明“指向谁 / 表示什么 / 何时消失”。没有叙事对象的装饰图形不得出现；高亮必须贴合被强调对象的轮廓，不能用泛化圆圈圈住一片空白。箭头必须从可见的原因对象出发、停在结果对象外沿，路径本身要能读出方向与因果。
+- **箭头原语（硬门槛）**：同一集只允许一套关系箭头原语：深蓝描边 + 珊瑚红纸带 + 固定比例的小箭头头部 + 绘制入场。关系默认使用对象之间的水平直连；不得用弧线、绕行线或流程图式折线增加装饰。不得混用 CSS 三角形、默认字符箭头、无描边线或不同颜色的箭头。空间不足时先重排对象，禁止把箭头压缩成只剩箭头头部。
+- 术语只在观众看懂动作后的结果帧出现一次；顶部关键词、中心贴纸和字幕不可重复同一术语。术语贴纸出现时，顶部关键词必须让位。
+- 每镜采用 `base_bg → content → text_sticker` 三层；不得用一张完成态大图替代渐进揭示。
+- **文字与路径防碰撞（硬门槛）**：每张可读文字卡、术语贴纸、角色名牌的可见边界（含描边与阴影）之间至少留 `24px`；连线、箭头、光束只能停在对象外沿，不得压过文字、描边、阴影或进入文字卡的点击/阅读区。需要指向时，箭头尖端与对象外沿保留 `8–16px` 间隙。
+- 禁止用不完整边框、孤立的半截箭头、无闭合折角来模拟纸片尾巴或连接关系；纸条拐角必须是完整闭合形状，连接线须在两个对象的空隙中可见且语义单一。
+- 底部 180px 是字幕带；关键内容的包围盒不得进入。
+- BGM、SFX、旁白分别建资产；旁白存在时 BGM 自动压低。只使用原创或许可明确可商用的音频和声音。
+- `cue-timeline.json` 是 0070 对轨真源；Remotion 组件不得自行写死字幕或 SFX 帧。
+- `LLM-S01-ChatDoor` 是频道贴纸系统的唯一质量母版，不是主题故事模板：先有角色要解决的事，再进入可感知的空间，由本主题英雄道具完成一次可见的变化，最后落在一个结果画面。
+- 每个正式场景必须提交独立 Remotion composition；先做 8–20 秒动态样片并获确认，再推广到全场。不得只交付整片预览。
+- 卡片、时间线节点、流程箭头只能作为道具的短暂状态，不能并排常驻承担讲解；禁止“背景 + 三张大卡 + 箭头 + 字幕”的成片结构。
+- 每场至少包含：前/中/后景，角色或道具的因果动作，一次镜头推进/拉远/穿行/转场，以及动作落点音效。没有这些只可标为预演，不可标为正式镜头。
+- 每个 cue 必须同时具备：`1 个叙事动作 + 1 个低频质感微动 + 1 个明确落点`。叙事动作推动因果（递交、选择、拆开、扫查、折叠等）；质感微动只增强纸片空间（纸张轻呼吸、光圈扩散、景深视差、阴影微偏移等），不得替代叙事；落点必须在动作结束时清晰可见，并配对应 SFX 或静默停顿。
+- 禁止无意义的漂浮、循环旋转、待机晃动和与画面无关的音效；角色只在入场、指向、递交、反应或收束等叙事动作时动画。
+- 每场先输出 3–4 张关键帧（建立、推进、术语结果、转场），逐张检查：无遮挡、无重复术语、无并排卡片墙、无事实越界；并以文字卡的描边/阴影外扩边界复核最小间距、连线终点与箭头尖端。通过后才渲染独立预览。
+- **动态碰撞验收（硬门槛）**：除建立/结果帧外，还必须抽检每段运动的 `25% / 50% / 75% / 90%` 帧。检查真实包围盒（文字、描边、阴影、缩放后的范围）是否相撞；尤其检查对象汇聚时不可落到同一坐标。任何重叠、遮字、无关残留或未绑定的线条，必须先修复场景图和生命周期，不能只靠微调坐标遮掩。
+
+## 资源
+
+- 风格规则：[`references/style-guide.md`](./references/style-guide.md)
+- 素材生成与透明验收：[`references/sticker-asset-production.md`](./references/sticker-asset-production.md)
+- 电影化导演规则与镜头配方：[`references/cinematic-direction.md`](./references/cinematic-direction.md)
+- 可复制预设：[`assets/knowledge-town-paper-film-v1.json`](./assets/knowledge-town-paper-film-v1.json)
+- 对轨构建与校验：[`scripts/`](./scripts/)
+- Remotion 组件模板：[`assets/remotion/`](./assets/remotion/)

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-knowledge-town/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "知识小城统一视觉视频制作"
+  short_description: "生成统一贴纸风格、可对轨的科普视频资产。"
+  default_prompt: "使用 $uc-media-knowledge-town 为本期科普锁定知识小城贴纸视觉系统，并建立可由 Remotion 渲染的素材、字幕、音频与镜头动作数据。"

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-knowledge-town/assets/knowledge-town-paper-film-v1.json

@@ -0,0 +1,80 @@
+{
+  "version": 2,
+  "styleId": "knowledge-town-paper-film-v1",
+  "characterSystem": "xiaoqi-bubu-v1",
+  "characterRoles": {
+    "xiaoqi": "audience_question_and_reaction",
+    "bubu": "guide_prop_and_plain_language_takeaway"
+  },
+  "fps": 30,
+  "canvas": {"width": 1920, "height": 1080, "subtitleBandPx": 180},
+  "visualTokens": {
+    "paperBase": "#f4e8c6",
+    "paperCard": "#fffdf5",
+    "ink": "#14213d",
+    "accent": ["#ffd161", "#77dfd1", "#ff9cb9"],
+    "shadow": {"color": "#14213d", "offsetPx": [10, 12], "blurPx": 0},
+    "texture": "warm-rice-paper-visible"
+  },
+  "stickerSystem": {
+    "caption": {"required": true, "position": "bottom-dialogue-frame", "maxLines": 2},
+    "nameplate": {"use": "first-entry-or-identity-only", "border": "ink", "shadow": "hard-offset"},
+    "archiveFrame": {"use": "real-screenshot-or-source", "preserveOriginalImage": true},
+    "relationshipArrow": {"style": "ink-outline-coral-paper-ribbon", "motion": "draw-in"},
+    "forbidden": ["pure-black-shadow", "soft-blur-shadow", "glassmorphism", "gradient-sticker", "3d-render", "photorealistic-subject", "second-card-system"]
+  },
+  "assetAcceptance": {
+    "format": "png-alpha",
+    "alphaPreviewBackgrounds": ["#14213d", "#f4e8c6"],
+    "reject": ["magenta-fringe", "green-screen-fringe", "missing-alpha", "baked-text", "baked-ui", "baked-logo"]
+  },
+  "themeFreedom": {
+    "allowThemeSpecificSceneAndCamera": true,
+    "allowThemeSpecificHeroProps": true,
+    "mustKeep": ["visualTokens", "stickerSystem", "caption-system", "archive-frame"]
+  },
+  "layers": ["base_bg", "content", "text_sticker", "caption"],
+  "timing": {"prepareFrames": 3, "actionProgress": 0.2, "labelProgress": 0.48},
+  "audio": {
+    "bgmVolume": 0.18,
+    "bgmDuckVolume": 0.06,
+    "sfxMap": {
+      "chatBubblesPop": [{"file": "audio/sfx/paper-icon-pop-v1.wav", "offsetFrames": 24, "volume": 0.75}],
+      "llmLabelReveal": [{"file": "audio/sfx/paper-icon-pop-v1.wav", "offsetFrames": 9, "volume": 0.5}],
+      "comicBoxOpen": [{"file": "audio/sfx/town-arrival-chime-v1.wav", "offsetFrames": 0, "volume": 0.48}],
+      "mapPiecesGather": [{"file": "audio/sfx/town-arrival-chime-v1.wav", "offsetFrames": 0, "volume": 0.68}]
+    }
+  },
+  "qualityGate": {
+    "referenceComposition": "LLM-S01-ChatDoor",
+    "requiredBeats": ["problem", "action", "choice_or_turn", "result", "clear_or_transition"],
+    "requiredSpatialLayers": 3,
+    "requireStandalonePreview": true,
+    "forbidCardWallAsFinal": true,
+    "forbidIdleMotion": true,
+    "maxConcurrentNarrativeObjects": 3,
+    "requireFactTraceability": true,
+    "forbidDuplicateTermAcrossCaptionAndSticker": true,
+    "requireNarrativeActionPerCue": true,
+    "requireAmbientMicroMotionPerCue": true,
+    "requireReadableLandingPerCue": true,
+  "requireTextAndPathCollisionCheck": true,
+  "requireSceneGraphPerCue": true,
+  "requireExplicitExitForPriorCueElements": true,
+  "requireDependentConnectorLifecycle": true,
+  "forbidUndeclaredOnScreenText": true,
+  "requireZOrderBands": true,
+  "requireMidMotionCollisionSampling": true,
+  "collisionSampleFrames": [0.25, 0.5, 0.75, 0.9],
+  "maxCarryoverObjects": 1,
+    "minTextCardOuterGapPx": 24,
+    "arrowTipClearancePx": [8, 16],
+    "forbidIncompletePaperCorners": true
+  },
+  "recipes": {
+    "themeOpening": ["theme-space", "character-or-hero-prop", "paper-entrance", "result-reveal"],
+    "sourceCheck": ["claim-or-object", "archive-frame", "check-action", "verified-result"],
+    "mapFinale": ["topic-results", "paper-fold", "path-or-map"],
+    "cardWall": "preview_only_never_final"
+  }
+}

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-knowledge-town/assets/remotion/AudioTracks.tsx

@@ -0,0 +1,20 @@
+import React from 'react';
+import {Sequence, staticFile, useCurrentFrame} from 'remotion';
+import {Audio} from '@remotion/media';
+import type {CueTimeline} from './CueTimeline';
+
+export const AudioTracks: React.FC<{timeline: CueTimeline; bgmFile: string}> = ({timeline, bgmFile}) => {
+  const frame = useCurrentFrame();
+  const hasVoice = timeline.cues.some((cue) => frame >= cue.startFrame && frame < cue.endFrame);
+  return (
+    <>
+      <Audio src={staticFile(bgmFile)} volume={hasVoice ? 0.06 : 0.18} />
+      <Audio src={staticFile(timeline.voice.file)} volume={1} />
+      {timeline.cues.flatMap((cue) => cue.sfx).map((effect) => (
+        <Sequence key={`${effect.file}-${effect.frame}`} from={effect.frame} layout="none">
+          <Audio src={staticFile(effect.file)} volume={effect.volume ?? 0.7} />
+        </Sequence>
+      ))}
+    </>
+  );
+};

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-knowledge-town/assets/remotion/CaptionLayer.tsx

@@ -0,0 +1,18 @@
+import React from 'react';
+import {interpolate, useCurrentFrame} from 'remotion';
+import type {CueTimeline} from './CueTimeline';
+
+export const CaptionLayer: React.FC<{timeline: CueTimeline}> = ({timeline}) => {
+  const frame = useCurrentFrame();
+  const cue = timeline.cues.find((item) => frame >= item.startFrame && frame < item.endFrame);
+  if (!cue) return null;
+  const opacity = interpolate(frame, [cue.startFrame, cue.startFrame + 4], [0, 1], {
+    extrapolateLeft: 'clamp',
+    extrapolateRight: 'clamp',
+  });
+  return (
+    <div style={{position: 'absolute', left: 220, right: 220, bottom: 42, minHeight: 112, zIndex: 50, opacity, display: 'flex', alignItems: 'center', justifyContent: 'center', padding: '18px 42px', color: '#14213d', background: '#fffdf5', border: '7px solid #14213d', borderRadius: 32, boxShadow: '0 12px 0 #14213d', fontFamily: 'Arial, PingFang SC, sans-serif', fontSize: 46, fontWeight: 900, lineHeight: 1.25, textAlign: 'center'}}>
+      {cue.caption.text}
+    </div>
+  );
+};

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-knowledge-town/assets/remotion/CueTimeline.ts

@@ -0,0 +1,24 @@
+export type CueSfx = {
+  file: string;
+  frame: number;
+  volume?: number;
+};
+
+export type Cue = {
+  cueId: string;
+  sceneId: string;
+  startFrame: number;
+  endFrame: number;
+  voText: string;
+  caption: {text: string; mode: 'bottomSpeechBubble'};
+  visual: {action: string; keyword: string};
+  sfx: CueSfx[];
+};
+
+export type CueTimeline = {
+  version: 1;
+  fps: number;
+  voice: {file: string; timingStatus: string};
+  canvas: {width: number; height: number; subtitleBandPx: number};
+  cues: Cue[];
+};

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-knowledge-town/assets/remotion/KnowledgeTownComposition.tsx

@@ -0,0 +1,21 @@
+import React from 'react';
+import {AbsoluteFill, useCurrentFrame} from 'remotion';
+import {AudioTracks} from './AudioTracks';
+import {CaptionLayer} from './CaptionLayer';
+import type {CueTimeline} from './CueTimeline';
+
+export const KnowledgeTownComposition: React.FC<{
+  timeline: CueTimeline;
+  bgmFile: string;
+  renderVisual: (action: string, frame: number) => React.ReactNode;
+}> = ({timeline, bgmFile, renderVisual}) => {
+  const frame = useCurrentFrame();
+  const cue = timeline.cues.find((item) => frame >= item.startFrame && frame < item.endFrame);
+  return (
+    <AbsoluteFill style={{background: '#f4e8c6', overflow: 'hidden'}}>
+      {renderVisual(cue?.visual.action ?? 'hold', frame)}
+      <CaptionLayer timeline={timeline} />
+      <AudioTracks timeline={timeline} bgmFile={bgmFile} />
+    </AbsoluteFill>
+  );
+};

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-knowledge-town/references/cinematic-direction.md

@@ -0,0 +1,73 @@
+# 电影化导演规则
+
+## Cue 模板
+
+每个 cue 先写五行，再画画面：
+
+```text
+事实来源：0030 facts / 已批准口播的句子
+主问题：观众此刻要解决的一个问题
+主动作：角色或英雄道具完成的一个动作
+可见结果：动作结束后唯一留下的新理解
+术语揭示：只在结果出现一次；没有必要则留空
+```
+
+禁止把“方便讲解的道具名”写成技术结论。比如 token 只能表现为“模型处理的文字小块，切分因模型而异”，不能用一个汉字断言一个 token。
+
+## 镜头语法
+
+1. **建立**：一名角色或一个道具进入可感知空间。
+2. **推进**：镜头推近唯一关键物；让它递交、拆开、选择、比较、盖章或折叠。
+3. **结果**：旧元素退场，只留一个新结果物；术语在这一拍出现。
+4. **转场**：结果物变成下一场的入口；不硬切到说明板。
+
+## 动效硬门槛
+
+每个 cue 都必须列出并实现以下三项：
+
+1. **叙事动作**：让信息发生变化，例如纸带送入、候选弹出、词卡回指、答案被选中、来源被扫查。
+2. **低频质感微动**：幅度小、速度慢，服务空间与材质，例如纸张 2–4px 呼吸、光圈扩散、前中后景视差、阴影微偏移。
+3. **明确落点**：动作结束后只留下一个可理解的结果，配一个准确 SFX 或 6–12 帧静默停顿。
+
+禁止用循环摇晃、无目的漂浮或持续旋转凑动效；它们不计入覆盖。
+
+## 场景图与叠放规范
+
+每个 cue 在编码前先给元素编号，并写清“何时出现、何时消失、处于哪层”。没有退场规则的元素不得进入下一 cue；例外只允许一个明确的转场物。
+
+```text
+bg(0–9) → stage(10–19) → connector(20–29) → prop(30–39)
+→ readable-card(40–49) → foreground-sticker(50–59) → caption(60+)
+```
+
+- 连线和箭头只在两个对象都可见时绘制，位于对象下层；箭头尖端停在目标外沿 `8–16px`，不穿入卡片、描边或阴影。
+- 同一术语只能有一个屏幕承载点；优先顶部关键词，其余区域只呈现动作或事实例子。
+- 对象做汇聚动画时，必须指定不同的最终落点；禁止多个标签落在同一坐标。
+- 圆圈、光晕、箭头、连线和图标都要有明确的叙事对象与解释：高亮贴合目标形状；箭头从原因对象出发、停在结果对象外沿。不能说明“它在指谁、为何此刻出现”的装饰，一律删除。
+- 关系箭头统一为深蓝描边、珊瑚红纸带、固定小箭头头部与绘制入场，并以对象之间的水平直连为默认。禁止弧线、绕行线、默认字符箭头、CSS 三角箭头和无描边线条混用。
+- 每段运动抽检 `25% / 50% / 75% / 90%` 帧，按含阴影的真实包围盒查碰撞。发现遮挡、叠字、残留线条时，先修生命周期/层级，再调坐标。
+
+## 常用配方
+
+| 讲解意图 | 电影动作 | 结果物 |
+| --- | --- | --- |
+| 预测候选 | 空位被推近，候选依次弹出，选中一张 | 被接回句尾的纸片 |
+| 上下文关系 | 指代词孤立，手电只连到相关词 | 一条定格关系线 |
+| 历史 | 引擎变车头，列车一次只停一站 | 下一站入口 |
+| 训练步骤 | 黑暗中一次只开一扇门 | 当前步骤的门牌 |
+| 可靠性 | 答案纸滑出，印章落下，具体处剥落 | 放大镜下的来源标签 |
+| 收束 | 已验证概念按口播顺序折成路径 | 一个可提问的结尾 |
+
+## 验收
+
+逐帧检查建立、推进、结果、转场四帧：
+
+- 是否只看得出一个主问题和一个动作？
+- 是否所有文字和因果能回溯至 facts/口播？
+- 是否术语只出现一次，且没有被字幕或顶部关键词重复？
+- 是否旧画面已清场，没有遮挡、交叉线或站桩角色？
+- 是否结果物能自然带入下一 cue？
+- 是否每个 cue 都有叙事动作、低频质感微动和明确落点？
+- 文字卡、术语贴纸、角色名牌是否包含描边与阴影后仍互不相撞（最小 `24px`）？
+- 所有箭头、连线、光束是否只在对象间空隙中运动，尖端离对象外沿 `8–16px`，没有覆盖文字或边框？
+- 纸条角、气泡尾巴、折页边是否为完整闭合形状，没有孤立折线或半截图形？

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-knowledge-town/references/sticker-asset-production.md

@@ -0,0 +1,30 @@
+# 知识小城贴纸素材生产
+
+在 0060 生成或采购素材前，先读取 `knowledge-town-paper-film-v1.json` 的 `visualTokens` 与 `assetAcceptance`。
+
+## 通用提示词前缀
+
+```text
+2D paper-cut collage sticker, warm rice-paper texture, deep navy #14213d thick ink outline, crisp offset deep-navy paper shadow, warm cream paper base, small accents only in bright yellow #ffd161, teal #77dfd1 and coral pink #ff9cb9, tactile layered paper, clean readable silhouette, no text, no logo, no UI, no watermark, no photorealism, no 3D render
+```
+
+### 变量模板
+
+| 素材 | 在前缀后补充 |
+|---|---|
+| 角色 | `full-body [role and action], transparent-background source, generous padding, no cast shadow` |
+| 单道具 | `one oversized [topic prop] showing [single action], transparent-background source, generous padding` |
+| 空景 | `[topic space] with foreground, midground and background layers, empty lower 180px subtitle area, no character, no text` |
+| 档案框 | `empty paper archive frame with wide image window, no text, transparent-background source` |
+
+## 透明资产验收
+
+1. 生图阶段使用单一、远离主体配色的纯色键背景；不得有渐变、地面、投影或反射。
+2. 转换为 alpha PNG 后，在 `#14213d` 和 `#f4e8c6` 两种底色预览。
+3. 检查完整轮廓、头发和深色线稿；不能有洋红/绿色残边、黑洞、锯齿或被擦除的细节。
+4. 通过后，将正式 PNG、来源、版本、角色/道具用途与深浅底检查结果登记进共享资产表；色键源图只留作溯源。
+5. 未通过验收的文件不得复制到新集或标记为 `cross_episode`。
+
+## 不可变与可变
+
+不可变：纸张、深海军蓝描边与硬阴影、强调色、贴纸卡、档案框、箭头和对白框。可变：主题空间、主题道具、角色动作、镜头语言和故事节奏。

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-knowledge-town/references/style-guide.md

@@ -0,0 +1,43 @@
+# 知识小城视觉规范
+
+以 LLM 集 `S01PaperFilmPreview` 为频道贴纸系统的唯一母版。它统一素材语言，不限制每期的主题空间、道具或镜头。
+
+## 频道贴纸系统（固定）
+
+| 项目 | 标准 |
+|---|---|
+| 纸张 | 暖米纸底 `#f4e8c6`、可见米纸纹；卡片底 `#fffdf5` |
+| 描边 | 深海军蓝 `#14213d` 粗描边 |
+| 强调色 | 明黄 `#ffd161`、青绿 `#77dfd1`、珊瑚粉 `#ff9cb9`；只作小面积强调 |
+| 阴影 | 深海军蓝硬边偏移阴影，默认 `10px 12px 0 #14213d`；不用纯黑或柔焦阴影 |
+| 文字 | 文字由 Remotion 渲染；贴纸有粗描边、圆角与硬阴影，不烤进生图 |
+| 字幕 | 底部对白框，最多两行；不与术语贴纸重复同一词 |
+
+所有自制角色、道具、术语卡、事实卡、关系箭头、档案框和地图收束件都必须使用这套 Token。不要引入玻璃拟态、渐变贴纸、3D、写实主体或第二套卡片/箭头体系。
+
+### 标准组件
+
+- **角色名牌**：只在首次入场或身份需要识别时出现；明黄或青绿底、海军蓝描边与硬阴影。
+- **术语贴纸**：在动作产生可见结果后出现一次，使用米白或强调色底；不得和字幕重复。
+- **档案贴纸框**：真实截图、GitHub 页面、项目界面和资料图保持原貌，只放入统一海军蓝描边的框内。
+- **关系箭头**：深海军蓝描边 + 珊瑚色纸带 + 绘制入场；只连接有因果关系的两个对象。
+- **底部对白框**：所有主题共用，留出 `180px` 字幕带；不能被道具或角色侵入。
+
+## 主题叙事世界（可变）
+
+许可证闸机、聊天门、档案列车、实验室、地图等都只是主题实例。每期可以自由改变场景、道具、构图、景别、机位、镜头推进与转场动作，但不得改变频道贴纸系统。
+
+一场仍按 `问题 → 行动 → 意外或选择 → 结果` 展开。角色或英雄道具推进因果；卡片、箭头和时间线只能短暂作为道具状态，不可变成常驻讲解板。
+
+## 素材准入
+
+- 角色和单道具使用透明 PNG；先检查 alpha 边缘，再登记共享资产库。
+- 在深海军蓝 `#14213d` 和暖米纸 `#f4e8c6` 底色各预览一次；出现洋红、绿幕残边、缺口或暗部被抠空即拒绝。
+- 生图只输出角色、场景或单道具：禁止烤入中文、品牌 Logo、UI、事实结论和字幕。
+- 真实截图不得重绘成纸片画；使用档案贴纸框，并在本集素材表记录来源。
+
+## 叙事与对轨
+
+每个 cue 依次经历 `prepare → action → label → hold → clear/transition`。先让观众看到动作和结果，再出现术语贴纸。每个 cue 只保留一个主角/道具/信息对象组合；上一 cue 的元素必须退场或折成明确的转场物。
+
+详细镜头、层级、文字和碰撞验收规则见 [`cinematic-direction.md`](./cinematic-direction.md)。0060 的生成提示词与透明素材验收见 [`sticker-asset-production.md`](./sticker-asset-production.md)。

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-knowledge-town/scripts/build_cue_timeline.py

@@ -0,0 +1,75 @@
+#!/usr/bin/env python3
+"""Build the single source of truth for narration, captions, visuals, and SFX."""
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+
+
+def load_json(path: Path):
+    with path.open(encoding="utf-8") as handle:
+        return json.load(handle)
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--captions", type=Path, required=True)
+    parser.add_argument("--beats", type=Path, required=True)
+    parser.add_argument("--preset", type=Path, required=True)
+    parser.add_argument("--voice", required=True)
+    parser.add_argument("--output", type=Path, required=True)
+    args = parser.parse_args()
+
+    captions = load_json(args.captions)
+    beat_document = load_json(args.beats)
+    preset = load_json(args.preset)
+    fps = beat_document.get("fps", preset.get("fps", 30))
+    beats = beat_document.get("beats", [])
+    caption_index = {(item["startMs"], item["endMs"]): item for item in captions}
+    sfx_map = preset.get("audio", {}).get("sfxMap", {})
+    cues = []
+
+    for beat in beats:
+        caption = caption_index.get((beat["startMs"], beat["endMs"]))
+        if caption is None:
+            raise ValueError(f"缺少与 {beat['cueId']} 对应的字幕时码")
+        if caption["text"].strip() != beat["captionText"].strip():
+            raise ValueError(f"{beat['cueId']} 字幕文本与视觉 beat 不一致")
+        sfx = []
+        for item in sfx_map.get(beat["visualAction"], []):
+            start_frame = beat["startFrame"] + item["offsetFrames"]
+            sfx.append({**item, "frame": start_frame})
+        cues.append({
+            "cueId": beat["cueId"],
+            "sceneId": beat["sceneId"],
+            "startMs": beat["startMs"],
+            "endMs": beat["endMs"],
+            "startFrame": beat["startFrame"],
+            "endFrame": beat["endFrame"],
+            "voText": caption["text"],
+            "caption": {"text": caption["text"], "mode": beat.get("captionMode", "bottomSpeechBubble")},
+            "visual": {
+                "action": beat["visualAction"],
+                "keyword": beat.get("onScreenKeyword", ""),
+                "timing": beat.get("progressiveTiming", {}),
+            },
+            "sfx": sfx,
+        })
+
+    output = {
+        "version": 1,
+        "styleId": preset["styleId"],
+        "fps": fps,
+        "voice": {"file": args.voice, "timingStatus": "estimated_until_forced_alignment"},
+        "canvas": preset["canvas"],
+        "audio": {"bgm": preset.get("audio", {}), "duckDuringVoice": True},
+        "cues": cues,
+    }
+    args.output.parent.mkdir(parents=True, exist_ok=True)
+    args.output.write_text(json.dumps(output, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
+    print(args.output)
+
+
+if __name__ == "__main__":
+    main()

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-knowledge-town/scripts/validate_cue_timeline.py

@@ -0,0 +1,68 @@
+#!/usr/bin/env python3
+"""Validate cue-timeline.json without third-party dependencies."""
+from __future__ import annotations
+
+import json
+import sys
+from pathlib import Path
+
+
+def validate(document: dict) -> list[str]:
+    errors: list[str] = []
+    if document.get("version") != 1:
+        errors.append("version must be 1")
+    fps = document.get("fps")
+    if not isinstance(fps, (int, float)) or fps <= 0:
+        errors.append("fps must be positive")
+        return errors
+    canvas = document.get("canvas", {})
+    if canvas.get("subtitleBandPx", 0) < 160:
+        errors.append("canvas.subtitleBandPx must be at least 160")
+    cues = document.get("cues")
+    if not isinstance(cues, list) or not cues:
+        return errors + ["cues must be a non-empty array"]
+    last_end_ms = last_end_frame = -1
+    ids: set[str] = set()
+    for cue in cues:
+        cue_id = cue.get("cueId")
+        if not cue_id or cue_id in ids:
+            errors.append(f"cueId must be unique: {cue_id!r}")
+        ids.add(cue_id)
+        start_ms, end_ms = cue.get("startMs"), cue.get("endMs")
+        start_frame, end_frame = cue.get("startFrame"), cue.get("endFrame")
+        if not isinstance(start_ms, int) or not isinstance(end_ms, int) or end_ms <= start_ms:
+            errors.append(f"{cue_id}: invalid millisecond range")
+        if not isinstance(start_frame, int) or not isinstance(end_frame, int) or end_frame <= start_frame:
+            errors.append(f"{cue_id}: invalid frame range")
+        if start_ms < last_end_ms or start_frame < last_end_frame:
+            errors.append(f"{cue_id}: overlaps previous cue")
+        if isinstance(start_ms, int) and isinstance(end_ms, int) and isinstance(start_frame, int) and isinstance(end_frame, int):
+            expected = round((end_ms - start_ms) * fps / 1000)
+            if abs((end_frame - start_frame) - expected) > 1:
+                errors.append(f"{cue_id}: frame duration disagrees with milliseconds")
+        if cue.get("voText") != cue.get("caption", {}).get("text"):
+            errors.append(f"{cue_id}: voiceover and caption text differ")
+        for effect in cue.get("sfx", []):
+            if effect.get("frame", -1) < start_frame or effect.get("frame", 10**9) >= end_frame:
+                errors.append(f"{cue_id}: SFX frame must fall inside the cue")
+        last_end_ms, last_end_frame = end_ms, end_frame
+    return errors
+
+
+def main() -> int:
+    if len(sys.argv) != 2:
+        print("Usage: validate_cue_timeline.py cue-timeline.json", file=sys.stderr)
+        return 2
+    path = Path(sys.argv[1])
+    document = json.loads(path.read_text(encoding="utf-8"))
+    errors = validate(document)
+    if errors:
+        print(f"FAIL {path}")
+        print("\n".join(f"  - {error}" for error in errors))
+        return 1
+    print(f"OK {path}  cues={len(document['cues'])}")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-knowledge-town/scripts/validate_style_preset.py

@@ -0,0 +1,22 @@
+#!/usr/bin/env python3
+"""Validate the immutable visual tokens of the knowledge-town style preset."""
+
+import json
+from pathlib import Path
+
+
+PRESET_PATH = Path(__file__).resolve().parents[1] / "assets" / "knowledge-town-paper-film-v1.json"
+
+
+def main() -> None:
+    preset = json.loads(PRESET_PATH.read_text(encoding="utf-8"))
+    assert preset["visualTokens"]["ink"] == "#14213d"
+    assert preset["visualTokens"]["accent"] == ["#ffd161", "#77dfd1", "#ff9cb9"]
+    assert preset["stickerSystem"]["caption"]["required"] is True
+    assert preset["assetAcceptance"]["alphaPreviewBackgrounds"] == ["#14213d", "#f4e8c6"]
+    assert preset["themeFreedom"]["allowThemeSpecificSceneAndCamera"] is True
+    print(f"Validated {preset['styleId']} visual system.")
+
+
+if __name__ == "__main__":
+    main()