# svf 短视频工厂 · Agent 安装指引

> 你(AI 助手)正在阅读本页。你的任务:帮用户把「svf 短视频工厂技能」装好,装完跑一遍自检,然后告诉用户可以开始出片了。
> 全程无需管理员权限、不碰用户其他数据、可重复执行(升级=重装一遍,程序层覆盖,用户项目永不丢失)。

---

## 第一步:确认平台

- **Windows**(Win10/11 x64)→ 下载 `svf-win-full.zip`(约 400MB,离线全量包,装完出片不需要联网)
- **macOS**(Intel 或 Apple Silicon 均可,通用包)→ 下载 `svf-mac.tar.gz`(约 7MB,渲染依赖首次使用时联网安装)

## 第二步:下载安装包(官网渠道)

### Windows

在 PowerShell 或 cmd 中(注意:`curl` 需写成 `curl.exe`,PowerShell 里裸 `curl` 是别名):

```powershell
curl.exe -fsSL -o svf-win-full.zip https://atomcreate.cn/cli/latest/svf-win-full.zip
```

校验完整性(可选但建议,输出应与下指纹一致):

```powershell
certutil -hashfile svf-win-full.zip SHA256
# svf 0.5.1: a95efd51109c59f045162365b6a3cb949c50d9c5b9a20fefe834408037e2491e
```

### macOS

```bash
curl -fsSL -o svf-mac.tar.gz https://atomcreate.cn/cli/latest/svf-mac.tar.gz
shasum -a 256 svf-mac.tar.gz
# svf 0.5.1: d820ef84e3ee2eaf5f37a41aff8c18ee76d389bd64719d6befec96b5763e6bb1
```

> 若上述地址不可达,说明用户可能给你发了本地安装包——跳到「本地包备选流程」。

## 第三步:安装

### Windows

```powershell
Expand-Archive -Path svf-win-full.zip -DestinationPath svf-install   # 或 tar -xf svf-win-full.zip
cd svf-install
cmd /c install.bat
```

安装器自动完成:程序落 `%USERPROFILE%\.svf\`、数据根智能落位(有达标的非系统固定盘——可写且剩余 ≥5GB——默认落 `<盘>:\短视频工厂\`,没有则回落 `%USERPROFILE%\短视频工厂\`;重装/升级自动沿用既有位置,安装末尾会写明「视频数据放在」哪)、
技能副本分发到它探测到的 Agent 技能目录(Claude Code/Codex/OpenCode/Windsurf/WorkBuddy,及跨厂商标准位 `~/.agents/skills`,
如 `%USERPROFILE%\.claude\skills\`、`%USERPROFILE%\.workbuddy\skills\`)、
工具写入用户级 PATH(幂等,重复安装无副作用)。

### macOS

```bash
tar -xzf svf-mac.tar.gz && cd svf-mac && bash install.sh
```

## 第四步:验证

```powershell
# Windows
& "$env:USERPROFILE\.svf\bin\svf.exe" doctor
```

```bash
# macOS
~/.svf/bin/svf doctor
```

预期 **绝大多数项 OK**;「凭证存在性」一项 FAIL 属正常(凭证见下节)。其余 FAIL 按输出里的修法处理。

然后**阅读技能正本** `%USERPROFILE%\.svf\skill\SKILL.md`(mac 为 `~/.svf/skill/SKILL.md`),
严格按其工作流协议为用户服务——出片前照协议确认需求与凭证状态。

完成后告诉用户:「装好了,你可以直接说『用 svf 出一条 60 秒竖屏短片,主题是……』来开始。」

## 凭证(渠道发放,不由安装处理)

包内不含凭证。配音环节需要 `.env.local`(凭证与专属 voice_id 配对,由发放渠道另行交给用户)。
收到后放入数据根即可(数据根位置以安装完成输出的「视频数据放在」为准——Windows 典型为 `<盘>:\短视频工厂\.env.local` 或 `%USERPROFILE%\短视频工厂\.env.local`;mac:`~/短视频工厂/.env.local`),
无需重装。缺它时其余功能可用,tts 环节会明确报错。

## 本地包备选流程(用户发来了压缩包文件时)

- Windows:解压 zip 到任意可写目录 → 在解压目录执行 `cmd /c install.bat` → 同第四步验证。
- macOS:`tar -xzf <文件名> && cd svf-mac && bash install.sh` → 同第四步验证。

## 前置条件

- Windows 10/11 x64,或 macOS 12+(Intel/Apple Silicon);
- 用户有一个 AI 助手宿主(Claude Code / Codex / WorkBuddy 等均可),安装器会把技能副本分发到探测到的宿主目录;
- 磁盘余量 ≥ 3GB;
- 用户已从渠道获得或即将获得 `.env.local` 凭证(仅影响配音)。

## 禁止事项

- **禁止**要求用户自己敲安装命令、询问安装路径——安装是你的活,不是用户的;
- **禁止**以管理员/提权方式运行安装器(只写用户目录,提权反而装错位置);
- **禁止**删除或改动数据根下的用户项目与 `assets/voice/` 配音;
- **禁止**读取、复述、记录 `.env.local` 的内容(搬运可以,看内容不行);
- 未阅读 SKILL.md 前,**禁止**猜测 svf 的命令用法。

---
*svf · 短视频工厂——一句话让 AI 出竖屏带货短片。版本与指纹随发布更新,本页由官方托管。*