开源榜单转抖音排行榜图文

你将学到什么

你将学到开源抖音导出命令的数据来源：weekly 正式库 JSON、Top AI 项目筛选、社交化导语段落，以及 ranking 总图加单项目卡片的输出布局。学完能固定每周出一条开源周榜图文系列。发布门禁要求中文简介与部署说明达标，否则导出图里会出现空白描述——应先完成后台中文发布再导出。ranking 总图 star 数只做视觉参考，口播说明「以仓库描述为准」。若某项目 deployGuide 为空，导出前在后台补一句中文部署提示，否则卡片下半留白。

适合谁

适合科技自媒体、开发者运营账号，想把 GitHub Trending 信息转成中文读者看得懂的图解，而不是英文截图直发。

不适合谁

不适合不做中文导语、只想贴 Star 数的账号；脚本依赖已富化的 `descriptionZh` 等字段，缺中文会被发布门禁挡在正式库外。 若你团队已有成熟流程，可把本课当对照表查漏补缺，不必推翻现有系统。

跟做步骤

1. 1先刷新榜单：`npm run refresh:opensource -- weekly`，再在后台通过中文质量门禁发布到 `src/data/opensource/weekly.json`。 weekly 发布后再跑 export，避免 Trending 与正式库周次不一致。
2. 2执行 `npm run export:opensource-douyin -- weekly`（或 daily/monthly），输出到 `exports/opensource-weekly-日期/`。 ranking 图放首图，口播先讲第 1 名再引导翻页，降低信息过载。
3. 3用 ranking.png 做首图，单项目 PNG 按 manifest 顺序发图文集；口播重点讲 1～3 名，其余引导「图集翻页」。 中文导语缺省的项目在后台补一句「适合谁」，再导出单卡。
4. 4水印与品牌字样在脚本常量里统一配置，避免每张图手工 PS。 ranking 总图 star 数只做视觉参考，口播说明「以仓库描述为准」。若某项目 deployGuide 为空，导出前在后台补一句中文部署提示，否则卡片下半留白。 manifest 里记录 repo 全名，评论区可贴 GitHub 链接方便观众溯源。

常见踩坑

未发布正式库就跑导出，图里是旧榜或空榜。简介过长会撑破版式，导语保持 2～3 句。GitHub 证书错误时需配置本机 CA，Actions 环境要单独验证。周榜视频口播建议只深讲前三名，其余引导观众翻图集，与钩子脚本课搭配使用。 周榜视频封面优先用 ranking 总图，单卡图放图集第 2～9 张，第 1 张用总榜更易吸引点击。

本课小结

带走周更节奏：刷新榜单 → 中文门禁发布 → 导出 PNG → 抖音图集。数据真源在仓库 JSON，导出只是呈现层。 下一课可继续本系列实战，把模板保存为团队默认文档。