Y2A-Auto

将 YouTube 视频自动搬运到 AcFun / bilibili 的一体化工具。

从下载、ASR、字幕翻译、字幕质检、内容审核到上传，全流程自动化；内置 Web 管理后台、YouTube 监控和维护能力。

快速开始 · 功能概览 · 部署与运行 · 配置说明 · 使用指南 · 常见问题

---

Telegram 转发机器人（试用）： @Y2AAuto_bot
_{自部署版本：Y2A-Auto-tgbot}

• 自动化流水线
  • yt-dlp 下载视频与封面
  • 自动或按需进行语音识别生成字幕，支持 Whisper、Voxtral、FireRedASR2S
  • 字幕翻译、字幕后处理、字幕质检（QC）与字幕烧录
  • AI 生成标题、简介、标签与分区推荐
  • 内容安全审核（阿里云 Green）
  • 自动上传到 AcFun / bilibili / 双平台
• Web 管理后台
  • 任务列表、人工审核、强制上传
  • 设置中心分组管理：运行概览、账号与网络、内容审核、AI 模型、字幕处理、语音识别、视频转码、监控与维护、安全
  • 登录保护、错误次数锁定和密码管理
• YouTube 监控
  • 频道监控与关键词搜索监控
  • 支持 latest / historical 模式、视频类型筛选和自动加入任务队列
  • 内置历史记录与配置文件恢复
• 视频转码
  • 支持 CPU / NVIDIA / Intel / AMD 硬件编码
  • 默认优先 HEVC / H.265，失败后自动回退到 H.264
• 维护与环境
  • Windows 可自动补齐 FFmpeg
  • 支持日志清理、下载清理和自定义 FFmpeg 路径

Y2A-Auto/
├── app.py
├── requirements.txt
├── Dockerfile
├── docker-compose.yml
├── docker-compose-build.yml
├── build-tools/
├── config/
├── cookies/
├── db/
├── downloads/
├── ffmpeg/
├── fonts/
├── logs/
├── modules/
├── static/
├── temp/
└── templates/

推荐使用 Docker（无需手动安装 Python、FFmpeg、yt-dlp）。

1. 准备 Cookie（必须）

• cookies/yt_cookies.txt：YouTube 登录 Cookie
• cookies/ac_cookies.json：AcFun 登录 Cookie
• cookies/bili_cookies.json：bilibili 登录 Cookie
• 可使用浏览器扩展导出 cookies.txt，请勿提交到仓库

2. 启动服务

# 默认从 Docker Hub 拉取镜像 fqscfqj/y2a-auto:latest
# 如需使用 GitHub 容器注册表，可切换为 ghcr.io/fqscfqj/y2a-auto:latest
docker compose up -d

3. 打开 Web

• 访问 http://localhost:5000
• 首次进入建议先配置登录保护、平台账号和 YouTube Cookie

默认会持久化目录：config/、db/、downloads/、logs/、temp/、cookies/。

说明：fonts/ 中的字体属于项目内置依赖，用于字幕烧录；许可证见 fonts/LICENSE.txt。

• 启动：docker compose up -d
• 停止：docker compose down
• 重启：docker compose restart
• 日志：docker compose logs -f

如需本地构建镜像，可使用：

docker compose -f docker-compose-build.yml up -d --build

前置要求：

• Python 3.11+
• FFmpeg
• yt-dlp

py -3.11 -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python app.py

访问 http://127.0.0.1:5000。

• build-tools/ 提供 Windows 可执行文件构建工具
• 官方 Windows Release 包通常已内置 FFmpeg / FFprobe
• 如果手工打包，保持 ffmpeg/ 目录完整即可

首次运行会自动生成 config/config.json。推荐先配置以下几类参数：

• AUTO_MODE_ENABLED：无人值守自动投稿总开关，默认 false
• password_protection_enabled：Web 密码保护，默认 false
• LOGIN_MAX_FAILED_ATTEMPTS：连续错误次数上限，默认 5
• LOGIN_LOCKOUT_MINUTES：锁定时长，默认 15
• UPLOAD_TARGET_DEFAULT：默认投稿平台，支持 acfun、bilibili、both
• UPLOAD_APPEND_REPOST_NOTICE：是否自动追加转载声明，默认 true

• YOUTUBE_COOKIES_PATH：YouTube Cookie 路径
• ACFUN_COOKIES_PATH：AcFun Cookie 路径
• BILIBILI_COOKIES_PATH：bilibili Cookie 路径
• YOUTUBE_PROXY_ENABLED / YOUTUBE_PROXY_URL：YouTube 下载代理
• YOUTUBE_DOWNLOAD_THREADS：下载线程数
• YOUTUBE_THROTTLED_RATE：下载速度限制
• YOUTUBE_API_KEY：YouTube Data API v3 密钥，监控功能需要
• FFMPEG_LOCATION：自定义 FFmpeg 路径
• FFMPEG_AUTO_DOWNLOAD：Windows 缺失时自动下载 FFmpeg，默认 true

