fitten code可自动从git提交记录生成结构化changelog。安装npm install -g @fitten/code,项目根目录执行fitten init初始化,配置.fittenrc.json中changelog字段(含output和fromtag),支持feat/fix等前缀提取,提供全量生成、增量追加(--since)、预览(--dry-run)三种方式,并可通过标题格式、git log对比及github链接有效性三步校验结果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

用Fitten Code自动生成Changelog,省去手动翻Git日志、逐条筛选feat/fix、再按格式拼接的重复劳动,直接从本地仓库提交记录中提取语义化信息生成结构化更新日志。
安装并初始化Fitten Code CLI
打开终端,执行命令安装全局CLI工具:npm install -g @fitten/code。
进入你的Git项目根目录,运行fitten init。这一步会创建.fittenrc.json配置文件,并自动检测当前仓库的远程地址和默认分支——【必须确保当前目录已是Git仓库且已提交过至少一次】。
初始化完成后,你会看到提示“✅ Config saved”,说明基础环境就绪。
配置Changelog生成规则
编辑项目根目录下的.fittenrc.json,找到changelog字段,填入以下最小必要配置:
"changelog": { "output": "CHANGELOG.md", "fromTag": "v1.0.0" }。
【fromTag值必须是仓库中真实存在的Git tag,否则生成时会报错退出】。若想从首次提交开始生成,可删掉fromTag字段,但首次运行会遍历全部历史,耗时明显增加。
支持的提交类型前缀已预设:feat、fix、docs、refactor、test、chore,默认仅提取feat和fix两类进Changelog。如需加入perf,在types数组中追加即可。
生成Changelog文件
方法一:一次性生成完整日志
CNB 云原生构建平台的 Git 操作技能,支持代码克隆、提交、推送、分支管理、Merge Request 管理、流水线触发与结果读取。初次使用需收集用户的 Git 用户名和邮箱。
运行fitten changelog。工具会自动解析fromTag之后的所有提交,按语义化版本规则分组(major/minor/patch),写入CHANGELOG.md。
方法二:增量追加最新变更
发布新版本前,先打tag:git tag v1.2.0,再执行fitten changelog --since v1.1.0。该命令只抓取v1.1.0到v1.2.0之间的提交,追加到现有文件末尾。
方法三:预览不写入文件
加--dry-run参数: fitten changelog --dry-run。终端直接输出Markdown格式内容,确认无误后再去掉参数正式生成。
校验生成结果是否符合预期
第一步:检查CHANGELOG.md头部是否包含标准语义化标题,形如## [1.2.0](https://github.com/xxx/yyy/compare/v1.1.0...v1.2.0) (2024-06-15)。
第二步:打开Git log对比验证——执行git log v1.1.0..v1.2.0 --oneline,逐行核对每条含feat:或fix:的提交是否出现在Changelog对应版本区块中。
第三步:确认链接是否可点击。生成的GitHub compare链接基于repository字段拼接,若.fittenrc.json里没填"repository": "https://github.com/xxx/yyy",链接会失效,需补全后再重跑。










