gingiris-opensource

开源营销——GitHub Stars 增长系统

🌍 语言 / 语言：English | 中文

优秀的代码仓库本身并不会带来 Stars——只有把优秀的代码仓库按正确的顺序展示给合适的开发者，才能收获 Stars。这套分阶段决策框架曾帮助 AFFiNE 从 0 增长到 60K Stars。

案例编号与引用边界：references/podcast-evidence.md。

2026 年发布准入标准（制定任何渠道计划前先执行）

从六个关卡对每项输入进行分类：Go、Fix 或 No-Go，涵盖定位、干净环境快速入门、可复现的证明、许可证/安全/隐私、响应责任归属和商业转化。产品或文档关卡未通过时，不要试图通过增加分发来弥补。

为每个渠道建立一行运营记录：

channel | ICP | native angle | CTA | source/UTM | owner | local time + timezone |
success threshold | stop condition | evidence URL

将源表工作流设为五个关联视图：研究、内容、分发、衡量和发布控制。平台规则、价格、账号状态、创作者指标和联系人列表都要注明日期，并在发布周重新核实。

跟踪完整转化漏斗： impression -> repo visit -> install/quickstart -> activation -> D7 retained -> contribution/qualified lead -> paid。2h 时只检查运营异常；24h 时决定继续/调整/暂停；72h 时选择第二波；7d 时决定是否复用以及预算。将不可获取的原生指标标记为 data unavailable；切勿根据浏览量推断这些指标。

严格禁止：购买 Stars/账号，组织虚假或带奖励的投票，隐瞒付费关系，抓取私人数据，批量发送垃圾私信/评论，或使用 AI 冒充真实社区成员参与互动。在社区帖子中披露所属关系。

---

英文版

三阶段框架

阶段 1 — 发布前（T-30 → T-0）

• README 以英文优先；首屏内容必须能在不到 3 秒内看懂。
• 演示视频 ≤ 60s，并配有字幕。
• 审慎选择许可证（MIT / Apache-2 / AGPL 各有需要注意的事项）。
• 安排好 3–5 位早期维护者 / 贡献者。
• 社区渠道已启用（Discord 或 Telegram，以英文为主）。

阶段 2 — 发布（T-0 → T+14）

• Product Hunt（执行专门的发布流程）。
• Hacker News Show HN——周二美东时间上午 9 点，或周六。
• Reddit——选择 3 个相关版块（r/selfhosted、r/programming，以及一个细分技术版块）。
• 在 dev.to / Zenn / CSDN 发布深入的技术文章。
• 邀请 3–5 位 KOL 扩大传播（活跃度 > 粉丝数）。

阶段 3 — 增长（T+14 → T+180）

• 每周发布一篇技术博客。
• 将 GitHub Issues 转化为内容（用户问题 → FAQ → 帖子）。
• 每月更新（邮件列表 + Discord）。
• 为走向全球进行本地化（先从日本/韩国开始）。

Stars 的地域分布（用于诊断，不是 Trending 规则）

• 根据地域分布诊断传播是否符合目标市场；GitHub 并未公布 Trending 的国家占比门槛。
• 项目的历史分布是注明时间的案例证据，不是普遍适用的目标。
• 更细致的基准（在 AFFiNE 发布前一周研究 VSCode / Vue / AppFlowy 得出）：美国占 19-21%，中国约占 19-21%，法国 + 德国 + 意大利 + 英国合计占 10-15%；俄罗斯和巴西通常也会出现在国家排名前 10 中。首周 Stars 分布符合这一曲线 = 全球冷启动健康。
• 工具：star-history.com（趋势图）· oss.cool / OSS Insight（按国家细分，由中国开发者构建）
• 发布顺序：根据 ICP、支持覆盖范围和当地时区选择各波次。 优先面向海外的发布顺序是一种可测试的方案，并非获得 Trending 资格的规则。
• AFFiNE 的真实案例：第一周有意跳过了微信朋友圈 / 中国社区帖子。

README 要点（转换清单）

• 结构：大幅 Logo → 一句话介绍 → 徽章 → 简短描述（参考：Dify、Lobechat、AFFiNE）。
• 不超过 8 屏——开发文档放在单独的链接中，不要内嵌。
• 添加一个 “⭐ 提醒用户点星”GIF（和 Bilibili 的“点赞／投币／收藏”提示有相同的心理作用——用户需要一点提醒）。
• 反向链接闭环：每个指向外部的链接（网站、博客、文档）都必须有一个显眼的 GitHub 链接指回。别让流量流失，却没有回流路径。

