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

先核对版本与升级影响

截至 2026 年 9 月 21 日，本页核对的最新官方版本为 0.2.10。0.2.0 改变了 Script 标记写法并要求显式准备本地语言与浏览器资源；更新 CLI 不会更新 Skill 或重写旧项目。

npm install --global @hypit/hypit@0.2.10
npx skills add hypit-ai/hypit -g
hypit --version
hypit version --check

先明确你要安装的是什么

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

普通创作与源码开发分开准备

普通创作者可让 Agent 准备可执行工具，无需先克隆整个仓库。源码开发文档中的工作区命令不是每个创作者都必须执行的步骤。Skill 与可执行程序分别更新，更新前保留自己的项目与素材。

交给 Agent 的首次环境交接

把检查结果写清楚，下一步就能从准备完成的位置继续。此清单不要求立即生成素材。

项目目录：
Agent 能否读取素材：
Skill 安装位置与版本：
Hypit 可执行版本：
选用的服务与 Provider：
本地处理依赖是否就绪：
预览地址如何打开：
源文件与成片保存位置：
尚缺少的准备：

凭据和本地资源显式准备

0.2.x 在 macOS 使用 Keychain、Windows 使用 Credential Locker，Linux 可选所有者私有文件；缺失后端不会静默切换。WhisperX 语言、浏览器和本地程序也要由 Profile 显式准备。

hypit programs prepare --runtime <profile> --endpoint <instance>
hypit programs up --runtime <profile> --endpoint <instance>