# @appveen/utils 中文文档

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

版本：6\.13\.10-2\.2
npm 元数据更新时间：2025-10-14T10:07:18.940Z
中文译文更新时间：2026-11-06T12:45:15.786Z
软件包许可：BSD-3-Clause

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

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

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

- 包体积（解压后）：29.4 kB，17 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：7 个
- 首次发布：2018-11-15T06:59:20.108Z
- 最新版本发布：2025-10-14T10:07:18.757Z
- 近 30 天下载量：5209（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：46（近 12 个月 0 个）

## 中文简介

appveen utils 库

## 安装

```sh
npm install @appveen/utils
```

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

## README

# \# 倾斜

该图书馆包含各种便利开发工作的实用模块.

1.  **计数器**: 生成唯一ID的模块.
    1.  **交易 IdGenerator: (英语)** 返回可以用于mongoose schema预保存钩钩的函数,以生成一个独特的通用切换 爱德.
    2.  **交易 IdGenerator Parallel : (帮助)** 返回可以用于mongoose schema预保存钩钩的函数,以生成一个独特的通用切换 爱德 在平行中件中使用钩子时,应该使用此函数.
    3.  **获取 IdGenerator :** 返回一个函数,该函数可以用于mongoose schema预保存钩钩,为特定集合中的每个文档生成一个独特的ID。 它需要两个论据: 1. 前缀 2. 收藏 名称
    4.  **错误 :** 函数以设置默认启动 它需要两个论据: 1. 收集 名称 2. 默认值
    5.  **获取数据 :** 递增 Id 的计数并触发参数中指定的回调。 需要三个参数 1. 集合 名称 2. Id (可以是无效) 3. 回调函数
2.  **缓存**: 要使用的帮助函数 [重写](https://redis.io/) 作为用户会话的缓存
    1.  uuid( ): 生成一个没有“ -” 的UUID
    2.  添加Token( token, default, uidOfUI, expiry) : 过期后, 向 UUID 会话添加一个新的用户令牌
    3.  添加UI会话( uuidOfUI, token, uiHeartbeatTimeOut):开始跟踪UI会话
    4.  手柄HeartBeat ( uidOfUI, token, uiHeartbeat Time Out): 处理来自UI的心跳
    5.  显示会议( token): 获取活动 UI 会话列表
    6.  是ValidToken( k):检查给定的密钥 k是否是一个有效的符号
    7.  is BlacklistToken ( k): 检查给定的密钥 k是否为黑名单的令牌
    8.  黑名列表 ( token, expiry): 带有指定过期的黑名列表符号
    9.  刷新Token( tokenOld, tokenNew, expiry):当新令牌发行时使用.
3.  **日期:** 返回指定月前的日期。 需要一个参数: 月份
4.  **IDGenerator: (英语)**
    1.  **获取独占ID :** 生成一个唯一ID,该ID可以作为模型的候选 id.
5.  **移动到 :** 将数据移至弹性搜索
    1.  **输入 :** 初始化对象。 取四格克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克.
    2.  **移动到 :** 将文档移动到弹性搜索服务器。 使用一个参数: doc
    3.  **移动全部 :** 将所有已删除的文档移至弹性搜索。 需要两个参数: req, res
6.  **兰德:** 返回随机整数。 使用一个参数:整数长度.
7.  **日志编辑器 :** 返回一个与 aou crud 库相容的log4j 对象.

## 常见问题

### @appveen/utils 是什么？

appveen utils 库

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

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

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

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/appveen\_\_utils 是否存在。

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

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

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

@appveen/utils 使用 BSD-3-Clause 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。另外不得用原作者名义为衍生产品背书。以上为概括，不构成法律意见，请以许可原文为准。

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

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

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

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