• OPENAI_API_KEY / OPENAI_BASE_URL / OPENAI_MODEL_NAME：全局 AI 配置
• OPENAI_THINKING_ENABLED：全局思考模式开关
• SUBTITLE_OPENAI_*：字幕翻译专用覆盖配置，留空则回退全局
• SUBTITLE_QC_*：字幕质检专用覆盖配置，留空则回退字幕翻译 / 全局配置
• TRANSLATE_TITLE / TRANSLATE_DESCRIPTION / GENERATE_TAGS：自动生成标题、简介、标签
• RECOMMEND_PARTITION：自动推荐分区
• FIXED_PARTITION_ID / FIXED_PARTITION_ID_BILIBILI：固定分区
• YOUTUBE_UPLOADER_AS_FIRST_TAG：将上传者作为首标签

• SUBTITLE_TRANSLATION_ENABLED：启用字幕翻译，默认 false
• SUBTITLE_SOURCE_LANGUAGE：源语言，默认 auto
• SUBTITLE_TARGET_LANGUAGE：目标语言，默认 zh
• SUBTITLE_FONT_NAME：烧录字幕字体名，默认 SourceHanSansHWSC-VF.otf
• SUBTITLE_BATCH_SIZE：翻译批次大小
• SUBTITLE_MAX_RETRIES / SUBTITLE_RETRY_DELAY：翻译重试策略
• SUBTITLE_EMBED_IN_VIDEO：是否将字幕嵌入视频
• SUBTITLE_KEEP_ORIGINAL：是否保留原始字幕文件
• SUBTITLE_MAX_WORKERS：字幕翻译并发线程数

• SPEECH_RECOGNITION_ENABLED：是否启用语音识别生成字幕，默认 false
• SPEECH_RECOGNITION_PROVIDER：支持 whisper、voxtral、fireredasr
• VAD_ENABLED：VAD 语音扫描窗，默认 true
• ASR_WORD_TIMESTAMPS_ENABLED：优先请求词级时间戳，默认 true
• WHISPER_FALLBACK_TO_FIXED_CHUNKS：VAD 失败时是否回退到固定分片，默认 false
• WHISPER_LANGUAGE / WHISPER_PROMPT / WHISPER_TRANSLATE：Whisper 专用参数
• VOXTRAL_TIMESTAMP_GRANULARITIES：默认 segment,word
• VOXTRAL_DIARIZE / VOXTRAL_CONTEXT_BIAS / VOXTRAL_LANGUAGE
• VOXTRAL_MAX_AUDIO_DURATION_S / VOXTRAL_LONG_AUDIO_MARGIN_S / VOXTRAL_ENFORCE_MAX_DURATION
• FIREREDASR_BASE_URL / FIREREDASR_API_KEY / FIREREDASR_TIMEOUT

• VIDEO_ENCODER：auto / cpu / nvidia / intel / amd
• VIDEO_CUSTOM_PARAMS_ENABLED / VIDEO_CUSTOM_PARAMS：自定义 FFmpeg 参数
• MAX_CONCURRENT_TASKS：最大并发任务数，默认 2
• MAX_CONCURRENT_UPLOADS：最大并发上传数，默认 1
• LOG_CLEANUP_ENABLED / LOG_CLEANUP_HOURS / LOG_CLEANUP_INTERVAL
• DOWNLOAD_CLEANUP_ENABLED / DOWNLOAD_CLEANUP_HOURS / DOWNLOAD_CLEANUP_INTERVAL

{
  "AUTO_MODE_ENABLED": false,
  "password_protection_enabled": false,
  "password": "",
  "UPLOAD_TARGET_DEFAULT": "acfun",
  "OPENAI_API_KEY": "",
  "OPENAI_BASE_URL": "https://api.openai.com/v1",
  "OPENAI_MODEL_NAME": "gpt-3.5-turbo",
  "OPENAI_THINKING_ENABLED": false,
  "SUBTITLE_TRANSLATION_ENABLED": false,
  "SUBTITLE_QC_ENABLED": false,
  "SPEECH_RECOGNITION_ENABLED": false,
  "SPEECH_RECOGNITION_PROVIDER": "whisper",
  "VAD_ENABLED": true,
  "VIDEO_ENCODER": "auto",
  "FFMPEG_AUTO_DOWNLOAD": true,
  "MAX_CONCURRENT_TASKS": 2,
  "MAX_CONCURRENT_UPLOADS": 1
}

启用 SUBTITLE_QC_ENABLED: true 后，系统会对 ASR 生成的源字幕做预检：

• SUBTITLE_QC_THRESHOLD：AI 复核分数下限（0 ~ 1，默认 0.60）
• SUBTITLE_QC_SAMPLE_MAX_ITEMS：AI 抽样条目上限，默认 80
• SUBTITLE_QC_MAX_CHARS：AI 单次送检最大字符数上限，默认 9000
• SUBTITLE_QC_MODEL_NAME：单独指定 QC 模型，留空则复用字幕翻译 / 全局模型

