WorkBuddy如何链接GitHub自动操作仓库
整个流程分为 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
- 三项确认(绿色对勾):
- ✅ 验证您的 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_id=65657419
第九步:登录 GitHub(如未自动登录)
如果 cookie 失效,会显示 GitHub 标准登录页:
- 标题:登录 GitHub 以继续访问 CodeBuddy-Connector
- 三个登录方式:
- 用户名 + 密码(推荐)
- 继续使用 Google
- 继续使用 Apple
操作:输入用户名/邮箱 + 密码 → 点击「登入」
第十步:找到 CodeBuddy-Connector GitHub App
GitHub 登录后,会自动跳转到 GitHub Apps 安装页:
如果没有自动跳转,手动打开这个URL:Sign 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 · GitHub
- Sign in to GitHub · GitHub
- Sign in to GitHub · GitHub
- Manual | GitHub CLI
