gingiris-github-star-growth
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseGitHub Star 持续增长实操手册
GitHub Star Sustained Growth Playbook
⚠️ Scope Differentiation:= Launch burst (0→1K in 72h). This skill = Sustained monthly growth (1K→10K→60K+).gingiris-opensource
⚠️ Scope Differentiation:= Launch burst (0→1K in 72h). This skill = Sustained monthly growth (1K→10K→60K+).gingiris-opensource
Star 地区分布 & 发布时序
Star Geographic Distribution & Launch Timeline
适用于 launch 阶段(和配合使用)gingiris-opensource
- 同一国家/地区 star 占比不超过 20%,是上 GitHub Trending 的隐性门槛。
- 工具:star-history.com(涨幅趋势)· OSS Insight(国家分布,国人开发)
- 发布时序:第一周海外宣发,第二周才做国内(朋友圈 / 中文社群)。
- AFFiNE 真实案例:开源第一周拿 6000 star,几乎全来自海外渠道。
- 陪跑好的项目节奏参考:至少提前 2-3 个月准备; 爆发期一周 4000-6000 star,三周可达 10000 star。
Applicable for the launch phase (to be used with)gingiris-opensource
- No single country/region should account for more than 20% of stars, which is an implicit threshold for getting on GitHub Trending.
- Tools: star-history.com (growth trend) · OSS Insight (geographic distribution, developed by Chinese developers)
- Launch sequence: Overseas promotion in the first week, domestic promotion (Moments / Chinese communities) only in the second week.
- AFFiNE real case: Gained 6000 stars in the first week of open-sourcing, almost all from overseas channels.
- Reference rhythm for well-supported projects: Prepare at least 2-3 months in advance; 4000-6000 stars in the burst week, reaching 10000 stars in three weeks.
Star 地域分布健康基准
Healthy Benchmark for Star Geographic Distribution
AFFiNE 开源前一周研究 VSCode / Vue / AppFlowy 等知名开源项目 star 分布总结的基准(口述回忆,数字加 ≈)
| 地区 | 健康占比 |
|---|---|
| 美国 | ≈19–21% |
| 中国 | ≈19–21% |
| 欧洲(法德意英合计) | ≈10–15% |
| Top 10 常客 | 印度、俄罗斯、巴西通常在列 |
- 硬规则:开源第一周全员禁发朋友圈,内容英文优先——防止中文圈流量污染全球化分布。AFFiNE 第一周 ≈6,000 star 的分布与知名项目基准吻合(中国 ≈19%)。
- 反例教训:第二周团队发朋友圈后,中国占比飙到 ≈35%,此后再没降下来——分布一旦被污染基本不可逆。
- 反模式:呼朋唤友第一二天刷 500-1,000 star 是舒适圈行为,会污染"全球市场试水温"的真实信号。
Benchmark summarized by researching star distributions of well-known open-source projects like VSCode / Vue / AppFlowy in the week before AFFiNE's open-sourcing (oral recall, numbers marked with ≈)
| Region | Healthy Proportion |
|---|---|
| United States | ≈19–21% |
| China | ≈19–21% |
| Europe (Combined: France, Germany, Italy, UK) | ≈10–15% |
| Top 10 Regulars | India, Russia, Brazil are usually included |
- Hard rule: No one in the team posts on Moments in the first week of open-sourcing, prioritize English content — to avoid polluting the global distribution with Chinese circle traffic. AFFiNE's ≈6,000 stars in the first week matched the benchmark of well-known projects (China ≈19%).
- Counterexample lesson: After the team posted on Moments in the second week, China's share surged to ≈35% and never dropped since — once the distribution is polluted, it's basically irreversible.
- Anti-pattern: Asking friends to get 500-1,000 stars in the first two days is a comfort zone behavior, which will pollute the real signal of "testing the global market temperature".
README 用户路径闭环(Star CTA Loop)
README User Path Loop (Star CTA Loop)
AFFiNE 开源实战 SOP:任何用户路径跳出去,都要能跳回来点 star。
- 枚举用户所有出口路径:README→官网;README→开发者文档;README→社区(Discord 等)。
- 每个出口页面都反向链接回 GitHub README:官网、文档站、社区页全部回链。
- 每个回链位置加一句 star CTA("If you like us, please give us a star on GitHub")。
- 闭环自检:沿每条路径走一遍,确认用户从任意出口都能一步跳回 repo 并看到 star 引导。
- README/官网随阶段更新:策略目标转变(如转向商业化)就即时改版,不要一成不变。
AFFiNE open-source battle-tested SOP: Any user path that jumps out must be able to jump back to click the star.
- Enumerate all user exit paths: README→official website; README→developer documentation; README→community (Discord, etc.).
- Add reverse links back to GitHub README on every exit page: Official website, documentation site, community page all link back.
- Add a star CTA at each backlink position ("If you like us, please give us a star on GitHub").
- Loop self-check: Walk through each path to confirm users can jump back to the repo in one step and see the star guide from any exit.
- Update README/official website with phases: Revise immediately when strategic goals change (e.g., shifting to commercialization), don't keep it unchanged.
Star 引流漏斗纪律
Star Traffic Funnel Discipline
- 所有渠道统一回溯 GitHub link,而非官网:Reddit / Twitter / Medium / 目录站发布的链接终点都指向 repo,保证所有流量都会看到 README 里的 star 引导。
- README 30 秒内让用户 get 价值,并直接引导点 star。
- 首周每个渠道发不同主题的 post,不是同一篇复制粘贴。
- 起量第一周每天看 GitHub Insights 的流量来源,据此决定接下来几天重点维护哪些渠道;"维护"= 去该渠道和潜在用户对话,不是 paid marketing。
- 私信对标产品的 Twitter follower list:发布日定向私信 Notion / Miro 类竞品的 follower,AFFiNE 实战转化 ≈几百个 star(口述数字)。
- 战略转移信号:star 到 ≈6,000 后不再把精力放在 GitHub 本身,转向 1v1 用户聊天 + 搭建用户社区。
- 永远不要买 star:AFFiNE 从未买星,star 涨太快时多家投资人 DD 写爬虫验证 star 来源,完全干净——买星在尽调时必被识破。
- 看增速不看绝对值:star 增速(而非总量)才是融资和 Trending 信号;GitHub Trending 有账号权限体系,非唯 star 论。
- All channels link back to GitHub instead of the official website: Links posted on Reddit / Twitter / Medium / directory sites all point to the repo, ensuring all traffic sees the star guide in the README.
- Let users get the value from README within 30 seconds, and directly guide them to click the star.
- Post different themed content on each channel in the first week, don't copy-paste the same article.
- Check GitHub Insights traffic sources every day in the first week of scaling, and decide which channels to focus on maintaining in the next few days; "maintenance" = talk to potential users on the channel, not paid marketing.
- Direct message the Twitter follower list of competing products: Send targeted DMs to followers of Notion / Miro-like competitors on launch day, AFFiNE's battle-tested conversion brought ≈hundreds of stars (oral number).
- Strategic shift signal: Stop focusing on GitHub itself after reaching ≈6,000 stars, shift to 1v1 user chats + building user communities.
- Never buy stars: AFFiNE never bought stars. When stars grew too fast, multiple investors wrote crawlers during DD to verify star sources, which were completely clean — buying stars will definitely be detected during due diligence.
- Look at growth rate not absolute value: Star growth rate (not total) is the signal for financing and Trending; GitHub Trending has an account permission system, it's not solely based on stars.
核心目标
Core Objectives
| 指标 | 月度目标 | 数据来源 |
|---|---|---|
| 月增 Star | 300+ | Client Project A 8个月辅导数据 |
| 内容产出 | 8-12篇/月 | 博客+视频+社交 |
| KOL 触达 | 60-80/月 | 每天3-4个 |
| 社区活动 | 1次线上/月 | 31-34人参与 |
| Contributor PR | 10+/月 | Good First Issues |
| Metric | Monthly Target | Data Source |
|---|---|---|
| Monthly Star Growth | 300+ | 8 months of coaching data for Client Project A |
| Content Output | 8-12 pieces/month | Blog + video + social media |
| KOL Outreach | 60-80/month | 3-4 per day |
| Community Events | 1 online event/month | 31-34 participants |
| Contributor PRs | 10+/month | Good First Issues |
月度执行框架(300 Star/Month Cadence)
Monthly Execution Framework (300 Star/Month Cadence)
1. 内容节奏
1. Content Rhythm
| 频率 | 渠道 | 内容类型 | 效果基准 |
|---|---|---|---|
| 每周 2-3 篇 | Dev.to / Medium / 官方博客 | 技术教程、用例解析、对比文章 | SEO 长尾流量 |
| 每周 1 个 | YouTube | 视频教程/Demo | 30 SGD 推流有效 |
| 每天 1-2 条 | Twitter/X | 技术向短内容、GIF、Thread | DM回复率 3-5% |
| 每周 1 篇 | 长文/案例分享 | DM回复率 10-15% |
| Frequency | Channels | Content Type | Effect Benchmark |
|---|---|---|---|
| 2-3 pieces per week | Dev.to / Medium / Official Blog | Technical tutorials, use case analysis, comparison articles | SEO long-tail traffic |
| 1 per week | YouTube | Video tutorials/Demos | 30 SGD promotion is effective |
| 1-2 posts per day | Twitter/X | Technical short content, GIFs, Threads | DM response rate 3-5% |
| 1 piece per week | Long articles/case sharing | DM response rate 10-15% |
2. 社区运营
2. Community Operations
| 渠道 | 频率 | 策略 | 转化效率 |
|---|---|---|---|
| 每周 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 + 开发者发现 |
| Channel | Frequency | Strategy | Conversion Efficiency |
|---|---|---|---|
| 2-3 posts per week | r/selfhosted, r/programming, r/MachineLearning | Direct conversion from post→Star (AFFiNE accumulated 2000+ stars) | |
| Hacker News | 1-2 times per month | Content submission via agency ($500/post, ensure HN guidelines compliance — submissions must be genuine and relevant) | Burst growth, single post can bring 200-500 stars |
| Discord/Telegram | Daily | Daily interaction, problem solving | Community retention, word-of-mouth spread |
| Dev.to / Hashnode | 1 piece per week | Cross-platform distribution | SEO + developer discovery |
3. 活动驱动增长
3. Event-Driven Growth
| 类型 | 频率 | 目标人数 | 执行要点 |
|---|---|---|---|
| 线上活动(Webinar/AMA) | 每月 1 次 | 31-34 人 | 技术分享 + Live Demo + Q&A |
| 线下活动(Meetup) | 每季度 1 次 | 70 人 | 特定市场深耕(如日本) |
| PR Challenge | 每季度 1 次 | — | Hacktoberfest / Good First Issue Sprint |
| Hackathon 赞助 | 按需 | 200-500 stars/场 | 印度学生黑客松效率最高 |
| Type | Frequency | Target Number of Participants | Execution Key Points |
|---|---|---|---|
| Online Events (Webinar/AMA) | 1 per month | 31-34 | Technical sharing + Live Demo + Q&A |
| Offline Events (Meetup) | 1 per quarter | 70 | Deep cultivation in specific markets (e.g., Japan) |
| PR Challenge | 1 per quarter | — | Hacktoberfest / Good First Issue Sprint |
| Hackathon Sponsorship | On demand | 200-500 stars per event | Highest efficiency in Indian student hackathons |
4. Contributor 体系
4. Contributor System
阶梯设计:
- Good First Issues — 标注清晰、低门槛、有 mentor 响应
- Regular Contributor — 累计 3+ PR merged → 加入 Contributors 列表
- Core Contributor — 负责特定模块 → Repo write access
- Maintainer — 代码审核权 + 社区管理权
关键动作:
- 每周标注 3-5 个 Good First Issues
- PR 24h 内首次响应
- 月度 Contributor Spotlight(社交媒体 highlight)
Ladder Design:
- Good First Issues — Clearly labeled, low threshold, with mentor responses
- Regular Contributor — Accumulate 3+ merged PRs → Join Contributors list
- Core Contributor — Responsible for specific modules → Repo write access
- Maintainer — Code review rights + community management rights
Key Actions:
- Label 3-5 Good First Issues per week
- First response to PR within 24h
- Monthly Contributor Spotlight (social media highlight)
5. Ambassador 计划
5. Ambassador Program
角色定义:社区传播者,非代码贡献者
激励:
- 专属 badge + README 致谢
- 早期功能体验权
- 年度线下活动邀请
- 推荐奖励(affiliate 模式 10-15%)
招募标准:
- 已在社交媒体自发分享过项目
- 技术社区有一定影响力(1K+ followers)
- 愿意每月产出 2+ 内容
Role Definition: Community communicators, non-code contributors
Incentives:
- Exclusive badge + README acknowledgment
- Early access to new features
- Invitation to annual offline events
- Referral rewards (10-15% affiliate model)
Recruitment Criteria:
- Has spontaneously shared the project on social media
- Has certain influence in technical communities (1K+ followers)
- Willing to produce 2+ pieces of content per month
渠道优先级矩阵
Channel Priority Matrix
| 渠道 | 适用阶段 | 效率指标 | 优先级 |
|---|---|---|---|
| 全周期 | 帖子→Star 直接转化 | ⭐⭐⭐ | |
| Hacker News | 爆发期 | $500/帖, 30 points | ⭐⭐⭐ |
| Twitter/X | 全周期 | DM回复率 3-5% | ⭐⭐⭐ |
| B2B获客 | DM回复率 10-15% | ⭐⭐ | |
| YouTube | 内容沉淀 | 30 SGD 推流有效 | ⭐⭐ |
| Dev.to | SEO长尾 | 文章可跨平台分发 | ⭐⭐ |
| Channel | Applicable Phase | Efficiency Metric | Priority |
|---|---|---|---|
| Full cycle | Direct post→Star conversion | ⭐⭐⭐ | |
| Hacker News | Burst phase | $500/post, 30 points | ⭐⭐⭐ |
| Twitter/X | Full cycle | DM response rate 3-5% | ⭐⭐⭐ |
| B2B customer acquisition | DM response rate 10-15% | ⭐⭐ | |
| YouTube | Content沉淀 | 30 SGD promotion is effective | ⭐⭐ |
| Dev.to | SEO long-tail | Articles can be distributed cross-platform | ⭐⭐ |
预算分配(月度 $2K-5K 档)
Budget Allocation (Monthly $2K-5K Tier)
| 项目 | 预算 | 预期产出 |
|---|---|---|
| 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.
| Item | Budget | Expected Output |
|---|---|---|
| HN Agency | $500-1000 | 1-2 posts, 30+ points each |
| YouTube Promotion | $100-300 | Video exposure + website clicks |
| KOL Collaboration | $500-2000 | 5-10 mid-tier KOLs |
| Event Costs | $200-500 | 1 online event + materials |
| Tool Subscriptions | $100-200 | Phantombuster, analytics tools |
Note: Automated outreach must comply with platform rate limits and anti-spam policies. Always respect opt-out requests.
数据漏斗
Data Funnel
曝光(Impression)
→ 访问 GitHub Repo(CTR 2-5%)
→ Star(访问→Star 转化率 10-30%)
→ Clone/Fork(Star 的 5-10%)
→ Contributor(Fork 的 1-5%)
→ 付费用户/Enterprise LeadImpression
→ GitHub Repo Visit (CTR 2-5%)
→ Star (Visit→Star conversion rate 10-30%)
→ Clone/Fork (5-10% of Stars)
→ Contributor (1-5% of Forks)
→ Paid User/Enterprise Lead实战 Benchmark(数据来源)
Battle-Tested Benchmarks (Data Sources)
| 项目 | 成果 | 时间线 | 关键策略 |
|---|---|---|---|
| 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 |
| Project | Outcome | Timeline | Key Strategies |
|---|---|---|---|
| AFFiNE | 10K stars in 43 days, 60K+ total | 2023-2026 | Reddit(2000+ stars) + HN + KOL + Contributor system |
| Client Project A | 0→10K stars | 8 months | Monthly 300 SOP + HN Agency + YouTube |
AFFiNE Star 时间轴(一手口径)
AFFiNE Star Timeline (Firsthand Source)
| 节点 | 数据 |
|---|---|
| 开源日 | 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 复现。
| Milestone | Data |
|---|---|
| Open-Source Date | 2022-08-03 |
| 72 Hours | ≈1,000 stars |
| First Week | ≈6,000 stars (80% from overseas) |
| 43 Days | Exceeded 10,000 stars |
| 2022-08 to 2022-12 | ≈28 times on GitHub Trending (topped the list on the 5th day of open-sourcing) |
| 24 Months | 60,000+ stars |
- Reddit Evidence: Subreddits like r/selfhosted, PKM brought tens of thousands of traffic, accumulating at least 2,000 stars (≈3-4 out of 10 posts went viral, others didn't or were removed).
- Credibility Endorsement: Zero paid marketing, never bought stars. Multiple investors wrote crawlers during DD to verify star sources, which were completely clean.
- Expectation Management (self-reported): Copying this SOP doesn't guarantee "6,000 stars in one week", but reaching 1,000–3,000 stars in 3 months is relatively easy, and other teams have already replicated it successfully.
完整 SOP 参考
Full SOP Reference
详见 references/full-sop.md — 包含日/周/月完整执行清单、模板、工具链推荐。
See references/full-sop.md — Includes complete daily/weekly/monthly execution checklists, templates, and toolchain recommendations.