整个流程分为 5 大阶段、12 个核心步骤第一步安装 GitHub 连接器安装 GitHub 连接器打开 WorkBuddy 连接器面板进入「更多连接器」入口打开 WorkBuddy 客户端在底部 技能栏找到 连接器图标。点击后会弹出连接器下拉列表红框标注的「更多连接器」 按钮在列表底部 —— 点击进入完整连接器管理页。 截图 1底部连接器入口 红框标注更多连接器位置第二步在连接器里找到 GitHub进入连接器页面后可以看到上百个连接器。在列表中定位 GitHub图标GitHub 八角章鱼标志描述在 GitHub 上克隆、推送代码查看和管理仓库与 Pull Request用自然语言完成代码协作。右侧有 号点击添加第三步点击「连接」触发 GitHub 授权点击 后弹出 GitHub 安装确认弹窗标题GitHub描述同上绿色 「连接」 按钮红框标注点击「连接」后顶部会出现 Toast 提示连接器 GitHub 已解锁。注如果没有自动触发到这个链接可以手动复制到浏览器打开打开https://github.com/login/oauth/authorize?client_idIv23liIip3I7DTZzqlzqredirect_urihttps%3A%2F%2Fwww.codebuddy.cn%2Fconsole%2Fas%2Fp%2Fconnector%2Foauth%2Fgithub%2Fconnectresponse_typecodescoperepouserstateH2x_YOFt0OAyE3tNpuSW-rQUc5HUGW7-xWGa5U6yBh0CYMIg7bvOEAdOZfaKLrj1cG9rIHNi8GadyZi3w-pRHijbCNZUvID2N14U5RLzPd7usrWy0cbjwmHj4hIiaT1ON7qEaLJX2FkGLOHCuSZ6zqs58sc6LEz0XjXuUKqMJ4oIZASZ2bp1cFE第四步查看 GitHub 授权页 (中英对照图跳转 GitHub OAuth 授权页点击「连接」后浏览器自动跳转到 GitHub 官方授权页页面关键信息应用名CodeBuddy-Connector by CodeBuddy-Official-Account三项确认绿色对勾✅ 验证您的 GitHub 身份✅ 了解可以访问哪些资源✅ 代表你行动请求权限清单17 项第五步点击「授权」页面底部有一个绿色「授权」按钮红框标注下方还有取消按钮。点击「授权」后浏览器会 重定向到https://www.codebuddy.cn回调地址第六步等待授权成功浏览器跳转到 CodeBuddy 官网的成功页面中央白色卡片GitHub 章鱼标志显示 connectors.github.title 和 connectors.auth.success这是开发期的英文 key正式版会翻译成GitHub 授权成功蓝色倒计时结束后页面自动关闭第七步回到 WorkBuddy 确认连接回到 WorkBuddy 连接器列表页可以看到 GitHub 卡片右上角出现绿色圆点表示已连接右侧的 变成箭头 表示点击可进入详情。GitHub 端安装/配置 App⚠️ 这一步是很多人最常遗漏的只完成 OAuth 授权不够还需要在 GitHub 端安装 GitHub App否则 WorkBuddy 无法访问你的仓库。第八步GitHub 首次访问触发安全确认如果 GitHub 检测到陌生环境会先弹出确认访问页面标题确认访问 / Confirm access当前用户登录你的账户提示你正在进入 sudo 模式。在你执行了 sudo 保护操作后只有在几小时未激活后才会被要求重新认证。操作输入 GitHub 密码 → 点击「确认 / Confirm」如果没有自动触发链接弹窗可以手动打开链接https://github.com/CodeBuddy-Official-Account https://github.com/apps/codebuddy-connector/installations/new/permissions?target_id65657419第九步登录 GitHub如未自动登录如果 cookie 失效会显示 GitHub 标准登录页标题登录 GitHub 以继续访问 CodeBuddy-Connector三个登录方式用户名 密码推荐继续使用 Google继续使用 Apple操作输入用户名/邮箱 密码 → 点击「登入」第十步找到 CodeBuddy-Connector GitHub AppGitHub 登录后会自动跳转到 GitHub Apps 安装页如果没有自动跳转手动打开这个URLSign in to GitHub · GitHub页面布局左侧导航栏个人设置公众形象、账号、外观等右侧主区「应用 / Applications」 标签三个子标签⬇️ 已安装的 GitHub Apps红框授权的 GitHub Apps授权的 OAuth 应用第十一步检查授权的 GitHub 应用切换到 「授权的 GitHub 应用 / Authorized GitHub Apps」 标签列表显示已经授权的所有 GitHub App截图示例中显示CodeBuddy-连接器从 CodeBuddy 官方拥有第十一步OAuth 应用对照应用切换到授权的 OAuth 应用标签GitHub CLI 红框第十二步配置 CodeBuddy-Connector 权限最关键如果还需要更细的权限控制切换到 「授权的 OAuth 应用 / Authorized OAuth Apps」 标签可以看到所有 OAuth 授权的应用如 GitHub CLI、OfxAI 等。对于 CodeBuddy-Connector点击右侧「Configure」进入配置页配置选项1. 权限 (Permissions)✅ 读取权限管理、代码空间生命周期管理员、代码空间元数据✅ 读写 Dependabot 警报、动作、动作变量、工作元数据、认证 API、检查、代码、代码空间、提交状态、仓库自定义属性、部署、讨论、环境、问题、合并队列、包、页面、拉取请求、仓库顾问、仓库钩子、仓库项目、秘密扫描警报、秘密扫描推送保护块请求、安全事件以及工作流程2. 存储库访问 (Repository access)✅ 所有存储库红框标注—— 适用于资源所有者拥有的所有当前和未来存储库⚪ 仅限部分存储库 —— 至少选择一个存储库3. 点击「保存」红框4. 危险区 (Danger Zone)暂停你的安装卸载 CodeBuddy-Connector红框第十三步进入 WorkBuddy 代码开发模式第十四步测试 GitHub 连接第十五步查看验证结果检查GitHub连接状态双向认证是否通过仓库权限是否获取第十六步确认最终结论双重验证双向认证 仓库权限回到 WorkBuddy切换到「代码开发」标签左侧菜单第二个符号然后在对话框输入模型响应模型会调用 GitHub MCP 工具进行以下三步检查get me —— 获取当前认证用户信息用户名、Profile、账号创建时间、公开仓库数、关注者search repositories —— 测试仓库访问权限输出 「GitHub 连接状态检查报告」① 双向认证状态✅ 认证通过② 仓库权限✅ 已获取admin 级别可完全管理所有仓库③ API 访问✅ 正常可读取仓库、用户信息等最终结论GitHub MCP 集成状态完全正常 ✨第十七步让 WorkBuddy 推代码到 GitHub实战发布项目提出发布需求在 WorkBuddy 代码开发标签的对话框中输入建立仓库设置为public规范化发布本项目详细写明所有必要的说明文件第十八步模型分析项目模型会进入 「深度思考」 模式分阶段执行第十九步深入读取项目结构第二十步读取关键源码第二十一步确认项目理解第二十二步明确执行计划第二十三步自动创建文档第二十四步完善 README第二十五步本地 Git 提交第二十六步完成提交第二十七步使用 GitHub MCP 创建仓库第二十八步使用 gh CLI 兜底第二十九步推送到 GitHub第三十步推送完成第三十一步查看完整任务清单✅ 全部步骤完成按上面的 31 步操作完成后WorkBuddy 和 GitHub 就完全连接起来了。 可以用自然语言让 WorkBuddy克隆/推送代码到 GitHub创建/管理仓库下载/部署 Agent 项目规范化发布项目自动写 README、LICENSE 等 常见问题Q1推送时提示GitHub MCP 权限不足正常现象。WorkBuddy 默认 GitHub MCP 是只读的写操作会用 gh CLI 兜底无需手动处理。Q2授权后 GitHub 显示权限不足如何修改已授权的仓库范围回到第十二步在存储库访问里切换「所有存储库」/「仅限部分存储库」点保存。Q3能部署 Agent 项目吗可以。在 WorkBuddy 里说部署这个 Agent 项目到 GitHub Pages 或 发布到 Vercel。 关键资源CodeBuddy-Official-Account · GitHubSign in to GitHub · GitHubSign in to GitHub · GitHubManual | GitHub CLI