教程与产品演示剪辑技能·专业版

概述

教程与产品演示深剪·专业版

把“我讲了功能，也录了屏”变成观众真正看得懂、跟得上、能验证结果的教程成片。

本 Skill 的核心不是多加转场，而是建立三列映射：口播说到什么 → 源录屏中的真实时刻 → 成片应该在什么时候展示。观众需要看到关键入口、实际操作和结果证明，而不是在说步骤时仍看着人物，或在口播结束后才出现录屏。

先看能力范围

案例使用虚构产品和合成界面展示方法，不冒充真实客户成果。用户的成片必须使用其已授权素材重新建立证据映射，不复制案例或参考视频的品牌资产。

适用与不适用

适用：

• AI工具、软件、网页、App、小程序的操作教程。
• 产品功能演示、工作流讲解、提示词与结果对比。
• 以口播为主线，同时包含真实录屏、截图或产品素材的视频。

不适用：

• 主要靠事件与现场声叙事的 Vlog。
• 多人长访谈、播客或课程全集。
• 没有真实产品证据、只想生成广告想象画面的品牌短片。
• 要求伪造登录、交易、模型输出、客户数据或产品能力。

识别到类型不符时，在付款前说明并推荐更合适的专项 Skill，不先收费。

默认任务范围

• 最终成片不超过 10 分钟。
• 最多 25 个源文件；口播、录屏、截图、Logo、现有 B-roll 和音频均计入。
• 最多 5 个真实教程区段、3 个提示词稳定帧或 MG 解释段。
• 一个主要画幅，可另交一个同内容轻量裁切版本；重新组织叙事属于新任务。
• 一次同范围调整。更换主口播、核心产品、完整视觉系统或大规模新增素材需重新确认任务。

超出范围时只提供两个选择：缩小本次任务，或改用更深的课程/商业宣传 Skill。不要付款后再临时加价。

首次使用与连接器

先检测当前宿主是否真的暴露 ChatCut 项目、素材、转写、时间线、预览和导出工具。连接正常时不重复安装。

• WorkBuddy：只引导用户打开当前官方入口 <https://chatcut.io/workbuddy>，不要复制可能过期的 OAuth 配置，也不要索要 Token、Cookie 或密码。
• Codex/Claude Code：按 ChatCut 当前官方 Agent Plugin 文档安装并授权；安装完成后新建任务，因为当前会话不会自动出现新工具。
• 连接器不存在、未授权或无法创建/访问项目时，停止付费流程。可以继续做本地元数据盘点，但不能假装已经建立可编辑时间线。

具体故障分流读取 [connector-readiness.md](references/connector-readiness.md)。

模型与成本说明

宿主模型建议仅是当前使用策略，不是性能保证：

• GLM5.3Flash：默认候选，适合素材盘点、普通转写整理、映射和小范围调整。
• GLM5.3：复杂长教程、跨轨重组和高要求验收候选，宿主积分可能更高。
• KIMI K3：超长文稿、多附件和长上下文盘点候选，宿主积分可能更高。

模型不可用时选择当前宿主中能调用工具、理解视频/图片并稳定执行复杂指令的模型，不要求用户单独配置 API。

付款前必须区分三类成本：本 Skill 的单次任务费、宿主模型积分、ChatCut 账号中的生成/Agent 成本。上传、整理、转写、标准字幕编辑和导出是否消耗 ChatCut 积分，以 ChatCut 当前官方说明和界面预估为准；调用 AI 视频、图片、音乐、旁白或 MG 前另行展示实际预估并取得确认。读取 [cost-and-models.md](references/cost-and-models.md)。

免费证据预演

免费阶段不创建订单，也不调用 ChatCut 付费生成服务。

1. 读取已授权素材的元数据、口播片段和必要的录屏帧；未授权外传时保持本地。
2. 选择一个 8–20 秒、同时具备“说到具体动作”和“录屏中存在对应证据”的关键步骤。
3. 生成 tutorial-preview.json：包含一句口播、源录屏入口/操作/结果时间、预计成片时间、人物窗策略、字幕样式和缺失素材提醒。
4. 运行 python scripts/build_evidence_preview.py tutorial-preview.json --output tutorial-preview.html，实际打开给用户看。
5. 用户可免费提出一次同预演的小调整；不继续也可以保留预演和映射说明。

预演只覆盖一个关键步骤，不输出全片转写、完整剪辑点、全部字幕、完整提示词、全片时间线或可发布视频。边界读取 [free-preview.md](references/free-preview.md)。

X402 付款与授权

付费前置检查

只有以下条件同时满足才进入付款：

• ChatCut 连接器和目标项目已验证可用。
• 素材权利、外部上传范围和隐私等级已确认。
• 真实预演已展示，用户明确认可方向并选择继续。
• 本次范围、三类成本与导出边界已经说明。

先查询实时价格：

python scripts/pay_gate.py quote --output live-quote.json

唯一支付服务入口：

POST https://api.superzixuan.com/v1/pay/skills/tutorial-demo-video-editor-pro

根据 [task-contract.md](references/task-contract.md) 生成并验证任务：

