# @gentleduck/libs 中文文档

规范地址：https://npmcn.com/package/%40gentleduck/libs/

版本：1\.0\.0
npm 元数据更新时间：2026-05-30T06:22:34.189Z
中文译文更新时间：2026-11-16T04:11:39.209Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40gentleduck/libs
原文对照：https://npmcn.com/package/%40gentleduck/libs/?lang=original
项目主页：https://gentleduck.org/duck-ui
源码仓库：https://github.com/gentleeduck/gentleduck

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

- 包体积（解压后）：11.9 kB，22 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.0\.0
- 运行依赖：0 个
- peer 依赖：clsx ^2\.1\.1，tailwind-merge ^3\.4\.0
- 首次发布：2025-09-02T14:15:07.416Z
- 最新版本发布：2026-05-30T06:22:34.074Z
- 近 30 天下载量：3075（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：16（近 12 个月 8 个）

## 中文简介

微小, 为温和duck/ ui 的框架不可知的效用 .

## 安装

```sh
npm install @gentleduck/libs
```

也可以使用：`pnpm add @gentleduck/libs`、`yarn add @gentleduck/libs`、`bun add @gentleduck/libs`

## README

![@gentleduck/libs](https://npmcn.com/package/public/logo-dark.svg)

# @ gentleduck/ libs (英语)

微小, 为温和duck/ ui 的框架不可知的效用 .

[麻省理工学院](https://npmcn.com/package/LICENSE) - 说吧 [更改日志](https://npmcn.com/package/CHANGELOG.md) - 说吧 [捐款](https://npmcn.com/package/CONTRIBUTING.md) - 说吧 [文档](https://gentleduck.org/duck-ui)

[![npm](https://img.shields.io/npm/v/@gentleduck/libs.svg)](https://www.npmjs.com/package/@gentleduck/libs) [![downloads](https://img.shields.io/npm/dm/@gentleduck/libs.svg)](https://www.npmjs.com/package/@gentleduck/libs) [![MIT](https://img.shields.io/npm/l/@gentleduck/libs.svg)](https://npmcn.com/package/LICENSE)

* * *

为温和的杜克生态系统共享公用事业.

## 快速启动

```bash
bun add @gentleduck/libs
```

```tsx
import { cn } from '@gentleduck/libs/cn'

<div className={cn('base', active && 'bg-blue-500')} />
```

## 公用事业

| 工具 | 导入 | 说明 |
| --- | --- | --- |
| `cn` | `@gentleduck/libs/cn` | 条件类Name 合并( Clsx + 尾风- 相接) |
| `cnMemo` | `@gentleduck/libs/cn` | 纪念 `cn` 用于稳定的分级输入 |
| `chunkByCounts` | `@gentleduck/libs/chunk-by-counts` | 按给定大小将数组分割为相继组 |
| `filteredObject` | `@gentleduck/libs/filtered-object` | 类型安全浅层 `Omit<T, K>` |
| `generateArabicSlug` | `@gentleduck/libs/generate-arabic-slug` | URL 安全保留阿拉伯脚本+拉丁文+数字 |
| `getTodayDate` | `@gentleduck/libs/get-today-date` | 今天作为 `YYYY-MM-DD` 本地时区 |
| `groupArrays` | `@gentleduck/libs/group-array` | **堕地.** 别名 `chunkByCounts` (反向段落) |
| `groupDataByNumbers` | `@gentleduck/libs/group-data-by-numbers` | **堕地.** 别名 `chunkByCounts` |
| `parseDate` | `@gentleduck/libs/parse-date` | 解析 `"today"`, (中文(简体) ), `"in N days"`,ISO-8601,或长式日期为 `Date` |

每个电源通过自己的子路径导出可以树起震动. 零框架依赖关系.

### 业绩说明

-   `cn()` 在每个呼叫中分配一个新数组,并按 `tailwind-merge` 每一个引用都经过三次 1000多个进口站点的单雷波范围 最热的类Name 路径 。 将稳定阶层的绳子从成形体中拉出,或者 使用情况 `cnMemo` 当输入是稳定的原始字符串时.
-   `cnMemo` 键入所加入输入的缓存。 不输入动态 booleans / 数组 / 对象 – 漏出内存而无还.

### 折旧

`groupArrays` 财务报告和审定财务报表 `groupDataByNumbers` 是字节相同的执行 带有倒转参数顺序。 都已经是瘦化的化名了 `chunkByCounts` 将在下一个大赛中被淘汰。 迁移到:

```ts
import { chunkByCounts } from '@gentleduck/libs/chunk-by-counts'

chunkByCounts(['a', 'b', 'c', 'd', 'e'], [2, 3])
// => [['a', 'b'], ['c', 'd', 'e']]
```

## 许可证

麻省理工学院

## 常见问题

### @gentleduck/libs 是什么？

微小, 为温和duck/ ui 的框架不可知的效用 \.

### 如何安装 @gentleduck/libs？

在项目目录运行 npm install @gentleduck/libs，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：clsx（^2\.1\.1）、tailwind-merge（^3\.4\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @gentleduck/libs 支持 TypeScript 吗？

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

### @gentleduck/libs 支持 ESM 还是 CommonJS？

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

### @gentleduck/libs 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @gentleduck/libs 可以商用吗？

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

### @gentleduck/libs 的下载量有多少？

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

### @gentleduck/libs 还在维护吗？

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

