让本机 Agent 跑起来

macOS：三步完成首次启动

Windows：三步完成首次启动

已经装过 PodCut？不用重新下载

启动器每次启动会自查更新：有新版就自己更新启动器和程序本体，保留已装好的 Python 环境和模型。从桌面或开始菜单启动 PodCut Agent 就是升级。

如果你装的是 2026 年 8 月 29 日之前的版本，它还不会自查更新（也可能被杀毒软件拦住下载）。用管理员 PowerShell 跑一次下面这条命令，把启动器换成最新版，之后就都是自动的了：

$d="$env:LOCALAPPDATA\PodCut"; $m=(Invoke-WebRequest -UseBasicParsing "https://podcut.pages.dev/downloads/latest.json").Content | ConvertFrom-Json; $t="$env:TEMP\PodCut-Windows.ps1"; Invoke-WebRequest -UseBasicParsing "https://podcut.pages.dev/downloads/PodCut-Windows.ps1" -OutFile $t; if ((Get-FileHash -Algorithm SHA256 $t).Hash.ToLowerInvariant() -eq $m.launcher_sha256) { New-Item -ItemType Directory -Force $d | Out-Null; Move-Item -Force $t "$d\PodCut-Windows.ps1"; "已更新，双击桌面 PodCut Agent 即可" } else { "校验失败，请重试" }

这条命令只替换启动器脚本本身，会先按官方清单校验 SHA-256 再落盘；你的素材、Key 和已下载的模型都不受影响。

首次会准备什么

Python 3.11–3.13

运行 PodCut 和本机 Agent。macOS 启动器会从国内镜像下载独立 Python，不需要 Homebrew。Windows 缺少时由 WinGet 安装。

FFmpeg / FFprobe

读取、裁切和导出视频。macOS 启动器会下载现成程序到本机目录，不需要 Homebrew。Windows 缺少时先由 WinGet 安装；WinGet 不可用或其 github.com 下载不通时，启动器改从 ModelScope 直接下载固定版本并按 SHA-256 校验。

faster-whisper 1.2.1

在本机把语音转换为带时间戳的文字。

Whisper large-v3-turbo

约 1.5 GB，只下载一次。依次尝试 ModelScope、hf-mirror.com、huggingface.co，每个文件按固定 SHA-256 校验，来源只是运输。三个源都连不通时，可设环境变量 PODCUT_MODEL_SOURCE 指向任何有这批文件的 HTTP 地址后重跑启动器。

模型 API Key（DeepSeek 或 OpenAI）

Agent 连接后在网页填写，境内网络推荐 DeepSeek（国内直连）；OpenAI 需要你的网络能直连 api.openai.com。气口优化用等长精校生成 SRT，并做有界的提取式清稿：只按逐字核验过的源 token 删除口头禅、应答词、结巴，不改写、不新增任何字；内容精剪还要理解结构和出精炼稿。Key 经本机 127.0.0.1 保存到当前用户的 .podcut 文件夹。启动器不会安装仅供开发者使用的 DeepSeek Harness。

磁盘空间

模型约 1.5 GB，另需 Python 包和输出视频空间。

macOS：双击无反应时，用终端启动

打开“终端”，复制下面整段并按回车。命令会下载脚本、赋予执行权限并启动它。

Windows：双击无反应时，用 PowerShell 启动

打开 PowerShell，复制下面整段并按回车。命令会下载、解压并运行启动器。