# @alexandregme/zljs 中文文档

规范地址：https://npmcn.com/package/%40alexandregme/zljs/

版本：2\.1\.2
npm 元数据更新时间：2026-11-04T04:57:31.985Z
中文译文更新时间：2026-11-06T03:01:25.271Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40alexandregme/zljs
原文对照：https://npmcn.com/package/%40alexandregme/zljs/?lang=original
项目主页：https://zljs.vercel.app/
源码仓库：https://github.com/alexandregme/zljs

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

- 包体积（解压后）：110 kB，17 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：14 个
- peer 依赖：next \>=16\.0\.0，react ^19\.0\.0，react-dom ^19\.0\.0，react-redux ^9\.0\.0，@reduxjs/toolkit ^2\.0\.0
- 首次发布：2026-10-18T05:43:30.300Z
- 最新版本发布：2026-11-04T04:57:31.672Z
- 近 30 天下载量：5991（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：42（近 12 个月 42 个）

## 中文简介

对企业应用(Next.js,Tailwind CSS v4)有意见,可访问的React组件库.

## 安装

```sh
npm install @alexandregme/zljs
```

也可以使用：`pnpm add @alexandregme/zljs`、`yarn add @alexandregme/zljs`、`bun add @alexandregme/zljs`

## README

# zljs——反应组件库

一个开源,TypeScript React组件库,用于企业网络应用(Next.js,Tailwind CSS v4),外加一个生成UI屏幕的AI代理.

## 软件包

| 软件包 | 说明 | 链接 |
| --- | --- | --- |
| `core/` | 组件库——按钮、 DataGrid、 Forms、 Modal 等 | [故事书](https://zljs.vercel.app/) |
| `agent/` | 生成 UI 屏幕的AI 代理( HTML + Tailwind CSS) | [读取](https://npmcn.com/package/%40alexandregme/zljs/agent/README.md) |

## AI 路线图

检查过的项目今天存在;未检查的项目是计划中的,没有执行.

-   [x] 对话的 UI 生成( Name`agent/`(中文(简体) )
-   [ ] AI-Powered测试自动化(通过zl-质基特)
-   [ ] 情报部门的建议
-   [ ] 预测质量门
-   [ ] 通过AI的可获取性验证

## 安装

```bash
pnpm add @alexandregme/zljs
```

同伴依赖性 : `react@19`, (中文(简体) ), `react-dom@19`, (中文(简体) ), `next@>=16`, (中文(简体) ), `@reduxjs/toolkit@2`, (中文(简体) ), `react-redux@9`。 。 。 .

一次导入全局样式( 如在根版式中) 。 它已经告诉Tailwind CSS v4 扫描图书馆的课,所以没有 `@source` 需要:

```css
/* app/globals.css */
@import "tailwindcss";
@import "@alexandregme/zljs/styles.css";
```

```tsx
import { Button } from "@alexandregme/zljs";
import { RootLayout } from "@alexandregme/zljs/next";
import { FormProvider, FormInput } from "@alexandregme/zljs/rhf";

<Button onClick={handleClick}>Submit</Button>;
```

## 颜色

组件工作时没有设置,使用默认颜色. 要使用自己的, 导入样式后重新定义您想要的值 :

```css
@import "tailwindcss";
@import "@alexandregme/zljs/styles.css";

@theme {
  --color-zl-primary: #2e7d32;
}
```

`primary`, (中文(简体) ), `success`, (中文(简体) ), `danger`, (中文(简体) ), `warning`, (中文(简体) ), `info` 财务报告和审定财务报表 `muted` 每个都取一个值(`--color-zl-<color>`),用于文本和重点大纲。 其他人跟着它, 你可以重新定义他们:

| 数值 | 用于 | 默认 |
| --- | --- | --- |
| `--color-zl-<color>-strong` | 链接徘徊和标签文本 | 30%更暗 |
| `--color-zl-<color>-bg` | 按钮背景 | 颜色本身( E)`warning`数字 : `yellow-500`(中文(简体) ) |
| `--color-zl-<color>-hover` | 按钮徘徊 | 背景 15% 更暗 |
| `--color-zl-<color>-on` | 背景文字 | 白色( R)`warning`数字 : `gray-900`(中文(简体) ) |

A 类 `Tag` 还取了辅助颜色 `orange`, (中文(简体) ), `pink` 财务报告和审定财务报表 `purple`,它们本身没有意义:用它们来区分类别。 每个只有 `--color-zl-<color>` 财务报告和审定财务报表 `--color-zl-<color>-strong`第一个,15%,是 `Tag` 背景,第二个是其文本.

仅检查默认值对比值 。 请检查access-date=中的日期值 (帮助) 4.5: 1 文本, 打开 `--color-zl-<color>` 反页并开 `-on` 反对 `-bg`,重点大纲为3:1。 嵌入元素上设定的值不能达到其产生的值,所以设置在 `@theme` 或者说 `:root`。 。 。 .

## 更新

见 [`CHANGELOG.md`](https://npmcn.com/package/%40alexandregme/zljs/CHANGELOG.md),在 [保留更改日志](https://keepachangelog.com/en/1.1.0/) 格式。 需要应用中动作的改变有: **移徙** 记着,写着一个特工可以跟着它 带包裹的文件船,在 `node_modules/@alexandregme/zljs/CHANGELOG.md`。 。 。 .

## 开始

```bash
pnpm install
pnpm storybook    # Component library docs
pnpm agent:dev    # AI agent
pnpm test         # Run tests
```

## 技术堆栈

TypeScript, React 19, Tailwind CSS v4, Story Book 10, Radix UI, pnpm 工作空间, GitHub 动作, Vercel

## 许可证

麻省理工学院

## 常见问题

### @alexandregme/zljs 是什么？

对企业应用\(Next\.js,Tailwind CSS v4\)有意见,可访问的React组件库\.

### 如何安装 @alexandregme/zljs？

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

### @alexandregme/zljs 支持 TypeScript 吗？

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

### @alexandregme/zljs 支持 ESM 还是 CommonJS？

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

### @alexandregme/zljs 可以商用吗？

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

### @alexandregme/zljs 的下载量有多少？

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

### @alexandregme/zljs 还在维护吗？

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