docs: first commit

Author: shitoujie

.github/workflows/update-task-progress.yml

@@ -0,0 +1,52 @@
+name: update-task-progress after pull request merged
+
+on:
+  pull_request_target:
+    types: [closed]
+    branches:
+      - main  # 或者你希望触发CI的分支名称
+
+jobs:
+  build:
+    if: github.event.pull_request.merged == true  # 只有当pull request被合并时才执行CI
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v2
+
+    - name: Set up Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: '3.8'  # 替换为你需要的Python版本
+
+    - name: Install dependencies
+      run: |
+        sudo apt install fonts-noto-cjk  
+        python -m pip install --upgrade pip
+        pip install -r assets/requirements.txt  # 如果你的项目有requirements.txt文件
+
+    - name: Run Python script
+      run: |
+        python assets/update-task-progress.py  # 替换为你需要运行的Python脚本
+
+    - name: Commit changes and add changes
+      run: |
+        git config --global user.email "github-actions[bot]@users.noreply.github.com"
+        git config --global user.name "github-actions[bot]"
+        git add .
+        git commit -m "Update task progress" -a
+      
+    # - name: Push changes
+    #   run: |
+    #     git push
+    #   env:
+    #     GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    # Push the changes
+    - name: Push changes
+      uses: ad-m/github-push-action@master
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        branch: main
+        force: true
+

README.md

