# @agregio-solutions/design-system 中文文档

规范地址：https://npmcn.com/package/%40agregio-solutions/design-system/

版本：2\.3\.4
npm 元数据更新时间：2026-10-23T09:26:43.369Z
中文译文更新时间：2026-11-06T19:56:28.511Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agregio-solutions/design-system
原文对照：https://npmcn.com/package/%40agregio-solutions/design-system/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.2 MB，794 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：5 个
- peer 依赖：react ^18\.0\.0 \|\| ^19\.0\.0，react-dom ^18\.0\.0 \|\| ^19\.0\.0，@tanstack/react-table ^9\.0\.0，react-aria-components ^1\.21\.0
- 首次发布：2024-05-03T13:38:02.356Z
- 最新版本发布：2026-10-23T09:26:43.179Z
- 近 30 天下载量：2414（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：174（近 12 个月 63 个）

## 中文简介

反应组件库和故事书,这是阿格里焦解决方案设计系统的一部分

## 安装

```sh
npm install @agregio-solutions/design-system
```

也可以使用：`pnpm add @agregio-solutions/design-system`、`yarn add @agregio-solutions/design-system`、`bun add @agregio-solutions/design-system`

## README

# Agregio 设计系统(故事书和软件包生成)

[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)

QQ 警告: 此文件可能是此工程中最重要的文件 。 请读一下 **小心点** 在做任何事情之前, 谢谢

## 捐款

此文档只涉及想要 **贡献** 到项目.

如果你正在寻找文档 **使用** 请参考 [零小时文档](https://zeroheight.com/4943b159f/p/5667cb-introduction) 换句话说.

## 安装

```bash
git clone <repo-url>
cd storybook-for-DS
npm install
npm run prepare
```

> `npm run prepare` 最紧急的汽车 `ignore-scripts=true` 最佳配置词 `.npmrc`,脚本自动执行 `prepare` 日报社 `npm install`. Sans cette étape, les hooks Husky (前承诺) ne seront pas snotés.

## 内容提要

-   [样式组件](https://npmcn.com/package/%40agregio-solutions/design-system/docs/styles.md):所有你需要了解的造型组件.
-   [更新依赖关系](https://npmcn.com/package/%40agregio-solutions/design-system/docs/updating-deps.md): 如果您需要更新前端的依赖关系.
-   [可用的脚本](https://npmcn.com/package/%40agregio-solutions/design-system/docs/available-scripts.md): 如果您已经安装了前端并想知道可用的 npm 脚本 .
-   [Git 流量部署进程( D)](https://npmcn.com/package/%40agregio-solutions/design-system/docs/deployment.md):如果你需要部署前端的新版本或者理解我们的CI/CD是如何工作的.
-   [提交消息公约](https://npmcn.com/package/%40agregio-solutions/design-system/docs/commit-message.md): 如果你想写一致和神奇的信息 qq
-   [代码质量](https://npmcn.com/package/%40agregio-solutions/design-system/docs/code-quality.md):如果你想了解为确保良好守则质量而选择的工具和做法.
-   [管理图标](https://npmcn.com/package/%40agregio-solutions/design-system/docs/icons-library.md):如果想要从图标组件中添加、更新或删除图标.
-   [关于国家预防机制的出版物包](https://npmcn.com/package/%40agregio-solutions/design-system/docs/publish-package.md):如果你想知道我们如何公布关于国家预防机制的套件.
-   [解决问题](https://npmcn.com/package/%40agregio-solutions/design-system/docs/troubleshooting.md): 重新源源于我们拥有的和修复它们的方法

## 常见问题

### @agregio-solutions/design-system 是什么？

反应组件库和故事书,这是阿格里焦解决方案设计系统的一部分

### 如何安装 @agregio-solutions/design-system？

在项目目录运行 npm install @agregio-solutions/design-system，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.0\.0 \|\| ^19\.0\.0）、react-dom（^18\.0\.0 \|\| ^19\.0\.0）、react-aria-components（^1\.21\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @agregio-solutions/design-system 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @agregio-solutions/design-system 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @agregio-solutions/design-system 可以商用吗？

@agregio-solutions/design-system 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @agregio-solutions/design-system 的下载量有多少？

根据 npm 官方下载统计，@agregio-solutions/design-system 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,414 次，日均约 80 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @agregio-solutions/design-system 还在维护吗？

最新版本 2\.3\.4 发布于 2026/10/23（15 天前）；至今共发布 174 个版本，其中过去 12 个月发布了 63 个；首次发布于 2024/05/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。