P104 darkzOGx/youtube-automation-agent

信息卡

项目	内容
仓库	darkzOGx/youtube-automation-agent
语言 / 许可证	JavaScript / MIT
总星标	⭐ 2658
本月净增星标	+966
榜单	星标增速榜第22名（相对增速视角排名）

一句话定位

AgentTube（内部代号 Lumen）：一个把选题研究、写稿、配音、成片、元数据优化、审核、排期、发布到数据学习全链条打通的开源 YouTube 频道自动化运营员。

增速解读：为什么涨这么快

总星 2658、月增 966，增速比约 57%，体量已过两千仍能保持这个斜率并不容易。"AI 自动做视频频道"是流量密码级题材，但同类项目大多停留在"生成一条视频"，而它把真正的运营纪律代码化了：审批优先（approval-first）、发布失败即停止（fail-closed）、事实声明必须挂已验证来源、评论草稿须人工批准——这些克制性设计和它"全自动"的名声形成反差，吸引了认真评估可行性的观众而非纯围观党。v2.10.0 引入的 SEO 可发现性适配层和带置信度判定的增长实验又给了老用户持续回访的理由。

核心功能拆解

自主频道运营商：设定目标/受众/支柱/节奏后自动产出内容计划。
八 Agent 流水线：Content Strategy → Script Writer → Thumbnail Designer / SEO Optimizer → Production → Discoverability Preflight → Review & Approval Gates → Publishing & Scheduling → Analytics，分析结果反馈回策略层。
生产就绪探活：验证文本/语音/YouTube 访问/MP4 编解码可用性而不实际上传。
断点续跑：每阶段写 SQLite 检查点，可按 jobId resume 或单阶段重生成。
Scene Repair Studio：单场景重生成、锁定与素材替换；Shorts 工作室一键产 3 个 9:16 MP4+SRT 草稿。
证据台（Evidence desk）：无来源的事实声明无法通过审核。
可控增长实验：轮换标题/缩略图，95% 置信阈值判定 CTR 胜者。
评论治理：主题分类、垃圾评论隔离（不删评）。

架构与技术栈浅析

Node.js ≥ 18 + Express 服务（默认端口 3456），agents/config/database/data/schedules 目录分明，SQLite 存储任务状态。文本模型高度可插拔：README 列出 OpenAI GPT-5.6 家族、Gemini 3.7 Flash/3.1 Pro Preview、Kimi K3/K2.7 Code、MiMo V2.5 Pro、GLM-5.3/5.2/5.1、OpenRouter 400+ 模型、Ollama 本地及任意 OpenAI 兼容端点。TTS 用 ElevenLabs v3 并可回退 OpenAI TTS 至模拟模式；图像用 Gemini 3.1 Flash Image/GPT Image 2；视频默认本地幻灯片渲染 + FFmpeg 合成，可选 Seedance 2.5（Replicate）、MiniMax-H3、Kling v3 Omni、Wan 2.7 等，长片走混合装配。

安装与环境要求

Node.js 18+；Google 账号 + YouTube Data API v3 OAuth 凭证存为 config/credentials.json；至少一个文本模型密钥；FFmpeg 由 ffmpeg-static 自动安装；Python 3.9+ 仅在启用 DarkzSEO 审计时需要。

快速上手示例

git clone https://github.com/darkzOGx/youtube-automation-agent.git
cd youtube-automation-agent && npm install
npm run walkthrough   # 引导式配置
npm start             # 打开 http://localhost:3456

.env 至少填一个密钥（OPENAI_API_KEY / GEMINI_API_KEY / MOONSHOT_API_KEY 等），并设 CHANNEL_NAME、TARGET_AUDIENCE；发布保护开关 DEFAULT_PRIVACY_STATUS=private。

进阶使用要点

调度器开箱即自动运转：06:00 生成内容、每 15 分钟处理发布队列、09:00 收集分析、22:00 优化，周日策略复盘。
通过 `POST /api/content/:id/approve` 放行时内容必须携带 factChecked 与 rightsConfirmed 标记。
视频提供商切换用 VIDEO_PROVIDER=slideshow/auto/seedance/kling 等，配合 VIDEO_GENERATION_MODE=hybrid 控制成本。
建议保留 API_KEY 保护性配置，避免本机服务被局域网滥用。

典型应用场景

个人知识频道无人值守日更试验场。
多语言矩阵频道的低成本批量试点。
教育/研究用途的内容流水线教学案例（八段式架构非常清晰）。
视频外包团队的初稿加速器，人工只做终审。

资源导航

仓库：https://github.com/darkzOGx/youtube-automation-agent ；LICENSE 为 MIT；可发现性审计依赖外部 DarkzSEO 1.4+ 项目（shell-free Python 子进程交互）。

darkzOGx/youtube-automation-agent

信息卡