Home › Blog › GitHub Desktop 推送教程

GitHub Desktop 推送代码完整教程

2026-06-27 | 适用于经营管理项目（8个 Cloudflare Pages 站点）

为什么要推送？

本项目有 8 个站点部署在 Cloudflare Pages 上。其中 aitools、templatehub、geoseo、cryptopay、sidehustle 这 5 个站点通过 GitHub Actions CI/CD 自动部署。

你在本地修改（或 AI 帮你修改）代码后，需要 推送到 GitHub，GitHub 收到推送后会触发 engine/daily.yml 中定义的工作流，自动运行构建脚本并部署到 Cloudflare Pages。

重要提醒：如果你在中国大陆，不要用命令行 git push（被墙），请使用 GitHub Desktop。

准备工作

1 下载安装 GitHub Desktop

访问 https://desktop.github.com/ 下载 Windows 版，直接安装，一路默认选项即可。

2 登录 GitHub 账号

打开 GitHub Desktop → File → Options → Accounts → 点击 Sign in 用浏览器登录你的 GitHub 账号。

如果你的网络打不开 GitHub 登录页面，可以使用 GitHub 个人访问令牌（见备选方案）。

3 添加本地仓库

点击左上角 File → Add Local Repository…（或拖拽文件夹）

选择本项目所在的文件夹：D:\github-20260612\经营管理

点击 Add Repository。

推送步骤

4 查看变更

添加仓库后，GitHub Desktop 会自动扫描文件变更。

左侧会显示所有 Changed Files（修改的文件）和 Untracked Files（新增的文件）。

你应该会看到类似：

5 填写提交信息

在左下角 Summary 框中填写提交说明，例如：

Add v7 tools, 78 blog posts, dynamic tools index, and rebuild

可选：在 Description 框中填写更详细的说明，如：

- 10 new v7 free tools (JSON↔CSV, YAML→JSON, Regex, Hash, etc.)
- 78 new blog posts across 8 sites
- Dynamic tools index (auto-scans directories)
- Blog index now auto-includes all posts
- SEO optimizer: 573 pages enhanced
- daily.yml updated with all generators

6 提交到本地

点击左下角蓝色的 Commit to main 按钮。

这将把变更保存到本地的 Git 记录中。

7 推送到 GitHub

点击顶部工具栏的 Push origin 按钮（或按 Ctrl+P）。

GitHub Desktop 会开始上传文件到 GitHub 服务器。

推送完成后，你会看到变为 Last fetched just now 的状态。

如何确认推送成功

推送后约 1-2 分钟，GitHub Actions 会自动运行：

  1. 打开浏览器访问 GitHub Actions 页面
  2. 应该能看到 Daily SEO Update 工作流正在运行
  3. 等待绿色 ✓ 出现，表示部署完成
  4. 访问各站点确认更新：

常见问题

Q: 推送时提示 "Failed to push"

如果网络连接不稳定，可以：

Q: 登录 GitHub 时打不开浏览器页面

使用 Personal Access Token 方式：

  1. 浏览器访问 https://github.com/settings/tokens（需要翻墙或代理）
  2. 点击 Generate new token → Classic
  3. 勾选 repo 和 workflow 权限
  4. 生成并复制 token
  5. GitHub Desktop → Settings → Accounts → GitHub.com → 选择 Sign in with a token
  6. 粘贴 token 即可

Q: 推送后站点没有变化

检查 GitHub Actions 是否正常运行：

Q: 不想提交 output/ 下的文件

output/ 目录已经通过 .gitignore 排除了。但有些新文件（如 devto 教程、deep-content）没有被 gitignore 覆盖。

你可以在提交前取消勾选不需要的文件（绿色复选框）。

提示：agentpro、automoney-store、maomaolove 三个站点已经由 AI 通过 API Token 直接部署，不需要推送也会更新。只有 aitools、templatehub、geoseo、cryptopay、sidehustle 这 5 个需要通过 GitHub Actions CI/CD 部署。

备选方案：直接用 GitHub 网页上传

如果你无法使用 GitHub Desktop，可以手动上传关键文件到 GitHub 网页：

  1. 打开 仓库主页
  2. 点击 Add file → Upload files
  3. 拖拽 engine/ 目录下的新文件（free-tools-builder-v7.js、generate-blog-posts-v2.js、rebuild-tools-index.js 等）上传
  4. 提交即可触发 Actions

但这种方式需要逐个文件上传，建议还是用 GitHub Desktop。

© 2026 AgentPro | Home | Blog | USDT (TRC-20): TRnz5Pi8R3hjCbBjnDuZo7ZvR57euo2q8Z