diff --git a/data/Git/task/camp3_557.md b/data/Git/task/camp3_557.md new file mode 100644 index 000000000..bee9360b5 --- /dev/null +++ b/data/Git/task/camp3_557.md @@ -0,0 +1,8 @@ +【大家可以叫我】: 猫先生 +【坐标】：广州 +【专业/职业】：摸鱼工程师 +【兴趣爱好】： 摸鱼 +【项目技能】：cv +【组队情况】：已组队，项目为三月七 +【本课程学习基础】：对 CV 领域有一定的了解，熟悉 pytorch huggingface +【本期活动目标】：一起学习进步 \ No newline at end of file diff --git a/data/Git/task/camp3_id.md b/data/Git/task/camp3_id.md new file mode 100644 index 000000000..1a3516a7c --- /dev/null +++ b/data/Git/task/camp3_id.md @@ -0,0 +1,8 @@ +【大家可以叫我】: InternLM +【坐标】：上海 +【专业/职业】：小助手 +【兴趣爱好】： 乒乓球 +【项目技能】：cv、nlp +【组队情况】：未组队，快来一起！ +【本课程学习基础】：CV、NLP、LLM +【本期活动目标】：一起学习，快乐暑假，闯关达人！ \ No newline at end of file diff --git a/docs/L0/Git/readme.md b/docs/L0/Git/readme.md index 8b1378917..3ad58ad4e 100644 --- a/docs/L0/Git/readme.md +++ b/docs/L0/Git/readme.md @@ -1 +1,298 @@ +# Git 关卡 +# 本节课目标 + +| 任务1 | 破冰活动：自我介绍 | +| ----- | ---------------------- | +| 任务2 | 实践项目：构建个人项目 | + +# Git + +是一个开源的分布式版本控制系统，被广泛用于软件协同开发。程序员的必备基础工具。 + +官网：[https://git-scm.com/](https://git-scm.com/) + +官方文档：[Git - Book](https://git-scm.com/book/en/v2) + +Git 基础：[Git 基础知识](https://aicarrier.feishu.cn/wiki/YAXRwLZxPi8Hy6k3tOQcuwAHn5g) + +## 1. Git 安装 + +### 1.1 **Windows 系统** + +[https://git-scm.com/download/win](https://git-scm.com/download/win) + +1. 选择适合您 Windows 版本（32 位或 64 位）的安装程序进行下载。 + +![Z8c3bDoHeobWXyxnhwVcMpOznSg](https://github.com/InternLM/Tutorial/assets/160732778/b8bfd42a-1e8a-4986-90ff-15c1d999f909) + +2. 在安装向导中，通常可以选择默认设置，一路点击“Next”（下一步）即可完成安装。 + +![Xo1LbZofZoJyxNxMpqScEW0onFe](https://github.com/InternLM/Tutorial/assets/160732778/a0114241-ce78-4b5f-9a15-9f3cbb75e497) + +3.检查是否安装完成。 + +打开终端（win+r—>cmd） + +输入指令检查 git --version + +（已经安装过，暂时不更新啦） + +![ImJpbk1qPoZdQyxA1GdcPvcEnHe](https://github.com/InternLM/Tutorial/assets/160732778/0bdaf412-1598-4b75-8df4-462c35d79969) + +### 1.2 **Linux 系统** + +通过包管理器安装 Git + +``` +sudo apt update +sudo apt install git +# _如果使用的 Intern-Studio 可以跳过或去除sudo后执行。默认已安装_ +``` + +检查 git 版本 + +![YSQpbPXWtoAVAqxuhkUcngX2npP](https://github.com/InternLM/Tutorial/assets/160732778/0fa2fbb4-d61c-42b5-8a14-3c6f4ee70993) + +如果没安装，可以按上面的安装教程完成安装。 + +## 2. 常见的 Git 托管平台 + +### 2.1 **GitHub** + +[https://github.com/](https://github.com/) + +- 是全球最大的代码托管平台之一，拥有丰富的开源项目和活跃的开发者社区。它提供了版本控制、项目管理、协作开发等功能，并支持多种编程语言。 + +### 2.2 **GitLab** + +[https://gitlab.com/](https://gitlab.com/) + +- 一个自托管或基于云的平台，提供了完整的 DevOps 工具链，包括代码托管、持续集成/持续部署（CI/CD）、问题跟踪等。 + +### 2.3 **Gitee** + +[https://gitee.com/](https://gitee.com/) + +- 国内的代码托管平台，提供了代码托管、项目管理、协作开发等功能，对国内开发者来说，访问速度可能更快，也更符合国内的使用习惯。 + +**Github 需要魔法，没条件的学员可以选择 Gitee 来使用。** + +## 3. 常用的 Git 操作 + +| 命令 | 描述 | +|------|------| +| `git init` | 初始化一个新的 Git 仓库，在当前目录创建一个 `.git` 隐藏文件夹来跟踪项目的版本历史。 | +| `git clone ` | 从指定的 URL 克隆一个远程仓库到本地。 | +| `git add ` 或 `git add .` | 将指定的文件或当前目录下的所有修改添加到暂存区，准备提交。 | +| `git commit -m "message"` | 提交暂存区的修改，并附带一个有意义的提交消息来描述更改的内容。 | +| `git status` | 查看工作目录和暂存区的状态，包括哪些文件被修改、添加或删除。 | +| `git log` | 查看提交历史，包括提交的作者、日期和提交消息。 | +| `git branch` | 列出所有本地分支。 | +| `git branch ` | 创建一个新的分支。 | +| `git checkout ` | 切换到指定的分支。 | +| `git merge ` | 将指定的分支合并到当前分支。 | +| `git push` | 将本地的提交推送到远程仓库。 | +| `git pull` | 从远程仓库拉取最新的更改并合并到本地分支。 | +| `git stash` | 暂存当前未提交的修改，以便在需要时恢复。 | +| `git stash pop` | 恢复最近暂存的修改。 | + +开始一个新的项目时，首先使用 `git init` 初始化仓库。在进行一些代码修改后，使用 `git add.` 添加所有修改，然后使用 `git commit -m "Initial commit"` 提交更改。 + +在团队工作中，完成自己的开发后，使用 `git push` 将更改推送到远程仓库，以便其他团队成员可以获取您的工作成果。 + +## 4. 常用插件 + +在 VSCode 等软件中，插件是效率提升的利器。（根据自己的爱好进行选择） + +![KvynbQdSyogfknxSbKccxbMdnjf](https://github.com/InternLM/Tutorial/assets/160732778/f735c3bf-ca9b-4e12-84ed-a63e4bb7db3a) + +| [GitLens](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens) | 在代码行上显示 Git 提交信息，如提交人、时间及变更描述等，还能查看文件历史记录、比较视图、显示 Git blame 注释和团队成员的最新活动等 | +| ------------------------------------------------------------ | ------------------------------------------------------------ | +| [Git Graph](https://marketplace.visualstudio.com/items?itemName=mhutchie.git-graph) | 类似于 SourceTree 的可视化版本控制插件，可用于查看提交记录、审视代码等 | +| [Git History](https://marketplace.visualstudio.com/items?itemName=donjayamanne.githistory) | Git 日志查看器，能轻松查看 Git 提交历史记录，支持显示不同颜色的分支、提交信息和更改详细信息，以及搜索提交历史记录； | + +# 作业 + +## 1. 破冰活动：自我介绍 + +### 任务 + +提交自己的破冰介绍.md + +### 要求 + +1. 命名 .md> +2. 路径：./data/Git/task/ +3. 【大家可以叫我】可以为 github 昵称，微信昵称等，或其他网名 +4. 作业提交对应的 PR 链接 + +``` +./data/Git/task/camp3_id.md +# id 为报名问卷的ID +``` + +![XNzebK7ItoftfwxiXQ2cY3lYn0g](https://github.com/InternLM/Tutorial/assets/160732778/bb74cc07-e806-4d17-9dbc-cca2890a9230) + +（倘若您经常使用，且参与过项目开发，那么下面的操作想必您都熟知，可以迅速跳过。） + +**动手操作** + +1.查看报名问卷 ID： + +[报名问卷](https://www.wjx.cn/vm/PvefmG2.aspx?sojumpparm=MTU3NjczNzE1ODY=) + +![XPcwbc8JHopWqRxTsVDc28gQnnc](https://github.com/InternLM/Tutorial/assets/160732778/5b18eb3b-df8a-4ec9-be27-3746b80815ee) + +2.Fork 项目 + +[项目链接](https://github.com/InternLM/Tutorial) + +![MXzyb640Ro6S1TxK3lrcpMTLnnb](https://github.com/InternLM/Tutorial/assets/160732778/7a88cbd5-3d53-4e55-97be-137b80944b92) + +3.获取仓库链接 + +![CWMvb92fFomY4gxsdgrcHw3mneh](https://github.com/InternLM/Tutorial/assets/160732778/bdee8d52-1226-4646-b2b7-b92578f149c9) + +```bash +git clone https://github.com/MrCatAI/Tutorial.git _#修改为自己frok的仓库_ +cd Tutorial/ +git branch -a +git checkout -b camp3 origin/camp3 +``` + +4.查看分支 + +![XgMvbeKkRojKmXxTqY0cAIwcnqc](https://github.com/InternLM/Tutorial/assets/160732778/3e604f79-f68b-4068-ba85-b06dbc5d9f21) + +5.切换到第三期的分支 + +![HK41btX6toRdINx8acUc0k4bnLf](https://github.com/InternLM/Tutorial/assets/160732778/d786651e-1506-420d-85cc-a3576b8fe1f0) + +6.查看分支内容 + +![FmlybnAfZoQ5f2xsdSDc5c5wnJx](https://github.com/InternLM/Tutorial/assets/160732778/8e2528f7-4ee4-4eda-b441-03053f5abac7) + +```bash +git checkout -b camp3_577 _# 自定义一个新的分支_ +``` + +![ED8YbzgA1oZXJdxBegZcl1o0ncy](https://github.com/InternLM/Tutorial/assets/160732778/a8751f86-78e5-4a00-9cbe-6def3ff572d4) + +示例： + +![I7ZsbQ0MMos1HMxufdaciHV4nMd](https://github.com/InternLM/Tutorial/assets/160732778/30e2b3b9-6091-4c04-90eb-5157691bae59) + +示例文件路径 + +```bash +./data/Git/task/camp3_id.md +``` + +7.创建自己的破冰文件 + +```bash +touch ./data/Git/task/camp3_557.md _#修改为自己的问卷ID_ +``` + +![BwGgbkHdLo1jzvxIMxTc0futnub](https://github.com/InternLM/Tutorial/assets/160732778/cbf78959-ed0b-4426-91af-dca75b9fc013) + +8.提交更改到分支 + +```bash +git add . +git commit -m "add git_557_introduction" _提交信息记录_ +``` + +![E7pybrN2sowPTFxThvmcxHKOnab](https://github.com/InternLM/Tutorial/assets/160732778/898de54d-b8ce-4666-948e-a142ac12aaa4) + +```perl +git push origin camp3_577 +``` + +（大家提交使用英文，避免仓库同步错误） + +注：初始化时可能需要创建对应的 token：（示例，可根据实际提示完成） + +![MKjsbwN3XoVjSGxsWZnc6x4hnCe](https://github.com/InternLM/Tutorial/assets/160732778/bea9600a-21f0-4cbc-8c7f-73fe5769e78b) + +![G3hmb6UmzomjJ7xOGZEc4GV0nNb](https://github.com/InternLM/Tutorial/assets/160732778/fae00c0f-6084-44d9-acf7-82fa915c90f9) + +![DxoLbxK01ovG88xUHehcnRgXnzT](https://github.com/InternLM/Tutorial/assets/160732778/c8f83c61-2973-4c8a-a9ae-6df3936a67ef) + +查看提交 + +![RaosbM8E7osYsqx8jnIcGkm1n5c](https://github.com/InternLM/Tutorial/assets/160732778/d8a322ec-9a06-4463-a61d-831ef953b1ef) + +在 github 页面将修改的内容 PR 到 Tutorial + +![TT2NbszJ1oKCorxMWpXcakPUnCd](https://github.com/InternLM/Tutorial/assets/160732778/bef3eac1-e5dc-4699-b8c6-e73066b68fda) + +按要求编写 title + +```bash +git_557_introduction #请统一 git__introduction 格式,方便审核 +``` + +下面可以查看修改的内容 + +![ZVVOb8NtEowWFQxWFQAcgcoWnQf](https://github.com/InternLM/Tutorial/assets/160732778/6bbc3734-ea3a-46f4-a468-d317ed23227f) + +PR 示例链接：[https://github.com/InternLM/Tutorial/pull/790](https://github.com/InternLM/Tutorial/pull/790) + +也可以合并到自己的仓库 + +![LBZibAcS0oArsFxzCLNcY1X2n7e](https://github.com/InternLM/Tutorial/assets/160732778/13a578cf-13be-45a2-81de-4cfab5109770) + +自己的仓库，可以自行 merge，作业提交到 Tutorial 需要维护者审核。 + +![UEl6btxJWo0OHRxcUjRcb9udnNe](https://github.com/InternLM/Tutorial/assets/160732778/72966a46-c634-48a9-9a88-fc6834d957e2) + +## 2. 实践项目：构建个人项目（简版） + +创建个人仓库，用于提交笔记、心得体会，或分享自己的项目和创意。我们特别欢迎与 LLM 训练和应用相关的内容，但不限于此。 + +### 目标 + +创建自己的仓库(拥有自己的仓库，记录笔记与心得 + +### 要求 + +1. 拥有自己的项目或笔记仓库（公开）。 +2. 提交作业 github 仓库链接（如已经有项目的可以提交项目链接。 +3. github 使用少的，可参考下面的操作，提交到常用的其他代码管理平台，如 gitee。 +4. 笔记或项目类仓库，添加超链接跳转 [GitHub 仓库](https://github.com/InternLM/Tutorial)（[https://github.com/InternLM/Tutorial]） + +**动手操作** + +1.先在 github 创建一个新的仓库 + +![GnmablchRoubIgxK7Ioc5JAQndg](https://github.com/InternLM/Tutorial/assets/160732778/10978930-88cc-4927-afdb-e494031dfd4f) + +![UBRjbS9lBozcUSxJN2IcNKNSn8d](https://github.com/InternLM/Tutorial/assets/160732778/05fe7cda-d103-42e9-b2d3-b74e6093c40a) + +这样你就得到一个空白的仓库： + +![QxjXbWeoxoH0VmxhT85cqrZ2nzd](https://github.com/InternLM/Tutorial/assets/160732778/506e7e78-a7aa-4c71-acbc-74c8df364f38) + +然后按上面的操作，可以拉取仓库和提交对应的信息： + +![QLZ9bEOV7oP3iaxHCOycP1J6nje](https://github.com/InternLM/Tutorial/assets/160732778/1461a56b-9ebb-4db4-a197-72d2c7dce586) + +![F5dNb3S9poBZS4xFdVLcptYgnIe](https://github.com/InternLM/Tutorial/assets/160732778/09d5821e-0229-4a62-a615-37e57562cfed) + +修改，并记录自己的项目信息等..... + +![IFM6bzj6SorSo5xgWj1czZNYnxg](https://github.com/InternLM/Tutorial/assets/160732778/eec52de1-6556-444e-bb76-9df1e0431afb) + +![JFPhbwINBoEDEWxCekHcAVyLnof](https://github.com/InternLM/Tutorial/assets/160732778/0b27b3e8-6fd1-49db-8189-a129017afd96) + +修改完后提交到仓库： + +![Xq3Eb5LjgoOc5KxP6FJcRsXzned](https://github.com/InternLM/Tutorial/assets/160732778/94b9377d-11bb-4c8e-9dd0-e39eec587b06) + +![IqU8bec1vomQELxE7sCcyKbInq2](https://github.com/InternLM/Tutorial/assets/160732778/ebfe2dc6-98ab-4373-8673-3d932f3b2695) + +![NiN3bCHIaoHh7GxQG6WcEY3Yn9f](https://github.com/InternLM/Tutorial/assets/160732778/c76691e7-eb21-435f-a0ed-4a6b62e569e4) + +参考仓库(仅演示)：[https://github.com/MrCatAI/March7thMuse1](https://github.com/MrCatAI/March7thMuse1) diff --git a/docs/L0/Git/task.md b/docs/L0/Git/task.md new file mode 100644 index 000000000..35466b676 --- /dev/null +++ b/docs/L0/Git/task.md @@ -0,0 +1,38 @@ +# Git 课程任务 + +## 任务概览 + +- **任务1**: 破冰活动：自我介绍 +- **任务2**: 实践项目：构建个人项目 + +## 任务1: 破冰活动：自我介绍 + +### 目标 + +每位参与者提交一份自我介绍。 + +![XNzebK7ItoftfwxiXQ2cY3lYn0g](https://github.com/InternLM/Tutorial/assets/160732778/bb74cc07-e806-4d17-9dbc-cca2890a9230) + +### 要求 + +1. 命名格式为 `camp3_.md`，其中 `` 是您的报名问卷ID。 +2. 文件路径应为 `./data/Git/task/`。 +3. 【大家可以叫我】内容可以是 GitHub 昵称、微信昵称或其他网名。 +4. 在 GitHub 上创建一个 Pull Request，提供对应的 PR 链接。 + + +## 任务2: 实践项目：构建个人项目 + +### 目标 + +创建一个个人仓库，用于提交笔记、心得体会或分享项目。 + +![NiN3bCHIaoHh7GxQG6WcEY3Yn9f](https://github.com/InternLM/Tutorial/assets/160732778/c76691e7-eb21-435f-a0ed-4a6b62e569e4) + +### 要求 + +1. 创建并维护一个公开的大模型相关项目或笔记仓库。 +2. 提交作业时，提供您的 GitHub 仓库链接。 +3. 如果您不常使用 GitHub，您可以选择其他代码管理平台，如 Gitee，并提交相应的链接。 +4. 仓库介绍中添加超链接跳转 [GitHub 仓库](https://github.com/InternLM/Tutorial)（[https://github.com/InternLM/Tutorial](https://github.com/InternLM/Tutorial)） +