Meta 把用了八年的设计系统开源了:13,000 个应用在跑

Meta 这周把内部设计系统放上了 GitHub。仓库是 meta/astryx,许可证 MIT,npm 上的包叫 @astryxdesign/core。一天多时间攒了 863 个 star,按 agent 技能类仓库的标准算平淡,但放出来的东西不是一个周末项目。Astryx 在 Meta 内部长了八年,是这家公司规模最大、用得最多的设计系统,目前压在 13,000 多个应用下面。
这个数字才是有意思的部分。多数开源设计系统是以「重新开始」的姿态出现的:一小套组件、一个好看的文档站、一句关于可访问性的承诺。Astryx 带来的是一堆已经在内部吵完的结论。产品经理、设计师和工程师在晚上十一点吵起来的时候,总得有个人定下来破坏性操作的确认弹窗该长什么样。这些决定现在都装在盒子里。
到底放了什么出来
系统建在 React 19 及以上,用 Meta 自家的 StyleX 写样式。如果你因为不想再引入一个样式运行时准备关掉页面,先看这个设计决定:StyleX 对使用方是不可见的。
装上 @astryxdesign/core,引一个主题,导入一份预编译好的 CSS,然后直接用带类型的 React 组件。没有构建插件要配,没有 PostCSS 或 Babel 那一步,也不用往打包器里塞编译器。想改组件外观,传一个 className,写 Tailwind、CSS module 或者裸 CSS 都行,Astryx 不管。你现有的工具链一行都不用动。
这是对主流设计系统套路的主动反向操作。常见玩法是把你锁进它自己的样式方案,好让组件能保证内部一致。Astryx 把一致性放在组件 API 里,样式留在你项目原本待的地方。
主题也是同一个思路。一个主题就是一组 CSS 自定义属性的覆盖值。包里带了七套:neutral、butter、chocolate、matcha、stone、gothic、y2k。都不合适,设计师可以重定义这些自定义属性,做出跟默认完全不像的系统,一个组件都不用 fork。
组合在各个层级都是开放的。拼出一个组件的零件是直接导出的,所以你可以自己重组表格行、菜单项或者表单字段,不用凭空造。还不够的话,有个叫 swizzle 的 CLI 命令能把组件源码整个弹进你的项目,从那一刻起它归你,想改什么改什么。多数设计系统要么不提供这个逃生口,要么提供得很糟。

