Clipping 微信公众号

【WorkBuddy基础教程】使用Github CLI进行项目代码管理&实战案例

by DracoVibeCoding 原文 ↗
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开发和部署一个网站:

  1. 开发网站并推送到Github仓库
1. 请使用three.js开发一个模仿黑客帝国效果的视觉酷炫的3D网站 
2. 开发完成后将代码同步到Github仓库中

  1. 片刻后开发完成

  1. 将项目部署到EdgeOne Pages:
请使用EdgeOne CLI,在EdgeOne里创建和该项目同名的新项目,并且将该项目前端页面部署到EdgeOne Pages
  1. 按照昨天文章中的方案给该项目设置自定义域名:

https://workbuddy-showcase-matrix.aigc.green 3D版骇客帝国字幕雨

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


内容效果不满意?点此反馈

输入关键词开始搜索