gingiris-github-star-growth

GitHub Star 持续增长实操手册

⚠️ Scope Differentiation: gingiris-opensource = Launch burst (0→1K in 72h). This skill = Sustained monthly growth (1K→10K→60K+).

---

2026 执行覆盖条款

先检查 Go / Fix / No-Go：Quick Start 是否由陌生开发者验证、Demo 是否可复现、 License/安全/隐私是否清楚、Issues/PR/社区是否有 owner、是否跟踪 activation/D7/ contributor/qualified lead。No-Go 时停止冲量，先修产品与文档。

统一看板字段：date | source | content URL | spend | repo views | stars | installs | activated | D7 retained | contributors | qualified leads | evidence strength。 2h 只排异常，24h 决定继续/改角度/暂停，72h 选第二波，7d 决定长期复用。 原生数据拿不到写 数据不可用。

禁止买 Star/账号、刷票、激励或协调虚假 Upvote、隐性付费合作、批量抓取并骚扰、 AI 冒充真人互动。平台规则、KOL 报价、账号数据与转化率必须带日期并在执行周复核。

Star 地区分布 & 发布时序（诊断信号，不是 Trending 规则）

适用于 launch 阶段（和 gingiris-opensource 配合使用）

• GitHub 未公开“单一国家/地区占比不超过 20%”的 Trending 门槛；只把地域分布 用于判断流量是否匹配目标市场。
• 工具：star-history.com（涨幅趋势）· OSS Insight（国家分布，国人开发）
• 发布时序按 ICP、支持覆盖和时区设计；“首周海外、次周国内”只是一种可测试方案。
  • AFFiNE 真实案例：开源第一周拿 6000 star，几乎全来自海外渠道。
• 陪跑好的项目节奏参考：至少提前 2-3 个月准备； 爆发期一周 4000-6000 star，三周可达 10000 star。

Star 地域分布健康基准

AFFiNE 开源前一周研究 VSCode / Vue / AppFlowy 等知名开源项目 star 分布总结的基准（口述回忆，数字加 ≈）

地区	健康占比
美国	≈19–21%
中国	≈19–21%
欧洲（法德意英合计）	≈10–15%
Top 10 常客	印度、俄罗斯、巴西通常在列

• AFFiNE 的阶段分布属于特定历史案例，使用时标记为口述/项目证据，不外推为算法规则。
• 反模式：为了数字组织与目标用户无关的集中点 Star；它会扭曲市场验证，也可能触发平台风控。

---

README 用户路径闭环（Star CTA Loop）

AFFiNE 开源实战 SOP：任何用户路径跳出去，都要能跳回来点 star。

1. 枚举用户所有出口路径：README→官网；README→开发者文档；README→社区（Discord 等）。
2. 每个出口页面都反向链接回 GitHub README：官网、文档站、社区页全部回链。
3. 每个回链位置加一句 star CTA（"If you like us, please give us a star on GitHub"）。
4. 闭环自检：沿每条路径走一遍，确认用户从任意出口都能一步跳回 repo 并看到 star 引导。
5. README/官网随阶段更新：策略目标转变（如转向商业化）就即时改版，不要一成不变。

---

Star 引流漏斗纪律

• 所有渠道统一回溯 GitHub link，而非官网：Reddit / Twitter / Medium / 目录站发布的链接终点都指向 repo，保证所有流量都会看到 README 里的 star 引导。
• README 30 秒内让用户 get 价值，并直接引导点 star。
• 首周每个渠道发不同主题的 post，不是同一篇复制粘贴。
• 起量第一周每天看 GitHub Insights 的流量来源，据此决定接下来几天重点维护哪些渠道；"维护"= 去该渠道和潜在用户对话，不是 paid marketing。
• 关系型精准触达：只联系公开讨论相关问题或同意接收产品信息的人，逐条个性化， 遵守平台限制并提供退出方式；不要批量抓取竞品 follower 后群发。历史转化数字须标为口述证据。
• 战略转移信号：star 到 ≈6,000 后不再把精力放在 GitHub 本身，转向 1v1 用户聊天 + 搭建用户社区。
• 永远不要买 star：AFFiNE 从未买星，star 涨太快时多家投资人 DD 写爬虫验证 star 来源，完全干净——买星在尽调时必被识破。
• 看增速不看绝对值：star 增速（而非总量）才是融资和 Trending 信号；GitHub Trending 有账号权限体系，非唯 star 论。

---

核心目标

指标	月度目标	数据来源
月增 Star	300+	Client Project A 8个月辅导数据
内容产出	8-12篇/月	博客+视频+社交
KOL 触达	60-80/月	每天3-4个
社区活动	1次线上/月	31-34人参与
Contributor PR	10+/月	Good First Issues

---

月度执行框架（300 Star/Month Cadence）

1. 内容节奏

