CodeBuddy 与 Git 的深度整合，并不仅仅是安装一个插件这么简单，它实际上是贯穿整个开发流程的基础协作能力——依赖 Git 来完成代码同步、版本回溯，并确保 AI 操作具备可逆性。整个配置过程可以浓缩为三个核心步骤：先让本地 Git 环境就绪，再配置好远程仓库的授权，最后在 CodeBuddy 中触发 Git 意图。下面就直接给出一份可执行的详细操作指南。
Git 环境准备与基础配置
CodeBuddy 本身不包含 Git，因此必须确保系统已安装并绑定了身份信息，否则所有克隆、提交、推送等操作都将无法正常执行。
- 安装 Git（根据操作系统选择对应方式）：
• Windows：从 https://git-scm.com/downloads/win 下载安装包，按默认选项完成安装即可
• macOS：在终端执行 brew install git（前提是已安装 Homebrew 包管理器）
• Ubuntu/Debian：运行 sudo apt-get update && sudo apt-get install git - 全局身份配置（此步骤必不可少，否则提交记录缺少作者信息）：
git config --global user.name "你的GitHub用户名"
git config --global user.email "你注册GitHub时使用的邮箱" - 验证环境是否就绪： 在终端输入 git --version，如果返回类似 git version 2.40.1 的提示，则说明安装成功
GitHub 令牌（Personal Access Token）生成与授权
CodeBuddy 需要借助令牌来访问你的私有仓库或受保护仓库，单纯依赖密码登录是无法实现的。这是安全前提，也是实现自动化克隆和推送的关键凭证。
- 登录 GitHub → 点击右上角头像 → 进入 Settings → 在左侧菜单中滚动到底部 → 选择 Developer settings → 点击 Personal access tokens → 进入 Tokens (classic)
- 点击 Generate new token → 填写 Note（例如 “codebuddy-git”）→ 设置 Expiration（建议选择 90 天）→ 勾选以下权限：
• repo（读写全部仓库）
• workflow（支持后续 CI 自动化流程） - 点击 Generate token → 页面会立即显示一串长字符串 → 请立即复制并安全保存（关闭页面后将无法再次查看）
在 CodeBuddy 中完成 Git 集成操作
不同形态的 CodeBuddy 触发方式略有差异，但其底层调用的都是同一套 Git 流程。以下以最常用的场景为例进行说明：
- 插件版（VS Code / JetBrains）：
• 启动 IDE 后，点击侧边栏的 CodeBuddy 图标 → 在对话框中直接输入：
“克隆 GitHub 仓库 https://github.com/用户名/仓库名.git，使用我的 GitHub 令牌 XXXXXX”
• CodeBuddy 会自动创建本地文件夹、执行 git clone 命令，并设置远程仓库 origin - CodeBuddy IDE（独立版）：
• 启动后选择 Import from VS Code 或 New Folder → 进入项目后，在底部状态栏点击 Git 图标 → 选择 Connect to GitHub → 粘贴刚才复制的令牌 → 授权完成 - CLI 版（codebuddy 命令行工具）：
• 在终端进入项目目录 → 运行：
codebuddy -p "提交当前所有修改，提交信息为：完成用户登录逻辑重构"
• 如果是首次操作，CLI 会提示输入 GitHub 令牌，后续操作将自动复用该凭证
日常 Git 协同中的 AI 辅助用法
集成完成后，Git 就不再仅仅是命令行工具，它成为了 CodeBuddy 理解上下文、生成合理变更的基础：
- 让 CodeBuddy 编写提交信息：
• 选中未提交的文件 → 输入：“帮我写一条符合 Conventional Commits 规范的 commit message”
• CodeBuddy 会分析改动内容，输出类似 feat(auth): add JWT token refresh logic 这样规范的提交信息 - 一键解决代码冲突：
• 出现 merge conflict 时，CodeBuddy 可以自动识别冲突块 → 输入：“根据主干最新代码，安全合并 login.js 中的冲突”
• 它会保留双方逻辑，并插入注释说明决策依据 - 回滚误操作：
• 如果不小心删除了关键文件，可直接询问：“恢复上一次提交中 src/utils/api.js 的内容”
• CodeBuddy 会调用 git checkout HEAD -- src/utils/api.js 命令并确认恢复结果