包里有一百五十个以上符合可访问性要求的组件,另外还有内部工具里必然出现的几种版式模板:表格页、详情页、表单向导、导航。整套还在 beta。
agent 那部分不是营销话术
Meta 反复讲的一句话是「人和 AI 共用一套系统」。说这话的厂商不少。Astryx 给出了一个结构性的理由。
API、文档和 CLI 是一起设计的,来自同一份参照材料。也就是说 CLI 不是事后为了脚手架硬接上去的附件,它本身带着组件文档。astryx docs 回答这套系统怎么运作,astryx component --list 列出有什么。一个能跑 shell 命令的编码 agent,因此可以像新员工读文档站那样去查 Astryx,拿到同样的答案。
CLI 比听起来更重要,有个很实际的原因。agent 用一套没见过的设计系统写 React 组件,翻车方式不是语法错误,是它自己编出听起来很合理的 prop 名。它写 ,因为别的库都这么写,然后组件默默渲染成默认样式。一个能列组件、能打印真实 prop 的 CLI 把这个缺口补上了,还不需要 agent 的训练数据里有这个库。
Meta 还建议把 CLI 写成 package.json 里的脚本,而不是依赖全局二进制:
"scripts": {
"astryx": "node node_modules/@astryxdesign/cli/clients/cli/bin/astryx.mjs"
}
之后通过这个脚本名调用 CLI。官方给出的理由是助手或新同事直接调二进制会出现路径错误。实际上这就是大家在 agent 工作流里跑 linter 的那条建议:把入口做得无聊而稳定,谁都不用猜。
安装本身三条命令:
npm install @astryxdesign/core @astryxdesign/theme-neutral @stylexjs/stylex
npm install -D @astryxdesign/cli
npm i -g @astryxdesign/cli
前两条装在项目里,第三条可选,把 CLI 装成全局的,这样在任何目录下 astryx 都能用。这条在你想让 agent 在项目还不存在的时候就具备设计系统知识时有用。
这几条原则像是吵完架才写下来的
仓库列了四条原则,每一条听着都像一场漫长内部争论的结论。
引导优先于强制:组件给你能力,不给你会跟你打架的护栏。设计观点放在文档和示例里。你传什么值,组件就渲染什么。这跟那些「你选的颜色我认为不对就不给你渲染按钮」的设计系统正相反。代价是 Astryx 会开开心心让你做出很丑的东西,Meta 显然是权衡过才接受这一点。
强约束、写清楚的约定:每个组件遵守同一套命名、prop 和组合规则。学会几个,剩下的行为就可预期。这种可预期性被描述成对人的好处,也是对模型的要求。一个看过三个 Astryx 组件的模型能推广到第四个,因为约定是一样的。
人和 AI 一套系统:API、约定、文档、CLI 是一起设计的。附带的说法很老实——每一个让 Astryx 对 AI 更友好的改动,同时也让人用得更顺。如果某个改动只帮到了其中一方,那大概率是个坏改动。
用测量挣来:约定是被测出来的,不是被宣称的;遇到反例就回去改结论。这条从外面最难看见,也正好解释了一套系统凭什么活过八年、撑住 13,000 个应用。
薄的地方在哪
beta 在这里不是一个法律措辞。包列表上的接缝很清楚。
@astryxdesign/lab 放实验组件,不发布到 npm,只给 Storybook 和沙箱用。@astryxdesign/vega 和 @astryxdesign/charts 有,但只在 @canary 这个 dist-tag 下,没有稳定版。也就是说每个内部看板都要用的图表,还不是能上线的功能。
React 19 是硬要求。如果你的应用因为某个动不了的依赖还停在 React 18,那你暂时不是它的用户。
用 CSS 自定义属性做主题很优雅,代价是主题没法强制结构规则。它能改颜色、间距、圆角、字体,改不了一张表怎么排序。这条线划得合理,但它是一条线。
还有一个显而易见的问题:一套按 Meta 的信息密度和工作流调出来的系统,适不适合十二个人的创业公司。Meta 的内部工具信息密集、以键盘操作为主、使用者都受过训练。一个拍照应用或者一条结账流程,是另一种形状的问题。组件能用,只是默认值可能像一件大两号的西装。
这次发布为什么值得看
老实说,因为它是对一个所有人都在说的主张的一次好测试。
那个主张是:设计系统现在应该为 agent 而建,做法是让文档和工具机器可读,而不是加一个 AI 功能。Astryx 是第一套来自这种体量公司的大型系统,把这件事以开源、MIT、源码可弹出的形式放了出来。
如果它成了,这个模式会扩散:文档即 CLI,约定即契约,组件即可组合的源码。如果没成,失败会很具体、很可见,其他人省下一年。
头几天一万六千个 star 说明大家至少好奇。更值得看的数字是三个月后还有多少仓库在 import @astryxdesign/core,以及其中有没有哪几个主要是由一个读过 CLI 的 agent 写出来的。这比一段演示视频更能说明什么叫「为 AI 而建」。
相关文章
744B 模型住进 9.9 GB 内存,专家从硬盘上读
colibri 把 744B 混合专家模型里常用的那部分留在内存,专家从磁盘流式读。README 把慢的基准和快的一起发,所以值得读。
不动模型,也能把智能体调好
Harness² 冻结权重,只改模型周围的八个组件,然后对比几次运行的差异。一个 benchmark 上最多涨 11.5 分,没有一次梯度更新。
编辑榜排第二,调用榜前五十都没进
微软发了一个根本不能生成图像的模型。它在编辑榜第二,在请求量前五十里找不到。这个落差说明图像榜单到底在量什么。
35 万个假受害者,和机构撒谎的伦理问题
Apate.ai 跑着 35 万个 AI 人格,工作是让骗子骗,再把骗出来的情报卖给银行和运营商。浪费时间这一步成立,没有人算过账的是那个先例。