Tryworld Paper

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：朱红"试界原创"印章