项目简介

该项目是一个基于Elemnt Plus进行二次封装的组件库，在保留Element Plus原有API的同时对一些业务场景进行封装和功能扩展。

运行项目

1. npm i ---安装项目依赖
2. npm run dev ---运行项目

文档地址

https://ksw.design.donxj.com/

检查

代码提交前先执行npm run lint检查代码，如有问题代码，可通过npm run fix修复，无法修复的则需要手动消除错误，请确保提交的代码没有问题，否则无法合入。

生成 CHANGELOG

项目使用 git-cliff 来生成 CHANGELOG

$3

``bash

with yarn

yarn add -D git-cliff

with npm

npm install git-cliff --save-dev
`

$3

`bash
npm exec git-cliff

or

npx git-cliff@latest
`

$3

首先先使用 git-cliff print-context 将上下文保存为 context.json

`bash
git-cliff --context --output context.json
`

生成所有版本的依赖, isFullHistory = true 的时候请保持工作区干净

`bash
node dependenciesChange/generate_deps.js
`

将 dependenciesVersion.json 中的内容注入到 context.json 对应版本的 extra.dependencies 中

`bash
node dependenciesChange/inject_deps.js
`

接着从修改后的 context.json 生成 CHANGELOG

`bash
git-cliff --from-context context.json -o CHANGELOG.md
`

提交规范

$3

> 常规提交规范是在提交信息之上的一个轻量级约定。它提供了一套易于遵循的规则，用于创建明确的提交历史；这使得在上面编写自动化工具变得更加容易。这个约定与 SemVer 相契合，通过描述提交信息中提到的特性、修复和破坏性变更。

提交包含以下结构元素，以向您的库的使用者者传达意图：

1. fix: 类型为 fix 的提交表示修复了代码库中的错误（这与语义化版本中的 PATCH 版本相关）。

2. feat: 类型为 feat 的提交表示向代码库引入了新功能（这与语义化版本中的 MINOR 版本相关）。

3. BREAKING CHANGE: 如果提交信息中包含脚注 BREAKING CHANGE:，或者在类型/作用域后附加了 !，则表示引入了破坏性的 API 变更（与语义化版本中的 MAJOR 版本相关）。BREAKING CHANGE 可以出现在任何类型的提交中。

4. 除了 fix: 和 feat: 之外，还允许其他类型的提交信息，例如 @commitlint/config-conventional（基于 Angular 规范）推荐使用 build:、chore:、ci:、docs:、style:、refactor:、perf:、test: 等类型。

5. 除了 BREAKING CHANGE: <描述> 之外，还可以提供其他脚注，并遵循类似于 git trailer 格式 的约定。

Conventional Commits 规范并未强制要求使用其他类型，这些类型在语义化版本控制中也没有隐含的影响（除非它们包含 BREAKING CHANGE）。

可以为提交类型提供一个作用域，以提供额外的上下文信息，作用域包含在括号内，例如：feat(parser): add ability to parse arrays。

示例

$3

#### 无正文的提交信息

`plaintext
docs: 更正 CHANGELOG 的拼写
`

输出:

`
更正 CHANGELOG 的拼写 - (feef1b4)
`

#### 包含作用域的提交信息

`plaintext
feat(lang): 添加波兰语支持
`

输出:

`
(lang) 添加波兰语支持 - (feef1b4)
`

$3

#### 使用 ! 强调破坏性变更的提交信息

`plaintext
feat!: 产品发货时向客户发送邮件
`

输出:

`
[重大变更] 产品发货时向客户发送邮件 - (b2ea094)
`

#### 包含描述和破坏性变更脚注的提交信息

`plaintext
feat: 允许提供的配置对象扩展其他配置

CHANGE: 配置文件中的 extends 键现在用于扩展其他配置文件
`

输出:

`
[重大变更] 允许提供的配置对象扩展其他配置 - (cfe9f23)
`

#### 包含作用域并使用 ! 强调破坏性变更的提交信息

`plaintext
feat(api)!: 产品发货时向客户发送邮件
`

输出:

`
(api) [重大变更] 产品发货时向客户发送邮件 - (0080264)
`

$3

`plaintext
chore!: 放弃对 Node 6 的支持

BREAKING CHANGE: 使用了 Node 6 中不可用的 JavaScript 特性。
`

$3

以下是一个提交信息中英文对照表，基于 commit_parsers 配置进行了整理：

| 英文前缀 | 中文前缀 | 分组标识 |
| ------------ | -------------- | ------------ |
| feat | 特性, 新增 | 🚀 特性 |
| fix | Bug, 修复 | 🐛 Bug 修复 |
| doc | 文档 | 📚 文档 |
| perf | 性能 | ⚡ 性能 |
| refactor | 重构 | 🚜 重构 |
| style | css, 样式 | 🎨 样式 |
| test | 测试 | 🧪 测试 |
| chore | ci | ⚙️ 杂项任务 |
| security | - | 🛡️ 安全 |
| revert | - | ◀️ 退回 |
| .* | - | 💼 修改 |

$3

- feat: 添加新功能 或 特性: 添加新功能 会被归类为 🚀 特性。
- fix: 修复登录问题 或 修复: 修复登录问题 会被归类为 🐛 Bug 修复。
- doc: 更新 README 或 文档: 更新 README 会被归类为 📚 文档`。