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

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

✨ 核心能力

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

🚀 快速开始

单次推广

# 推广一个仓库到 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	暖色新手指南	快速上手引导

使用智谱 CogView-4 API 生成，认证用 ZAI_API_KEY。

📁 项目结构

Github/
├── SKILL.md                        # Agent Skill 定义文件
├── scripts/
│   └── 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