脚本化视频 是做什么的?
在这里,视频是一个脚本:一个描述说话内容、画面内容及其时间线的文件。一个小型引擎(位于 starter/ 中)将其转化为浏览器中的图片,并生成包含声音、字幕和章节的 .mp4 文件。由于视频就是文本,你可以编写、检查、逐行审阅、逐帧查看、翻译,甚至修改一个词而无需重新编辑任何时间线。
引擎只是简单的一部分。一个用于教学的视频需要讲述一个真实的故事,按照观众能理解的顺序,使用他们熟悉的词汇,并配上与语音同步指向的画面。本技能的大部分内容专注于这一部分。请按顺序执行各个阶段;每个阶段都会生成一个文件供下一个阶段读取,这样工作能在长时间会话中持续,并允许另一个代理接手。
目标是交付一个请求者无需纠正的视频。 他们的时间就是你正在节省的成本。因此:自行决定可以决定的事项并记录下来;使用他们提供的所有服务、密钥和事实;在交付前,像请求者那样审视视频(参见“交付前”章节)。请求者最先注意到的问题几乎从来不是检查工具能发现的规则违反,而是:视频从未回答的猜测、空洞无实物的主题,以及听起来未完成的视频。
所有关于真实世界的视频都遵循三个原则。每个原则在此陈述一次;下面的各个阶段会应用它们,references/research.md 提供了具体方法。
- 核心深度讲述;研究深入一层。 你交付的视频是核心:能够保持承诺、真实且公平的最短讲述:对于有真实故事的主题,大约 10 到 20 分钟;对于单一机制则更短。请求者指定的长度是上限并优先;研究深度随之缩小。研究则深入一层,达到细节的深度(人物、关键日期、确切手段、竞争对手、调查发现),以便核心内容是基于知识选择的,并且能发现相邻主题:一个与主要话题相关、本身具有故事性的事件、机构或想法。每个相邻主题都作为一行写入
research/next-videos.md,并附上已知信息,但不再进一步研究。细节之下(每个人的晚年生活、每份文件的全文、某个机构的全部历史)是另一个视频的研究范畴:在一次工作中,这样做导致视频变成了六小时,而请求者想要的只是 18 分钟的核心内容。更长的版本仅在请求时制作。 - 每个真实示例都展示主要话题的实际运作。 一个真实故事只有在其所述的主要事物确实在其中发生,且与来源描述一致时,才应被纳入视频:例如,一个关于期货市场的视频,其中必须包含在交易所实际交易的期货合约、追加保证金、合约交割等场景。一个仅仅相关(同时期、有名人物、看起来相似但以其他方式进行的赌注)的故事,无论多么有名,甚至由请求者建议,都应被排除。在第一轮研究来源时就应检查这一点,避免在其上投入任何深度。在一次工作中,为期货视频提供的最著名故事最终被证明是通过与银行的私人交易进行的赌注;在已经讲述了两版之后,它被移除了。但简短不等于单薄:在核心内容中,每个真实示例都应讲述其人物、日期、确切手段、金额、原本可能如何发展、如何结束,以及它揭示了关于主要话题的什么内容。
- 研究有边界和终点。 每条线索在投入搜索前,都应先针对主要话题进行测试;失败的线索只需用一行文字记录下来并放弃(“有趣”本身不足以深入探究)。规划三个研究轮次(大纲、细节、以及一次针对视频将使用的所有内容的来源核实),外加一个简短的第四轮,仅用于核心内容需要但尚未命名的事项。更多轮次由请求者决定。
默认观众: 第一次接触该主题的人。请以 8 岁儿童能理解的方式写作,使用成年人不会觉得幼稚的平静、专业的措辞。简单不等于幼稚:使用短句、日常词汇、一次只表达一个想法,避免使用儿语。仅在需求说明中指定了不同观众时才更改此设定。
设置
将此技能的 starter/ 文件夹复制到用户的项目中(例如,命名为 video/),然后:
cd video
npm install # 一个小依赖;它会使用机器上已有的 Chrome
node tools/check.mjs # 示例视频应该通过检查
需要:Node 18 或更新版本;Chrome、Edge 或 Chromium(用于绘制图片);ffmpeg(用于录制语音和导出)。如果缺少任何一项,请参阅 references/troubleshooting.md。不要直接在技能文件夹内工作;请在工作副本中操作。
该副本包含一个示例 videos/hello.json:15 秒的纯数据,带有翻译和纵向布局,用于检查设置是否正常工作。每个阶段应产出的内容由 node tools/new.mjs 创建的文件定义:每个文件都以其自身的检查清单开始。当用户自己的视频开始制作时,请删除该示例。
各个阶段
从 node tools/new.mjs <id> "<Title>" 开始每个视频。它会创建 notes/<id>/(以下列出的文件及其检查清单)和一个脚本骨架 videos/<id>.mjs。
| # | 阶段 | 产出物 | 完成条件 | 参考文档 |
|---|---|---|---|---|
| 0 | 简报 | notes/<id>/brief.md | 确定观众、承诺(“观看后,观众能够……”)、时长、形式和语言,并记录所有请求者明确要求的内容。 | 下文 |
| 1 | 研究方法 | research/00-how-to-research.md | 了解该领域的专业人士如何查找信息,以及新手常犯的错误。 | references/research.md |
| 2 | 研究,三轮 | research/NN-name.md, research/leads.md, research/next-videos.md, research/index.md | 每条线索(位于 leads.md)的状态都已关闭(已研究、未找到、转移至下一个视频、离题或开放);每个真实示例都通过了示例测试并已知其细节;已研究其他观点和迷思;第三轮已针对来源重新阅读了视频中将使用的每项声明,每条声明都有来源和置信度标签;请求者记起的事实已得到验证。完整列表:references/research.md,第 11 节。 | references/research.md |
| 3 | 思维导图 | mindmap.json | 每个研究过的想法都被标记为 core(在视频中)、support(已研究且真实,但不包含在核心内容中)或 cut(未确认、不公平或离题);仅 core 部分的想法足以履行承诺;node tools/mindmap.mjs <id> 报告无错误。 | references/planning.md |
| 4 | 故事板 | storyboard.md, assets.md | 每个节拍都有画面、要点、组件和声音(通常为无);底部的检查项已勾选。 | references/planning.md |
| 5 | 脚本 | videos/<id>.mjs | node tools/check.mjs <id> 报告无错误,且您已阅读每个警告。脚本为核心长度。 | references/authoring-kit.md, references/components.md |
| 6 | 准确性审查 | review/accuracy.md, research/index.md(仅当需要完整报告时创建 review/coverage.md) | dump --claims 的每一行都有判定和来源;对于每个真实故事,一位未编写它的检查者(或在没有第二个代理时,由您自己进行,并在文件中注明“非独立”)已将脚本、笔记和来源进行比对;研究已对照脚本重新阅读,核心内容需要但缺失的内容现已包含;修正已写回笔记。 | references/script-review.md |
| 7 | 理解度审查 | review/WhatIHaveLearned.md, review/lost-points.md | 日记以无间隙的方式达成承诺,每个可能导致观众迷失的地方都有修复方法或理由。 | references/script-review.md |
| 8 | 视觉审查 | review/visual.md | 已检查每一帧画面,确保没有内容被裁剪、遮挡、空白或难以阅读。 | references/visual-review.md |
| 9 | 语音与声音 | 已录制台词位于 out/tts/,声音文件位于 assets/<id>/ | 脚本已通过第 6 至 8 阶段,语音已录制;时间线现在跟随真实语音。已设置事件音效;任何音乐仅位于故事部分之下。 | references/voice-and-assets.md |
| 10 | 导出与最终观看 | out/<id>.mp4, .srt, .vtt, .chapters.txt | 您已查看导出文件的帧画面并检查了其声音。 | references/export-and-publish.md |
| 11 | 其他语言与画面比例(如要求) | videos/i18n/<id>.<lang>.json | 每种语言均通过 check 检查,且其画面已通过查看。 | references/localization.md |
| 12 | 发布工具包 | publish.md | 标题、描述、章节、字幕、缩略图、来源和致谢已准备就绪。 | references/export-and-publish.md |
| 13 | 交付 | 给请求者的消息 | 已通过请求者视角的检查;消息说明了哪些决定已做出、哪些已修正以及哪些仍待处理。 | references/finishing-and-revising.md |
从第 4 阶段开始适用的写作规则位于 references/writing-for-everyone.md(词汇和句子)和 references/teaching-techniques.md(如何让想法落地)。references/visual-design.md 涵盖布局、色彩和动效。在写出第一个脚本之前,请阅读这三份文档。
第 0 阶段:简报
根据用户所说内容填写 brief.md。对于其他所有内容,写下您的最佳假设并用“(assumed)”标记;不要停下来询问(参见“决定、记录、继续”)。最重要的一行是承诺:以“观看后,观众能够……”开头的一句话。后续的每个决定(研究什么、删除什么、视频何时完成)都将根据它来检验。同时记录观众已有的知识,因为视频将从这里开始。
在简报中用请求者自己的话,复制他们明确要求的所有内容:要使用的服务、密钥及其位置、要包含的示例或事件、他们记得的事实、他们认为令人困惑的部分、限制条件(例如“大部分内容不要配乐”)。每一条都是一个需要在交付前勾选的待办事项。对于指定的服务,应立即检查其可访问性,而不是等到第 9 阶段;对于他们记得的事实,应作为需要验证的内容进入研究,而不是作为需要重复的内容。
在此决定是否需要进行研究。仅当内容完全给定(例如用户自己的产品、他们编写的脚本、他们描述的过程)并且您没有添加任何自己的事实时,才跳过第 1 和第 2 阶段。如果您将要添加哪怕一个数字、日期、名称或“因为”,都请进行研究。
第 1 和第 2 阶段:研究
在研究主题之前,先研究如何研究它:进行两三次搜索,了解人们如何学习并调查这个领域,并向上追溯一层(例如,对于债券市场:先搜索“如何理解债券市场”,再搜索“如何学习经济学”)。这些搜索会告诉您哪些来源可信、哪些数字重要以及新手常犯的错误。然后进行三轮研究:
- 大纲。 每个主题一个笔记,顶部有摘要:带来源的事实、真实事件(先通过示例测试)、日常类比,以及最强的反对观点和迷思,需像主线一样仔细研究。
- 细节。 在
research/leads.md中,列出笔记中提及但未解释的每个人物、地点、日期、数字、术语、机制、原因和引用。研究与主要话题相关的那些线索,研究一次,达到细节深度。相邻主题移至next-videos.md;其余标记为离题。 - 双重核实。 不再引入新主题。在原始来源处重新阅读视频将说的所有内容;为令人惊讶的声明、体现故事规模的数据、引用以及对指名人物不利的内容,寻找第二个独立来源。
在开始前规划好搜索,并为第三轮保留约三分之一的资源。如果您可以启动其他代理,请将每个真实事件分配给一个独立的代理,并将双重核实分配给一个未编写原始笔记的代理。
完成的视频必须能够利用以下两项:
- 真实事件,已知至细节深度。 虚构的人物使想法易于理解;真实的事件让观众信服并记住。对于有历史背景的主题(市场、技术、机构),至少研究两个真实事件。如果一个事件展示了某人获胜,请研究它原本可能如何失败,并找到一个有人失败的事件:仅展示胜利会传递错误的教训。对于自然机制或方法(天空为什么是蓝的,如何打结),一个真实的观察、测量或发现就足够了,也可以没有:在简报中写下“无,因为……”。
- 请求者记起的事实,已核实。 它是一条线索,且常常部分是错的。验证每个部分,使用可靠的,并告知他们您修正了什么以及原因;切勿因为“请求者说过”而重复某项声明,也切勿无声无息地将其删除。
详情:references/research.md。
第 3 阶段:思维导图
mindmap.json 是一个简短的想法树,包含视频可能包含的所有想法(节点类型在 references/planning.md 第 1 节中列出;当类型错误时,node tools/mindmap.mjs 会提示)。每个节点用几个词说明想法是什么、其细节在研究中的位置("file.md#Heading")、观众需要先了解哪些想法,以及它与哪些其他想法相关联。每个想法被标记为 core(在视频中:承诺需要它、讲述真实故事离不开它、或为公平起见需要它)、support(已研究且真实,但保留在核心内容之外:用于描述文本、请求者要求的长版本、或下一个视频的素材)或 cut(未确认、无法公平讲述、或与主要话题无关;未能通过示例测试的真实故事应标记为 cut)。该工具会检查每个指针是否指向有效位置,确保教学顺序合理。详情:references/planning.md。
第 4 阶段:故事板
一个表格,每个节拍一行:观众看到什么、语音的要点、使用哪个组件绘制、是否有新词汇出现、以及除了语音之外还能听到什么(例如音乐)。