FineSub CLI

FineSub 的命令行发行版：把长音频转成字幕（人声分离 → VAD+ASR 对齐 → 稳定化 → SRT）。安装的是一个轻量壳——首次运行时它会在 %LOCALAPPDATA%\FineSub 下 自动装好隔离的 Python 3.12 运行环境（含锁定的 AI 依赖）和 FFmpeg，模型按需下载 到同一目录。装过 FineSub Desktop（安装器版）的机器还会共享它的设置与 API Key。

安装

一条命令（cli/install.ps1：自动找最新 Release 的 wheel 装成 uv tool，缺 uv 会先装 uv；重跑即升级）：

powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/caca2331/finesub/main/cli/install.ps1 | iex"

手动装也可以：到 GitHub Release 复制最新 finesub-*.whl 的链接，uv tool install <链接>（或 pipx install <链接> / 自建 venv pip install <链接>，壳很轻）。将来发上 PyPI 后可直接 uv tool install finesub。

使用

参数与仓库开发版的 asr-pipeline 完全一致：

finesub input.wav --model large-v3-turbo --language en --gpu-budget-gb 8
finesub batch --manifest tasks.jsonl
finesub setup        # 只预装运行环境，不跑任务
finesub doctor       # 查看运行环境状态与各路径（跑完整健康探针，需数秒）
finesub uninstall    # 删除运行环境/模型/缓存；个人数据需 --purge-user-data

普通命令信任持久化的健康判定（runtime/python/finesub-health.json，环境一变即 失效），启动接近零开销；怀疑环境坏了就跑 doctor——它永远做真探针。

彻底移除：finesub uninstall 之后 uv tool uninstall finesub。

环境变量 FINESUB_HOME 可改数据根（默认 %LOCALAPPDATA%\FineSub；小 C 盘用户 可指到别的盘）。指向 FineSub Desktop 的安装目录即可复用它已下载的运行环境和模型。 本地 token 计数器（tokcount）不随 wheel 分发，计数自动退到免费的 countTokens 接口；要用本地版就设 GEMINI_TOKEN_COUNTER_EXE。

构建（维护者）

wheel 由 cli/scripts/build-wheel.ps1 产出：staging 目录里放入本包源码 + _vendor（src/asr_playground、src/llm、src/finesub_bootstrap 快照、 pylock.win-py312.toml、runtime-manifest.json），版本号取自 desktop/VERSION （CLI 与桌面同版本、同 tag、同 Release）。构建机需要 python -m build。

.\cli\scripts\build-wheel.ps1

uv 钉版必须与 desktop/resources/runtime-manifest.json 一致，由 desktop/scripts/tests/test_desktop_dependencies.py 强制。