init biliup-next

DELIVERY.md

@@ -0,0 +1,104 @@
+# 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
+
+```bash
+cd /home/theshy/biliup/biliup-next
+bash setup.sh
+```
+
+如需把父项目中的运行资产复制到本地：
+
+```bash
+cd /home/theshy/biliup/biliup-next
+./.venv/bin/biliup-next sync-legacy-assets
+```
+
+## Verify
+
+```bash
+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
+
+手动方式：
+
+```bash
+cd /home/theshy/biliup/biliup-next
+bash run-worker.sh
+bash run-api.sh
+```
+
+systemd 方式：
+
+```bash
+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，本地可用，但不等于完整权限系统