1. 📥 下载视频           [约 1-5 分钟]
   └─ 自动选择最高清晰度

2. 🎤 提取音频           [约 10-30 秒]
   └─ 转换为 WAV 格式供 Whisper 处理

3. 📝 生成字幕           [约 1-10 分钟，取决于视频长度]
   └─ Whisper AI 自动识别语音

4. 🌐 翻译字幕           [约 30 秒-2 分钟]
   └─ DeepSeek/Gemini 智能翻译

5. 📷 下载封面           [约 5-10 秒]
   └─ 提取高清缩略图

6. 🤖 生成元数据         [约 20-60 秒]
   └─ AI 分析生成标题、简介、标签

7. 📤 上传到 Bilibili    [约 5-30 分钟，取决于视频大小]
   └─ 自动投稿，获取 BV 号

8. 📝 上传字幕           [约 10-30 秒]
   └─ 添加 CC 字幕到已发布视频

ytb2bili/
├── 📄 main.go                          # 应用入口，Uber FX 依赖注入配置
├── 📄 config.toml                      # 主配置文件
├── 📄 Makefile                         # 构建脚本（一键编译前后端）
├── 🐳 docker-compose.yml               # Docker 编排文件
├── 🐳 Dockerfile                       # 容器构建文件
│
├── 📂 internal/                        # 内部业务逻辑（不对外暴露）
│   ├── 📂 chain_task/                  # ⛓️ 任务链处理引擎
│   │   ├── chain_task_handler.go       #    任务调度器（每 5 秒扫描待处理任务）
│   │   ├── upload_scheduler.go         #    上传调度器（定时上传）
│   │   ├── 📂 handlers/                #    具体任务处理器
│   │   │   ├── down_load_video.go      #      1️⃣ 下载视频（yt-dlp）
│   │   │   ├── extract_audio.go        #      2️⃣ 提取音频（FFmpeg）
│   │   │   ├── generate_subtitles.go   #      3️⃣ 生成字幕（Whisper）
│   │   │   ├── translate_subtitle.go   #      4️⃣ 翻译字幕（AI）
│   │   │   ├── download_img_handler.go #      5️⃣ 下载封面
│   │   │   ├── generate_metadata.go    #      6️⃣ 生成元数据（AI）
│   │   │   ├── upload_to_bilibili.go   #      7️⃣ 上传视频
│   │   │   └── upload_subtitle_to_bilibili.go  8️⃣ 上传字幕
│   │   └── 📂 manager/                 #    任务链状态管理
│   │       ├── chain.go                #      任务链定义
│   │       └── state.go                #      状态机实现
│   │
│   ├── 📂 core/                        # 核心服务层
│   │   ├── app_server.go               #    HTTP 服务器配置（Gin）
│   │   ├── 📂 models/                  #    数据库模型（GORM）
│   │   │   ├── tb_video.go            #      视频表（保存下载的视频信息）
│   │   │   ├── tb_task_step.go        #      任务步骤表（记录每个步骤的状态）
│   │   │   ├── tb_user.go             #      用户表（B站账号信息）
│   │   │   └── tb_bili_account.go     #      B站账号详情（Cookie、Token）
│   │   └── 📂 services/                #    业务逻辑服务
│   │       ├── saved_video_service.go  #      视频管理服务
│   │       └── task_step_service.go    #      任务步骤服务
│   │
│   ├── 📂 handler/                     # HTTP API 路由控制器
│   │   ├── video_handler.go            #    视频管理 API（增删改查）
│   │   ├── upload_handler.go           #    上传相关 API
│   │   ├── subtitle_handler.go         #    字幕管理 API
│   │   ├── auth_handler.go             #    认证 API（登录、注册）
│   │   ├── accounts_handler.go         #    B站账号管理 API（扫码登录）
│   │   ├── config_handler.go           #    配置热更新 API
│   │   ├── cron_handler.go             #    定时任务管理 API
│   │   └── analytics_handler.go        #    数据分析 API
│   │
│   ├── 📂 middleware/                  # HTTP 中间件
│   │   └── firebase_auth.go            #    Firebase 认证中间件
│   │
│   ├── 📂 storage/                     # 存储接口
│   │   ├── interfaces.go               #    存储接口定义
│   │   └── login_store.go              #    登录信息存储
│   │
│   └── 📂 web/                         # 静态资源（嵌入到二进制）
│       └── static.go                   #    Next.js 构建产物嵌入
│
├── 📂 pkg/                             # 公共工具包（可复用）
│   ├── 📂 analytics/                   # 数据分析客户端
│   │   ├── client.go                   #    分析事件上报
│   │   └── middleware.go               #    分析中间件
│   │
│   ├── 📂 auth/                        # 认证鉴权
│   │   ├── jwt.go                      #    JWT Token 生成/验证
│   │   ├── middleware.go               #    认证中间件
│   │   └── decrypt_middleware.go       #    Cookie 解密中间件
│   │
│   ├── 📂 cos/                         # 腾讯云 COS 客户端
│   │   ├── cos_client.go               #    COS 上传/下载封装
│   │   └── download_utils.go           #    下载工具函数
│   │
│   ├── 📂 translator/                  # 翻译引擎（工厂模式）
│   │   ├── interface.go                #    翻译器接口定义
│   │   ├── factory.go                  #    翻译器工厂
│   │   ├── manager.go                  #    翻译管理器（多引擎切换）
│   │   ├── deepseek_translator.go      #    DeepSeek 翻译实现
│   │   ├── baidu_translator.go         #    百度翻译实现
│   │   └── gemini_translator.go        #    Gemini 翻译实现
│   │
│   ├── 📂 subtitle/                    # 字幕处理
│   │   ├── ytdlp_subtitle.go           #    yt-dlp 字幕提取
│   │   └── README.md                   #    字幕格式说明
│   │
│   ├── 📂 services/                    # 第三方服务集成
│   │   ├── bilibili_account_service.go #    B站账号服务（登录、上传）
│   │   └── subtitle_service.go         #    字幕服务
│   │
│   ├── 📂 store/                       # 数据存储
│   │   ├── database.go                 #    数据库连接池
│   │   ├── migrate.go                  #    数据库迁移
│   │   ├── cache_dict.go               #    缓存字典
│   │   └── 📂 model/                   #    通用数据模型
│   │
│   ├── 📂 utils/                       # 通用工具函数
│   │   ├── crypto.go                   #    加密解密工具
│   │   ├── ffmpeg_utils.go             #    FFmpeg 工具封装
│   │   ├── file_utils.go               #    文件操作工具
│   │   ├── youtube_utils.go            #    YouTube 工具函数
│   │   ├── ytdlp_manager.go            #    yt-dlp 管理器
│   │   └── subtitle_validator.go       #    字幕验证器
│   │
│   └── 📂 logger/                      # 日志系统
│       └── logger.go                   #    Zap 日志配置
│
├── 📂 web/                             # Next.js 前端项目
│   ├── 📄 package.json                 #    前端依赖配置
│   ├── 📄 next.config.js               #    Next.js 配置
│   ├── 📄 tailwind.config.ts           #    TailwindCSS 配置
│   ├── 📄 tsconfig.json                #    TypeScript 配置
│   │
│   ├── 📂 src/
│   │   ├── 📂 app/                     #    App Router 页面
│   │   │   ├── page.tsx                #      首页（仪表盘）
│   │   │   ├── videos/                 #      视频管理页面
│   │   │   ├── accounts/               #      账号管理页面
│   │   │   └── settings/               #      设置页面
│   │   │
│   │   ├── 📂 components/              #    React 组件
│   │   │   ├── VideoCard.tsx           #      视频卡片组件
│   │   │   ├── TaskProgress.tsx        #      任务进度条
│   │   │   ├── QRCodeLogin.tsx         #      扫码登录组件
│   │   │   └── FileManager.tsx         #      文件管理器
│   │   │
│   │   ├── 📂 services/                #    API 服务层
│   │   │   ├── api.ts                  #      Axios 实例配置
│   │   │   ├── videoService.ts         #      视频 API
│   │   │   └── accountService.ts       #      账号 API
│   │   │
│   │   └── 📂 types/                   #    TypeScript 类型定义
│   │       ├── video.ts
│   │       └── account.ts
│   │
│   └── 📂 output/                      #    构建产物（静态文件）
│       ├── index.html
│       ├── _next/
│       └── static/
│
├── 📂 data/                            # 数据存储目录（运行时生成）
│   ├── videos/                         #    下载的视频文件
│   ├── subtitles/                      #    生成的字幕文件
│   ├── thumbnails/                     #    视频封面图片
│   └── temp/                           #    临时文件
│
├── 📂 cookies/                         # B站登录 Cookie 存储
└── 📂 logs/                            # 日志文件（按日期轮转）

MIT License

Copyright (c) 2026 YTB2BILI Contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software...