# @allahjs/antd 中文文档

规范地址：https://npmcn.com/package/%40allahjs/antd/

版本：0\.4\.0
npm 元数据更新时间：2026-11-02T10:41:13.804Z
中文译文更新时间：2026-11-06T22:17:49.288Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40allahjs/antd
原文对照：https://npmcn.com/package/%40allahjs/antd/?lang=original
项目主页：https://allah-prime.github.io/allah-antd/
源码仓库：https://github.com/allah-prime/allah-antd

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

- 包体积（解压后）：2 MB，447 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：19 个
- peer 依赖：antd \>=6\.0\.0，react \>=18\.0\.0，react-dom \>=18\.0\.0
- 首次发布：2026-10-24T19:50:20.986Z
- 最新版本发布：2026-11-02T10:41:13.413Z
- 近 30 天下载量：2269（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 13 个）

## 中文简介

基于 antd v6 封装的 React 业务组件库

## 安装

```sh
npm install @allahjs/antd
```

也可以使用：`pnpm add @allahjs/antd`、`yarn add @allahjs/antd`、`bun add @allahjs/antd`

## README

# allah-antd

`@allahjs/antd` —— 基于 antd v6 封装的 React 业务组件库。

-   文档站：https://allah-prime.github.io/allah-antd/
-   npm：https://www.npmjs.com/package/@allahjs/antd

## 安装

```bash
pnpm add @allahjs/antd
# peerDependencies：antd >= 6、react >= 18（项目内需已具备）
# 样式为 Less，需要构建工具支持 less（`pnpm add -D less`）
```

## 使用

```tsx
import { AhProTable } from '@allahjs/antd';

// 入口处引入全量样式
import '@allahjs/antd/dist/ui/index.less';
```

## 包结构

| 目录 | 内容 |
| --- | --- |
| `src/ui` | 核心企业级组件（AhProTable、AhPage、Login、LightFilter 等 40+） |
| `src/edit` | 编辑器（AhEditor 富文本 / AhNotion / AhMarkdown / Monaco） |
| `src/drag` | 拖拽交互（DndKit、DragModal、GridCards 等） |
| `src/mobile` | 移动端组件（antd-mobile 封装：AhForm、AhFlatList 等） |
| `src/types` | 共享类型 |

组件按 `src/ui/<组件名>/` 目录组织：`index.md` 为 dumi 组件文档，`demo/` 为文档站示例。 新增组件后在 `src/index.ts` 导出即可。

工具与类型依赖 **@allahjs/utils**（`arrayUtils`/`dateUtils`/`diffUtils`/`fileUpload2Usage`/表单联动规则 `validateActions`/`ahRules` 等均已在该库提供）。本地联调时该依赖以 `link:../allah-utils` 软链到 工作区源码，改 utils 后先在 allah-utils 里 `pnpm build` 刷新 dist。

## 本地开发

```bash
pnpm install
pnpm dev          # dumi 文档站（组件开发调试）
pnpm build        # father 构建，输出 ESM 到 dist/
pnpm lint         # eslint（已知历史债务：15 error / 31 warning，多为原仓库代码风格）
pnpm type-check   # tsc --noEmit（不含 demo 目录）
```

## 发版（GitHub Actions + semantic-release + npm Trusted Publishing）

与工作区其他仓库一致，发版零操作：

```bash
git commit -m "feat: 新组件"   # feat → minor，fix → patch
git push                        # 推到 main，自动定版本、发 npm、打 tag、建 Release
```

**不要手动改 package.json 的 version，也不要手动打 tag。**

### ⚠️ 首次发布需要一次性引导（仅新包需要）

npm 的 Trusted Publishing 不支持「包还不存在」时的 OIDC 首发 （见 [npm/cli#8544](https://github.com/npm/cli/issues/8544)）。**在完成下面的引导之前，`Node.js Package` 流水线每次都会红**，报 `404 OIDC token exchange error - package not found` + `ENONPMTOKEN`——这是新包 的必经状态，不是配置错误。引导只需一次：

1.  本地手动首发一次（需 2FA / passkey）：
    
    ```bash
    version 已是 0.0.1，直接发布：
    pnpm publishNpm
    ```
    
2.  到 npmjs.com → `@allahjs/antd` → Settings → **Trusted Publisher** 添加绑定（五项缺一不可）：
    
    | 字段 | 值 |
    | --- | --- |
    | Organization or user | `allah-prime` |
    | Repository | `allah-antd`（不带组织前缀） |
    | Workflow filename | `npm-publish.yml` |
    | Environment name | `main` |
    | Allowed actions | `npm publish`（不要选 stage publish） |
    
3.  之后全自动：feat → 0.1.0、fix → 0.0.2（v0.0.1 锚点 tag 已就位，semantic-release 以它为基准递增）。
    

完整机制与排错见工作区 [docs/npm-自动化发包指南.md](https://npmcn.com/package/%40allahjs/docs/npm-%E8%87%AA%E5%8A%A8%E5%8C%96%E5%8F%91%E5%8C%85%E6%8C%87%E5%8D%97.md)。

## 常见问题

### @allahjs/antd 是什么？

基于 antd v6 封装的 React 业务组件库

### 如何安装 @allahjs/antd？

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

### @allahjs/antd 支持 TypeScript 吗？

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

### @allahjs/antd 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @allahjs/antd 可以商用吗？

@allahjs/antd 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @allahjs/antd 的下载量有多少？

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

### @allahjs/antd 还在维护吗？

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