问题排查
Hypit 常见问题排查：安装、素材、生成和导出
按失败发生的位置排查 Hypit 工作流，整理最小复现信息、模型请求与输出检查。以下为诊断方法，不把推测写成已知官方故障。
HypitAI 编辑整理 · 核对日期
先定位失败发生在哪一步
同一个“不能用”可能出现在 Skill 加载、素材读取、模型请求或成片导出阶段。先记录最后一个成功步骤，能避免重装整个环境。以下是通用诊断路径，不是对某个版本缺陷的断言。
| 现象 | 先检查 | 应保留的证据 |
|---|---|---|
| Agent 找不到 Skill | 安装目标是否为当前 Agent，是否已刷新会话 | 安装命令、Agent 名称、错误文字 |
| 读不到参考素材 | 路径、访问权限、文件是否完整 | 脱敏后的路径和文件类型 |
| 模型请求失败 | 服务商、模型、账户权限和返回错误 | 时间、请求 ID、状态码，不含密钥 |
| 显示完成但没有可用视频 | 实际输出路径、文件大小和播放结果 | 输出清单及播放器错误 |
不要把网络超时当作一定没生成
提交请求后连接中断，服务端可能已经接收任务。先查原任务或请求记录，再决定重试，尤其不要同时开多个窗口重复提交可能付费的任务。把请求 ID 和时间放在同一条诊断记录中。
字幕或声音不对时，先缩小范围
用一个短片段对照原台词：是文字本身错、发音错，还是时间位置错？分别描述问题，保留一处可复现的时间点。中文标点、人名和数字读法应在脚本阶段确认。
- 文字错误：修正脚本并检查字幕是否来自旧版本。
- 时间错误：对照声音与字幕出现时刻，记录偏移。
- 声音问题：检查原素材与导出文件是否都有音轨。
- 样式问题：在目标手机尺寸检查字号和安全区域。
发送一份可用的问题报告
提供最少但足以定位的信息。日志中先移除密钥、签名 URL 和私人素材地址。
目标：
系统与 Agent：
Hypit 版本／检查日期：
输入类型：
最后成功步骤：
失败步骤及错误原文：
请求 ID（如有）：
期望结果／实际结果：
已尝试的排查：恢复后再验证一次
修复后先用最小片段确认问题消失，再扩大项目。记录哪些文件或设置改变了，避免下一次更新时重复同样的排查。关于版本特有问题，以官方维护记录为准。