你把代码仓库设为公开,却几乎没有人使用。关于推广开源项目的建议,大多是一份可以发帖的地方清单,加上几年前写的获取更多 GitHub star 的技巧。如今 star 已经很容易造假:一项在 ICSE 2026 上发表的研究估计 GitHub 上有六百万个疑似虚假 star,并发现买来的热度会在大约两个月内消退。本指南讲的是:应该推广什么而不是 star、先面向哪类受众、一份依据 GitHub 自身限制的代码仓库检查清单、哪种渠道适合哪类项目、会适得其反的推广方式、一个 30 天计划、一份可以直接复制的每周发布台账,以及如果项目属于一家初创公司,用户如何转化为客户。即使没有 Soloop 账户,本指南也同样有用。
简短回答
要推广一个开源项目,先为一类用户和一个问题而写,让 README 和快速上手指南在几分钟内帮这个人得到可用的结果,然后在这些用户已经在交流的一个地方发布。接着与试用过的人交谈,修复让他们卡住的地方,再换一个地方重新发布。
衡量人,而不是 star。GitHub 禁止自动加 star 和付费互动,而在 ICSE 2026 上发表的研究发现,虚假 star 会给项目带来短暂的提升,随后是持久的损害。追踪谁访问了、谁克隆或安装了、谁提交了 issue、谁又回来了,并在 GitHub 展示的 14 天流量数据消失之前把它保存下来。
为什么在 2026 年 star 是一个薄弱的目标
star 只是一个书签。它只需点一下,无法说明这个人是否用过这个项目,而且可以买到。Hao He 等人的研究团队估计,2019 年至 2024 年间约有六百万个疑似虚假 star,且在 2024 年急剧上升。其中大多数用于推广短命的恶意软件代码仓库;其余主要推广 AI 和 LLM、区块链、工具和教程类项目。推广效果持续不到约两个月,之后虚假 star 就变成了负担。
作为公开信号,star 仍然重要。投资人和各类榜单会关注它:Runa Capital 的 ROSS Index 按 star 增长对开源初创公司排名,而在 2026 年第三季度,榜单上几乎每个项目都是 AI 或智能体工具。把 star 当作人们觉得项目有用之后的滞后结果,而绝不是你要优化的目标。
2019 年至 2024 年约有六百万个疑似虚假 star,2024 年激增;大多数用于推广短命的恶意软件代码仓库,其余主要是 AI/LLM、区块链、工具和教程类代码仓库;推广效果持续不到约两个月,之后变成负担。
He et al.:Six Million (Suspected) Fake Stars in GitHub(ICSE 2026)禁止不真实的互动、自动加 star 或关注等排名滥用、以空投等奖励激励的互动,以及买卖不真实活动的二级市场。
GitHub Acceptable Use Policies,第 4 节2026 年第三季度 ROSS Index 按 GitHub star 增长对开源初创公司排名;20 个上榜项目几乎全是 AI 或智能体项目。
Runa Capital:ROSS Index Q3 2026先决定你要面向谁推广
一个开源项目可能有三类受众,他们需要的东西各不相同。GitHub 的维护者座谈说得很简单:先增长用户,因为看得见的使用才会吸引贡献者。如果项目属于一家公司,买家会更晚出现,来自那些在工作中依赖它的用户。
| 维度 | 他们需要你提供什么 | 第一步 |
|---|---|---|
| 用户 | 清楚说明它解决什么问题、一个能跑通的快速上手指南,以及它仍在维护的证明。 | 围绕一类用户和一个问题重写 README 的第一屏,并配上 10–20 秒的演示。 |
| 贡献者 | 贡献指南、路线图、带标签的入门 issue,以及会友善回复的维护者。 | 添加 CONTRIBUTING、一份简短的路线图和几个描述清楚的 issue,然后感谢每一份首次报告。 |
| 买家(如果你在卖东西) | 一个不会破坏免费项目的付费理由:托管、支持、团队功能或合规。 | 问问在工作中使用它的人,哪些部分他们不想自己运维。 |
点明具体的问题和好处;瞄准一个细分领域;分享 10–20 秒的演示;让 README 围绕用户的问题;贡献者随用户的自然采用而来,需要贡献指南、路线图以及响应及时且友善的维护者;衡量长期影响,而不是下载量或 star。
GitHub Blog:Marketing for maintainers(2022 年 7 月)推广任何东西之前的代码仓库检查清单
每个渠道都会把人带到同一个页面。如果代码仓库在第一屏里说不清自己是什么,推广只会让更多人离开。先逐项检查。
- 描述和 README 第一行:用平实的语言说明它为谁而做、做什么,不写实现细节。
- 靠近顶部的演示:一段 10–20 秒的 GIF 或短视频,展示第一个有用的结果。
- 快速上手:可直接复制粘贴的安装命令,以及在全新机器上能跑通的一条命令或一段代码。发布前从零开始测试一遍。
- Topics:最多 20 个,只用小写字母、数字和连字符,每个不超过 50 个字符。使用人们会搜索的词,例如编程语言、框架和问题。
- 社交预览图:至少 640×320,最好是 1280×640,PNG、JPG 或 GIF,小于 1 MB,这样在 X、Slack 或 Reddit 上分享的链接看起来是用心准备的。
- 一个许可证文件,让公司知道自己能否使用。
- CONTRIBUTING、一份简短的路线图,以及几个标记为适合新手、并附有足够上下文的 issue。
- 活跃的迹象:最近的版本发布、有回复的 issue 和更新日志。访客会查看是否有人在维护。
- 谁在使用:真实的用户或公司,只在获得许可后才写出名字。
- 如果有文档或网站,附上链接,并说明如何获得帮助。
小写字母、数字和连字符;不超过 50 个字符;每个代码仓库不超过 20 个;topic 页面和搜索帮助人们发现代码仓库。
GitHub Docs:Classifying your repository with topics最小 640×320 像素,1280×640 显示效果最佳;PNG、JPG 或 GIF,小于 1 MB。
GitHub Docs:Customizing your repository's social media preview按项目类型选择发布渠道
选一个有这个问题的人已经聚集的地方,展示项目如何解决它,并留下来回答问题。第二个渠道可以等到第一个渠道让你看清人们误解了什么之后再说。
| 维度 | 第一批用户在哪里 | 第一步 |
|---|---|---|
| 库或 SDK | 该框架的社区、它的 issue 跟踪器和讨论区,以及你的库能回答的 Stack Overflow 问题。 | 在库确实有帮助的地方回答现有问题,并发布一个解决常见任务的简短示例。 |
| CLI 或开发者工具 | Hacker News、开发者 subreddit,以及分享工具的 X 账号。 | 发一篇无需注册即可试用的 Show HN,并在最初几个小时守在评论区。 |
| 付费产品的自托管替代品 | 抱怨付费产品价格、限制或隐私的人,以及自托管社区。 | 清楚对比它替代了什么、目前还做不到什么,以及如何运行它。 |
| AI 智能体工具、MCP 服务器或插件 | X 和 GitHub 上的构建者、智能体框架社区和 AI 助手目录。 | 演示一个智能体以前做不到的任务;如果有相关目录,就在其中上架。 |
| Open-core 初创公司 | 已经在工作中使用该项目的团队。 | 在宣布付费版之前,先与提交 issue 的人以及来自公司域名的安装者交谈。 |
会适得其反的推广
这些做法要么违反平台规则,要么产生误导你的数字。在发布周之前,对照这份清单检查你的计划。
- 购买 star、与其他维护者互刷 star,或使用自动加 star 的工具。
- 以奖励、空投或赠品换取 star、关注或其他互动。
- 请朋友或同事为你的 Show HN 投票或评论。
- 把落地页、候补名单或注册表单当作 Show HN 发布,而不是人们可以试用的东西。
- 在其他项目的 issue 里打广告,或在许多代码仓库中发布同样的推广内容。
- 抓取 GitHub 个人资料,发送有关你项目的未经请求的邮件。
- 不读自我推广规则,就在许多 subreddit 或群组中发同一个链接。
第 4 节禁止不真实的活动、自动加 star 等排名滥用、以奖励激励的互动以及协同的不真实活动;第 7 节禁止将 GitHub 信息用于未经请求的邮件等垃圾信息;第 10 节禁止在 issue 中发布商业化或过量的批量内容。
GitHub Acceptable Use Policies用于人们可以上手试玩的东西;不接受博客文章、注册页面、新闻通讯或清单;不接受落地页或筹款;不要请朋友投票或评论;让人无需注册即可轻松试用。
Hacker News:Show HN guidelines30 天发布计划
- 第 1–3 天:写一句话,点明用户、问题和结果。据此重写代码仓库描述、README 第一段和演示。
- 第 4–7 天:逐项完成上面的代码仓库检查清单。请两位从未见过这个项目的人在你旁观下按快速上手指南操作,修复他们卡住的每一个地方。
- 第 8–14 天:找到 20 个已有的、有人遇到这个问题的对话,例如 issue、论坛帖子或社交帖子。只在项目确实有帮助的地方回复,并说明这是你做的。
- 第 15–21 天:在这些对话发生的渠道做一次公开发布,例如一篇 Show HN 或一篇演示帖子。守在评论区,记下每一个问题和异议。
- 第 22–30 天:解决最常见的异议,发布一个说明改动内容的版本,感谢报告问题的人,并把这一时段的台账与第一个时段进行对比。
复制每周发布台账
GitHub 只展示最近 14 天的访客、克隆、主要来源网站和热门内容,而且只对拥有推送权限的人可见。REST API 返回的也是同样的 14 天,所以要每周复制这些数字,否则就会丢失。包注册表保留的历史更长:npm 的下载 API 可以查询上周等时间段,或 18 个月内的某个日期范围,而 PyPI 把下载数据发布到一个公开的 BigQuery 数据集中。
下载量统计的是安装次数,包括自动化安装,而不是人数。把它当作趋势来看,并结合台账中的人工信号:陌生人提交的 issue、首次贡献,以及与在实际工作中使用该项目的人的对话。
完整克隆数、过去 14 天的访客、来源网站和热门内容;拥有推送权限的人均可查看。
GitHub Docs:Viewing traffic to a repository按天或按周的浏览量和克隆数、前 10 个来源网站和路径,覆盖最近 14 天;需要写入权限。
GitHub REST API:Repository traffic提供单点和区间端点,可查询最近一天、最近一周、最近一个月、最近一年或某个日期范围;查询限于 18 个月的数据。
npm registry:download counts下载事件以流式方式写入公开的 BigQuery 表 bigquery-public-data.pypi.file_downloads。
PyPI Docs:BigQuery datasets把数字放在一起看
以下是示意性的例子,不是基准:在一次 Show HN 前后的 14 天里,一个代码仓库获得 2,400 位独立访客和 180 位独立克隆者,即 7.5% 的访客克隆了它(180 ÷ 2,400)。它还获得 150 个 star,约每 100 位访客 6 个,以及 12 个来自团队以外的人的 issue。围绕最常见的问题重写 README 之后,接下来的 14 天访客变少,为 2,000 位,但独立克隆者有 200 位,即 10%(200 ÷ 2,000)。来的人更少,但试用的人更多:重写起了作用,尽管 star 增长得更慢。
要在这样的背景下解读 star。star 激增而克隆、安装或 issue 没有变化,通常意味着有关注却没有使用。陌生人提交的 issue 越来越多,通常意味着真实的使用,即使它们是 bug 报告。
从用户到客户
如果项目属于一家初创公司,第一批客户通常已经在你的 issue 跟踪器里了。找出在工作中使用它的人,问问他们更不愿意自己运维什么,并在搭建定价页之前,先和他们测试一项付费服务,例如托管、支持、团队功能或合规协助。
让免费项目保持真正有用。把快速上手指南放到注册之后,或移除用户依赖的功能,会破坏当初吸引他们的信任;而在 Hacker News 上,注册门槛会让一篇 Show HN 失去资格。
Soloop 能做什么
Soloop 不会为代码仓库加 star、发布包或管理你的 GitHub 项目。它帮助的是项目周边的推广工作,你可以从一个代码仓库开始。根据 Soloop 手册,它可以调研人们在哪里讨论某个问题并给出资料来源,在你通过 OAuth 连接后在 X 上发帖,准备 Reddit 帖子供你自己发布,通过 Gmail 发送冷邮件,以及准备 Google Search Ads 供你审阅和付款。默认情况下,各项操作都会等待你的审批。
一个有边界的首次请求:我的开源项目[代码仓库 URL]帮助[用户][获得结果]。找到 20 个[用户]描述[问题]的近期对话并附上资料来源,建议一个发布渠道,并在 HN 规则范围内起草一个 Show HN 标题和第一条评论。不要发布或发送任何内容。
资料来源、局限和更新
虚假 star 研究、GitHub 的 Acceptable Use Policies、流量、topics 和社交预览文档、流量 REST API、Show HN 指南、npm 和 PyPI 下载文档、GitHub 的维护者推广座谈以及 Runa Capital 2026 年第三季度 ROSS Index,均于 2026 年 11 月 2 日查阅。GitHub 没有公布 Trending 或搜索如何对代码仓库排名,而且下载量包括自动化安装。受众和渠道表格、检查清单、计划和台账属于编辑建议;漏斗示例仅为示意。本文任何内容均不保证 star、用户或客户。
本指南将在 2027 年 2 月 2 日之前复审;如果 GitHub 更改其 star、流量或 Trending 规则,会更早复审。
Soloop 手册描述了附带资料来源的调研、通过 OAuth 在 X 上发布、准备 Reddit 内容并由用户手动发布、通过 Gmail 发送冷邮件,以及在审阅和付款后上线 Google Search Ads;默认先审批。它不管理 GitHub 代码仓库、star 或包的版本发布。
Soloop 产品手册