codegeex 不直接生成 changelog,但可通过解析 git 提交、润色日志、编写生成脚本或增强 conventional-changelog 输出四种方式辅助构建。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在使用 CodeGeeX 进行开发时,希望借助其能力辅助生成项目 CHANGELOG,需明确 CodeGeeX 本身不直接提供 CHANGELOG 自动生成功能,但可通过其代码理解与文本生成能力,配合 Git 提交信息、规范日志结构或已有日志片段完成整理与润色。以下是实现该目标的多种可行路径:
一、利用 CodeGeeX 对 Git 提交信息进行语义解析与归类
该方法基于 CodeGeeX 的自然语言理解能力,将非结构化的 commit message 转换为符合 Conventional Commits 规范的分类条目,从而支撑后续日志组织。前提是提交信息具备基本可读性,无需严格格式约束。
1、在 IDEA 或 VS Code 中打开终端,执行 git log --oneline -n 50 获取最近 50 条提交摘要。
2、复制输出内容,粘贴至 CodeGeeX 的聊天界面或代码注释生成区域。
3、输入提示词:“请将以下 Git 提交摘要按 feat/fix/docs/refactor/test/chore 分类,并为每类生成简洁中文描述,保留原始 commit hash”。
4、接收 CodeGeeX 输出结果,手动或脚本化导入至 CHANGELOG.md 模板对应章节。
二、使用 CodeGeeX 补全与润色已有 CHANGELOG 片段
当项目已存在部分手工编写的 CHANGELOG 条目,但存在表述冗余、术语不统一或遗漏关键信息等问题时,CodeGeeX 可作为智能编辑器对内容进行一致性增强和用户视角转化。
1、选中 CHANGELOG.md 中待优化的一段(例如 “修复登录页 token 刷新失败”)。
2、右键调出 CodeGeeX 上下文菜单,选择 “重写为面向用户的发布说明”。
3、确认生成结果是否包含影响范围(如“影响所有使用 JWT 自动续期的 Web 用户”)及操作建议(如“无需用户操作,服务端已修复”)。
4、将优化后文本替换原文,保持全文语气与粒度一致。
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本,对Inline Chat功能进行了重大优化,包括UI设计升级、支持流式输出以提升响应速度,并新增“查看思路”按钮以便理解代码原理。同时,该版本在编辑器中新增CodeLens控件,支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
三、通过 CodeGeeX 辅助构建自定义 CHANGELOG 生成脚本
该方法适用于无现成工具链或需深度定制日志结构的团队。CodeGeeX 可快速生成符合项目需求的 Bash/Python 脚本原型,解析 Git 日志并输出 Markdown 格式日志,再由开发者嵌入 CI 流程。
1、在空文件中输入提示:“写一个 Python 脚本:读取 git log --pretty=format:'%h|%s|%an|%ad' --date=short,按周分组,提取 feat/fix 关键词,生成带版本号占位符的 CHANGELOG.md 片段”。
2、运行 CodeGeeX 生成的脚本,检查输出是否包含正确分隔符与标题层级(如 ## [Unreleased]、## [v1.2.0])。
3、将脚本保存为 scripts/generate_changelog.py,并在本地 Git hook(如 post-merge)中添加调用指令。
4、验证每次拉取主干后,scripts/changelog-draft.md 是否自动更新且未覆盖人工修订内容。
四、结合 CodeGeeX 与 conventional-changelog 工具链做双校验
此方案不替代标准工具,而是利用 CodeGeeX 对 conventional-changelog 输出进行可读性增强与上下文补全,尤其适用于需向非技术人员同步版本信息的场景。
1、确保项目已配置 .conventional-changelog 配置文件并安装 conventional-changelog-cli。
2、执行 npx conventional-changelog -p angular -i CHANGELOG.md -s 生成基础日志。
3、将生成的 CHANGELOG.md 内容分块(如每个版本区块),逐段提交给 CodeGeeX。
4、使用提示词:“将以下技术性变更条目转化为产品经理可直接用于发布公告的 30 字以内短句,强调用户获益”,获取传播友好型文案。










