codegeex 可基于暂存区 diff 自动生成符合 conventional commits 规范的提交信息：安装插件后暂存文件，点击 git 面板闪电图标即可生成多条选项，支持预设模板、作用域检测及单文件精准生成。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果你正在 VS Code 中完成代码修改，却卡在 Git 提交消息的措辞上——不确定该用 feat 还是 fix、要不要加作用域、是否遗漏关键改动点，CodeGeeX 可以直接基于你暂存区的 diff 自动生成符合 Conventional Commits 规范的一行式提交信息，省去反复推敲和格式校验的时间。
安装并启用 CodeGeeX 插件
打开 VS Code 扩展市场（Ctrl+Shift+X），搜索 【CodeGeeX 智能编程助手】，点击安装并重启编辑器。插件需全局启用，否则 Git 面板中不会出现 CodeGeeX 图标。
确保你的 VS Code 版本 ≥ 1.68.0，低版本将无法加载插件核心功能。
在源代码管理面板一键生成提交信息
完成代码修改后，先将文件 【暂存（Stage）】：在源代码管理视图（Ctrl+Shift+G）中勾选变更文件左侧复选框，或右键选择“暂存更改”。未暂存的文件不会被分析。
点击提交消息输入框上方的闪电图标（CodeGeeX 图标），插件立即读取 git diff 内容并生成建议消息。
生成结果会以下拉列表形式弹出，通常包含 3～5 条不同风格的选项，例如：feat(api): add retry logic for 429 responses、fix(auth): prevent token refresh on expired session。选中最贴切的一条，按 Enter 确认插入。
若首条不理想，可点击“重新生成”按钮切换语义侧重——它会基于相同 diff 重新采样，可能给出更偏重影响范围或修复深度的表述。
自定义生成风格与作用域
进入 VS Code 设置（Ctrl+,），搜索 【codegeex.commit】，找到 CodeGeeX: Commit Message Style 选项。
方法一：选择预设模板 可选 “Conventional Commits”（默认）、“Angular”、“Atom” 等，不同模板对前缀粒度、作用域括号格式、冒号后空格规则有细微差异。
方法二：手动注入作用域
在设置中启用 CodeGeeX: Enable Scope Detection，插件会扫描当前修改涉及的文件路径（如 src/components/Button.tsx → 自动提取 scope 为 components），生成类似 chore(components): update storybook args interface 的消息。
注意：作用域检测依赖文件路径结构，若项目使用扁平化目录（如所有组件都在 src/ 下无子目录），该功能可能返回空 scope。
通过右键菜单为单个文件生成精准消息
第一步：在源代码管理视图的 Local Changes 列表中，右键点击某个已暂存的文件（非文件夹）。
第二步：从上下文菜单中选择 【CodeGeeX → Generate Commit Message】。
第三步：插件仅分析该文件的 diff，输出高度聚焦的描述，例如修改了 utils/date.ts 中的时区处理逻辑，可能生成 fix(utils): correct DST offset calculation in parseLocalDate。
这一步适合重构类提交——当一个文件承担多个职责，但你只想为其中一项改动写 message，避免泛泛而谈。
