# @cenk1cenk2/cz-cc 中文文档 规范地址：https://npmcn.com/package/%40cenk1cenk2/cz-cc/ 版本：3\.0\.12 npm 元数据更新时间：2026-11-04T10:12:47.985Z 中文译文更新时间：2026-11-09T08:40:29.819Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40cenk1cenk2/cz-cc 原文对照：https://npmcn.com/package/%40cenk1cenk2/cz-cc/?lang=original 源码仓库：https://gitlab.kilic.dev/libraries/cz-cc ## 关键信息（来自 npm 元数据） - 包体积（解压后）：15.9 kB，4 个文件 - 模块格式：CommonJS - TypeScript 类型：未声明 - Node.js 要求：\>= 24 - 运行依赖：6 个 - 首次发布：2020-07-26T15:13:17.672Z - 最新版本发布：2026-11-04T10:12:47.878Z - 近 30 天下载量：3432（2026-10-10 至 2026-11-08，npm 官方下载统计） - 已发布版本数：145（近 12 个月 42 个） ## 中文简介 遵循常规更改log格式提交适配器. ## 安装 ```sh npm install @cenk1cenk2/cz-cc ``` 也可以使用：`pnpm add @cenk1cenk2/cz-cc`、`yarn add @cenk1cenk2/cz-cc`、`bun add @cenk1cenk2/cz-cc` ## README # @cenk1cenk2/cz-cc [![pipeline status](https://gitlab.kilic.dev/libraries/cz-cc/badges/master/pipeline.svg)](https://gitlab.kilic.dev/libraries/cz-cc/-/commits/master) [![Version](https://img.shields.io/npm/v/@cenk1cenk2/cz-cc.svg)](https://npmjs.org/package/@cenk1cenk2/cz-cc) [![Downloads/week](https://img.shields.io/npm/dw/@cenk1cenk2/cz-cc.svg)](https://npmjs.org/package/@cenk1cenk2/cz-cc) [![Dependencies](https://img.shields.io/librariesio/release/npm/@cenk1cenk2/cz-cc)](https://npmjs.org/package/@cenk1cenk2/cz-cc) [![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release) ![Demo](https://npmcn.com/package/%40cenk1cenk2/cz-cc/demo/demo.gif) - [说明](https://npmcn.com/package/%40cenk1cenk2/cz-cc/#readme-description) - [使用量](https://npmcn.com/package/%40cenk1cenk2/cz-cc/#readme-usage) - [配置](https://npmcn.com/package/%40cenk1cenk2/cz-cc/#readme-configuration) - [软件包.json](https://npmcn.com/package/%40cenk1cenk2/cz-cc/#readme-packagejson) - [环境变量](https://npmcn.com/package/%40cenk1cenk2/cz-cc/#readme-environment-variables) - [中断更改](https://npmcn.com/package/%40cenk1cenk2/cz-cc/#readme-breaking-changes) - [迁移到 v3](https://npmcn.com/package/%40cenk1cenk2/cz-cc/#readme-migration-to-v3) - [委员会](https://npmcn.com/package/%40cenk1cenk2/cz-cc/#readme-commitlint) ## 说明 这是直接的叉子 [cz- 常规变化日志](https://github.com/commitizen/cz-conventional-changelog)时,它交换 `inquirer` 页:1 `enquirer` 以输入类型,并减少总的问题,使许多问题成为可选的. ## 使用量 - 安装承诺。 要么在全球范围内,要么在项目中. ```shell # yarn yarn global add commitizen # npm npm install -g commitizen ``` - 在工程中启动这个适配器 。 如果已经启动, 您可以添加 `--force` 旗下可以将这个适配器和旧的相换. - 目前工作空间有问题 `commitizen`。 。 。 . ```shell # yarn commitizen init @cenk1cenk2/cz-cc --yarn --dev # npm commitizen init @cenk1cenk2/cz-cc --dev ``` - 添加 git- hooks 为 [小时](https://hk.jdx.dev/)。 。 。 . ```pkl amends "package://github.com/jdx/hk/releases/download/v2.0.1/hk@2.0.1#/Config.pkl" hooks { ["prepare-commit-msg"] { steps { ["commitizen"] { fix = "git cz --hook" interactive = true } } } } ``` - 添加 [承诺](https://github.com/conventional-changelog/commitlint#readme) 如果需要的话. ## 配置 利用全球承诺安装安装适配器. 下面是配置设置 . ### 软件包.json 与承诺式一样,您通过包指定了cz-常规切换log的配置. 强森的 `config.commitizen` 键. ```json5 { // ... default values "config": { "commitizen": { "path": "./node_modules/@cenk1cenk2/cz-cc", "preset": "conventionalcommits", "maxHeaderWidth": 100, "maxLineWidth": 100, "defaultType": "", "defaultScope": "", "defaultSubject": "", "defaultBody": "", "defaultIssues": "", "types": { ... "feat": { "description": "A new feature", "title": "Features" }, ... } } } // ... } ``` `preset` 选择断开更改是如何被提示和渲染的, 或 `conventionalcommits` (违约)或 `angular`。见 [中断更改](https://npmcn.com/package/%40cenk1cenk2/cz-cc/#readme-breaking-changes)。 。 。 . ### 环境变量 以下的环境可流体可以用来覆盖任何默认配置或包. json基于配置. - CZ PRESET = 预设 - CZ TYPE = 默认类型 - CZ SCOPE = 默认范围 - CZ SUBJECT = 默认对象 - CZ BODY = 默认的Body - CZ MAX HEADER WIDTH = 最大页眉宽度 - CZ MA LINTH = 最大线网 ## 中断更改 突破性变化通过快速和 `preset` 组合决定提供两种机制中的哪一种。 它必须与发布工具分析的预设相匹配. - `conventionalcommits` (单位:千美元)**默认**二者兼具. `breaking-marker` 附加 `!` 如 `feat(api)!: drop the legacy token endpoint`,以及 `breaking-changes` 附录a `BREAKING CHANGE` 脚指. 规格将两者视为独立的信号,因此任何一个单独标出承诺即为破解并选择两者都是有效的. - `angular` 提议 `breaking-changes` 一个人,因为 `!` 标记不是其头图案的一部分。 这是每一次发布在v3之前的行为. 选择既不离开承诺的不突破,所以普通的承诺仍然在一次通过中跳过整个主题. ### 迁移到 v3 `conventionalcommits` 成为 v3 中的默认, 因此通过适配器所做的承诺现在可以携带 `!` 在页眉中标记一次 `breaking-marker` 已选定。 有两件事要查: - 释放工具必须分析与 `conventionalcommits` 预设,否则 `!` 标记不读取为大起落. `@semantic-release/commit-analyzer` 财务报告和审定财务报表 `commitlint` 都拿一个 `preset` 他们自己的. - `header-max-length` 计算额外字符,任何工具匹配自定义正则表达式的 承诺信头必须允许 `!` 在结肠之前. 为了保持先前的行为, 将预设后置 : ```json5 { config: { commitizen: { preset: 'angular' } } } ``` ## 委员会 如果使用 [承诺](https://github.com/conventional-changelog/commitlint) js 库,"maxheaderWidth"配置属性将默认为"header-max-长"规则的配置,而不是100的硬码值. 这可以通过设置宏包中的"maxheaderWidth"配置来覆盖.json或CZ MA HEADER WIDTH环境变量. ## 常见问题 ### @cenk1cenk2/cz-cc 是什么？ 遵循常规更改log格式提交适配器\. ### 如何安装 @cenk1cenk2/cz-cc？ 在项目目录运行 npm install @cenk1cenk2/cz-cc，或使用 pnpm add / yarn add / bun add。 ### @cenk1cenk2/cz-cc 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cenk1cenk2\_\_cz-cc 是否存在。 ### @cenk1cenk2/cz-cc 支持 ESM 还是 CommonJS？ 以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。 ### @cenk1cenk2/cz-cc 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>= 24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @cenk1cenk2/cz-cc 可以商用吗？ @cenk1cenk2/cz-cc 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @cenk1cenk2/cz-cc 的下载量有多少？ 根据 npm 官方下载统计，@cenk1cenk2/cz-cc 在 2026/10/10 – 2026/11/08 这 30 天内被下载 3,432 次，日均约 114 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @cenk1cenk2/cz-cc 还在维护吗？ 最新版本 3\.0\.12 发布于 2026/11/04（5 天前）；至今共发布 145 个版本，其中过去 12 个月发布了 42 个；首次发布于 2020/07/26。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。