一、先分清设计系统和组件库
Meta 把内部用了八年的 Astryx 开源了,MIT 协议,仓库 meta/astryx,目前标着 Beta,还没有任何 tagged release。它自称支撑公司内部 13000 多个应用——这是 Meta 自己的说法,外部无法独立核实。代码库有 6848 次提交、1.2k fork,11 月 7 日约 14100 star。
它不是又一个 Button 集合。结构分三层:foundations 管颜色、字体、布局、间距和无障碍;components 提供 150 多个组件;patterns 给的是整页结构,比如表格页、详情页、表单向导、导航布局。技术栈是 React 19 加 StyleX 加 TypeScript,文档用 Storybook,测试用 Vitest 和 Playwright,配 7 套主题和暗色模式。
二、agent ready 落在三个具体动作上
大多数产品说支持 AI,指的是加个 MCP 服务器、放一份 llms.txt,或者写一篇怎么让编辑器用我们库的教程。Astryx 的做法是把人和智能体塞进同一份参考里。
API 层,每个组件遵循同一套命名、prop 和组合规则,学会几个就能猜出剩下的。文档层,写清某个 prop 在具体场景该给什么值,而不是只列存在哪些 prop。CLI 层,astryx component --list 列组件,astryx docs global 打印全局文档,模板、脚手架、主题、codemod 都能从命令行拿到。仓库里还直接带 AGENTS.md、CLAUDE.md 和 .claude 目录。
这一层的价值在于消除猜测。智能体写前端最难看的地方不是不会写,而是凭空发明间距和组件名,最后拼出三种风格混在一起的页面。给它一个可查询的组件库,比给它一段更长的提示词管用。
三、装上之后要注意的四件事
依赖是 React 19 或更高,加上 @astryxdesign/core、一个主题包和 @stylexjs/stylex。样式没有锁定:想用 Tailwind、CSS modules 或纯 CSS,都可以通过 className 覆盖。要彻底接管源码就走 swizzle,把组件复制进自己的仓库再改。
四个坑先记住。一是 Beta 且没有版本标签,升级可能破坏兼容,生产项目要锁 commit。二是 StyleX 是编译期方案,构建链得接它的编译插件,纯运行时环境跑不通。三是 150 个组件不等于 150 个能用的页面,patterns 是起点不是成品。四是 agent ready 目前只是设计目标,没有第三方在你自己的任务上验证过它是否真的少犯错。
README 的原话是:API、文档和 CLI 的设计目标是让开发者和 AI 助手工作在同一个参考上。这句话是可检验的承诺,也是这类项目最该被追问的一句。