PR 文章策略

• 发布一篇权威文章（官方博客／Medium／dev.to），全面说明项目的价值。
• 目的：为任何想推广你项目的人提供现成的宣传稿。他们无需询问就会直接使用。
• AFFiNE 案例：一位德国用户在没有事先联系的情况下，自发在 40 多个论坛发帖——这只有在存在一篇清晰的参考文章时才有可能。

基于关系的推广

• 只联系相关人士，且仅限平台允许、消息经过个性化处理、内容真实并且对方容易拒绝的情况。优先联系公开讨论过该问题或主动表示愿意了解产品的人；不要批量抓取竞品的关注者。
• 除非有注明日期的来源以及从来源到激活的证据，否则应将历史响应／转化数据视为自我报告。
• 目标：积极抱怨竞品的用户——他们已经有了转换意向。

有效的渠道顺序

英语 > 多语言 > 仅中文。 除非你的目标用户就是中文用户，否则先向中文社区推出英语项目会浪费你最好的机会。

反面做法（让你无人发现的行为）

• ❌ 刷星——GitHub 很快就能检测到；惩罚是从搜索结果中消失。
• ❌ 在 Reddit 发一次帖就离开——社区会反感，且被封禁的风险很高。
• ❌ README 里放太多表情符号／徽章——会降低可信度。
• ❌ 把 Show HN 当成一次性投稿——当天要回复每一条评论。

首日最低准备包（1 周准备期）

如果你只有 1 周时间准备（AFFiNE 于 2022-08-03 开源，当时正好只有 1 周），就只发布以下四项资产，不要做其他事：

#	资产	标准
1	一句话介绍网站	大号字体、简洁排版：首屏展示标题＋副标题＋GitHub 链接（Vercel 风格的开源软件落地页）
2	配有插图的 README	视频／GIF > 图片 > 文字；访客能在 30 秒内了解项目是什么、为什么值得关注，随后看到直接的点星号召
3	一篇竞品对比文章	“X 是一款开源的 [顶级竞品] 替代方案”——撰写一篇权威文章，并在所有渠道重复使用
4	精简的开发文档	4 个页面：我们是谁 · 功能 · 各操作系统的部署指南（macOS / Windows / Linux）· 如何贡献。粗略一些也没关系——有总比没有好

冷启动 6 步 SOP（已验证：第 1 周约获 6,000 颗星）

1. 开始行动前，研究成功的开源项目同行是如何发布的（AFFiNE 研究了 AppFlowy）。
2. 发布配有插图的 README（参见上面的准备包）。
3. 发布“开源 X 替代方案”定位文章。
4. 提交到开源替代方案目录网站。
5. 给你对标竞品的 Twitter/X 关注者发私信——这些粉丝是最精准的种子用户群。
6. 在 Reddit 和开发者社区发帖。

在同一天内集中执行第 3–6 步，制造集中曝光，然后让增长飞轮自行转动。

逆向分析竞品的发布日（Star-history 方法）

1. 在 star-history.com / OSS Insight 上查找最强竞品的确切开源日期。
2. 使用限定在当天/当周的 Google 高级搜索，还原他们发布的每一篇帖子、PR 和目录提交。
3. 制作渠道电子表格（AppFlowy 案例：约 40 个渠道——20 多个目录，如 opensourcealternative.to、Medium / dev.to、开发者论坛、Reddit），并标注免费/付费。
4. 选择近 2-3 年内发布、且你有能力追上的竞品——不要剖析已有 8 年历史的巨头。

预期管理：照搬 SOP 并不能保证一周获得 6,000 颗星，但 3 个月获得 1,000-3,000 颗星是现实的。

将开源作为融资筹码（AFFiNE 数据链）

开源前	开源后（2022-08-03）
天使轮：约 12 个月内与投资人会面约 400 次（自述）	第 1 周：≈6,000 颗星，80% 来自海外
	第 43 天：10,000 颗星
	发布约 1 个月后：锁定 800 万美元 Pre-A 轮融资
	24 个月：60K+ 颗星

• 投资人看重的是星标增长速度，而非绝对数量——增长速度才是信号。
• 投资人可能会在尽职调查期间运行爬虫，核实星标不是刷出来的；干净的历史记录本身就是一项资产。

付费模式定价测试（付费产品尚不存在时）

