biliup-next/DELIVERY.md

biliup-next Delivery Checklist

Scope

biliup-next 当前已经是一个可独立安装、可运行、可通过控制台运维的本地项目。

当前交付范围包括：

• 独立 Python 包
• 本地 .venv 初始化
• SQLite 状态存储
• 隔离 workspace
• worker / api 运行脚本
• systemd 安装脚本
• Web 控制台
• 项目内日志落盘
• 主链路：
  • stage
  • ingest
  • transcribe
  • song_detect
  • split
  • publish
  • comment
  • collection

Preflight

• Python 3.11+
• ffmpeg
• ffprobe
• codex
• biliup
• biliup-next/runtime/cookies.json
• biliup-next/runtime/upload_config.json
• biliup-next/runtime/biliup

Install

cd /home/theshy/biliup/biliup-next
bash setup.sh

如需把当前机器上已有运行资产复制到本地：

cd /home/theshy/biliup/biliup-next
./.venv/bin/biliup-next sync-legacy-assets

Verify

cd /home/theshy/biliup/biliup-next
./.venv/bin/biliup-next doctor
./.venv/bin/biliup-next init-workspace
bash smoke-test.sh

预期：

• doctor.ok = true
• data/workspace/stage
• data/workspace/backup
• data/workspace/session

Run

手动方式：

cd /home/theshy/biliup/biliup-next
bash run-worker.sh
bash run-api.sh

默认会写入：

• runtime/logs/worker.log
• runtime/logs/api.log

默认按大小轮转：

• 单文件 20 MiB
• 保留 5 份历史日志

systemd 方式：

cd /home/theshy/biliup/biliup-next
bash install-systemd.sh

Control Plane

• URL: http://127.0.0.1:8787/
• 健康检查：/health
• 可选认证：runtime.control_token

Repository Hygiene

这些内容不应提交：

• .venv/
• data/
• systemd/rendered/
• config/settings.staged.json

Known Limits

• 当前控制台认证是单 token，本地可用，但不等于完整权限系统
• sync-legacy-assets 仍是一次性导入工具，方便把已有资产复制到 runtime/