编辑与交付
Hypit Studio 中文教程：预览、局部修改、批注与导出
了解官方 Hypit Studio 的项目准备、中文界面、时间线与属性编辑、时间点批注，以及预览和导出的区别。附局部修改示例与检查表。
HypitAI 编辑整理 · 核对日期
先确认你打开的是官方项目工具
这里介绍 hypit.ai 文档中的官方 Studio：它在浏览器里展示可编辑的视频项目。本站 hypit.io 提供独立整理的教程与案例，自己的生成工作室尚未开放。本文根据官方文档编写，操作示例未在本次研究中执行。
准备 Run 文件和实际素材
Studio 需要现有项目及选中的 Run，不能只凭一个空文件夹生成完整视频。让 Agent 说明哪个 .svrun 对应要编辑的成片、需要哪些素材，以及素材是否已准备好。
| 准备项 | 作用 | 检查方式 |
|---|---|---|
| Author 与 Recipe 文件 | 描述内容和表现方式 | 确认项目文件可读取 |
| Run 文件 | 选择作品与使用的结果 | 确认指向一个 Film 及其 Timeline |
| 已有素材 | 让预览显示实际画面和声音 | 检查所选输出和文件仍然存在 |
| 执行环境 | 提供项目所需的处理能力 | 使用该项目选定的 Runtime |
打开项目并切换中文
在项目目录运行下面的命令，把 build.svrun 替换成实际 Run 路径，再打开终端打印的地址。Studio / Comments 左侧的地球菜单可选择简体中文；它改变界面语言，不会自动翻译脚本、字幕或批注。
- 默认端口为 5179，以终端实际输出为准。
- 如果 Agent 在远程环境运行，使用它提供的预览转发地址；远程 localhost 不是你电脑上的地址。
- 保留项目目录，避免临时会话结束后丢失素材与修改。
hypit studio --run build.svrun认识时间线、素材与属性面板
从 Source 查看项目文件，从 Tasks 查看制作记录，从 Artifacts 检查已保留的文件。时间线可以定位词语或图形，Inspector 显示组件开放的编辑项。某个内容能被渲染，不代表它的所有属性都能在界面拖动修改。
- 先播放到有问题的片段，再定位对应对象。
- 确认选中的是字幕、图形还是素材，避免改错共享设置。
- 检查保存状态与重新编译结果；失败时按界面提示处理。
原创示例：只调整产品名称的字幕位置
假设水杯视频的产品名称遮住了杯盖，这是编辑计划示例。先定位名称出现的片段，选择字幕并检查是否有位置控件；若无控件，让 Agent 修改对应源值。保留旁白与产品演示素材，再检查其他使用相同样式的字幕是否受影响。
只调整产品名称字幕的位置，避免遮挡杯盖。保持已确认的台词、产品素材与片段顺序。先指出对应组件和可编辑属性；若修改共享样式会影响其他片段，请列出影响范围。修改后检查手机画幅内是否清晰。用时间点批注交给 Agent
Comments 视图适合边看边记录问题。选定时间后提交批注，点击保存的批注可返回对应画面。记录保存在项目 FEEDBACK.json；提交是保存反馈，还需要告诉 Agent 开始处理。
00:03 产品名称遮住杯盖：将字幕移到不遮挡的位置。
00:11 演示动作结束后字幕仍未切换：核对该句与动作的对应。
处理后逐条说明修改，并保留未解决项。保留已确认的素材再继续修改
历史结果需要在 Run 中明确选用。官方文档用 build-record 和 satisfy 选择已完成输出；不要把“以前生成过”理解为后续一定自动复用。查看计划时确认哪些素材继续使用、哪些处理需要重新执行。
预览完成后，单独导出并验收
打开 Studio 或 Comments 不会自动编码成片。让 Agent 确认导出目标，执行对应的 export Build，再取得实际视频文件。build.svrun 和 final.video 只是下面示例的项目名称，须替换为真实目标。
- 用独立播放器完整播放导出文件。
- 检查声音、字幕、画幅和产品事实。
- 对照批注逐条确认，不仅看任务成功状态。
- 保存源项目与选用结果，方便下一次修改。
hypit plan build.svrun
hypit build build.svrun --follow
hypit get <build-id> --output final.video --to output/final.mp4