乐于分享
好东西不私藏

扒完 Claude Code 源码,我开源了个框架,24 小时 1500+ Star(1)

扒完 Claude Code 源码,我开源了个框架,24 小时 1500+ Star(1)

凌晨 4 点。

发了。

不到 24 小时,1500+ Star,800+ Fork。

这篇不是来晒数据的。我想把整个过程摊开——策略是什么、踩了什么坑、犯了什么蠢、怎么补救的。你如果也在做开源或者产品推广,后面那些教训可能比 star 数有用得多。

先说这是个什么东西

open-multi-agent,一个 TypeScript 多 Agent 协作框架。多个 AI Agent 组团干活,自动拆任务、按依赖关系调度、还能共享记忆和互相通信。

技术细节见下一篇文章,这里只聊推广。

时间线

凌晨 4:00 — 推到 GitHub,同步发了 Reddit 的 r/ClaudeCode 和 r/ClaudeAI。

上午 — 朋友圈发了一条,又投了 r/LocalLLaMA。Reddit 帖子开始起量,评论也开始涌进来。

上午到下午 — 疯狂干活:准备各平台文案、优化 README、发 npm 包、处理各种突发状况。

下午 2:00 — 520+ Star,130+ Fork。12 个渠道的推广全部完成:Reddit 5 个子版、Hacker News、Product Hunt、Twitter、即刻、小红书、掘金、知乎、微信群、朋友圈。

24 小时 — 1500+ Star,800+ Fork。还在涨。

不同平台讲不同的故事

这件事上我花了最多心思。

同一个项目,在不同平台用了完全不同的叙事角度:

平台
角度
原因
r/ClaudeCode、r/ClaudeAI
“研究了 Claude Code 架构后重写”
蹭热点,这两个社区最关注 Claude
r/LocalLLaMA
“模型无关,欢迎贡献本地模型适配器”
这群人最在意不被大厂绑定
r/SideProject
“独立开发者的 side project,10 小时 520 star”
builder 社区吃个人故事和数据
r/ArtificialIntelligence
“多 Agent 协作的概念和场景”
更偏科普的受众
HN
纯技术标题,不提数据不提热点
HN 反感营销味,让内容自己说话
Product Hunt
开发者工具定位
PH 用户关心”这工具能帮我干嘛”
掘金
技术教程:”从零实现”
掘金用户要干货,不要故事
知乎
深度架构对比
知乎用户要深度和对比
小红书
“6 小时 300 Star,我做了什么”
小红书吃数据和个人叙事
朋友圈
简短 + 数据 + 链接
朋友圈没人看长文

每个平台的文案都是独立写的,不是一篇到处搬。 Reddit 技术社区要冷静克制,小红书要个人叙事,掘金要代码和解释。搬运一定会被嗅出来。

发布节奏也有讲究。Reddit 几个子版之间间隔发,避免被标记 spam。先发热度最高的 r/ClaudeCode,再扩散到更大的池子。

国内平台用了不同的钩子——国内可以正面说”研究了 Claude Code 的架构”,这在国内语境下是技术实力的体现。但在 Reddit 上这么说,会被一群人追着问法律问题。

踩过的坑

标题擦边,被反噬了

Reddit 的标题用了”Claude Code’s source was just exposed via source maps — I studied the architecture and re-implemented…”

这标题带来了巨大流量。

也带来了最多的攻击。

评论区差不多一半在讨论两件事:

“你没写,AI 写的”——”I studied” 这三个字成了最大的靶子。

“这不合法”——大量 clean room reimplementation 的法律讨论。

Reddit 发完之后标题改不了。内容改了,但标题和内容不匹配,又被说标题党。

说实话,擦边确实是双刃剑。流量来了,但评论区的负面讨论会影响项目长期口碑。如果是一个你打算长期维护的项目,宁可慢热也别招黑。

npm 包名被人抢了

这是最蠢的一个失误。

项目叫 open-multi-agent,README 里写的安装方式是 npm install open-multi-agent。但我一直没真的发布到 npm。

等我终于去发的时候——npm 上已经有一个别人的包叫 open-multi-agent,而且已经有 2100 次下载。

2100 个人看了我的 README,跑了 npm install,装了别人的包。

最后只能用 scoped name @jackchen_me/open-multi-agent 发布。损失已经造成了。

