返回夜猫子首页

新用户教程 01

代码仓库：把项目代码放到正确的位置

这份教程给第一次使用夜猫子的成员看。目标是让你知道账号怎么用、项目应该放进哪个组织、怎样克隆仓库、怎样提交代码，以及什么时候需要发起评审。

1. 登录和账号

账号由管理员分发。首次登录后先修改密码，并检查邮箱是否正确。后续代码推送、包上传和 API 访问都基于这个账号授权。

  • 内网访问速度更快，适合上传较大的固件和安装包。
  • 异地访问请使用管理员提供的 HTTPS 地址。
  • 不要把密码写进脚本，自动化任务应使用访问 Token。

2. 找到项目组织和仓库

一个团队或项目通常会对应一个组织。进入组织后可以看到仓库列表、团队成员和权限范围。新成员没有看到仓库时，先联系管理员确认是否已经加入正确团队。

  • 单片机项目建议一个硬件型号或产品线一个仓库。
  • 工具脚本、上位机、固件、文档可以按项目边界拆分。
  • 发布产物不要直接混在源码目录里，优先使用 Release 或软件包。

3. 克隆和提交代码

日常开发建议使用 Git over HTTPS。需要高频推送时，可以配置 SSH Key，让本机无需每次输入密码。

git clone https://git.liuzi233.cn/组织名/仓库名.git
cd 仓库名
git checkout -b feature/你的功能名
git add .
git commit -m "说明本次修改"
git push origin feature/你的功能名

4. 分支和评审

不要直接把未经确认的修改推到主分支。一般流程是创建功能分支，推送后发起 Pull Request，让负责人检查代码、固件版本和变更说明。

  • 修复问题：使用 `fix/问题描述` 分支。
  • 新增功能：使用 `feature/功能描述` 分支。
  • 发布准备：使用 `release/版本号` 分支。

遇到权限不足、仓库不可见、无法推送时，先截图错误信息并联系组织管理员。