首页/资讯中心/详情

WorkBuddy如何链接GitHub自动操作仓库

WorkBuddy如何链接GitHub自动操作仓库
📅 发布时间：2026/6/29 18:06:32

整个流程分为 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_id=Iv23liIip3I7DTZzqlzq&redirect_uri=https%3A%2F%2Fwww.codebuddy.cn%2Fconsole%2Fas%2Fp%2Fconnector%2Foauth%2Fgithub%2Fconnect&response_type=code&scope=repo+user&state=H2x_YOFt0OAyE3tNpuSW-rQUc5HUGW7-xWGa5U6yBh0CYMIg7bvOEAdOZfaKLrj1cG9rIHNi8GadyZi3w-pRHijbCNZUvID2N14U5RLzPd7usrWy0cbjwmHj4hIiaT1ON7qEaLJX2FkGLOHCuSZ6zqs58sc6LEz0XjXuUKqMJ4oIZASZ2bp1cFE

第四步：查看 GitHub 授权页 (中英对照图）

跳转 GitHub OAuth 授权页，点击「连接」后，浏览器自动跳转到 GitHub 官方授权页：

页面关键信息：

  • 应用名：CodeBuddy-Connector by CodeBuddy-Official-Account
  • 三项确认（绿色对勾）：
    1. ✅ 验证您的 GitHub 身份
    2. ✅ 了解可以访问哪些资源
    3. ✅ 代表你行动

请求权限清单（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_id=65657419

第九步：登录 GitHub（如未自动登录）

如果 cookie 失效，会显示 GitHub 标准登录页：

  • 标题：登录 GitHub 以继续访问 CodeBuddy-Connector
  • 三个登录方式：
    1. 用户名 + 密码（推荐）
    2. 继续使用 Google
    3. 继续使用 Apple

操作：输入用户名/邮箱 + 密码 → 点击「登入」

第十步：找到 CodeBuddy-Connector GitHub App

GitHub 登录后，会自动跳转到 GitHub Apps 安装页：

如果没有自动跳转，手动打开这个URL：Sign in to GitHub · GitHub

页面布局：

  • 左侧导航栏：个人设置（公众形象、账号、外观等）
  • 右侧主区：「应用 / Applications」 标签
  • 三个子标签：
    1. ⬇️ 已安装的 GitHub Apps（红框）
    2. 授权的 GitHub Apps
    3. 授权的 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. 1. 权限 (Permissions)：
    • ✅ 读取权限管理、代码空间生命周期管理员、代码空间元数据
    • ✅ 读写 Dependabot 警报、动作、动作变量、工作元数据、认证 API、检查、代码、代码空间、提交状态、仓库自定义属性、部署、讨论、环境、问题、合并队列、包、页面、拉取请求、仓库顾问、仓库钩子、仓库项目、秘密扫描警报、秘密扫描推送保护块请求、安全事件以及工作流程
  2. 2. 存储库访问 (Repository access)：
    • ✅ 所有存储库（红框标注）—— 适用于资源所有者拥有的所有当前和未来存储库
    • ⚪ 仅限部分存储库 —— 至少选择一个存储库
  3. 3. 点击「保存」（红框）
  4. 4. 危险区 (Danger Zone)：
    • 暂停你的安装
    • 卸载 "CodeBuddy-Connector"（红框）

第十三步：进入 WorkBuddy 代码开发模式

第十四步：测试 GitHub 连接

第十五步：查看验证结果

检查GitHub连接状态，双向认证是否通过？仓库权限是否获取？

第十六步：确认最终结论

👍

双重验证（双向认证 + 仓库权限）

回到 WorkBuddy，切换到「代码开发」标签（左侧菜单第二个，@符号），然后在对话框输入：

模型响应：

模型会调用 GitHub MCP 工具进行以下三步检查：

  1. get me —— 获取当前认证用户信息
    • 用户名、Profile、账号创建时间、公开仓库数、关注者
  2. search repositories —— 测试仓库访问权限
  3. 输出 「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 · GitHub
  • Sign in to GitHub · GitHub
  • Sign in to GitHub · GitHub
  • Manual | GitHub CLI