Claude Skill

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

LLM Mart · 0 points · 9 views 77 listing impressions 0 install-command copies
Download TryWorld2026-paper-algorithm-skills_tryworld-paper-a28ff0b.zip · 57 KB

Install

skills CLI npx skills add https://github.com/TryWorld2026/paper-algorithm/tree/main/skills/tryworld-paper
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install tryworld2026-paper-algorithm@llmmart
Git 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 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:朱红"试界原创"印章
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 知识口播稿变成风格统一的横屏视频、横竖封面与平台标题。
    
    ![风格](https://img.shields.io/badge/风格-纸上算法-C0452F)
    ![配音](https://img.shields.io/badge/配音-多音色·默认云希-2E5E8C)
    ![画幅](https://img.shields.io/badge/画幅-1920x1080-1C1916)
    ![状态](https://img.shields.io/badge/状态-已启用-8FAF8C)
    
    ## 这是什么
    
    `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.

No comments yet.

Reviews (0)

No reviews yet.