QC 会先用规则做硬拦截，只有边界样本才会调用 AI 严格复核。

命中署名行、噪声提示、界面操作词、模板化重复句等明显低质量字幕时，会在规则层直接失败，不再进入宽松放行。

可疑样本在 AI 不可用、返回异常或输出不合规时，默认按失败处理。QC 失败时会跳过烧录字幕，但仍保留字幕文件并继续上传原视频，任务最终标记为完成，并显示字幕异常标记。

当前支持三类 ASR 提供商：

• Whisper：兼容 OpenAI 风格接口，可使用独立的 API Key、Base URL 和模型名
• Voxtral：Mistral /v1/audio/transcriptions，默认模型为 voxtral-mini-latest
• FireRedASR2S：适用于自建 /v1/process_all 服务

建议优先保持 VAD_ENABLED=true。当前默认采用质量优先的扫描窗参数，分片更短、重叠更小，便于提升字幕边界精度。

如果 VAD 结果不理想，系统会自动进入分片或整段兜底流程；WHISPER_FALLBACK_TO_FIXED_CHUNKS 目前保留为兼容配置项，主要用于配置迁移和界面控制。

• 项目默认内置 SourceHanSansHWSC-VF.otf，作为字幕烧录依赖随仓库一起分发
• 可通过 SUBTITLE_FONT_NAME 指定 fonts/ 目录中的字体文件名；程序会读取该文件的真实字体名供 libass 使用
• 字体许可证位于 fonts/LICENSE.txt

1. 在首页或任务页提交 YouTube 链接创建任务。
2. 自动模式下流程为：下载 -> ASR / 字幕处理（可选） -> AI 元信息 -> 审核 -> 上传目标平台。
3. 在人工审核页可调整标题、简介、标签、分区并强制上传。
4. 启用 YouTube 监控后，可按频道或关键词定时拉取任务，并自动加入任务队列。
5. 在设置页可分组维护账号、AI、字幕、ASR、转码、维护与安全项。

• 默认优先使用项目内 ffmpeg/ 目录中的二进制
• Windows 环境下如果 ffmpeg/ 缺失，系统可自动下载并补齐
• FFMPEG_LOCATION 可覆盖默认路径，支持直接指向 ffmpeg.exe 或其所在目录
• VIDEO_ENCODER=cpu 时使用 libx264（H.264）
• VIDEO_ENCODER=auto|nvidia|intel|amd 时优先使用 HEVC / H.265 硬件编码：
  • NVIDIA：hevc_nvenc
  • Intel：hevc_qsv
  • AMD（Windows）：hevc_amf
  • AMD（Linux）：hevc_vaapi
• 如果 HEVC 硬编不可用或转码失败，会自动回退到 libx264（H.264）

NVIDIA（推荐）：

# 在 docker-compose.yml 内取消以下注释即可启用：
# gpus: all
# environment:
#   - NVIDIA_VISIBLE_DEVICES=all
#   - NVIDIA_DRIVER_CAPABILITIES=compute,video,utility

Intel / AMD（Linux）：

devices:
  - /dev/dri:/dev/dri
group_add:
  - video
  - render

NVIDIA 专用覆盖文件已移除，相关配置已直接集成到主 docker-compose.yml。

• 需要先配置 YOUTUBE_API_KEY
• 支持关键词搜索、指定频道、历史搬运和持续跟进最新模式
• 支持视频类型筛选：video / short / live
• 可设置自动添加到任务队列，并保留监控历史记录
• 配置文件会保存到 config/youtube_monitor/，历史数据库位于 db/youtube_monitor.db

• 403 / 需要登录 / not a bot
  • 通常是 YouTube 反爬或权限问题，更新 cookies/yt_cookies.txt
• 找不到 FFmpeg / yt-dlp
  • Docker 环境通常无需处理；本地运行请确保 PATH 正确
  • 如果使用 Windows Release 包，通常不应出现缺失 FFmpeg；若出现，请确认 ffmpeg/ 未被安全软件隔离
• 上传 AcFun 失败
  • 更新 cookies/ac_cookies.json，并检查人工审核页元信息是否合规
• 字幕翻译慢
  • 调整并发与批量大小，同时注意 API 限速
• Docker 未启用 NVENC
  • 检查 docker-compose.yml 中 GPU 部分是否已取消注释
  • 确认主机已安装 nvidia-container-toolkit

• 欢迎提交 Issue / PR：../../issues
• 请勿提交包含 Cookie、密钥等敏感信息的文件

• acfun_upload
• yt-dlp
• FFmpeg
• Flask
• OpenAI

本项目基于 GNU GPL v3 开源。请遵守相关平台条款，仅在合法合规前提下用于学习与研究。