这事还有一层。之前在另一个对话里,AI 帮我写的 README 直接用了 npm install open-multi-agent,我当时脑子里闪过”这里可能有问题”,但没停下来验证。

AI 生成的东西看起来很自信,但它不会主动告诉你”我没验证过这个信息”。这种一闪而过的直觉,以后得认真对待。

npm 发布流程的连环坑

包名的问题解决了,发布本身又是一堆问题:

  1. npm registry 指向了国内镜像
     — 之前配了 npmmirror.com 加速,导致 token 认证失败。排查了一阵才发现
  2. 2FA 问题
     — npm 要求发布必须开 2FA,我用的是 Passkey(指纹验证),但 npm CLI 不认 Passkey,只认 TOTP 验证码
  3. 最终方案
     — 生成了一个带 “Bypass 2FA for automation” 权限的 Granular Access Token 才搞定

整个 npm 发布折腾了快一个小时。用户在等着装包,我在这调 2FA。

发布流程应该提前跑通,不该等项目火了才来折腾这些。

README 里不该对比 Claude Agent SDK

最初 README 第二段写的是:

Unlike single-agent SDKs like @anthropic-ai/claude-agent-sdk which run one agent per process, Open Multi-Agent orchestrates multiple specialized agents working together in-process.

这个对比在 Reddit 上被精准打击。有人指出:Claude Agent SDK 是单 Agent 运行时,你做的是多 Agent 协作框架,不是同一层级的东西。对比不成立。

后来改了,改成直接讲项目的价值,不踩别人。

产品定位这事,直接说你能做什么,比说”别人不能做什么”有用得多,也不会招来不必要的反驳。

做对了的事

评论分类,只回技术问题

Reddit 评论涌进来之后,我做了个分类:

  • 技术问题
     → 认真回
  • 人身攻击 / 法律讨论
     → 不回
  • 真实用户(在试用、在问怎么用)
     → 重点维护

大概 30% 是技术问题和真实兴趣,18% 是法律警告,22% 是嘲讽,20% 是吃瓜。

越解释越像心虚,越回怼越多人来喷。不回就是了。

README 持续优化

发布后 README 改了好几版:

  1. 去掉 Claude Agent SDK 的对比
  2. 加了 Star History 趋势图
  3. 10 个 feature 平铺改成 4 个核心卖点 + 折叠的详细示例
  4. 加了 Contributing 板块引导社区参与
  5. npm 安装方式从错误的包名更正过来

README 就是你的落地页。大部分人从 Reddit / Twitter 点进来,看 30 秒 README 就决定 star 还是关掉。

数据

指标
数字
24h Star
1500+
24h Fork
800+
Fork/Star 比
~54%(很高,框架类项目特征)
Reddit r/LocalLLaMA
300+ upvotes,143K 浏览,160+ 评论
Reddit r/ClaudeAI
250+ upvotes
发布到 520 star 用时
10 小时
覆盖平台
13 个
npm 被错误安装次数
2100(血泪教训)

说几句实话

热点占了多少功劳?

大部分。Claude Code 源码泄露是一个时效性很强的热点,我的项目标题踩中了。晚两周发,没这个热点,初始增速不会这么快。

但后续的持续增长说明项目本身也有被需要的价值。TypeScript 生态确实缺这个东西。

1500 个 star 等于成功吗?

不等于。真正会用这个框架的可能不到几十个人。Star 是虚荣指标,issue 和实际使用才是真信号。到现在,真正的技术 issue 寥寥无几。

擦边值不值?

短期看值——流量确实来了。长期不好说。Reddit 上已经有人把我标记为 “snake oil salesman”,这标签会跟着我的 Reddit 账号。以后再推别的项目,这个印象是减分的。

AI 辅助推广,边界在哪?

这次所有文案都是 AI 辅助写的——不同平台的文案、评论回复建议、README 优化。效率确实高。

但 AI 也犯了错。npm 包名没验证就写进 README,导致 2100 次错误安装。人的角色是做最终的事实核查,这个责任外包不出去。

接下来

推广该做的都做了。

接下来要回答一个更难的问题:用多 Agent 协作这个能力,做什么产品、卖给谁、怎么收费。

框架是手段。1500 个 star 证明了”有人关注这个方向”,但还没有证明”有人愿意为此付费”。

后者才是真正重要的事。


GitHub: https://github.com/JackChen-me/open-multi-agent

npm:npm install @jackchen_me/open-multi-agent