Git、GitHub 与 GitHub Desktop 入门
Git 是版本控制工具。你可以把它理解成“给项目文件夹拍可回退的快照”。它最常用于代码项目，但科研文档、数据处理脚本、Docusaurus 网站和教程材料也很适合用 Git 管理。
GitHub 是在线代码和文档托管平台。你可以把本地 Git 项目上传到 GitHub，方便备份、协作、查看历史记录和发布网站。
GitHub Desktop 是 GitHub 官方提供的图形界面工具。它适合不熟悉命令行的新手，用按钮完成提交、同步、查看改动等操作。
Git 能帮你做什么
- 记录每次修改了哪些文件。
- 在改坏时回到之前的版本。
- 和 GitHub 等平台同步项目。
- 让多人协作时知道是谁改了什么。
- 在使用智能体改文件前后保留清楚的变更记录。
GitHub 能帮你做什么
- 把本地项目备份到云端。
- 在网页上查看文件、历史记录和每次修改。
- 多人一起编辑同一个项目。
- 用 Pull Request 讨论和审查改动。
- 发布 Docusaurus、说明文档或项目网站。
GitHub Desktop 适合谁
如果你刚开始接触 Git，不想马上记命令，可以先用 GitHub Desktop。它能让你：
- 看到哪些文件被修改。
- 勾选要提交的文件。
- 写提交说明并点击提交。
- 把本地提交推送到 GitHub。
- 从 GitHub 拉取别人最新的改动。
- 更直观地查看每次提交的差异。
下载入口
- Git 官方下载页
- Windows 用户也可以直接看 Git for Windows
- GitHub 官网
- GitHub Desktop 下载页
最少要知道的命令
安装后先掌握这几个命令：
git status
git add 文件名
git commit -m "说明这次改了什么"
git log --oneline
如果使用 GitHub Desktop，也要理解这些命令背后的含义：
| 命令/概念 | 在 GitHub Desktop 里大概对应什么 |
|---|---|
git status | 左侧文件改动列表 |
git add | 勾选要提交的文件 |
git commit | 写 Summary 后点击 Commit |
git push | 点击 Push origin |
git pull | 点击 Fetch origin / Pull origin |
git diff | 点击文件查看具体改动 |
和智能体协作时怎么用
在让智能体修改文件前，推荐先运行：
git status
这样可以确认当前项目里是否已经有未保存的改动。智能体修改后，再用：
git diff
查看它具体改了什么。确认无误后，再提交：
git add .
git commit -m "添加智能体介绍文档"
如果你用 GitHub Desktop，推荐流程是：
- 修改前先打开 GitHub Desktop，确认当前改动列表是否干净。
- 让智能体修改文件。
- 回到 GitHub Desktop 查看 changed files。
- 点开每个文件，确认改动符合预期。
- 写一句清楚的 Summary，例如“添加智能体介绍文档”。
- 点击 Commit，再根据需要 Push 到 GitHub。
警告
不要在不理解后果的情况下运行 git reset --hard、git checkout -- 文件名 这类会丢弃修改的命令。遇到不确定的情况，先备份或先问清楚。