用途
video-walkthrough 用于录制一段可播放的视频，展示在浏览器、桌面应用或终端中实际完成的工作或工作流程，可选加入旁白和字幕。其核心要求是交付真实的录制文件：脚本、截图或对拟议视频的描述都不算交付物。如果工作在开始捕获前已经发生，则录制结果行为的安全演示，并明确标注为重放，而非原始执行；对于不可逆的操作，只展示当前结果，不重复执行该动作。
主要能力
- 规划简短演示：利用现有任务上下文选择结果和几个有意义的步骤，通常控制在约 60–90 秒，除非任务需要其他长度。完整书面走查是可选的，仅在明确要求时使用。
- 旁白与字幕：在解释有帮助时进行旁白，尊重静音视频的请求，避免把快速证明变成演示项目。旁白部分涉及本地 Kokoro 语音生成、场景时间线以及捆绑的 MP4/字幕/章节组装；其他已安装语音或用户提供的音频可使用同一时间线。若本地合成失败，不得静默切换到付费或外部语音服务。
- 多环境捕获：
- 浏览器：在可用且允许时，使用用户正常浏览器处理需认证的工作，并用可用的录制器录制该界面；对于隔离的本地/演示会话，Playwright 视频是一个选项，但应先阅读浏览器录制相关说明。
- 桌面：使用可用的操作系统/窗口录制器和 UI 自动化，捕获相关窗口或区域，而非无关屏幕或通知。
- 终端：用屏幕录制器捕获可读的命令和实际输出，或使用已安装工具将真实终端录制渲染为 MP4。纯文本日志或终端 cast 本身不是通常可播放的视频。
- 真实行为捕获：捕获前先登录；将密码、令牌、私人通知和无关个人数据排除在画面外；使用授权的演示记录和状态变更；不要为拍摄而重置数据或重放破坏性命令；等待有意义的可见结果，并留出时间让观看者阅读；若声称持久化，需展示真实的重新加载或重新打开；绝不通过编辑 DOM 或显示输出来伪造成功的保存、排序或结果。
- 文件追踪与清理：从录制器追踪确切的录制文件，而非共享目录中最新的文件；即使失败也要停止并完成捕获；仅恢复走查自有的临时更改，不覆盖其他用户的工作；保留任务脚本和原始产物直到审查，以便编辑可重复。
- 检查与交付：生成 H.264 视频的 MP4，旁白时使用 AAC 音频以便广泛播放；对于静音或已混合的捕获，如需要可直接用 FFmpeg 转码，捆绑的组装器专门用于分离的场景旁白；当原始音频是演示的一部分时保留它。检查成品文件而非仅检查捕获：开头、关键交互、可读文本、停顿和最终帧；在播放工具允许时，将旁白与动作一起聆听；使用 ffprobe 验证流和时长；估计的字幕在声称同步前需要检查。如果无法播放或聆听，需披露该限制；仅元数据不能证明视频看起来或听起来正确。将检查过的视频保存到请求的目标位置，否则保存到 Downloads（如可用）或一个命名清晰的本地产物目录；使用新文件名或目录；除非要求替换，否则保留之前的拍摄。生成字幕/转录时一并包含，并在最终回复中链接视频。在支持且适当时，在用户播放器中打开它；只报告实际观察到的播放情况。说明演示了什么以及检查了什么。
使用方式
检查当前仓库的启动和自动化说明，发现实际的 URL、命令、账户和数据，绝不假设框架或端口。根据环境支持选择捕获方法（浏览器、桌面或终端）。在可用且允许时使用用户正常浏览器处理需认证的工作；对于隔离的本地/演示会话，Playwright 视频是一个选项。桌面使用可用的操作系统/窗口录制器和 UI 自动化。终端用屏幕录制器捕获可读命令和实际输出，或使用已安装工具将真实终端录制渲染为 MP4。工具可用性和权限是真实约束，在执行一次性操作前检查捕获支持；如果所选工具无法录制，报告该情况并在授权范围内使用受支持的录制器。不得声称视频存在，也不得静默替换为幻灯片或生成素材。
适用场景
适用于需要向他人展示实际工作过程或工作流程的场合，例如演示浏览器中的操作、桌面应用的使用或终端命令的执行。适合需要简短证明（约 60–90 秒）而非完整演示项目的情况。
限制
- 工具可用性和权限是真实约束，可能无法录制。
- 不得上传到托管服务、发布或向他人发送消息，除非明确要求；录制本身不授权这些操作。
- 保持媒体、认证状态、依赖和模型远离 Git。
- 不得将私有发布服务作为本地视频的前提条件。
- 如果无法播放或聆听，需披露该限制；仅元数据不能证明视频看起来或听起来正确。
- 估计的字幕在声称同步前需要检查。
- 若本地语音合成失败，不得静默切换到付费或外部语音服务。
- 关于收费、价格、平台支持等具体信息，资料中暂未提供。