# @atcute/tid 中文文档

规范地址：https://npmcn.com/package/%40atcute/tid/

版本：1\.1\.4
npm 元数据更新时间：2026-07-16T00:04:13.515Z
中文译文更新时间：2026-11-07T01:52:25.766Z
软件包许可：0BSD

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

原始 npm 页面：https://www.npmjs.com/package/%40atcute/tid
原文对照：https://npmcn.com/package/%40atcute/tid/?lang=original
源码仓库：https://github.com/mary-ext/atcute

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

- 包体积（解压后）：7.3 kB，11 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2024-08-18T04:17:38.449Z
- 最新版本发布：2026-07-16T00:04:13.302Z
- 近 30 天下载量：7935（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 5 个）

## 中文简介

时间戳标识符编码库

## 安装

```sh
npm install @atcute/tid
```

也可以使用：`pnpm add @atcute/tid`、`yarn add @atcute/tid`、`bun add @atcute/tid`

## README

# @ tcute/ tid (帮助)

aT 协议的时标标识符(TID)编码器.

```sh
npm install @atcute/tid
```

此库执行 atproto 的 TID 编码器, 用于生成压缩而独特的记录密钥 按时间顺序排序.

## 使用量

### 生成 TID

```ts
import * as TID from '@atcute/tid';

// generate a TID for the current time
const tid = TID.now();
// -> "3l25zusnsfctk"

// create from specific timestamp (microseconds) and clock ID
const custom = TID.create(1724171495793000, 512);
// -> "3l25zusnsfck2"
```

在节点J, `TID.now()` 依赖于系统的实时时钟微秒精度 可用,否则会回到毫秒精度.

`TID.now()` 不是单调的 — TID 编码了墙钟时间, 所以生成器必须跟随时钟 更正而不是保留命令。 在不可靠的时钟设备上执行单调 (例如电话)在更正后会让发电机在错误的时间永久被卡住. 页:1 只有一个例外,就是在一个遵守同样时间戳的单一过程中连续快速呼叫, 避免碰撞.

### 解析 TID

```ts
import * as TID from '@atcute/tid';

const { timestamp, clockid } = TID.parse('3l25zusnsfctk');
// timestamp: 1724171495793000 (microseconds since epoch)
// clockid: 816
```

### 正在验证 TID

```ts
import * as TID from '@atcute/tid';

TID.validate('3l25zusnsfctk'); // true
TID.validate('invalid'); // false
```

## 常见问题

### @atcute/tid 是什么？

时间戳标识符编码库

### 如何安装 @atcute/tid？

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

### @atcute/tid 支持 TypeScript 吗？

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

### @atcute/tid 支持 ESM 还是 CommonJS？

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

### @atcute/tid 可以商用吗？

@atcute/tid 使用 0BSD 许可。几乎没有限制：可自由使用、修改和分发，连保留版权声明也不要求。以上为概括，不构成法律意见，请以许可原文为准。

### @atcute/tid 的下载量有多少？

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

### @atcute/tid 还在维护吗？

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