@@ -0,0 +1,96 @@
+<p align="center">
+    <img width=50% src="assets/p1.png"/>
+</p>
+
+<h1 align="center">欢迎报名 IRobot 战队算法组！</h1>
+
+<div align="center">
+    <a href="http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=2JehDBVI8BBWEfourtdRF60RpF1zjHOV&authKey=EvFODrPUWOLijVFji0AScdjeAl2JCO7ZtpbFKF14VjfpjFyHmIU3e%2FijA%2FvoBc2l&noverify=0&group_code=635535591">交流群</a>
+    <span>&nbsp;&nbsp;|&nbsp;&nbsp;</span>
+    <a href="https://space.bilibili.com/436391821/channel/collectiondetail?sid=1809229">2023培训</a>
+    </br></br>
+</div>
+
+谢谢你的报名！这里是我们 2025 赛季的招新文档，我们会在这里发布一些公告信息，部分入队考核也会在这里进行。
+
+## 信息发布栏
+
+**算法组 招新 qq 群：** 622101394
+
+**实验室地址：** 南校区大学生活动中心 四楼 407 ***🤬马上就搬家了🤬  🫡过来帮我们搬家报学号加分***
+
+**联系人：** 不用列出来了哦哦有事在群里公屏打出来就好私聊群主管理也行
+
+<img width=50% src="assets/p2.jpg"/>
+
+## 关于我们
+
+我们是 IRobot 战队算法组，由对嵌入式编程、电子技术和控制理论感兴趣的同学组成。一个赛场上的机器人**需要拥有躯体、可以行动、会感知决策**，嵌入式组的责任就是搭建电路、编写控制程序，让机器人拥有行动能力。（**这里改一下**）
+
+日常工作主要围绕下面这几项技术开展：（**这里改一下**）
+
+- 单片机开发
+
+- 嵌入式 Linux、ROS
+
+- 控制算法、仿真
+
+- 功率电子设计（电容）
+
+- PCB 设计
+
+在每个赛季的备赛过程中，我们会并行进行开发和研发两条线，既利用已经掌握的技术造出本赛季要上场的机器人，也学习探索新技术，不断进步迭代;
+
+不管你选择帮助我们造车，还是做一些研究性的贡献，嵌入式组都会是一个绝佳的实践平台，提供你作为个人难以获得的资源。
+
+## 入队考核（**这里改一下**）
+
+相信大家一定会在我们的团队里发挥才能，也会在这里结识志同道合的朋友！但为了确保你能胜任我们的工作，完成规则测评之后，还有几项考核任务需要完成；
+
+如果觉得自己的知识有漏洞也不用担心，部分任务的文档里会包含一些参考资料，以便大家学习相关的知识点。希望大家发挥自学能力和信息检索能力，独立完成这些任务。如果遇到自己实在解决不了的问题，可以在群里提问交流。
+
+### 考核进度跟踪（**这里改一下或者删掉**）
+
+[时间轴](https://w0ybodqyg7f.feishu.cn/share/base/view/shrcnuEAKBb1HkQ7SRoO7ExsDTQ)上标出了每一项任务的 deadline 和你的进度。信息随时更新，如果你顺利完成了一项任务，那么你的进度条会前进到这一项任务处。***大家按照要求，一个任务用一个文件夹或者一个文件，我是按照你名字文件夹下的目录数量来更新时间轴的***
+![alt](assets/task_progress.png)
+
+**请大家务必按时完成任务，任务逾期即考核不通过。**
+
+### 任务目录（**这里讨论完改一下**）
+
+- [任务零：C 语言基础+Git](tasks/0.prerequisites/README.md)
+
+完成任务零之后，标志着你已经有了开始学习的基础；我们会开设一系列集体线下课，教会你使用我们队内的工作流进行 STM32 开发，**时间和地点在招新群里通知**。
+
+考核进度不受线下课影响，如果有能力，可以先行继续完成下面的任务。下面的任务可以乱序进行。
+
+- [任务一：简单 PCB 绘制](tasks/1.pcb/README.md)
+
+- [任务二：C++/CMake](tasks/2.cpp-buildsystem/README.md)
+
+- ~~任务三：Linux 基本使用/Python/ROS2~~ _没有硬性要求必须现在就完成，但是很建议先学起来，这赛季的新方案技术验证一旦完成，ROS+Linux 的方案会取代 STM32。_
+
+接下来的这些任务需要来实验室完成：
+
+来之前先在[问卷](https://w0ybodqyg7f.feishu.cn/share/base/form/shrcnmOrLiNsDxQ9RQW10x1NaSf)里预约一下你要来的时间，或者在群里问问有没有队员有空，我们会抽人联系你接应一下，防止迷路。
+
+- [任务四：焊接](tasks/4.solder/README.md)
+
+- [任务五：底盘控制 - 驱动 CAN 总线电机/PID 控制器](tasks/5.chassis/README.md)
+
+- [任务六：云台控制 - 姿态解算/PID 控制器](tasks/5.gimbal/README.md)
+
+- [任务七：整车控制](tasks/6.vehicle/README.md)
+
+- 任务八：认识裁判系统 - 真·整车控制
+
+- 任务九：和机械组协作
+
+在完成以上任务之后，你就是一名合格的嵌入式组队员了！进队之后，你就肩负着完成自己负责的任务的责任，尽快和大家熟络起来、尽快对 rm 的比赛规则和比赛生态建立理解、积极完成任务、放开手脚干。
+
+
+## 最后：
+
+认真干活虽然重要，也祝你在实验室玩的开心！
+
+![p3](assets/p3.jpg)

assets/p1.png

@@ -0,0 +1,13 @@
+contourpy==1.1.1
+cycler==0.12.1
+fonttools==4.53.1
+importlib_resources==6.4.5
+kiwisolver==1.4.7
+matplotlib==3.7.5
+numpy==1.24.4
+packaging==24.1
+pillow==10.4.0
+pyparsing==3.1.4
+python-dateutil==2.9.0.post0
+six==1.16.0
+zipp==3.20.1

assets/p2.jpg

@@ -0,0 +1,48 @@
+# This script is used to update the progress of a task in the database.
+
+import matplotlib.pyplot as plt
+import matplotlib.font_manager as fm
+import os
+
+# 设置字体
+font_path = '/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc'
+font_prop = fm.FontProperties(fname=font_path)
+
+# font_path = '/System/Library/fonts/PingFang.ttc'
+# font_prop = fm.FontProperties(fname=font_path)
+
+# 数据
+directory = 'submissions/'
+all_items = os.listdir(directory)
+members = [item for item in all_items if os.path.isdir(os.path.join(directory, item)) and item != 'README.md']
+task_counts = {}
+for member in members:
+    folder_path = os.path.join(directory, member)
+    items = os.listdir(folder_path)
+    task_counts[member] = len(items)
+
+for member, count in task_counts.items():
+    print(f"{member}: {count}")
+
+
+# 设置图形大小
+plt.figure(figsize=(10, 6))
+
+plt.barh(members, task_counts.values(), color='gold', label=f'已提交人数{len(members)}' )
+
+# 显示图例
+plt.legend(loc="upper right", prop = font_prop)
+
+# 设置标题和标签
+plt.title('任务轴', fontproperties = font_prop)
+plt.xlabel('任务数量', fontproperties = font_prop)
+
+x_ticks = range(0, 9, 1)
+x_labels = [f'task{i-1}' for i in x_ticks]
+plt.xticks(x_ticks, x_labels, fontproperties = font_prop)
+
+for label in plt.gca().get_xticklabels() + plt.gca().get_yticklabels():
+    label.set_fontproperties(font_prop)
+
+# 存储图表
+plt.savefig('assets/task_progress.png')

assets/p3.jpg

@@ -0,0 +1 @@
+这里用来放提交的任务

assets/requirements.txt

@@ -0,0 +1,23 @@
+# 任务零：C 语言基础+Git
+
+## 📃 任务描述
+
+在这个任务中，你需要编写一个最基本的 C 语言程序，并且使用 Git 进行简单的版本控制和团队协作。
+
+开始做任务之前，先注册一个 GitHub 账号；
+
+## 🎯 任务目标
+
+使用 C 语言编写一个冒泡排序程序：用户输入几个数字，使用冒泡排序算法将输入的整数从小到大排序并且打印出来。
+
+![](./assets/1.png)
+
+在这个仓库的[`submission`目录](../../submissions/README.md)下建一个以你的名字命名的文件夹；把程序源代码放进去，并提交一个 Pull Request。
+
+## 🔗 参考资料
+
+- [C 语言教程 | 菜鸟教程](https://www.runoob.com/cprogramming/c-tutorial.html)
+
+- [C 语言期末不挂科 | 补考 | 速成课 | 3 小时拿下期末](https://www.bilibili.com/video/BV1pE421N7en/)
+
+- [【git、github 保姆级教程入门，工作和协作必备技术，github 提交 pr - pull request】](https://www.bilibili.com/video/BV1s3411g7PS/)