Astryx 是什么:Meta 开源给 Agent 用的设计系统

Astryx 是 Meta 开源的 React 设计系统,内部用了八年、撑起 13,000 多个应用,现在以 MIT 许可证放出 Beta。和一般组件库比,它多了一个 CLI:组件文档、模板、主题都能用命令查,还会在你电脑上放一份给编程 Agent 读的 Skill。11 月 10 日我们对照仓库 README、CLI 文档和 v0.7.11 发布页整理了用法。
它是什么
它是人和 Agent 共用的一套前端组件库。样式用 StyleX 写,但用的人感觉不到:想覆盖就传 className,Tailwind、CSS Modules、普通 CSS 都行。主题就是一组 CSS 变量,设计师改品牌色不用 fork 组件源码;真要深改某个组件,swizzle 命令把它的完整源码拷进你的项目。
| 仓库 | github.com/meta/astryx |
|---|---|
| 作者 | Meta |
| 许可证 | MIT |
| 热度 | GitHub 20,747 星(GitHub API,2026-11-10 14:05 北京时间);npm 上 @astryxdesign/core 一周下载 661,968 次、@astryxdesign/cli 365,973 次(2026-11-02 至 11-08) |
| 运行要求 | React 19 及以上;参与开发需 Node 22+、pnpm 11 |
| 最新版本 | 0.7.11(发布于 2026-11-07 23:00,北京时间),所有 @astryxdesign/* 包同版本发布;目前标注 Beta |
解决什么问题
让 Agent 写界面,常见的毛病是它不知道你项目里有哪些组件,于是自己拼一个按钮、猜一个属性名,样式和交互每页都不一样。Astryx 把文档做成了机器能直接读的接口:
- 一处搜全部:
astryx search button在组件、hook、文档、模板、主题里一起找,每条结果后面附上下一条该跑的命令。 - 能力清单:
astryx manifest --json一次吐出所有命令、参数、返回类型和退出码,官方说法是「CLI 的 OpenAPI」,Agent 不用去解析--help。 - 从模板起步:仪表盘、设置页、表单、详情页都有模板,
astryx template --list查看,再按需生成。 - 升级有 codemod:换版本后
astryx upgrade --from 旧版本 --apply自动改代码。
怎么用
装组件、主题和 CLI:
npm install @astryxdesign/core @astryxdesign/theme-neutral @stylexjs/stylex
npm install -D @astryxdesign/cli
npx @astryxdesign/cli init
Next.js 项目在 globals.css 里按顺序导入三份样式,再用 Theme 包住应用:
@import '@astryxdesign/core/reset.css';
@import '@astryxdesign/core/astryx.css';
@import '@astryxdesign/theme-neutral/theme.css';
顺序对应层叠:重置样式、组件样式、主题变量。Vite、Tailwind 和 CDN 的配置在 core 包的 README 里。
查文档的几条命令:
npx @astryxdesign/cli component Button
npx @astryxdesign/cli component --list
npx @astryxdesign/cli docs tokens
npx @astryxdesign/cli template --list
想让电脑上所有 Agent 都知道 Astryx,就全局装一次:npm i -g @astryxdesign/cli。在项目里运行时,仍然由项目自己装的版本作答,全局版本不会影响项目。官方还建议在 package.json 加一条 "astryx" 脚本指向本地 CLI,免得 Agent 调用时找错路径。
核验记录
- 版本:GitHub Releases 最新为 v0.7.11,npm 上 @astryxdesign/core 的 latest 也是 0.7.11,许可证字段 MIT。这一版主要是触屏细节:Popover 从触发点长出来、按钮在手指下的点击区扩到 44px、Banner 的
role="alert"只留在标题和描述上。 - Skill 写到哪:CLI 文档写明,全局版第一次运行和每次升级后在后台写
~/.agents/skills/astryx/SKILL.md,总是链接到~/.claude/skills/astryx;~/.kiro、~/.letta、~/.continue等目录存在时也会链过去。你改过的文件它不覆盖,不是它创建的东西它也不碰。 - 联网:全局版每天最多查一次 npm 上的最新版本,有新版时在命令末尾打印两行提示,不会自动升级。设
NO_UPDATE_NOTIFIER或CI环境变量就不查。 - 还没稳定的部分:图表包 @astryxdesign/vega 和 @astryxdesign/charts 只在
@canary标签下发布,实验组件包 lab 不发 npm。
它给 Agent 准备了一份查得到的组件清单,Agent 就不用再自己现编按钮了。
适合谁,不适合谁
适合:新开的 React 19 项目、内部后台和工具类应用;经常让 Claude Code、Codex 写前端,想让每页风格一致的团队;需要成套无障碍组件又不想被样式方案绑死的人。
不适合:还在 React 18 或用 Vue、Svelte 的项目;已经深度绑定 shadcn/ui、MUI 的老项目,迁移成本要算清楚(Astryx 的 upgrade 命令可以刷新从 shadcn 拷来的组件,但不等于一键迁移)。它还是 Beta,小版本里会有行为调整,比如 0.7.11 改了动画时长,升级前先看发布说明。只想让 Agent 的界面少点「AI 味」而不换组件库,可以看站内的 Impeccable 和 Hallmark。
最后
手上有 React 19 的新项目,就先跑一遍 npx @astryxdesign/cli init,再让 Agent 用 astryx template --list 挑一个设置页模板,看它生成的页面和你手写的差多少。