feat: package docker deployment and publish flow

This commit is contained in:
theshy
2026-04-22 16:20:03 +08:00
parent 055474360e
commit 2146687dc6
178 changed files with 24318 additions and 20855 deletions

View File

@ -1,113 +1,113 @@
# 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/`
# 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/`