选择适合你的运行方式

• Windows 桌面：使用 Portable，Full 自带 Python 与 FFmpeg。
• Linux 无头服务器：按服务器部署指南安装，在自己的浏览器中完成扫码登录和日常管理。
• Docker：按容器部署说明运行，持久化保存配置、模型与录制数据。
• Python 源码：按源码部署指南安装，在 Windows、macOS 或 Linux 上通过 Python 启动。

源码快速启动

在全新的项目目录中，准备 Python 3.12、Node.js 24、FFmpeg 和编译工具。将 .env.example 复制为 .env，已存在时保留原文件，按需编辑后执行：

uv sync --locked --no-dev --extra web
uv run --no-sync blc init
npm --prefix frontend ci
npm --prefix frontend run build
uv run --no-sync blc start

打开 http://127.0.0.1:8000，添加直播间或导入已有视频。完整安装步骤及 venv + pip 方式见源码部署。

准备转写与分析

上面的命令先安装 Web 管理和录制所需依赖。需要本地转写与 LLM 分析时，按完整安装说明补充可选依赖、模型和服务配置。管理员登录与 Bilibili 扫码登录是两个独立步骤。

插件扩展

按需安装独立插件，扩展高光评分、直播来源和音频分析能力：

• 个性化高光评分：Highlight 结合转写、弹幕与音频特征评估候选片段，支持使用人工审核反馈训练模型，让评分更贴近自己的选片偏好。
• 抖音直播接入：DouyinCompatibility 提供直播间解析、开播检测与取流，沿用主程序的录制、转写、分析和切片流程。目前不采集抖音弹幕。
• 语音与音乐检测：inaSpeech 识别语音、音乐、噪声和静音的时间区间及占比，为录播分析补充音频分类信息。目前仅记录分析结果，不改变高光评分；推理服务需单独部署在 Linux、Docker 或 WSL2 环境中。

安装步骤、依赖与兼容要求见各插件仓库。Highlight 与 inaSpeech 使用同一高光评分插件入口，需择一启用。

从哪里开始

• 第一次使用：阅读安装方式导览和使用指南。
• 分析已有视频：查看录播导入与恢复。
• 调整常用项与高级参数：查看配置参考。
• 修改 Web 页面：查看 Web 页面开发与验证。
• 开发新平台或分析能力：查看插件开发与直播源契约。
• 了解版本变化：查看更新记录，完整目录见文档导览。

Alpha 版本升级

升级前停止服务并备份运行目录。数据库按格式版本、模型指纹、实际结构及约束验证，应用版本仅记录创建来源；完整校验通过时可复用原数据。不兼容的数据库会保留并拒绝启动。详见升级说明。