• 即使付费层尚未构建，也先上线定价页面——各层级可以保持模糊。为每个层级设置“联系我们”+ typeform（层级 + 问题 + 联系方式）。
• AFFiNE 的结果：2 周内收到数十条定价咨询；问题从“这是免费的吗？”转变为“价格是多少？”。意向分布约为：70% 社区免费版 / 20% 个人版 / 10% 团队版。
• 尽早告诉用户存在付费模式——越早说明，用户越早形成认知。要积极打破“开源 = 免费”的刻板印象。
• 随着策略转向普通用户，逐步减少网站上“开源 / 隐私优先”的表述，并从标语中去掉“始终免费”（AFFiNE 于 2023-02 去掉了这一表述）。

接下来怎么做

• 阶段 1 完成 → 执行 Product Hunt 发布流程。
• Show HN 成功 → 添加对“<project> github”的 SEO 监测。
• 需要内容引擎 → 转到博客撰写工作流。
• 发现竞品有新动作 → 进行竞品拆解。

---

中文版

3 阶段框架

阶段 1 — 发布前（T-30 → T-0）

• README 以英文为主，首屏内容 <3 秒即可读懂。
• Demo video ≤ 60s，带字幕。
• 选对 License（MIT / Apache-2 / AGPL 各有陷阱）。
• 找到 3–5 位早期 maintainer / contributor。
• 社群频道就位（Discord 或 Telegram，以英文为主）。

阶段 2 — 发布（T-0 → T+14）

• Product Hunt（按统一发布流程进行）。
• Hacker News Show HN — 美东时间周二上午 9 点或周六。
• Reddit — 选择 3 个相关 sub（r/selfhosted、r/programming、细分技术 sub）。
• 在 dev.to / Zenn / CSDN 发布技术深度文章。
• 找 3–5 位 KOL 转发（活跃度 > follower 数）。

阶段 3 — 增长（T+14 → T+180）

• 每周发布 1 篇技术 blog。
• 将 GitHub Issues 转化为内容素材（把用户问题变成 FAQ）。
• 每月更新 1 次（邮件列表 + Discord）。
• 出海本地化（先日韩）。

Star 地区分布与发布时序

• 同一国家/地区的 star 占比不超过 20%，否则难以上 Trending。
• 健康分布参考：中国 19-21%、美国 19-21%，其余分散在欧洲/俄罗斯/加拿大/印尼。
• 更细的基准（AFFiNE 开源前一周研究 VSCode / Vue / AppFlowy 得出）：美国 19-21%、中国约 19-21%、法德意英合计 10-15%，Top10 国家通常包括俄罗斯和巴西。第一周 star 分布符合此曲线 = 全球冷启动健康。
• 工具：star-history.com（增长趋势）· OSS Insight（国家分布，由中国人开发）
• 发布时序：第一周只做海外宣传，第二周才做国内宣传。顺序反了会破坏分布比例。
• AFFiNE 真实案例：开源第一周刻意不发朋友圈、不进入国内社群。

README 优化要点

• 结构：大 logo + 一句话介绍 + badges + 简短介绍（参考 Dify / Lobechat / AFFiNE）
• 不超过 8 屏，开发者文档单独放一个链接，不塞进 README
• 加入提醒用户点 star 的小动图（类似 B 站 UP 主的“一键三连”——用户需要被提醒）
• backlinks 循环：所有跳转出去的链接（官网/博客/文档站）都必须能跳回 GitHub，流量不能只出不回

PR 文章策略

• 准备一篇阐述项目优势的完整文章（官网 Blog / Medium / dev.to）
• 目的：给所有想帮你传播的人一把枪，让他们可以直接引用，不必自己琢磨如何介绍
• AFFiNE 案例：一位德国用户在 40 多个论坛发帖，事先没有打招呼——之所以能发出去，是因为有可供参考的文章

竞品 follower 私信

• 给竞品（Notion / Miro 等）的 Twitter follower 发私信
• 实战数据：几百条私信 → 转化出几百个 star
• 优先找“吐槽竞品”的用户，他们已经有了切换意愿

渠道顺序

英文 > 多语言 > 纯中文。 除非目标用户就是中文用户，否则先把英文项目发到中文社群，是在浪费最好的一次机会。

反模式

• ❌ 刷 star（GitHub 很快检测，后果是搜不到）。
• ❌ Reddit 只发一次就跑（社群反感，易被 ban）。
• ❌ README 太多 emoji / badge（降低可信度）。
• ❌ 把 Show HN 当一锤子买卖（要回一整天评论）。

2026 实验记录与生态分发

