选择安装方式

约 1057 字大约 4 分钟

BiliLiveCut 的完整流程是：添加直播间 → 录制或导入视频 → 转写与识别高光 → 人工审核 → 生成切片 → 可选上传。先选部署方式，再准备实际需要的模型和服务。

安装入口

运行环境	建议入口	需要准备
Windows 桌面	Portable 使用说明	Full 自带 Python 和 FFmpeg，模型另行准备
Linux 无头服务器	Linux 部署指南	Python、FFmpeg；原生扩展构建需要编译工具和 Python 开发头文件
Docker	容器部署	Docker，镜像与构建缓存空间，持久化数据目录和模型空间
Windows、macOS 或 Linux 源码运行	源码部署	Python、FFmpeg；默认原生扩展安装需要编译工具和 Python 开发头文件
修改代码或参与开发	开发环境	uv 或 venv + pip、FFmpeg、编译工具；JavaScript 检查和文档站另需 Node.js

源码安装同时支持 uv 和传统 venv + pip。Web 控制台使用独立 React 前端：源码安装需要 Node.js 24 构建页面；wheel、Docker 和 Portable 自带静态产物，运行时不需要 Node.js。文档站使用独立的依赖与构建。

当前 Docker 部署会在本机构建包含本地 CPU 转写依赖的完整镜像，首次构建耗时和磁盘占用较大。选择前请阅读构建成本与资源占用，为构建缓存、模型和录制数据分别预留空间。

第一次运行

启动 Web 服务，打开终端给出的地址。
根据部署方式完成管理员登录或首次初始化。管理员账号与 Bilibili 账号是两套独立的登录。
在“Bilibili 登录”页面扫码。无头服务器通过浏览器显示二维码，无需服务器桌面。
添加一个直播间，进行短时间录制；已有视频可直接使用录播导入。
准备所选 ASR 模型和分析服务，再测试转写、高光识别、审核与渲染。

只有录制和 Web 管理需求时，可以先不安装 ASR/LLM 可选依赖。完整本地转写需要对应依赖、模型文件及足够的内存与磁盘空间，首次模型下载可能耗时。

接下来读什么

日常操作、CLI、转写与排错：使用指南。
参数含义、常用/高级设置与生效时间：配置参考。
修改与检查 Web 页面：Web 页面开发与验证。
二次开发与平台扩展：插件开发、直播源插件。

升级前保留旧环境

升级前停止录制和服务，备份完整运行目录。应用版本只记录数据库创建来源；格式版本、模型指纹、实际表列、唯一约束、外键及完整性全部通过时，新程序可以复用原数据库，且不改写来源版本。不兼容格式会拒绝启动，须先在副本上验证受支持的转换方案，或显式配置独立新库；不能手改版本或指纹绕过校验。

Portable 仍以 Launcher 所在目录作为运行目录，版本化 runtime/releases/ 只存源码；Docker 仍使用持久卷中的 /data/blc.db。源码部署更换工作目录时，应显式核查 DATABASE_URL 与 STORAGE_ROOT，相对路径随工作目录解析，不会自动寻找其他目录的数据库。独立测试请使用数据库及媒体副本，避免两个版本同时写同一库；降级还需核查目标版本的配置与业务记录兼容性。模型内容按现有完整性规则复用，详见项目说明。

Python 依赖源

默认可使用官方 PyPI。需要镜像时，现有源码指南提供以下 PowerShell 进程级配置；这些变量用于 pip 安装，不写入应用 .env：

$env:PIP_INDEX_URL='https://mirrors.aliyun.com/pypi/simple/'
$env:PIP_EXTRA_INDEX_URL='https://pypi.tuna.tsinghua.edu.cn/simple/'