# 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

```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
```

默认会写入：

- `runtime/logs/worker.log`
- `runtime/logs/api.log`

默认按大小轮转：

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

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

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