开发者选项

WARNING

以下选项面向进阶用户和开发者，普通用户无需修改。

---

钩子系统（Hooks）

biliup 提供四个阶段的钩子，支持自定义脚本和外部通知：

钩子阶段	配置字段	触发时机	用途示例
录制前	preprocessor	检测到开播，准备开始录制	发送开播通知
分段后	segment_processor	录制文件达到分段条件	弹幕压制、格式转换
下载完成	downloaded_processor	直播录制全部完成	文件预处理、通知
上传后	postprocessor	上传完成	发送通知、删除本地文件、Webhook

钩子步骤类型

每个钩子阶段接受一个步骤数组，每个步骤支持以下格式：

格式	JSON 示例	说明
run	{"run": "sh ./process.sh"}	执行 Shell 命令（Windows: cmd /C，Unix: sh -c）
mv	{"mv": "backup/"}	移动文件到指定目录
remux	{"remux": "mp4"}	转封装为 MP4（使用 ffmpeg，不重编码）
rm	"rm"	删除文件

各阶段输入数据

阶段	输入方式	数据格式
preprocessor	JSON via stdin	{"name":"主播名","url":"直播间URL","start_time":时间戳}
segment_processor	文件路径 via stdin	视频分段的文件路径
downloaded_processor	JSON via stdin	{"name":"主播名","url":"URL","room_title":"标题","start_time":时间戳,"end_time":时间戳,"file_list":[文件列表]}
postprocessor	文件路径 via stdin	已上传视频的文件路径

钩子配置方式

在 WebUI「空间配置」→「开发者选项」中配置，或在主播的独立配置中指定。

配置示例（YAML 格式）：

preprocessor:
  - run: "echo $0"
segment_processor:
  - remux: "mp4"
downloaded_processor:
  - run: "sh ./notify.sh"
postprocessor:
  - rm
  - mv: "backup/"
  - run: "sh ./cleanup.sh"

Webhook 格式

上传完成后发送的 POST 请求包含以下信息：

{
  "title": "视频标题",
  "bvid": "BVxxxxxxxxxx",
  "aid": 123456789,
  "file": "/path/to/video.flv"
}

---

分段处理器（segment_processor）

录制文件达到分段条件后，可对文件进行后处理。

内置处理器

处理器	说明
remux:mp4	将 FLV/TS 重新封装为 MP4（无需重新编码，速度快）

remux:mp4 技术细节

remux:mp4 将 .ts/.m2ts 文件转封装为 .mp4（不重编码），使用以下 ffmpeg 命令：

ffmpeg -hide_banner -loglevel warning -y \
  -fflags +genpts+igndts \
  -i input.ts \
  -c copy \
  -bsf:a aac_adtstoasc \
  -movflags +faststart \
  -avoid_negative_ts make_zero \
  output.mp4

这解决了 B站对 .ts 直传的时间戳跳变问题。

自定义处理器

可编写自定义 Python 脚本，搭配 DanmakuFactory 等工具实现弹幕压制。

---

高级配置

配置文件位置

• WebUI 默认使用 data/data.sqlite3 存储配置
• 支持通过 --config 参数使用 biliup 1.0.7 风格的 YAML 配置文件启动录制
• 新版启动时自动将旧版 YAML 配置转换到数据库

INFO

--config 加载的是旧版 YAML 配置（v1.0.7 风格），而非当前版本的数据库配置。主要用于兼容旧版部署。

日志级别

日志级别通过全局配置中的 LOGGING.root.level 和 loggers_level 设置，而非命令行参数：

配置项	说明	可选值
LOGGING.root.level	ds_update.log 控制台日志级别	DEBUG/INFO/WARNING/ERROR/CRITICAL
loggers_level	download.log 文件日志级别	同上

CLI 的日志级别可通过全局选项 --rust-log 设置：

# 详细日志（用于排查问题）
biliup --rust-log debug server

# 仅特定模块的详细日志
biliup --rust-log "tower_http=debug,biliup=trace,info" server

数据库结构

biliup 使用 SQLite 存储配置和运行数据，主要表结构：

表名	说明
livestreamers	直播主播配置
uploadstreamers	上传模板
streamerinfo	录制记录
filelist	录制文件列表
configuration	全局配置和 Cookie 存储