• 每次渠道动作都写一行实验记录：日期 / 假设 / 渠道 / 素材 / UTM / 24h结果 / 7d结果 / 下一步。Star 只作领先指标，同时看安装、首次成功运行、回访和付费意向。
• README、Demo 视频、最短可运行路径是同一条激活链；任何一步超过 3 分钟，都先修激活再放大流量。
• 把项目提交到真实相关的 Awesome Lists、包管理器、模板市场和上下游集成目录；逐站遵守投稿规则，不批量灌水、不买链接。
• 案例数字必须标注日期、样本范围和 self-reported / 可验证来源，避免把历史平台规律写成永久算法事实。

开源 Day One 四件套（一周准备期最小集）

只有一周准备时间时（AFFiNE 2022-08-03 开源，就是这个节奏），只做这四件：

#	资产	标准
1	一句话官网	字大行稀：首屏只有主标题+副标题+GitHub 链接（对标 Vercel 类开源官网）
2	图文并茂 README	能上视频/GIF 就上，退而求其次上图；30 秒内让人 get 价值，并直接引导点 star
3	一篇对标竞品文章	"X is an open source [头部竞品] alternative"——一篇权威稿全渠道复用
4	最小开发者文档集	4 篇：我们是谁 · 功能介绍 · 分系统部署（macOS / Windows / Linux）· 如何参与贡献。粗糙没关系，有比没有好

开源冷启动 6 步 SOP（实证：第一周 ≈6,000 star）

1. 先研究成功开源前辈怎么发布的（AFFiNE 学的是 AppFlowy），再动手。
2. 备好图文并茂 README（见上面四件套）。
3. 发一篇「我是 XXX 的开源替代」定位文章。
4. 提交 open-source-alternative 类导航站。
5. 私信对标竞品的 Twitter/X 粉丝——竞品粉丝就是最精准的种子池。
6. Reddit 和开发者社区发帖。

第 3-6 步一天之内集中铺完，打出声量后等飞轮。

star-history 逆向工程竞品开源日

1. 在 star-history.com / OSS Insight 查最强竞品的开源日期。
2. Google 高级搜索限定那一天/那一周，还原竞品当天发的所有帖子、PR、导航站提交。
3. 拉渠道大表（AppFlowy 案例约 40 个渠道：20+ 导航站如 opensourcealternative.to、Medium / dev.to、开发者论坛、Reddit），标注免费/付费。
4. 选近 2-3 年发布、体量"勾勾手够得着"的竞品，别拆 8 年前的老巨头。

预期管理：照抄 SOP 不保证一周 6,000 star，但 3 个月 1,000-3,000 star 相对容易。

开源撬动融资（AFFiNE 数据链）

开源前	开源后（2022-08-03）
天使轮：见了 ~400 个投资人、耗时约 12 个月（口述口径）	第一周：≈6,000 star，80% 来自海外
	第 43 天：破 1 万 star
	开源后约 1 个月：锁定 $8M Pre-A
	24 个月：60K+ star

• 投资人真正买单的是 star 增速而非绝对值——速度才是信号。
• 投资人 DD 时可能写爬虫验证 star 是否刷量，干净的历史本身就是资产。

商业化 pricing test（付费版还没做出来就能测）

• 商业版没做出来也先挂 pricing 页——档位可以写得模糊，每档配 contact us + typeform（选档位+问题+联系方式）。
• AFFiNE 结果：两周收到几十个问价；咨询口径从「这免费吗」变成「大概多少钱」。意向比例 ≈ 70% community free / 20% 个人版 / 10% team 版。
• 及早告诉用户产品有付费模式——越早说，用户越早建立付费认知；主动对抗「open source = free」刻板印象。
• 战略转向 general user 后，官网上 "open source / privacy-first" 字样逐步变小，tagline 去掉 "always free"（AFFiNE 于 2023-02 改掉）。

---

By Iris (生姜 Iris) · ex-COO @ AFFiNE (0 → 60k★) · Install: npx skills add Gingiris-1031/gingiris-opensource

加入出海社群与购买资料包 · Community & Resources

• 加入出海社群： 微信添加 staywildgrow，留言「加入社群」即可。

• 购买资料包： 微信添加 staywildgrow，咨询购买 Gingiris 出海资料包，价格 599 元人民币。

• Join the global growth community: Add staywildgrow on WeChat and send “加入社群” (join the community).

• Get the resource pack: Add staywildgrow on WeChat to purchase the Gingiris global growth resource pack for CNY 599.

社群与资料包为可选入口，不影响本开源 Skill 的安装和使用。

The community and paid resource pack are optional; neither is required to install or use this open-source skill.