tesseract-video

使用 Tesseract 编辑视频

若要将文件转换为 Premiere Pro 或 After Effects 等其他编辑工具可用的格式，或从这些工具的格式转换文件，请阅读 转换。打开共享或较旧的 .tsrct 文件、更新工具，或调查加载和渲染差异时，请阅读 版本与兼容性。

对于某些命令，CLI 可能会发送基本使用情况遥测数据。你可以通过 TESSERACT_SKILL=tesseract-video 和其他归因变量选择性地提供归因信息。遵守 CLI 的遥测退出设置；绝不要代替用户启用遥测。

基于用户提供的素材，有意识地进行剪辑。Tesseract 是本地剪辑和渲染引擎；Agent 负责提供编辑判断。输出既是可播放的视频，也是可编辑的项目。

从素材着手

1. 从此 SKILL.md 所在目录解析此技能的根目录。阅读 CLI 安装，并在每次会话中检查一次所需的 Tesseract 版本。在整个任务中使用解析出的可执行文件路径。脚本和参考文件相对于已安装的技能，而不是臆测的主目录或开发检出目录。
2. 阅读本地操作。检查提供的媒体，在有意义的时间点采样帧，并使用主机上可用的媒体工具试听音频。元数据无法告诉你镜头呈现了什么。如果无法试听音频，请说明这一限制，不要声称已完整审看素材。
3. 根据请求确定交付内容、受众、宽高比、时长、必须保留的片段，以及提供的品牌素材。只针对会实质影响剪辑的缺失信息提问。对于小幅修正，保留现有剪辑的风格和范围。
4. 规划新剪辑前，阅读编辑决策。针对每个节拍，判断使用素材、素材与图形，还是全图形，并说明原因。这不是配额：不要为了展示引擎而添加动态图形。

制作新广告或修改其开场时，请阅读 广告钩子。根据实际素材、主张和证据，在开头几秒打造视觉钩子。如果提供了音乐，请考虑不同的创意概念，选出最有力的方案，并将其揭示方式、动态效果和有目的的音效与已确认的开场音乐提示点对应起来。润色其余部分前，先渲染并检查钩子及其与广告后续部分的衔接。对于无关修改，保留原有范围。

当音乐决定节奏或需要裁剪讲话画面时，请阅读波形剪辑。规划画面时序前，生成并打开音乐波形；通过试听确认节拍、乐句和主要变化，并将视觉内容的出现时机与其对应。对于讲话素材，使用整体和放大后的源波形来选择停顿的裁剪位置，保护轻声词语的边界，并保留自然呼吸。波形标记只是候选位置，绝不是自动剪辑决策。

对于篇幅较长的新视频，请提供简洁的剪辑计划，说明源素材片段、叙事目的、图形处理和音频意图。已获授权的常规剪辑可以直接进行。每次本地预览或修改都无需重新征求批准。

编写剪辑

• 新建剪辑：tsrct project create 会创建可移植的 .tsrct 文档；放置图层前，请先导入本地素材。对于现有 .tsrct：检查文档，并检出一份可编辑的 JSON 副本。保留原件和稳定 ID。通过 project commit 保存 JSON，或在渲染前使用 project apply 应用受支持的操作批次。
• 修改项目结构前，请阅读 原生创作。源时间、剪辑时间和图层时间是不同的时钟。尤其要注意，移动片段时不得悄然改变其播放的源素材时刻。
• 将素材剪辑、完整场景和可编辑叠加层保留为文档单一合成中的原生图层。使用组来组织场景。activeRange 用于将片段放置在父级中；sourceRange 用于选择源素材时刻。不要创建基础视频、字幕或音频轨道。
• 对于访谈镜头剪辑，请遵循视线连续性：通过恰当的取景（包括推近镜头），让剪辑切换前后的说话者眼睛高度和画面位置保持一致。检查渲染后的出入点画面和播放效果，同时保留自然的头部运动和有意为之的镜头变化。
• 进行动态设计时，请先阅读动态设计，然后只阅读相关的创作参考。示例展示的是真实架构；其视觉风格并非必需模板。
• 每次新剪辑或音效处理都请阅读声音设计。根据作品需要考虑对白、音乐、微音效、结构提示音以及拟音／环境声。无需逐条音效征求批准，可使用提供的／本地素材或程序化辅助工具添加合适的声音。使用 project import-asset --kind audio 导入选定文件，然后将其保留为可编辑的 Audio 图层。关于放置、闪避、本地准备和测量，请参阅音频与时间。保留有用的源音频和选定的音乐。不要生成虚构对白或字幕。
• 当素材需要色彩校正、风格化处理、Log 转换或镜头匹配，或用户询问色彩时，请阅读调色。遵循其中的场景感知工作流，对于烘焙式剪辑，必要时包括镜头局部控制。即使用户未另行提出，也应确保镜头间一致性，但应保留有意营造的光照差异。遵循其中的相对于源素材的中性色和肤色检查：在匹配的时间戳处，对原始源素材和最终输出使用 Lab 中值区域，而非较早的调色预览。保持校正为原生且可编辑；在风格化效果下保护肤色，并使用夸张预览检查二级选区（CLI 没有蒙版预览开关）。仅使用一个空间 noiseReduction 实例，并检查边缘保留情况；参阅降噪。在默认文档中，HDR 输出并不意味着调色处于 HDR 域。若要处理电影感高光、类似光照的合成、无需厂商 LUT 的相机 Log，或为 SDR 和 HDR 共用一种调色，请参阅该文档的 ACES 部分。承诺提供跟踪或自动匹配前，请阅读其中的限制说明。
• 当需要清理对话音频时，请阅读语音清理。判断问题是房间噪声还是混响／回声，酌情使用适度的 EQ、动态处理或局部降噪，并在响度匹配的条件下进行比较。保留人声细节和时序；此插件不附带去混响模型。
• 保持排版、图形、素材和音频均为原生且可编辑。使用 project import-asset --kind image 将提供的图片作为资源导入，不要用它们扁平化替换文本、矢量图形或整个场景。使用现有素材；此插件不提供生成式视频或虚拟形象服务。
• 尊重用户提供的品牌参考。Mirage 品牌标识的是此插件，而不是使用它创建的每一部视频。

仅在需要时查询功能

通过本地操作使用已安装 CLI 的架构。

查看功能，了解功能映射和限制；查看 FX 创作，了解原生图层和素材；查看 动态效果，了解支持的关键帧和脚本操作。搜索 所需的具体定义，而不要导出整个架构。操作架构包含支持的独立操作及其字段限制；使用 本地操作来选择操作，或选择 JSON 检出/提交。已安装的架构和实际渲染结果具有权威性。

审核与交付

使用胶片条审核检查并修正视觉 变化。对于对白剪辑和音乐定时，请遵循波形编辑。 最后按照审核与交付完成；报告实际 检查内容和任何限制。遵循最终导出画面检查：检查剪辑点/淡入淡出之外的多个导出时间戳，与源文件进行比较，并在无法解释的黑屏画面出现时阻止交付。使用绝对本地文件链接，并在支持时以内嵌方式显示视频。云同步和发布尚未实现。

如果宿主无法执行本地命令或访问本地 GPU/文件系统，请说明此软件包需要本地执行环境。不要改用托管服务，也不要悄悄切换渲染引擎。