Hypit 安装指南：先配置 Agent，再检查视频制作环境

先明确你要安装的是什么

Hypit 的 Skill 为 Agent 提供工作说明，可执行工具负责具体制作操作，视频项目则保存你的素材与创作结果。这三个部分不要混为一谈。本文根据官方安装入口整理，不代表已经在你的机器上验证通过。

准备一个清晰的项目文件夹

先把计划使用的材料放在单独目录，保留原文件。文件名应能说明内容；不把 API 密钥、个人资料或无关项目一起交给制作流程。

• 确认 Agent 在这个文件夹中工作。
• 在 brief.txt 写清受众、语言、画幅和目标。
• 用 approved-claims.txt 记录允许表达的产品事实。

my-video/
  brief.txt
  assets/
    product-front.jpg
    product-side.jpg
    reference.mp4
  notes/
    approved-claims.txt

安装 Skill

在适合你的终端中执行官方 Skill 安装命令，阅读安装器提示并选择实际使用的 Agent。命令报错时保留完整错误上下文，但不要贴出密钥。

npx skills add hypit-ai/hypit -g

让 Agent 检查工具，而不是重复盲装

安装后重新打开或按 Agent 的方式刷新 Skill，先确认它能识别 Hypit。请它检查已有可执行程序及当前文档要求；不要因为 Skill 已安装，就推断所有模型和媒体处理依赖都准备好了。

请检查这个项目能否使用 Hypit。先列出已安装工具、缺失依赖和拟执行的安装步骤。暂时不要调用付费模型，也不要修改其他项目。

检查已有安装的版本

官方快速开始提供以下版本检查入口。记录结果与检查日期；如果当前版本不支持该命令，按官方文档中的旧版本检查方式处理，不要据此删除现有项目。

hypit version --check

第一次使用如何算准备完成

以明确证据判断环境是否就绪，不把一条成功命令当作整个视频工作流验收。

• Agent 能识别 Skill，并解释下一步计划。
• 需要的本地素材能读取，文件路径没有指向别的项目。
• 所选模型的服务商与账户明确，密钥不出现在公开记录中。
• 缺失依赖、预期费用和输出位置已说明。
• 真正生成之后，另行检查视频能否播放、字幕和声音是否正确。