# @chiballc/utils 中文文档

规范地址：https://npmcn.com/package/%40chiballc/utils/

版本：2\.6\.2
npm 元数据更新时间：2026-11-06T09:16:23.111Z
中文译文更新时间：2026-11-09T12:51:43.394Z
软件包许可：ISC

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

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

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

- 包体积（解压后）：618 kB，77 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：11 个
- peer 依赖：ipx ^4\.0\.0，hono ^4\.12\.34，vite ^5\.0\.0 \|\| ^6\.0\.0 \|\| ^7\.0\.0 \|\| ^8\.0\.0，unstorage ^1\.17\.6，@hono/zod-openapi ^1\.5\.1
- 首次发布：2026-04-11T18:47:18.204Z
- 最新版本发布：2026-11-06T09:16:22.760Z
- 近 30 天下载量：4261（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：30（近 12 个月 30 个）

## 中文简介

TypeScript 工具,浏览器工人消息,以及用于OpenBao后置运行时配置的 Kibao Nuxt 模块.

## 安装

```sh
npm install @chiballc/utils
```

也可以使用：`pnpm add @chiballc/utils`、`yarn add @chiballc/utils`、`bun add @chiballc/utils`

## README

# 千叶有限责任公司 用户

TypeScript 工具,浏览器工人消息,以及用于OpenBao后置运行时配置的 Kibao Nuxt 模块.

## 安装

```bash
pnpm add @chiballc/utils
```

从包根导入核心帮助. 工人和Nuxt入口使用明显的子路径.

```ts
import { execute, LRUCache } from "@chiballc/utils";
import { useWebWorker } from "@chiballc/utils/web-workers";
import { useServiceWorker } from "@chiballc/utils/service-workers";
import serviceWorkerPlugin from "@chiballc/utils/plugins";
```

克宝被捆入"根包". 在 Nuxt 注册 `@chiballc/utils/kibao`; 可用运行时间帮助 `@chiballc/utils/kibao/runtime`。 。 。 .

```ts
export default defineNuxtConfig({
  modules: ["@chiballc/utils/kibao"],
});
```

图像移取可取自 `@chiballc/utils/images`。有条件的导出选择 Cloudflare 图像绑定, `ipx` (节点)或 `Bun.Image` (Bun) 通过构建目标适配器,有未存储后缓存层; `@chiballc/utils/images/nuxt` 登记它为 Nitro 预设。 见 [图像](https://chiballc.github.io/utils/packages/images)。 。 。 .

完整的API文档,示例,生命周期行为,以及OpenBao安全模型均可在下列地点获得: [c. github.io/ 无效](https://chiballc.github.io/utils/)。 。 。 .

## 文档

文献网站使用VitePress.

```bash
pnpm install
pnpm docs:dev
```

`pnpm docs:build` 将制作网站写入 `docs/.vitepress/dist`启用 `pnpm docs:preview` 服务于本地构建的产出.

## GitHub 页面

`.github/workflows/deploy-docs.yml` 建立和部署文档文件, `package.json`,或 `pnpm-lock.yaml` 更改 `main`。它使用 GitHub Pages 文物,所以没有生成文件或 `gh-pages` 分支是承诺的.

在仓库的 GitHub 设置中, 打开 **页 次** 选择 **GitHub 动作** 作为出版来源。 站点配置为项目站点路径 `https://chiballc.github.io/utils/`。如果移动到自定义域或组织根站点,则更新 `base` 内 `docs/.vitepress/config.mts`。 。 。 .

## 许可证

公务员制度委员会

## 常见问题

### @chiballc/utils 是什么？

TypeScript 工具,浏览器工人消息,以及用于OpenBao后置运行时配置的 Kibao Nuxt 模块\.

### 如何安装 @chiballc/utils？

在项目目录运行 npm install @chiballc/utils，或使用 pnpm add / yarn add / bun add。

### @chiballc/utils 支持 TypeScript 吗？

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

### @chiballc/utils 支持 ESM 还是 CommonJS？

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

### @chiballc/utils 可以商用吗？

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

### @chiballc/utils 的下载量有多少？

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

### @chiballc/utils 还在维护吗？

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