github提供五大核心工具：cli命令行工具gh实现终端自动化；actions内置ci/cd工作流引擎；github apps支持细粒度权限的第三方集成；github-dark为社区深色主题插件；gh extension生态扩展cli功能。
GitHub 作为全球主流的代码托管与协作平台，不仅提供核心 Git 功能，还围绕开发全生命周期构建了丰富的官方工具链与活跃的第三方集成生态。以下是针对 GitHub 官方工具与主流第三方工具的实用说明：
一、GitHub CLI（gh）——官方命令行核心工具
GitHub CLI 是 GitHub 官方推出的终端原生命令行工具，可直接替代大量网页操作，实现仓库管理、PR 处理、议题跟踪、发布管理等高频任务的自动化执行。它支持跨平台（macOS、Linux、Windows），并深度集成 GitHub API 与身份认证体系。
1、安装 gh 工具：访问 cli.github.com 下载对应系统安装包，或通过包管理器安装（如 macOS 的 Homebrew：brew install gh）。
2、完成初始认证：在终端运行 gh auth login，按提示选择 GitHub.com、登录方式（浏览器或设备码）、默认协议（HTTPS/SSH）及默认 Git 主机。
3、执行典型操作：例如创建 PR —— 运行 gh pr create --title "feat: add dark mode toggle" --body "closes #42"，自动推送到远程并打开网页预览。
二、GitHub Actions —— 内置自动化工作流引擎
GitHub Actions 是 GitHub 原生 CI/CD 服务，无需额外部署服务器即可定义基于事件（push、pull_request、schedule 等）触发的可编程工作流。所有运行均在 GitHub 托管的 runner 上执行，支持 Linux/macOS/Windows 及自托管节点。
1、创建工作流文件：在仓库根目录新建 .github/workflows/ci.yml，定义 on、jobs、steps 等字段。
2、使用预建 action：例如通过 actions/checkout@v4 拉取代码，actions/setup-node@v4 配置 Node.js 环境。
3、启用 OIDC 身份验证：在 workflow 中配置 permissions: id-token: write，配合 AWS/GCP 等云平台实现安全凭证交换，避免硬编码密钥。
三、GitHub Apps —— 安全可控的第三方集成载体
GitHub Apps 是 GitHub 推荐的集成方式，区别于传统 OAuth App，采用细粒度权限控制与短期 JWT 令牌，显著降低凭据泄露风险。每个 App 可被精确授权至特定仓库或组织，并仅能访问所声明的资源范围。
1、识别已安装 App：进入仓库 Settings → Manage access → Installed GitHub Apps，查看当前启用的 App 列表及其权限范围。
2、安装可信 App：访问 github.com/marketplace，筛选“Developer tools”或“Project management”，点击目标 App 的“Install it for free”按钮。
3、配置事件订阅：在 App 设置页勾选需监听的 Webhook 事件（如 issues.opened、pull_request.review_requested），确保后端服务能实时接收通知。
四、GitHub-Dark —— 社区驱动的视觉增强插件
GitHub-Dark 是由社区维护的开源深色主题项目，通过注入定制 CSS 替换 GitHub 默认样式，缓解长时间编码导致的眼部疲劳，并提升夜间工作效率。其不修改任何功能逻辑，纯前端渲染层增强。
1、选择兼容扩展：Firefox 用户安装 Stylus；Chrome/Edge 用户安装 Stylus；Safari 用户安装 Cascadea。
2、导入主题规则：在扩展中添加新样式，粘贴来自 github.com/primer/github-dark 的最新 github-dark.user.css 内容。
3、启用 GitHub 原生深色模式：进入 GitHub Settings → Appearance → Dark theme，选择 “Default to dark” 或 “Sync with system”，确保基础背景协调一致。
五、gh extension 生态 —— 可扩展的 CLI 插件体系
GitHub CLI 扩展系统允许用户安装二进制、Git 仓库或本地开发的自定义命令，将 gh 命令能力延伸至代码审查、安全扫描、项目看板、CI 状态监控等场景。所有扩展均通过统一接口调用，无需额外环境配置。
1、发现可用扩展：运行 gh extension browse，在终端内交互式浏览分类列表及描述。
2、安装热门扩展：例如安装分支清理工具 —— 执行 gh extension install github/branch-cleaner；安装 PR 统计工具 —— 执行 gh extension install dlvhdr/gh-pr-stat。
3、验证扩展功能：安装完成后，直接使用新增子命令，如 gh branch-cleaner --dry-run 预览将删除的远程分支，或 gh pr-stat --user @me 查看个人 PR 合并趋势。
