tryworld-paper
Create branded 试界TryWorld AI-knowledge videos in the fixed "Paper Algorithm" (纸上算法) style with HyperFrames. Input is a Chinese voiceover script and optional images; output is a 16:9 horizontal video with Azure YunxiNeural (真·云希) voiceover, word-synced captions, ink/paper animatio
Install
npx skills add https://github.com/TryWorld2026/paper-algorithm/tree/main/skills/tryworld-paper
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install tryworld2026-paper-algorithm@llmmart
git clone https://github.com/TryWorld2026/paper-algorithm.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole tryworld2026/paper-algorithm collection as a plugin from our marketplace. Git is the plain clone.
README
试界-纸上算法 TryWorld-Paper Algorithm
一页会动的算法笔记 —— 把 AI 知识口播稿变成风格统一的横屏视频、横竖封面与平台标题。
这是什么
tryworld-paper(试界-纸上算法 TryWorld-Paper Algorithm)是试界TryWorld 的视频生产 Skill:输入一篇中文 AI 口播稿(可附图片),自动产出:
- 横屏主视频(16:9,口播最长约 10 分钟)—— 纸上算法风格,真云希配音,全程烧录字幕;超长稿提炼核心精华压缩
- 横版封面 + 竖版封面(1920x1440 横 4:3 / 1080x1440 竖 3:4)—— 深墨海报风(与视频浅纸面两套视觉语言),标题 + 信息块,适配 B站/抖音/小红书
- 3-5 个平台标题 —— 按 B站/抖音/小红书分别适配
- 右上角全程常驻的"试界原创"防伪印章
- 每期固定的默认结尾签名(试界TryWorld 标准收尾,口播+画面同步)
设计契约:纸上算法 Paper Algorithm
设计源头:科学手稿 + 中文印刷传统。每一期视频都是一页"会动的算法笔记",纸面是舞台,墨迹是文字,朱红是重点,印章是签名。
色板(4 色锁定,不新增)
| 色 | 值 | 用途 |
|---|---|---|
| 纸面 | #F4EFE4 |
背景主色 |
| 墨黑 | #1C1916 |
主文字、线条 |
| 朱红 | #C0452F |
唯一强调色:关键词、数字、印章 |
| 墨水蓝 | #2E5E8C |
次级批注、图表线 |
字体
- 主标题:思源宋体(Noto Serif SC)
- 批注/引用:ZCOOL XiaoWei(默认);霞鹜文楷(LXGW WenKai)如需使用须自带 woff2
- 数据/坐标:等宽字体(JetBrains Mono)
动效签名(全片统一)
| 签名 | 感觉 | 缓动 |
|---|---|---|
| 墨落纸 | 主入场 | power3.out |
| 笔写入 | 批注/小元素 | sine.inOut |
| 盖章 | 数字/结论/印章 | back.out(1.4) |
转场统一为墨染过渡:前场景被墨色浸染溶解,新场景从纸面浮现;章节间留纸面空场。
动态图表
数据/对比/流程用风格统一的动态图表表达:数字滚动盖章、柱状墨迹增长、折线一笔描画、进度环、对比卡片;等宽数字 + 朱红强调 + 墨水蓝网格,GSAP/SVG 实现,避免大段静态文字配解说。
配音质量保障
- 多音色:默认云希(Azure YunxiNeural,试界品牌音色),
--voice可换预设(xiaoxiao 晓晓 / yunjian 云健 / yunyang 云扬 / xiaoyi 晓伊 / yunxia 云夏 / xiaobei 小贝东北话 / xiaoni 小妮陕西话),也接受完整 edge-tts 音色 id;本地合成,无需 API Key - 默认语速 +8%,可按内容微调 +5%~+15%
- 防卡顿机制:文本自动规整(清除 markdown、合并句中换行),按句切分合成——停顿只允许出现在句号/问号/感叹号处,句子中间永不硬断
- 句级时间戳(
sentences.json)直接驱动字幕同步,不依赖 whisper
工作流
口播稿 → 读稿理解 → 第一性原理优化 → 活人感改稿七遍 → 净化写作标记 → 硬禁项检查(check_prose.py 清零) → 用户确认优化稿 → 句级切分 → 云希配音 → 句级时间轴
→ 章节/场景规划 → HyperFrames 构图 → lint/validate/inspect --strict
→ 渲染前核验 → 渲染 16:9 主视频 → 横竖封面 → 平台标题 → 交付核验(verify_output.py)→ outputs/ 交付
使用方式
在 Codex 会话中给出口播稿(纯文字或 .txt/.md,可附图片):
用 $tryworld-paper 把这篇口播稿做成视频,加上横竖封面和标题。
可选输入:图片目录(AI 概念图 / 截图 / 图表,会自动"纸面化"处理)。
目录结构
tryworld-paper/
├── SKILL.md # 主说明:品牌契约、工作流、质量门禁
├── agents/
│ └── openai.yaml # UI 元数据
├── references/
│ ├── style-system.md # 视觉契约(色板/字体/动效/封面)
│ ├── workflow.md # 生产流程与命令
│ └── titles.md # 平台标题规则
├── scripts/
│ ├── tts_yunxi.py # 云希配音管线(句级切分 + 拼接 + 时间轴)
│ ├── verify_output.py # 交付核验硬门禁(音轨/时长/双封面/标题/发布计划)
│ └── check_prose.py # 活人感硬禁项检查(源自 human-writing v1.1.0,MIT)
└── assets/
├── paper-grain.svg # 纸纹叠加层
└── seal.svg # 朱红"试界原创"印章
环境要求
- Node.js >= 22
- FFmpeg(含 ffprobe,加入 PATH;
winget install Gyan.FFmpeg) - Python 3.10+,
pip install edge-tts - HyperFrames CLI(
npx hyperframes)
运行 npx hyperframes doctor 可一键检查环境。
防伪标识
视频与封面统一携带:
- 右上角全程常驻朱红试界原创印章(保护区,内容不得覆盖)
- 不添加"试界TryWorld 纸上算法"文字水印,印章是唯一水印
许可
本仓库采用 MIT License。其中 scripts/check_prose.py 源自 KKKKhazix/human-writing v1.1.0(禁令上移到修辞动作级,检测器补盲区降误伤),按 MIT License 使用与改造,版权归原作者所有,完整声明见 LICENSE-MIT。
Skill manifest
TryWorld-Paper Algorithm(试界-纸上算法)
按当前主题的品牌制作 AI 知识类视频(默认主题为试界TryWorld 的纸上算法)。所有产出必须遵守本文件与 references/style-system.md 锁定的设计系统,任何一条都不允许为了省事而让步。
流水线契约(不可配置)
以下机制是这套工作流的价值本身,任何主题都必须遵守,动了不交付:
- 优化稿必须经用户确认才能进入配音/构图/渲染(闸门);口播稿与平台标题必须过
scripts/check_prose.py硬禁项清零 - 字幕全程烧录在画面内并与配音同步;印章/标识右上角全程常驻(根层覆盖实现),是唯一水印,禁止文字水印;印章为保护区
- 画幅:横屏 1920x1080;口播时长最长约 10 分钟(短可到抖音 30 秒),超长稿先提炼压缩
- 交付物:主视频(烧录字幕)、横版封面(1920x1440,4:3)、竖版封面(1080x1440,3:4)、3-5 个平台标题、字幕/时间轴
- 交付核验(硬性,最后一步):交付前必须运行
python -X utf8 scripts/verify_output.py --dir <outputs目录>,逐项核验主视频音轨、时长对齐、双封面尺寸、标题与发布计划——任何一项 FAIL 都不交付,修复后重跑直到全部 PASS。禁止跳过或仅凭肉眼判断。 - 数据必须有来源;场景必须有入场动画与转场(除末场无退场)
品牌主题(从主题文件读取)
平台名、色板、字体、印章、签名语、封面风格、动效签名、默认配音音色,全部定义在主题文件 themes/paper-algorithm.json(默认主题,试界TryWorld 品牌)。出片前先确认要用的主题(默认 paper-algorithm,用户说「用 <主题名> 主题」或要求换品牌时切换),品牌值一律以主题文件为准,不在本文件中写死。
- 想用自己的品牌做频道:复制主题 JSON 并按
references/theme-guide.md修改(可改色板/印章/签名/字体/音色等;流水线契约不可配置) - 默认主题的视觉细则见
references/style-system.md(纸上算法视觉系统的完整定义)
配音默认音色来自主题文件:出片配音命令带 --theme <主题文件>,脚本读取主题 voice.preset 作为音色(默认主题为云希);--voice <预设名> 可覆盖(xiaoxiao 晓晓 / yunjian 云健 / yunyang 云扬 / xiaoyi 晓伊 / yunxia 云夏 / xiaobei 小贝东北话 / xiaoni 小妮陕西话),交互规则见「音色选择」章节。
启动前必读
外部依赖:渲染依赖 hyperframes 技能(
$hyperframes,或npx hyperframesCLI)与 Node.js >= 22;配音依赖 edge-tts(Python 3.10+)。$hyperframes不在本仓库内,需另行安装;未安装时出片流程无法执行。
- 读
themes/paper-algorithm.json(或用户指定的主题文件)——确认本次出片的品牌值。 - 读
references/style-system.md—— 视觉契约。编写任何 HTML/CSS 前必须先读,并作为 hyperframes 流程中的 DESIGN.md 使用。 - 读
references/workflow.md—— 生产流程与命令,按顺序执行。 - 编写构图时遵循 hyperframes skill(
$hyperframes)的全部规则。 - 生成标题前读
references/titles.md。
工作流
- 输入并通读理解:口播稿(文本或 .txt/.md 文件)与可选图片。先通读全文,理解主题、受众、核心结论与章节结构;图片缺失时跳过图片场景,不允许降级风格。
- 优化并净化脚本:按流量第一性原理优化口播稿(共鸣选题带流量、认可攒赞、槽点引评论、嘴替促转发、价值认同涨粉),再按"活人感改稿七遍"清模型腔与注水(看谁在说 → 检查推进/删注水 → 拆表演性中文 → 听中文节奏 → 清硬禁项 → 核现实 → 查结尾,固定签名保留),随后清除写作标记/结构标签(如"一、开场钩子"、"(插入截图)")——标记不得以原文出现在视频中(不朗读、不上字幕、不显示),按意图转化为实际表达。净化后正文与平台标题必须运行
scripts/check_prose.py清零硬禁项。规则见 workflow.md。 - 交付优化稿并等待确认:净化后正文先通过
$env:USERPROFILE\.agents\skills\tryworld-paper\scripts\check_prose.py(硬禁项清零),再把优化后的口播稿完整展示给用户审阅,附简明优化说明(改了什么、为什么)、元素落点清单(钩子/干货/槽点/嘴替/价值收尾)与数据来源清单;未获用户确认前,禁止进入配音/构图/渲染。 - 分段:按净化后口播时长分段,每章 40-90 秒;不足 1 分钟不分章;口播目标不超过约 10 分钟,超长稿先提炼核心精华压缩再分段;标记章节标题、关键词、数据点、图片提示。
- 配音:
python "skills/tryworld-paper/scripts/tts_yunxi.py" <净化后的脚本> --out work/audio --theme "skills/tryworld-paper/themes/paper-algorithm.json"(或用户指定的主题文件)生成配音、分段时间与合并音轨。 - 时间轴:字幕时间轴来自
work/audio/sentences.json(edge-tts 句级时间戳,已带绝对时间);如需词级时间轴可用npx hyperframes transcribe(依赖 whisper,可选)。 - 场景规划:按章节规划场景与节奏(开场-讲解-数据-小结),数据/对比/流程优先规划为动态图表场景,避免大段静态文字;先声明节奏模式再写 HTML。
- 构图:把
assets/复制进项目;按 style-system.md 与 hyperframes 规则编写 16:9 主构图。每个场景必须有入场动画与转场;除末场外禁止退场动画。 - 检查:
npx hyperframes lint、npx hyperframes validate、npx hyperframes inspect --strict全部通过——错误与警告清零,禁止元素重叠、文字溢出/出画布/截断等排版错误;封面构图同样核验。 - 渲染前核验:渲染前必须按 workflow.md 的"渲染前核验清单"逐项对照本文件与 style-system.md 的全部要求,确认无误后才允许渲染;任一项不满足先修改再渲染,避免返工。
- 渲染:
npx hyperframes render --fps 30 --quality high输出主视频(先--quality draft预览确认,再 high 出片)。 - 封面:按 style-system.md 封面系统独立设计 4:3 与 3:4 静态构图(使用主题定义的封面视觉语言,与视频画面保持两套语言;禁止截取主视频画面),渲染后取帧为 PNG。
- 标题:按 titles.md 生成 3-5 个候选,标注平台推荐与命中的增长原则(共鸣/认可/槽点/嘴替/价值认同);候选标题同守硬禁词(禁冒号/破折号/翻案句/黑话/模型路标),生成后自检或跑
$env:USERPROFILE\.agents\skills\tryworld-paper\scripts\check_prose.py清零。 - 交付:主视频(烧录字幕)、横竖封面、标题、字幕文件统一放入
outputs/。
质量门禁(不通过不交付)
lint/validate/inspect全部通过。- 排版:禁止元素重叠、文字溢出/出画布/截断等低级错误;
inspect --strict错误与警告清零才可交付,封面同样核验。 - 防伪间距:右上角印章与文字/内容/动画保持安全距离,禁止重叠或贴近;视频与封面均适用。
- 场景间必须转场,禁止硬切;每个场景元素必须有入场动画(hyperframes 硬性规则)。
- 动效丰富度:禁止连续 3 秒静止;每场 ≥1 ambient、≥3 层视觉、≥2 焦点;动效遵守安全护栏——不入侵字幕/印章区、同屏并发 ≤3、只用风格内变换、无诡异运动与重叠。
- 无文字水印:视频与封面禁止出现"平台名+主题名"或类似文字水印;印章是唯一水印。
- 印章常驻:印章必须以根层覆盖实现并全程可见,渲染后抽查首/中/尾帧确认。
- 对比度:正文 4.5:1,大字(24px+ 或 19px+ 粗体)3:1,只能在本风格色板内调整。
- 确定性:禁止
Math.random()/Date.now();动画 repeat 必须有限值。 - 配音:句子只允许在句号/问号/感叹号处停顿;
tts_yunxi.py会自动规整文本并按句切分,禁止句子中间产生停顿或卡顿。 - 时长:口播最长约 10 分钟;超长稿必须提炼核心精华压缩(保留主线/结论/数据亮点,砍掉重复铺垫与次要细节),时长与质量并重。
- 脚本净化:写作标记/结构标签(如"一、开场钩子")不得以原文出现在视频中——不朗读、不上字幕、不显示为画面文字,必须转化为实际表达。
- 口播优化:脚本须按流量第一性原理优化(共鸣选题/认可点赞/槽点评论/嘴替转发/价值认同涨粉),成片须具备钩子、干货、讨论点、嘴替句与价值收尾;结尾固定使用主题 JSON 的
brand.sign_off;数据须场景化"人话"解读、不冷冰冰堆数据;专业人认可价值、普通人觉得用得上看完;全程高价值,能留住观众。 - 数据真实性:口播稿所有数据点须有来源(原稿出处或标注"待核实"),确认时附数据来源清单;禁止编造数据。
- 用户确认闸门:优化后的口播稿必须先完整展示给用户审阅并获确认,未经确认禁止生成视频。
- 字幕:主视频烧录字幕并与配音同步;字幕与画面动画文字不得重复——画面展示核心内容时该句字幕可隐藏或精简,同一信息同屏只呈现一次;字幕文件同步交付。
- 数据可视化:数据/对比/流程必须用风格统一的动态图表表达(等宽数字 + 主题强调色 + 主题次级色网格,GSAP/SVG 实现),禁止大段静态文字或原图图表。
- 标题增长:每个候选标题必须命中至少一个增长原则(共鸣/认可/槽点/嘴替/价值认同),禁止为凑数生成无钩子标题。
- 渲染前核验:渲染前必须逐项对照本文件与 style-system.md/workflow.md 的全部规则并确认通过,未通过禁止渲染。
- 封面:必须独立构图设计,禁止从主视频截帧或裁切充当封面;封面采用主题定义的封面视觉,与视频画面保持两套语言,避免被平台判定为截图。
- 防 AI 味:禁止紫蓝霓虹、黑底光效、通用科技字体、机械匀速动画、空荡背景、每句整屏大字。
- 活人感:净化后口播稿正文与
titles.txt硬禁项清零——动作级禁令:翻案腔(先立误解再推翻抬价,含 9+ 变形)、三项以上同构排比、抒情借喻(抽象名词配具体动词)、动词名词化;标点:破折号全禁、冒号仅引出直接原话可用;硬停词"说白了/说穿了/先说结论";模型洞察路标;商业与模型黑话(绝对禁词 + 语境判断词两档,清单见scripts/check_prose.py);check_prose.py失败不交付。
音色选择(静默默认,按需试听)
- 默认流程不询问音色,直接用当前主题的默认音色(默认主题为云希);只有用户主动提到换声音(女声/男声/换个音色/有哪些音色等)时才进入选择。
- 进入选择时:用用户当前稿子的开头两句(约 30 字)对候选音色各合成 3-5 秒试听 mp3,列出文件让用户听完再定;禁止只用文字描述(「温暖」「活泼」)代替试听。
- 用户选定后,本次配音带
--voice <预设名>,交付物注明所用音色;用户说「以后都用这个」时记录偏好,后续流程默认该音色,不再询问。 - 推荐组合(供用户参考):资讯盘点
yunyang(播报感)、热血/体育向选题yunjian、知识讲解yunxi/xiaoxiao、方言玩梗xiaobei/xiaoni。
语音回退(按序)
- 默认:
scripts/tts_yunxi.py(edge-tts,默认云希,--voice可换预设音色,需联网)。 - 用户提供云希音频:直接导入并转写,跳过合成步骤。
- 离线兜底:
npx hyperframes tts --voice zm_yunxi(音色偏平,需告知用户差异)。
资源
themes/paper-algorithm.json:默认品牌主题(色板/印章/签名/字体/音色等全部品牌值)references/style-system.md:默认主题(纸上算法)的视觉契约(色板/字体/动效/转场/字幕/图片处理/防伪/封面)references/theme-guide.md:主题指南——如何创建自己的品牌主题references/workflow.md:详细生产流程与命令references/titles.md:平台标题规则scripts/tts_yunxi.py:配音管线(内置多音色预设,默认云希)scripts/verify_output.py:交付核验硬门禁(音轨/时长/双封面/标题/发布计划,全过才交付)scripts/check_prose.py:活人感硬禁项检查脚本(TryWorld 改造版,源自 KKKKhazix/human-writing v1.1.0,MIT;禁令上移到修辞动作级)assets/paper-grain.svg:纸纹叠加层assets/seal.svg:朱红"试界原创"印章
Files (paper-algorithm)
-
agents
-
openai.yaml 335 B
Loading…
-
-
assets
-
paper-grain.svg 380 B · in bundle
-
seal.svg 945 B · in bundle
-
-
references
-
style-system.md 10 KB
Loading… -
theme-guide.md 5.2 KB
Loading… -
titles.md 3.9 KB
Loading… -
workflow.md 22 KB
Loading…
-
-
scripts
-
check_prose.py 24.3 KB
Loading… -
tts_yunxi.py 13.8 KB
Loading… -
verify_output.py 7.7 KB
Loading…
-
-
templates
-
cover-horizontal.html 3.2 KB · in bundle
-
-
themes
-
content-default.json 501 B
Loading… -
content-test-brand.json 510 B
Loading… -
paper-algorithm.json 1.8 KB
Loading… -
test-brand.json 1.4 KB
Loading…
-
-
.gitignore 19 B · in bundle
-
LICENSE-MIT 1.5 KB · in bundle
-
NOTICE.md 1 KB
Loading… -
README.md 5.6 KB
# 试界-纸上算法 TryWorld-Paper Algorithm > 一页会动的算法笔记 —— 把 AI 知识口播稿变成风格统一的横屏视频、横竖封面与平台标题。     ## 这是什么 `tryworld-paper`(试界-纸上算法 TryWorld-Paper Algorithm)是试界TryWorld 的视频生产 Skill:输入一篇中文 AI 口播稿(可附图片),自动产出: - **横屏主视频**(16:9,口播最长约 10 分钟)—— 纸上算法风格,真云希配音,全程烧录字幕;超长稿提炼核心精华压缩 - **横版封面 + 竖版封面**(1920x1440 横 4:3 / 1080x1440 竖 3:4)—— 深墨海报风(与视频浅纸面两套视觉语言),标题 + 信息块,适配 B站/抖音/小红书 - **3-5 个平台标题** —— 按 B站/抖音/小红书分别适配 - 右上角全程常驻的"试界原创"防伪印章 - 每期固定的默认结尾签名(试界TryWorld 标准收尾,口播+画面同步) ## 设计契约:纸上算法 Paper Algorithm 设计源头:**科学手稿 + 中文印刷传统**。每一期视频都是一页"会动的算法笔记",纸面是舞台,墨迹是文字,朱红是重点,印章是签名。 ### 色板(4 色锁定,不新增) | 色 | 值 | 用途 | |---|---|---| | 纸面 | `#F4EFE4` | 背景主色 | | 墨黑 | `#1C1916` | 主文字、线条 | | 朱红 | `#C0452F` | 唯一强调色:关键词、数字、印章 | | 墨水蓝 | `#2E5E8C` | 次级批注、图表线 | ### 字体 - 主标题:思源宋体(Noto Serif SC) - 批注/引用:ZCOOL XiaoWei(默认);霞鹜文楷(LXGW WenKai)如需使用须自带 woff2 - 数据/坐标:等宽字体(JetBrains Mono) ### 动效签名(全片统一) | 签名 | 感觉 | 缓动 | |---|---|---| | 墨落纸 | 主入场 | `power3.out` | | 笔写入 | 批注/小元素 | `sine.inOut` | | 盖章 | 数字/结论/印章 | `back.out(1.4)` | 转场统一为**墨染过渡**:前场景被墨色浸染溶解,新场景从纸面浮现;章节间留纸面空场。 ### 动态图表 数据/对比/流程用风格统一的动态图表表达:数字滚动盖章、柱状墨迹增长、折线一笔描画、进度环、对比卡片;等宽数字 + 朱红强调 + 墨水蓝网格,GSAP/SVG 实现,避免大段静态文字配解说。 ## 配音质量保障 - **多音色**:默认云希(Azure YunxiNeural,试界品牌音色),`--voice` 可换预设(xiaoxiao 晓晓 / yunjian 云健 / yunyang 云扬 / xiaoyi 晓伊 / yunxia 云夏 / xiaobei 小贝东北话 / xiaoni 小妮陕西话),也接受完整 edge-tts 音色 id;本地合成,无需 API Key - **默认语速** +8%,可按内容微调 +5%~+15% - **防卡顿机制**:文本自动规整(清除 markdown、合并句中换行),按句切分合成——停顿只允许出现在句号/问号/感叹号处,句子中间永不硬断 - 句级时间戳(`sentences.json`)直接驱动字幕同步,不依赖 whisper ## 工作流 ```text 口播稿 → 读稿理解 → 第一性原理优化 → 活人感改稿七遍 → 净化写作标记 → 硬禁项检查(check_prose.py 清零) → 用户确认优化稿 → 句级切分 → 云希配音 → 句级时间轴 → 章节/场景规划 → HyperFrames 构图 → lint/validate/inspect --strict → 渲染前核验 → 渲染 16:9 主视频 → 横竖封面 → 平台标题 → 交付核验(verify_output.py)→ outputs/ 交付 ``` ## 使用方式 在 Codex 会话中给出口播稿(纯文字或 .txt/.md,可附图片): ```text 用 $tryworld-paper 把这篇口播稿做成视频,加上横竖封面和标题。 ``` 可选输入:图片目录(AI 概念图 / 截图 / 图表,会自动"纸面化"处理)。 ## 目录结构 ```text tryworld-paper/ ├── SKILL.md # 主说明:品牌契约、工作流、质量门禁 ├── agents/ │ └── openai.yaml # UI 元数据 ├── references/ │ ├── style-system.md # 视觉契约(色板/字体/动效/封面) │ ├── workflow.md # 生产流程与命令 │ └── titles.md # 平台标题规则 ├── scripts/ │ ├── tts_yunxi.py # 云希配音管线(句级切分 + 拼接 + 时间轴) │ ├── verify_output.py # 交付核验硬门禁(音轨/时长/双封面/标题/发布计划) │ └── check_prose.py # 活人感硬禁项检查(源自 human-writing v1.1.0,MIT) └── assets/ ├── paper-grain.svg # 纸纹叠加层 └── seal.svg # 朱红"试界原创"印章 ``` ## 环境要求 - Node.js >= 22 - FFmpeg(含 ffprobe,加入 PATH;`winget install Gyan.FFmpeg`) - Python 3.10+,`pip install edge-tts` - HyperFrames CLI(`npx hyperframes`) 运行 `npx hyperframes doctor` 可一键检查环境。 ## 防伪标识 视频与封面统一携带: - 右上角全程常驻朱红**试界原创**印章(保护区,内容不得覆盖) - 不添加"试界TryWorld 纸上算法"文字水印,印章是唯一水印 ## 许可 本仓库采用 **MIT License**。其中 `scripts/check_prose.py` 源自 [KKKKhazix/human-writing](https://github.com/KKKKhazix/human-writing) v1.1.0(禁令上移到修辞动作级,检测器补盲区降误伤),按 **MIT License** 使用与改造,版权归原作者所有,完整声明见 [LICENSE-MIT](LICENSE-MIT)。 -
SKILL.md 13.7 KB
--- name: tryworld-paper description: Create branded 试界TryWorld AI-knowledge videos in the fixed "Paper Algorithm" (纸上算法) style with HyperFrames. Input is a Chinese voiceover script and optional images; output is a 16:9 horizontal video with Azure YunxiNeural (真·云希) voiceover, word-synced captions, ink/paper animations and unified transitions, an always-visible anti-counterfeit red seal, plus horizontal (4:3) and vertical (3:4) cover images and platform-optimized titles for Bilibili/Douyin/Xiaohongshu. Brand values are theme-driven (themes/paper-algorithm.json by default; custom brand themes supported — see references/theme-guide.md). Use when the user provides an AI 科普/教程/内容解读/知识分享 script and wants a TryWorld/试界 branded video, asks for the 纸上算法/Paper Algorithm style, wants a consistent script-to-video pipeline with covers and titles, or wants this pipeline with their own brand theme. --- # TryWorld-Paper Algorithm(试界-纸上算法) 按当前主题的品牌制作 AI 知识类视频(默认主题为试界TryWorld 的纸上算法)。所有产出必须遵守本文件与 `references/style-system.md` 锁定的设计系统,任何一条都不允许为了省事而让步。 ## 流水线契约(不可配置) 以下机制是这套工作流的价值本身,任何主题都必须遵守,动了不交付: - 优化稿必须经用户确认才能进入配音/构图/渲染(闸门);口播稿与平台标题必须过 `scripts/check_prose.py` 硬禁项清零 - 字幕全程烧录在画面内并与配音同步;印章/标识右上角全程常驻(根层覆盖实现),是唯一水印,禁止文字水印;印章为保护区 - 画幅:横屏 1920x1080;口播时长最长约 10 分钟(短可到抖音 30 秒),超长稿先提炼压缩 - 交付物:主视频(烧录字幕)、横版封面(1920x1440,4:3)、竖版封面(1080x1440,3:4)、3-5 个平台标题、字幕/时间轴 - **交付核验(硬性,最后一步)**:交付前必须运行 `python -X utf8 scripts/verify_output.py --dir <outputs目录>`,逐项核验主视频音轨、时长对齐、双封面尺寸、标题与发布计划——任何一项 FAIL 都不交付,修复后重跑直到全部 PASS。禁止跳过或仅凭肉眼判断。 - 数据必须有来源;场景必须有入场动画与转场(除末场无退场) ## 品牌主题(从主题文件读取) 平台名、色板、字体、印章、签名语、封面风格、动效签名、默认配音音色,全部定义在主题文件 **`themes/paper-algorithm.json`**(默认主题,试界TryWorld 品牌)。出片前先确认要用的主题(默认 `paper-algorithm`,用户说「用 <主题名> 主题」或要求换品牌时切换),品牌值一律以主题文件为准,不在本文件中写死。 - 想用自己的品牌做频道:复制主题 JSON 并按 `references/theme-guide.md` 修改(可改色板/印章/签名/字体/音色等;流水线契约不可配置) - 默认主题的视觉细则见 `references/style-system.md`(纸上算法视觉系统的完整定义) 配音默认音色来自主题文件:出片配音命令带 `--theme <主题文件>`,脚本读取主题 `voice.preset` 作为音色(默认主题为云希);`--voice <预设名>` 可覆盖(xiaoxiao 晓晓 / yunjian 云健 / yunyang 云扬 / xiaoyi 晓伊 / yunxia 云夏 / xiaobei 小贝东北话 / xiaoni 小妮陕西话),交互规则见「音色选择」章节。 ## 启动前必读 > **外部依赖**:渲染依赖 hyperframes 技能(`$hyperframes`,或 `npx hyperframes` CLI)与 Node.js >= 22;配音依赖 edge-tts(Python 3.10+)。`$hyperframes` 不在本仓库内,需另行安装;未安装时出片流程无法执行。 1. 读 `themes/paper-algorithm.json`(或用户指定的主题文件)——确认本次出片的品牌值。 2. 读 `references/style-system.md` —— 视觉契约。编写任何 HTML/CSS 前必须先读,并作为 hyperframes 流程中的 DESIGN.md 使用。 3. 读 `references/workflow.md` —— 生产流程与命令,按顺序执行。 4. 编写构图时遵循 hyperframes skill(`$hyperframes`)的全部规则。 5. 生成标题前读 `references/titles.md`。 ## 工作流 1. **输入并通读理解**:口播稿(文本或 .txt/.md 文件)与可选图片。先通读全文,理解主题、受众、核心结论与章节结构;图片缺失时跳过图片场景,不允许降级风格。 2. **优化并净化脚本**:按流量第一性原理优化口播稿(共鸣选题带流量、认可攒赞、槽点引评论、嘴替促转发、价值认同涨粉),再按"活人感改稿七遍"清模型腔与注水(看谁在说 → 检查推进/删注水 → 拆表演性中文 → 听中文节奏 → 清硬禁项 → 核现实 → 查结尾,固定签名保留),随后清除写作标记/结构标签(如"一、开场钩子"、"(插入截图)")——标记不得以原文出现在视频中(不朗读、不上字幕、不显示),按意图转化为实际表达。净化后正文与平台标题必须运行 `scripts/check_prose.py` 清零硬禁项。规则见 workflow.md。 3. **交付优化稿并等待确认**:净化后正文先通过 `$env:USERPROFILE\.agents\skills\tryworld-paper\scripts\check_prose.py`(硬禁项清零),再把优化后的口播稿完整展示给用户审阅,附简明优化说明(改了什么、为什么)、元素落点清单(钩子/干货/槽点/嘴替/价值收尾)与数据来源清单;**未获用户确认前,禁止进入配音/构图/渲染**。 4. **分段**:按净化后口播时长分段,每章 40-90 秒;不足 1 分钟不分章;口播目标不超过约 10 分钟,超长稿先提炼核心精华压缩再分段;标记章节标题、关键词、数据点、图片提示。 5. **配音**:`python "skills/tryworld-paper/scripts/tts_yunxi.py" <净化后的脚本> --out work/audio --theme "skills/tryworld-paper/themes/paper-algorithm.json"`(或用户指定的主题文件)生成配音、分段时间与合并音轨。 6. **时间轴**:字幕时间轴来自 `work/audio/sentences.json`(edge-tts 句级时间戳,已带绝对时间);如需词级时间轴可用 `npx hyperframes transcribe`(依赖 whisper,可选)。 7. **场景规划**:按章节规划场景与节奏(开场-讲解-数据-小结),数据/对比/流程优先规划为动态图表场景,避免大段静态文字;先声明节奏模式再写 HTML。 8. **构图**:把 `assets/` 复制进项目;按 style-system.md 与 hyperframes 规则编写 16:9 主构图。每个场景必须有入场动画与转场;除末场外禁止退场动画。 9. **检查**:`npx hyperframes lint`、`npx hyperframes validate`、`npx hyperframes inspect --strict` 全部通过——错误与警告清零,禁止元素重叠、文字溢出/出画布/截断等排版错误;封面构图同样核验。 10. **渲染前核验**:渲染前必须按 workflow.md 的"渲染前核验清单"逐项对照本文件与 style-system.md 的全部要求,确认无误后才允许渲染;任一项不满足先修改再渲染,避免返工。 11. **渲染**:`npx hyperframes render --fps 30 --quality high` 输出主视频(先 `--quality draft` 预览确认,再 high 出片)。 12. **封面**:按 style-system.md 封面系统独立设计 4:3 与 3:4 静态构图(使用主题定义的封面视觉语言,与视频画面保持两套语言;禁止截取主视频画面),渲染后取帧为 PNG。 13. **标题**:按 titles.md 生成 3-5 个候选,标注平台推荐与命中的增长原则(共鸣/认可/槽点/嘴替/价值认同);候选标题同守硬禁词(禁冒号/破折号/翻案句/黑话/模型路标),生成后自检或跑 `$env:USERPROFILE\.agents\skills\tryworld-paper\scripts\check_prose.py` 清零。 14. **交付**:主视频(烧录字幕)、横竖封面、标题、字幕文件统一放入 `outputs/`。 ## 质量门禁(不通过不交付) - `lint` / `validate` / `inspect` 全部通过。 - 排版:禁止元素重叠、文字溢出/出画布/截断等低级错误;`inspect --strict` 错误与警告清零才可交付,封面同样核验。 - 防伪间距:右上角印章与文字/内容/动画保持安全距离,禁止重叠或贴近;视频与封面均适用。 - 场景间必须转场,禁止硬切;每个场景元素必须有入场动画(hyperframes 硬性规则)。 - 动效丰富度:禁止连续 3 秒静止;每场 ≥1 ambient、≥3 层视觉、≥2 焦点;动效遵守安全护栏——不入侵字幕/印章区、同屏并发 ≤3、只用风格内变换、无诡异运动与重叠。 - 无文字水印:视频与封面禁止出现"平台名+主题名"或类似文字水印;印章是唯一水印。 - 印章常驻:印章必须以根层覆盖实现并全程可见,渲染后抽查首/中/尾帧确认。 - 对比度:正文 4.5:1,大字(24px+ 或 19px+ 粗体)3:1,只能在本风格色板内调整。 - 确定性:禁止 `Math.random()` / `Date.now()`;动画 repeat 必须有限值。 - 配音:句子只允许在句号/问号/感叹号处停顿;`tts_yunxi.py` 会自动规整文本并按句切分,禁止句子中间产生停顿或卡顿。 - 时长:口播最长约 10 分钟;超长稿必须提炼核心精华压缩(保留主线/结论/数据亮点,砍掉重复铺垫与次要细节),时长与质量并重。 - 脚本净化:写作标记/结构标签(如"一、开场钩子")不得以原文出现在视频中——不朗读、不上字幕、不显示为画面文字,必须转化为实际表达。 - 口播优化:脚本须按流量第一性原理优化(共鸣选题/认可点赞/槽点评论/嘴替转发/价值认同涨粉),成片须具备钩子、干货、讨论点、嘴替句与价值收尾;结尾固定使用主题 JSON 的 `brand.sign_off`;数据须场景化"人话"解读、不冷冰冰堆数据;专业人认可价值、普通人觉得用得上看完;全程高价值,能留住观众。 - 数据真实性:口播稿所有数据点须有来源(原稿出处或标注"待核实"),确认时附数据来源清单;禁止编造数据。 - 用户确认闸门:优化后的口播稿必须先完整展示给用户审阅并获确认,未经确认禁止生成视频。 - 字幕:主视频烧录字幕并与配音同步;字幕与画面动画文字不得重复——画面展示核心内容时该句字幕可隐藏或精简,同一信息同屏只呈现一次;字幕文件同步交付。 - 数据可视化:数据/对比/流程必须用风格统一的动态图表表达(等宽数字 + 主题强调色 + 主题次级色网格,GSAP/SVG 实现),禁止大段静态文字或原图图表。 - 标题增长:每个候选标题必须命中至少一个增长原则(共鸣/认可/槽点/嘴替/价值认同),禁止为凑数生成无钩子标题。 - 渲染前核验:渲染前必须逐项对照本文件与 style-system.md/workflow.md 的全部规则并确认通过,未通过禁止渲染。 - 封面:必须独立构图设计,禁止从主视频截帧或裁切充当封面;封面采用主题定义的封面视觉,与视频画面保持两套语言,避免被平台判定为截图。 - 防 AI 味:禁止紫蓝霓虹、黑底光效、通用科技字体、机械匀速动画、空荡背景、每句整屏大字。 - 活人感:净化后口播稿正文与 `titles.txt` 硬禁项清零——动作级禁令:翻案腔(先立误解再推翻抬价,含 9+ 变形)、三项以上同构排比、抒情借喻(抽象名词配具体动词)、动词名词化;标点:破折号全禁、冒号仅引出直接原话可用;硬停词"说白了/说穿了/先说结论";模型洞察路标;商业与模型黑话(绝对禁词 + 语境判断词两档,清单见 `scripts/check_prose.py`);`check_prose.py` 失败不交付。 ## 音色选择(静默默认,按需试听) - 默认流程**不询问音色**,直接用当前主题的默认音色(默认主题为云希);只有用户主动提到换声音(女声/男声/换个音色/有哪些音色等)时才进入选择。 - 进入选择时:用用户当前稿子的开头两句(约 30 字)对候选音色各合成 3-5 秒试听 mp3,列出文件让用户听完再定;禁止只用文字描述(「温暖」「活泼」)代替试听。 - 用户选定后,本次配音带 `--voice <预设名>`,交付物注明所用音色;用户说「以后都用这个」时记录偏好,后续流程默认该音色,不再询问。 - 推荐组合(供用户参考):资讯盘点 `yunyang`(播报感)、热血/体育向选题 `yunjian`、知识讲解 `yunxi`/`xiaoxiao`、方言玩梗 `xiaobei`/`xiaoni`。 ## 语音回退(按序) 1. 默认:`scripts/tts_yunxi.py`(edge-tts,默认云希,`--voice` 可换预设音色,需联网)。 2. 用户提供云希音频:直接导入并转写,跳过合成步骤。 3. 离线兜底:`npx hyperframes tts --voice zm_yunxi`(音色偏平,需告知用户差异)。 ## 资源 - `themes/paper-algorithm.json`:默认品牌主题(色板/印章/签名/字体/音色等全部品牌值) - `references/style-system.md`:默认主题(纸上算法)的视觉契约(色板/字体/动效/转场/字幕/图片处理/防伪/封面) - `references/theme-guide.md`:主题指南——如何创建自己的品牌主题 - `references/workflow.md`:详细生产流程与命令 - `references/titles.md`:平台标题规则 - `scripts/tts_yunxi.py`:配音管线(内置多音色预设,默认云希) - `scripts/verify_output.py`:交付核验硬门禁(音轨/时长/双封面/标题/发布计划,全过才交付) - `scripts/check_prose.py`:活人感硬禁项检查脚本(TryWorld 改造版,源自 KKKKhazix/human-writing v1.1.0,MIT;禁令上移到修辞动作级) - `assets/paper-grain.svg`:纸纹叠加层 - `assets/seal.svg`:朱红"试界原创"印章
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.