需先配置本地 git 环境并绑定 github 账户：安装 git、设置全局用户名和邮箱、生成并添加 ssh 密钥、复制公钥至 github。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 Qoder 进行开发时，希望代码修改能自动同步至 GitHub 并完成版本归档，但发现提交失败、远程连接中断或推送无响应，则可能是由于 Git 配置未与 GitHub 账户正确绑定、SSH 密钥未生效或 Qoder 的自动推送策略未启用。以下是实现 Qoder 与 GitHub 联动的具体操作路径：
一、配置本地 Git 环境并绑定 GitHub 账户
Qoder 依赖本地 Git CLI 工具执行底层版本控制操作，必须确保 Git 已安装、全局用户信息已设置且 SSH 或 HTTPS 认证通道可用。若认证缺失，所有推送动作将被 GitHub 拒绝。
1、下载并安装 Git for Windows，安装过程中勾选 “Add Git to the system PATH” 选项。
2、打开终端，执行 git config --global user.name "your_github_username" 设置用户名。
3、执行 git config --global user.email "your_registered_email@github.com" 设置邮箱，该邮箱须与 GitHub 账户注册邮箱一致。
4、生成 SSH 密钥对：运行 ssh-keygen -t ed25519 -C "your_registered_email@github.com"，全程按回车使用默认路径与空密码。
5、启动 ssh-agent 并添加私钥：eval "$(ssh-agent -s)" 后执行 ssh-add ~/.ssh/id_ed25519。
6、复制公钥内容：clip （Windows），随后登录 GitHub → Settings → SSH and GPG keys → New SSH key，粘贴并保存。
二、在 Qoder 中启用 Git 插件并关联远程仓库
Qoder 需通过内置 Git 插件识别项目根目录下的 .git 文件夹，并读取 origin 远程地址以触发自动同步。若插件未激活或远程 URL 错误，将无法建立有效推送链路。
1、在 Qoder 编辑器中打开左侧边栏「扩展」，搜索并启用 Git Integration 插件。
2、确认项目根目录存在 .git 文件夹；若不存在，进入终端执行 git init 初始化本地仓库。
3、执行 git remote add origin git@github.com:username/repo.git（替换为实际 SSH 地址）绑定远程仓库。
4、验证绑定结果：运行 git remote get-url origin，输出应为完整 SSH 或 HTTPS URL。
5、在 Qoder 设置中搜索 git.autoFetch，将其设为 true，确保后台定时拉取最新变更。
三、启用 Qoder 自动提交与分支追踪策略
Qoder 的自动版本管理依赖于细粒度的提交行为作为同步锚点。若未开启自动暂存与提交，编辑内容仅存在于工作区，不会生成可广播的 Git 提交记录，导致 GitHub 托管失效。
1、在 Qoder 设置中定位 git.autoStage，设为 true，使每次保存自动暂存修改文件。
2、启用 git.autoCommit，并设置提交消息模板为 "chore(qoder): auto-commit on save"。
3、开启 git.branchAutoSetup，确保新建文件首次保存时自动创建本地分支并与远程同名分支建立追踪。
4、手动建立上游追踪关系：执行 git branch -u origin/main（或 origin/master，依 GitHub 默认分支而定）。
5、验证追踪状态：运行 git branch -vv，当前分支后应显示 [origin/main] 字样。
四、配置 GitHub Webhook 实现事件反向驱动
除正向推送外，Qoder 支持通过 GitHub Webhook 接收外部事件（如 PR 合并、Issue 创建），从而触发数字员工执行代码审查、文档生成等动作。该机制需双向密钥校验确保通信安全。
1、登录 Qoder 企业控制台，进入【集成中心】→【Webhook管理】→【新建接收端】，选择系统类型为 GitHub。
2、系统生成唯一 Webhook URL 与 HMAC-SHA256 签名密钥，请立即复制并安全保存——该密钥仅显示一次。
3、进入对应 GitHub 仓库 Settings → Webhooks → Add webhook，粘贴上述 URL 至 Payload URL 栏。
4、Content type 选择 application/json，Secret 字段填入第 2 步复制的密钥。
5、勾选需监听的事件类型，例如 Pull request、Pushes、Issues，点击 Add webhook 完成注册。
五、启用 Qoder 远程沙箱直推模式（替代本地 Git CLI）
当本地 Git 环境不可控（如受限企业网络、无管理员权限）时，Qoder 可绕过本地 Git，直接通过其云端沙箱环境构建并推送代码包至 GitHub。该方式不依赖本地 ssh-agent 或 git 命令，适用于高隔离场景。
1、在 Qoder 控制台进入【项目设置】→【部署管道】→【GitHub 直连模式】，启用开关。
2、点击【绑定 GitHub 账户】，跳转至 GitHub OAuth 授权页，授予 public_repo 与 workflow 权限。
3、授权完成后，Qoder 自动获取 GitHub App Installation ID 与临时访问令牌。
4、在项目根目录下创建 .qoder/deploy.yml，指定目标仓库为 owner/repo 及分支为 main。
5、任意编辑并保存文件后，Qoder 沙箱将自动打包变更、生成 commit、签署 GitHub API 请求并完成推送。
