【WorkBuddy基础教程】使用Github CLI进行项目代码管理&实战案例
Created: 2026-07-02
公众号名称:Draco正在VibeCoding
作者名称:DracoVibeCoding
发布时间:2026-07-02 16:40
如果你是Git老手,可以无须阅读
如果你是AI Agent小白玩家,请一定要重视这篇文章。
Github应当是你日常项目管理的基石。你应当养成及时commit & push代码的习惯,遇到问题也应当利用Git及时回滚~
当然,你也可以选择GitLab、Gitee、Bitbucket等,其Git仓库管理部分基本相同。

由于Github依然是目前行业标杆,本文依然以Github为例~
Github账号注册和CLI安装:
- 访问:https://github.com 点击右上角Sign Up进行账号注册(如果已经有Github账号可以直接Sign in)

- 在账号注册页填写相关信息完成账号注册(或者用Google/Apple快捷账号注册)

- 完成Github账号的注册和激活之后,回到你的Agent(这里以WorkBuddy为例),让其安装Github CLI(即Agent使用的Github命令行控件)

应该1分钟左右就能安装成功
- 然后,打开你的终端,输入以下命令来:
gh auth login
- 选择Github

- 选HTTPS

- 选Login with a web browser

- 然后点击下面给出的链接(并且把8位数字/字母复制出来)

https://github.com/login/device
- 点Continue

- 填入上面命令行里的8个数字/字母,点击Continue:

- 点击Authorize github

- 如果你在Github设置过2MF,还需要输入二次验证码,然后点击Verify

- 验证成功

- 回到命令行终端,显示登录成功:

- 回到WorkBuddy,让它检查是否已经打通了Github CLI

- Github CLI的能力如下:
GitHub CLI(当前版本 2.83.0)的能力可以按下面几类划分:
## 认证与配置
- `gh auth` — 登录、登出、切换账号、刷新 Token、查看状态
- `gh config` — 管理配置项、缓存、编辑器、输出格式
- `gh completion` — 生成 Shell 补全脚本
- `gh alias` — 创建命令别名
## 仓库管理
- `gh repo` — 创建、克隆、Fork、查看、归档、删除、同步仓库
- `gh browse` — 在浏览器中打开仓库、Issue、PR、文件
- `gh label` — 管理 Issue/PR 标签
- `gh ruleset` — 查看仓库规则集
- `gh search` — 搜索代码、提交、Issue、PR、仓库
## Issue 与 PR
- `gh issue` — 创建、编辑、关闭、删除、列出、查看 Issue
- `gh pr` — 创建、检出、合并、审查、关闭、Diff、检查 CI
- `gh status` — 查看与你相关的 Issue、PR、通知
## GitHub Actions
- `gh workflow` — 查看、触发、启用/禁用工作流
- `gh run` — 查看、重跑、取消、下载工作流运行日志
- `gh cache` — 管理 Actions 缓存
- `gh secret` — 管理仓库/环境 Secrets
- `gh variable` — 管理 Actions 变量
## 发布与包管理
- `gh release` — 创建、编辑、上传、删除 Release
- `gh attestation` — 验证工件来源证明
## 个人与组织
- `gh gist` — 管理代码片段
- `gh org` — 列出组织
- `gh project` — 管理 GitHub Projects
- `gh ssh-key` / `gh gpg-key` — 管理 SSH/GPG 密钥
## 高级
- `gh api` — 直接调用 GitHub REST/GraphQL API
- `gh extension` — 安装、管理第三方 gh 扩展
- `gh codespace` — 管理 Codespaces
- `gh agent-task` — 处理 agent 任务(预览功能)
- `gh preview` — 试用预览功能
## 查看子命令
每个命令下还有子命令,例如:
```bash
gh pr --help
gh repo --help
```
官方完整文档:https://cli.github.com/manual
工作习惯
以下是手动操作步骤,你完全可以用刚安装好的Github CLI来自动完成以下动作,内容仅为示例:
- 创建仓库:在Github首页点击左上角的New

- 在新仓库中填写项目名字,以及选择仓库是公开(Public)还是私有(Private),然后点击Create repository
如果你希望所有人都能访问你的仓库代码,选择Public 反之,如果你希望除了你自己的之外的任何人都看不到仓库代码,选择Private

- 点击Set up in Desktop

- 提示打开Github Desktop,点击打开Github Desktop.app(如果你没有安装Github Desktop应用,会让你下载并安装Github Desktop)

- Github Desktop应用会启动仓库代码克隆界面,你可以选择希望保存项目仓库的文件目录位置,然后点击Clone

- 项目目录同步成功

- 打开WorkBuddy,新开一个会话,点击“选择工作空间”—> “打开本地工作空间”

- 选择刚才同步到本地的项目仓库,点击打开:

- 可以看到目前已经在该项目的代码空间内了

实战案例:
结合昨天的内容(【WorkBuddy基础教程】如何开发部署网站到公网可见的自有域名 - 腾讯EdgeOne Pages版),我们就可以这样使用Github CLI开发和部署一个网站:
- 开发网站并推送到Github仓库
1. 请使用three.js开发一个模仿黑客帝国效果的视觉酷炫的3D网站
2. 开发完成后将代码同步到Github仓库中

- 片刻后开发完成

- 将项目部署到EdgeOne Pages:
请使用EdgeOne CLI,在EdgeOne里创建和该项目同名的新项目,并且将该项目前端页面部署到EdgeOne Pages
- 按照昨天文章中的方案给该项目设置自定义域名:
https://workbuddy-showcase-matrix.aigc.green 3D版骇客帝国字幕雨

📹 此处为视频内容(vid: wxv_4586531941113708553)(上图为封面),未能直接提取,请前往原文查看:在公众号原文中观看
内容效果不满意?点此反馈