频率	渠道	内容类型	效果基准
每周 2-3 篇	Dev.to / Medium / 官方博客	技术教程、用例解析、对比文章	SEO 长尾流量
每周 1 个	YouTube	视频教程/Demo	30 SGD 推流有效
每天 1-2 条	Twitter/X	技术向短内容、GIF、Thread	DM回复率 3-5%
每周 1 篇	LinkedIn	长文/案例分享	DM回复率 10-15%

2. 社区运营

渠道	频率	策略	转化效率
Reddit	每周 2-3 帖	r/selfhosted, r/programming, r/MachineLearning	帖子→Star 直接转化（AFFiNE 累计 2000+ stars）
Hacker News	每月 1-2 次	Content submission via agency ($500/post, ensure HN guidelines compliance — submissions must be genuine and relevant)	爆发式，单帖可带 200-500 stars
Discord/Telegram	每天	日常互动、问题解答	社区留存、口碑传播
Dev.to / Hashnode	每周 1 篇	跨平台分发	SEO + 开发者发现

3. 活动驱动增长

类型	频率	目标人数	执行要点
线上活动（Webinar/AMA）	每月 1 次	31-34 人	技术分享 + Live Demo + Q&A
线下活动（Meetup）	每季度 1 次	70 人	特定市场深耕（如日本）
PR Challenge	每季度 1 次	—	Hacktoberfest / Good First Issue Sprint
Hackathon 赞助	按需	200-500 stars/场	印度学生黑客松效率最高

4. Contributor 体系

阶梯设计：

1. Good First Issues — 标注清晰、低门槛、有 mentor 响应
2. Regular Contributor — 累计 3+ PR merged → 加入 Contributors 列表
3. Core Contributor — 负责特定模块 → Repo write access
4. Maintainer — 代码审核权 + 社区管理权

关键动作：

• 每周标注 3-5 个 Good First Issues
• PR 24h 内首次响应
• 月度 Contributor Spotlight（社交媒体 highlight）

5. Ambassador 计划

角色定义：社区传播者，非代码贡献者

激励：

• 专属 badge + README 致谢
• 早期功能体验权
• 年度线下活动邀请
• 推荐奖励（affiliate 模式 10-15%）

招募标准：

• 已在社交媒体自发分享过项目
• 技术社区有一定影响力（1K+ followers）
• 愿意每月产出 2+ 内容

---

渠道优先级矩阵

渠道	适用阶段	效率指标	优先级
Reddit	全周期	帖子→Star 直接转化	⭐⭐⭐
Hacker News	爆发期	$500/帖, 30 points	⭐⭐⭐
Twitter/X	全周期	DM回复率 3-5%	⭐⭐⭐
LinkedIn	B2B获客	DM回复率 10-15%	⭐⭐
YouTube	内容沉淀	30 SGD 推流有效	⭐⭐
Dev.to	SEO长尾	文章可跨平台分发	⭐⭐

---

预算分配（月度 $2K-5K 档）

项目	预算	预期产出
HN Agency	$500-1000	1-2 帖, 各 30+ points
YouTube 推流	$100-300	视频曝光 + 网站点击
KOL 合作	$500-2000	5-10 个中腰部 KOL
活动费用	$200-500	1次线上 + 物料
工具订阅	$100-200	Phantombuster、分析工具

Note: Automated outreach must comply with platform rate limits and anti-spam policies. Always respect opt-out requests.

---

数据漏斗

曝光（Impression）
  → 访问 GitHub Repo（CTR 2-5%）
    → Star（访问→Star 转化率 10-30%）
      → Clone/Fork（Star 的 5-10%）
        → Contributor（Fork 的 1-5%）
          → 付费用户/Enterprise Lead

---

实战 Benchmark（数据来源）

项目	成果	时间线	关键策略
AFFiNE	10K stars in 43 days, 60K+ total	2023-2026	Reddit(2000+ stars) + HN + KOL + Contributor体系
Client Project A	0→10K stars	8 个月	月度300 SOP + HN Agency + YouTube

AFFiNE Star 时间轴（一手口径）

节点	数据
开源日	2022-08-03
72 小时	≈1,000 star
第一周	≈6,000 star（80% 来自海外）
43 天	破 10,000 star
2022-08 至 2022-12	≈28 次登上 GitHub Trending（开源第 5 天登顶）
24 个月	60,000+ star

• Reddit 实证：r/selfhosted、PKM 等子版块带来几万流量，累计转化至少 2,000 star（≈10 帖火 3-4 帖，其余没火或被 remove）。
• 可信度背书：全程零 paid marketing、从未买星，多家投资人 DD 时写爬虫验证 star 来源，完全干净。
• 预期管理（self-reported）：复制该 SOP 不保证"一周 6,000 star"，但 3 个月做到 1,000–3,000 star 相对容易，已有其他团队按 SOP 复现。

---

完整 SOP 参考

详见 references/full-sop.md — 包含日/周/月完整执行清单、模板、工具链推荐。