Github — GitHub 开源项目全自动推广引流技能

🚀 全自动多平台推广 GitHub 开源项目：轮流宣传每个仓库、生成中英双语内容、创建推广图、定时发布到 X/V2EX/掘金/知乎/Reddit，按 Stars 升序优先推广新仓库。

✨ 核心能力

• 轮流推广：按 Stars 升序自动轮换 DaBaoAgent 下所有公开仓库，优先推广少星新仓库
• 双语内容：每个仓库自动生成中文 + 英文推广文案，3 种角度轮换（功能介绍 / 技术亮点 / 实战效果）
• 推广图审计：批量检查全部公开仓库是否具备 hero / workflow / beginner 三类图片
• 推广图生成：使用可用的 AI 生图工具生成 3 张 1280×720 推广图，审核后嵌入 README
• 多平台分发：X(Twitter) API 直发 + V2EX/掘金/知乎/Reddit 浏览器模拟
• 定时发布：支持 cron 定时任务，每天 2-3 次，不同平台错开
• 状态追踪：JSON 状态文件记录推广历史、角度索引、总次数
• 凭证自适应：无 X API 凭证时自动跳过发布，仅生成内容并保存

🚀 快速开始

检查全部仓库的推广图

# 默认检查 DaBaoAgent 下公开、非归档、非 Fork 仓库
python scripts/audit_promo_images.py

# 检查其他用户或组织，并输出 JSON
python scripts/audit_promo_images.py --owner <owner> --json

脚本按 Stars 升序输出仓库，缺少图片时返回退出码 1，便于接入定时任务或 CI。

单次推广

# 推广一个仓库到 X（自动选仓）
python scripts/promote.py --platform x --repo auto

# 推广到所有平台
python scripts/promote.py --platform all --repo auto

# 指定仓库推广
python scripts/promote.py --platform x --repo douyin-auto-publish

# 试运行（不发布）
python scripts/promote.py --platform x --repo auto --dry-run

每日定时推广

0 9 * * *  → 推广到 X（早高峰）
0 12 * * * → 推广到 掘金/V2EX（午休）
0 21 * * * → 推广到 X（晚高峰）

📋 推广策略

平台	方式	最佳时间(CN)	内容形式
X/Twitter	API 直发	9:00 / 15:00 / 21:00	短文+链接+话题标签
V2EX	浏览器模拟	10:00	技术分享帖
掘金	浏览器模拟	12:00	技术文章
知乎	浏览器模拟	20:00	问答/专栏
Reddit	浏览器模拟	8:00	英文帖子

轮换策略：按 Stars 升序排列仓库 → 每次推广 Stars 最少的仓库 → 全部轮完后重置

🎨 推广图生成

每个仓库在 assets/readme/ 下放置 3 张推广图：

图片	风格	用途
hero.webp	深蓝科技风 3D 渲染	README 主视觉横幅
workflow.webp	黑底五步流程图	展示工作流
beginner.webp	暖色新手指南	快速上手引导

优先使用当前 Agent 可用的内置生图工具；也可使用智谱 CogView-4 API（认证变量 ZAI_API_KEY）。生成后统一整理为 1280×720，并导出 PNG 与 WebP（quality=90）。先人工审核文字、主体和流程，再上传仓库。

README 顶部使用以下标记包裹三张 WebP，方便后续自动识别或替换：

<!-- README-PROMO:START -->
<p align="center">
  <img src="assets/readme/hero.webp" width="100%" />
  <img src="assets/readme/workflow.webp" width="100%" />
  <img src="assets/readme/beginner.webp" width="100%" />
</p>
<!-- README-PROMO:END -->

📁 项目结构

Github/
├── SKILL.md                        # Agent Skill 定义文件
├── scripts/
│   ├── audit_promo_images.py       # 批量检查仓库是否缺少三类推广图
│   └── promote.py                  # 推广脚本（选仓→生成内容→保存→记录状态）
├── references/
│   └── x-credentials-setup.md      # X/Twitter API 凭证配置指南
├── assets/
│   └── readme/                     # 推广图（hero/workflow/beginner）
└── README.md

🔧 依赖

• Python 3.10+
• GitHub CLI (gh) — 获取仓库列表
• X/Twitter API 凭证（可选，无则跳过 X 发布）

🤝 贡献者

• Dabao (@DaBaoAgent) — 创建与维护

📄 许可

MIT License