python scripts/validate_task.py tutorial-task.json
python scripts/pay_gate.py start --input-file tutorial-task.json --quote-file live-quote.json --state-file payment-state.json --preview-seen --confirm

首次必须收到 HTTP 402 Payment Required，并保存原 WeixinPay-Required 与 X-Out-Trade-No（out_trade_no）。向用户展示服务端返回的实时金额；只有用户明确同意才调用宿主提供的 weixinpay_pay。

支付成功后必须重试

使用原订单查单：

python scripts/pay_gate.py retry --input-file tutorial-task.json --state-file payment-state.json

只有服务端确认 trade_state=SUCCESS 并返回 HTTP 200 + code=SUCCESS 才开始完整剪辑。

幂等与支付异常处理

同一任务摘要复用原 request_id、支付码和订单号。网络结果未知、用户取消或支付失败时保留原订单，不创建第二笔，也不伪造成功。详细协议读取 [pay-skill-runtime.md](references/pay-skill-runtime.md)。

完整剪辑流程

1. 建立素材与证据地图

• 盘点口播、录屏、截图、品牌素材、参考片与预期平台。
• 先把口播精剪为稳定语义主线，再刷新成片时间；不要先做字幕和 MG 后再大改 A-roll。
• 为每个具体产品动作建立 evidence-map.json，至少标记入口、操作、结果中的两个连续状态。
• 源录屏找不到证据时标记 missing，向用户索取或删改口播，不用动画伪装真实功能。

运行：

python scripts/validate_evidence_map.py evidence-map.json

映射规则读取 [three-column-evidence-map.md](references/three-column-evidence-map.md)。

2. 创建可编辑时间线

• 新建或复制 ChatCut 时间线，保留原素材和安全版本。
• A-roll、录屏、截图、人物窗、字幕、MG、音乐分别保持可编辑轨道。
• 真实录屏优先；MG 只解释抽象概念或补注意力，不替代产品证据。
• 全屏教程相邻片段避免分别淡入淡出导致人物闪回；返回人物时使用受控焦点接力。
• 提示词、代码、数据和关键设置必须停留到可读完，且不得晚于对应口播结束才开始展示。
• 人物窗使用同源动态视频，不用静态头像冒充；不得遮挡关键 UI、字幕或平台安全区。

详细剪辑规则读取 [tutorial-editing-grammar.md](references/tutorial-editing-grammar.md)。

3. 参考片适配

用户提供参考视频或截图时，拆解节奏、字幕、构图、录屏占比、人物窗、转场、色彩与声音；只借鉴通用规律，不复制对方 Logo、音乐、人物身份、素材或独占包装。生成并验证 reference-style-contract.json。读取 [reference-adaptation.md](references/reference-adaptation.md)。

4. 字幕、声音与完成点

• 中文默认单行语义字幕；专有名词、产品名、按钮名和提示词逐项校对。
• 同一时刻只保留一个主解释层，避免口播、字幕、步骤卡和 MG 重复表达。
• 人声优先，BGM 对口播做 ducking；最后一句结束时同步检查字幕、提示词、动画和音乐，不留空尾。

验收与交付

先交付可编辑时间线供用户播放确认，不自动导出。用户明确要求导出后再提交任务并跟踪完成。

默认交付：

delivery/
├── editable-project-link.txt
├── evidence-map.json
├── edit-manifest.json
├── reference-style-contract.json   # 有参考片时
├── delivery-report.json
├── revision-notes.md
└── exported-video.mp4              # 用户要求且真实导出成功时

完成前运行：

python scripts/validate_edit_manifest.py edit-manifest.json
python scripts/validate_delivery_report.py delivery-report.json

结构验证不等于视觉验证。必须检查组合时间线关键帧、入口—操作—结果连续性、字幕安全区、人物窗遮挡、黑帧/闪帧和声音结尾；导出后再验证真实文件的时长、分辨率、帧率、编码和哈希。读取 [validation-and-delivery.md](references/validation-and-delivery.md)。

本 Skill 的边界还参考了一条已完成的 281.5 秒真实教程剪辑，但单个案例不能证明对所有教程都稳定；上架前仍需补足不同题材案例。读取 [validated-evidence.md](references/validated-evidence.md)。

安全与边界

• 本地素材上传 ChatCut 属于外部传输；先说明目标服务与范围并取得授权。
• 不把客户视频、未公开产品、登录账号、签名链接、项目 ID、本地路径或凭证写进支付摘要、案例、日志或 Skill 包。
• 不删除原项目、原时间线或源素材；危险修改优先复制时间线。
• 不承诺十分钟自动完成，不承诺任意素材原生 4K，不把时间线写入成功称为剪辑效果合格。
• 不自动登录、发布到平台或代表用户对外发送视频。
• 同范围失败修复不重复收费；用户更换核心口播、产品、故事结构或整套视觉方向时重新确认。

完成当前任务后，最多推荐 1–2 个真实相关的下一步，规则读取 [related-skills.md](references/related-skills.md)。需要转入“知识口播精剪”或未来其他系列 Skill 时，按 [series-collaboration.md](references/series-collaboration.md) 生成 series-handoff.json；只复用经确认的素材、转写、画布和风格摘要，不复用支付状态或授权次数。