114 lines
1.9 KiB
Markdown
114 lines
1.9 KiB
Markdown
# 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/`
|