Codex 中文提交说明

在 VS Code 的“源代码管理”工具栏增加一个 Codex 图标，点击后使用 Codex 生成中文提交说明，并填入当前 Git 仓库的提交输入框。

使用

1. 查看本次准备提交的更改，按需要暂存文件。
2. 点击源代码管理工具栏中的 Codex 图标，或在命令面板运行“Codex: 生成中文提交说明”。
3. 检查生成的中文说明，然后使用原有的提交按钮提交。

有暂存文件时，说明只依据暂存差异生成；没有暂存文件时，会依据当前跟踪文件的改动和未被忽略的新文件生成。扩展不会自动暂存、提交或推送。

生成过程中可取消。如果你在等待时编辑了提交输入框，扩展会保留你输入的内容，并提供复制生成说明的选项。

Codex

优先使用已经安装的 OpenAI Codex 扩展中的 Codex CLI，也可通过 codexCommit.executablePath 设置可执行文件路径。使用 Codex 已保存的登录状态，不需要另填 API Key。

生成使用独立的临时只读会话、Codex CLI 默认模型和较低推理强度。该会话不加载用户的 MCP、钩子配置或仓库说明，只接收扩展收集的差异。详细差异最多约 96,000 个字符，超出时保留文件列表并注明截断；二进制及较大的未跟踪文件只记录文件名。

超时默认 180 秒，可在 codexCommit.timeoutSeconds 中调整。错误详情和已生成的说明可在“输出 → Codex 中文提交说明”中查看。

实现使用 Codex 官方非交互调用接口 与 VS Code Source Control API。本扩展由独立开发者维护，与 OpenAI、Microsoft 无隶属关系，也未获得其背书。Codex、Git 和 VS Code 名称仅用于说明兼容产品。

市场图标由 imagegen 根据本项目的原创构图生成，工具栏图标由通用几何图形独立绘制，均不使用第三方品牌标志。

数据处理

点击生成按钮后，本次收集的文件列表和代码差异会通过本机 Codex CLI 发送给当前 Codex 账号所使用的模型服务。请只在允许使用该服务的仓库中运行。本扩展不另设遥测或独立上传服务。

源码与验证

• extension.js：工具栏命令、仓库选择、进度和提交输入框写入。
• lib/generator.js：只读差异收集、Codex 调用和中文输出校验。
• test/generator.test.js：Git 范围、Unicode、取消与超时测试。
• test/vscode-test.js：真实 VS Code 扩展宿主与 Codex 调用测试。
• scripts/package_vsix.py：使用 Python 标准库打包本地 VSIX；市场发布使用官方 @vscode/vsce 打包。

本地安装：在扩展视图选择“从 VSIX 安装”，选取 codex-chinese-commit-message-0.1.1.vsix。市场标识为 rscgg.codex-chinese-commit-message。卸载时搜索“Codex 中文提交说明”并卸载即可。