# @dittolive/anvil 中文文档

规范地址：https://npmcn.com/package/%40dittolive/anvil/

版本：0\.0\.12
npm 元数据更新时间：2026-11-05T19:24:44.975Z
中文译文更新时间：2026-11-12T12:37:12.697Z
软件包许可：SEE LICENSE IN LICENSE\.md

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

原始 npm 页面：https://www.npmjs.com/package/%40dittolive/anvil
原文对照：https://npmcn.com/package/%40dittolive/anvil/?lang=original
项目主页：https://github.com/getditto/anvil#readme
源码仓库：https://github.com/getditto/anvil

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

- 包体积（解压后）：1.5 MB，174 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：42 个
- peer 依赖：react ^18\.2\.0 \|\| ^19\.0\.0，react-dom ^18\.2\.0 \|\| ^19\.0\.0
- 首次发布：2026-08-12T21:30:32.393Z
- 最新版本发布：2026-11-05T19:24:44.773Z
- 近 30 天下载量：2561（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

Anvil, Ditto的反相设计系统.

## 安装

```sh
npm install @dittolive/anvil
```

也可以使用：`pnpm add @dittolive/anvil`、`yarn add @dittolive/anvil`、`bun add @dittolive/anvil`

## README

# 安维尔

Anvil是Ditto网络项目的反应设计系统.

组件库基于 Tailwind CSS v4 并拥有共享主题, 符号和组件源检测.

## 安装

从寄存器根安装依赖性 :

```sh
yarn install
```

## 开始

1.  安装组件库和 Tailwind CSS .
2.  从您的应用程序 CSS 导入 Tailwind 和设计系统主题 :

```css
@import 'tailwindcss';
@import '@dittolive/anvil/theme.css';

@source './src';
```

字体通过明确的软件包子路径提供, 例如 `@dittolive/anvil/font/geist/geist.css`。 。 。 .

新图标应当使用 `Icon` 构成部分从 `@dittolive/anvil` 带有 磷酸盐图标通过 `svg` 道具 (英语).

## 发展

-   `yarn storybook` 启动用于本地组件开发的故事手册.
-   `yarn test` 运行测试套房.
-   `yarn lint` 运行 Linting 、 格式化检查和 TypeScript 检查.
-   `yarn build` 创建生产包 `dist/`。 。 。 .
-   `yarn build:watch` 当源文件更改时重建软件包.
-   `yarn changeset` 为软件包的更改创建出出纸条并成交.

为了测试另一个项目的本地安维尔变化,指出该项目的依赖性 本次检出时 :

```json
"dependencies": {
  "@dittolive/anvil": "link:../path/to/anvil"
}
```

运行 `yarn build:watch` 在这里开发,然后恢复消耗 用于在进行依赖性更改之前将软件包版本放出.

## 文档

运行 `yarn storybook` 浏览本地组件,或 `yarn build-storybook` 制作静态文档网站.

## 释放

Anvil使用变相器进行版本,变相日志生成和npm发布. 对于任何用户软件包的更改,请运行 `yarn changeset`,选择适当的 闪烁起起起伏起起伏起起伏起起伏起起伏起起伏起伏起起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起伏起出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出 `.changeset/*.md` 带有更改的文件.

当改变土地 `main`,发布工作流程打开或更新发布 PR 将待处理的更改应用到 `package.json` 财务报告和审定财务报表 `CHANGELOG.md`合并 该发布 PR 发布 `@dittolive/anvil` 之后为 npm `yarn pack:check` 通过.

## 软件包边界

这个寄存器是真相的来源 `@dittolive/anvil`软件包 建筑是合同:消费者应该使用 `package.json` 财务报告和审定财务报表 依赖于已发布的软件包版本,除非它们正在明确测试本地软件包 结账.

## 许可证

Anvil根据PolyForm非商业许可证 1.0. 商业 使用需要与DittoLive公司单独许可。 请参看LICENSEMD 在此包内提供许可详情.

版权:"2019-2026 DittoLive"股份有限公司.

## 常见问题

### @dittolive/anvil 是什么？

Anvil, Ditto的反相设计系统\.

### 如何安装 @dittolive/anvil？

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

### @dittolive/anvil 支持 TypeScript 吗？

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

### @dittolive/anvil 支持 ESM 还是 CommonJS？

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

### @dittolive/anvil 可以商用吗？

@dittolive/anvil 使用 SEE LICENSE IN LICENSE\.md 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @dittolive/anvil 的下载量有多少？

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

### @dittolive/anvil 还在维护吗？

最新版本 0\.0\.12 发布于 2026/11/06（6 天前）；至今共发布 9 个版本，其中过去 12 个月发布了 9 个；首次发布于 2026/08/13。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。