HiAPI 真实感视频双 Skill 工作流

一条命令安装两个彼此独立的 Agent Skill：

1. realistic-video-prompting：负责面向所有视频模型的真实感方法、结构化提示词和自动核对。
2. hiapi-seedance-2-0-video：负责 HiAPI Seedance 2.0 参数校验、任务提交、轮询和下载。

npx -y github:HiAPIAI/hiapi-realistic-video-workflow -y

安装器不会保存 API Key，也不会把两个 Skill 合成一个黑盒。

这是 Seedance 用户的快捷组合，不代表真实感提示词只支持 Seedance。单独安装 realistic-video-prompting 后，可把核对结果交给 Veo、Kling、Runway、Sora 或其他视频模型对应的 Skill/API。

为什么保持两个 Skill

用户需求	调用路径
“用 Seedance 做一段海边广告”	直接 Seedance
“把提示词改成 DV 家庭录像感，先不出片”	只用真实感 Skill
“用 Seedance 做一段手机随拍感视频，直接出片”	真实感自动核对 → 显式 Seedance 适配器
“用其他模型做手机随拍感视频”	真实感自动核对 → 对应模型 Skill/API

这样原有 Seedance 用户不用学习新安装流程；真实感用户也可以只写提示词、不产生费用，或选择其他模型执行。

安装目标

安装器会检测 Codex 和 Claude Code。也可以指定：

npx -y github:HiAPIAI/hiapi-realistic-video-workflow --codex
npx -y github:HiAPIAI/hiapi-realistic-video-workflow --claude
npx -y github:HiAPIAI/hiapi-realistic-video-workflow --target=/path/to/skills

更新时会先把两个仓库克隆到临时目录并验证 SKILL.md 身份，再替换旧版本。如果旧目录有未提交修改或不是干净的 Git 安装，默认停止，避免覆盖用户内容。

确认已备份后才使用：

npx -y github:HiAPIAI/hiapi-realistic-video-workflow --target=/path/to/skills --force

单独安装仍然支持

npx -y github:HiAPIAI/realistic-video-prompting -y
npx -y github:HiAPIAI/hiapi-seedance-2-0-video-skill -y

realistic-video-prompting 默认 prompt-only，不会调用付费 API。Seedance 出片前需要在 Agent 运行环境设置 HIAPI_API_KEY。

卸载组合

npx -y github:HiAPIAI/hiapi-realistic-video-workflow --uninstall --target=/path/to/skills

如果任一 Skill 有本地修改，卸载会停止。只有确认已经备份时才加 --force。

安全边界

• 不保存、打印或复制 API Key。
• 不静默启用 4k 或持续计费的 persistent storage。
• prompt-only 永不创建视频任务。
• 安装替换和卸载默认保护本地修改。
• 安装过程中任一步失败，会恢复已替换的旧目录。

English: README.en.md