项目2026-11-10 · 智涌AI

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

Astryx 头图:终端展示 init 写入 AGENTS.md 组件索引、search 查组件、template 列模板和全局 Skill 路径,标注 150 多个无障碍组件、Meta 内部 13,000 多个应用、最新版本 0.7.11

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 把文档做成了机器能直接读的接口:

怎么用

装组件、主题和 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 调用时找错路径。

核验记录

它给 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 挑一个设置页模板,看它生成的页面和你手写的差多少。

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。