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
• 上层项目仍需提供：
  • ../cookies.json
  • ../upload_config.json
  • ../.env 中的运行时路径配置

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

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

• 当前仍复用父项目中的 cookies.json / upload_config.json / biliup
• 当前 provider 仍有 legacy adapter
• 当前控制台认证是单 token，本地可用，但不等于完整权限系统