# @chronus/chronus 中文文档

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

版本：1\.5\.1
npm 元数据更新时间：2026-09-11T16:02:10.350Z
中文译文更新时间：2026-11-09T15:23:51.726Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：455 kB，317 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.0\.0
- 运行依赖：14 个
- 首次发布：2024-01-28T02:09:34.094Z
- 最新版本发布：2026-09-11T16:02:09.968Z
- 近 30 天下载量：25759（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：37（近 12 个月 6 个）

## 中文简介

克罗纳斯

## 安装

```sh
npm install @chronus/chronus
```

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

## README

# 克罗纳斯

Chronus是帮助管理单列波版本的工具. 每一个 PR 可以被设置为要求每个软件包的更改描述 `chronus verify`。 。 。 . 释放时 `chronus version` 以更改描述为基础生成更改日志.

## 安装

```bash
# Locally (recommended)
npm install -D @chronus/chronus
# Or globally
npm install -g @chronus/chronus
```

## 使用量

| 无 | N | 雅伦 | 全球 |
| --- | --- | --- | --- |
| `npx chronus` | `pnpx chronus` | `yarn chronus` | `chronus` |

### `chronus add [packages...]`

添加新的更改描述 。 可选择地指定更改所适用的软件包。 默认情况下,它会促使哪个软件包应用更改.

选项 :

-   `--since` 只计算自指定分支以来的更改 .

### `chronus verify`

验证软件包中是否有更改 `baseBranch` 这一切都被描述.

选项 :

-   `--since` 只计算自指定分支以来的更改 .

### `chronus status`

此命令将显示工作空间变化的当前状态 。 这基本上是一个总结 `chronus version` 如果跑的话,会做的.

此命令的选项与 [`chronus version`](https://npmcn.com/package/%40chronus/chronus/#readme-chronus-version)。 。 。 .

### `chronus version`

应用软件包的更改描述和凸起版本。 默认情况下, 这将尊重配置的版本策略( 见 [版本政策](https://npmcn.com/package/%40chronus/chronus/version-policies.md)) (中文(简体) ).

### `chronus changelog`

生成变换日志到 stdout 而不折叠软件包的版本 .

选项 :

-   `--package` 生成特定软件包的更改日志.
-   `--policy` 生成特定策略的汇总更改日志.

### 选项

##### `--ignore-policies`

这样可以忽略 [版本政策](https://npmcn.com/package/%40chronus/chronus/version-policies.md) 并独立地撞击包裹。 这可能在 `lockStep` 做热补时的政策.

##### `--only`

只按下指定的软件包 。 如果只想要发布某些软件包, 这可能有用 。 此命令会提取指定包的更改描述并折叠这些包的版本. 如果套件上的更改没有在 `--only` 选项将被忽略。 如果两者都指定了更改,则将适用该更改和包含在 `only` 阵列将从更改描述文件中删除.

```bash
$ chronus version --only @my-scope/my-package1 --only @my-scope/my-package2
```

### `chronus pack`

包装所有配置到工作空间的软件包 .

默认情况下,它将具有与 `npm pack` 在每个软件包目录中运行.

### 选项

##### `--pack-destination`

将打包包放置的目录 。 默认情况下,每个 tar 文件都会被放入包目录中.

```bash
$ chronus pack --pack-destination /temp/artifacts

✔ @chronus/chronus packed in chronus-chronus-0.7.0.tgz (94.5 kB)
✔ @chronus/github-pr-commenter packed in chronus-github-pr-commenter-0.3.0.tgz (5.49 kB)
```

## 常见问题

### @chronus/chronus 是什么？

克罗纳斯

### 如何安装 @chronus/chronus？

在项目目录运行 npm install @chronus/chronus，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 kro、chronus，可以用 npx kro 直接运行。

### @chronus/chronus 支持 TypeScript 吗？

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

### @chronus/chronus 支持 ESM 还是 CommonJS？

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

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

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

### @chronus/chronus 可以商用吗？

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

### @chronus/chronus 的下载量有多少？

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

### @chronus/chronus 还在维护吗？

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