105 lines
1.8 KiB
Markdown
105 lines
1.8 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`
|
||
- 上层项目仍需提供：
|
||
- `../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，本地可用，但不等于完整权限系统
|