Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
60 changes: 12 additions & 48 deletions zh-cn/contest_2026/code_submission_guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,11 @@
```text
报名审核通过
组委会创建专属仓库 + 开通 push 权限
组委会创建专属仓库 + 开通权限
repo init + repo sync 一键拉取完整工程
在专属仓内开发 → git commit → git push
AI Coding 日志由插件自动归集到 logs/
fork 专属仓库开发 → 发起 PR → 自行 review 合入
初赛截止,组委会统一收回 push 权限(仍可 clone / 查看)
Expand All @@ -30,9 +28,9 @@ AI Coding 日志由插件自动归集到 logs/

## 一、提交总览

- 组委会会为**每支队伍 / 每位参赛者创建专属的 GitHub 代码仓库**(按作品形态可能不止一个,如应用仓、快应用仓、板级 vendor 仓),默认 **public**(有特殊需求可申请改为私仓)。
- 比赛期间,你**直接在自己的专属仓库内开发并提交(push)**,无需发起 PR
- 若需改动 **nuttx 等公共仓库**,则不在专属仓内直接 push,而是 fork 对应公共仓、以 **PR** 形式提交到 `dev-ai-contest-2026` 分支,由组委会 review 后合入(详见[四、分赛道说明](#四分赛道说明))
- 组委会会为**每支队伍 / 每位参赛者创建专属的 GitHub 代码仓库**,默认 **public**(有特殊需求可申请改为私仓)。
- 比赛期间,你 fork 自己的专属仓库进行开发,再以 **PR** 形式提交回专属仓库,可**自行 review 并合入**(无需等待组委会审核)
- 若需改动 **nuttx 等公共仓库**,则不在专属仓内直接 push,而是 fork 对应公共仓、以 **PR** 形式提交到 `dev-ai-contest-2026` 分支,由组委会 review 后合入。
- 大赛**仅在 GitHub 进行**(不使用 Gitee / GitCode;后两者仅作为获取 openvela 源码的镜像入口)。
- 初赛截止后,组委会会**统一收回提交权限**(你仍可 clone、查看自己的作品,但不能再 push)。
- **获奖后**,再按要求将作品 PR 至 openvela 上游对应仓库(走标准 PR + CI 流程)。
Expand All @@ -43,61 +41,27 @@ AI Coding 日志由插件自动归集到 logs/

1. 队长确认队伍组建完成(个人参赛者本人确认即可)。
2. 运营收集:队长 / 个人参赛者的 **GitHub 账号**、**队伍 / 个人名称**、(如需)**开发板需求**。
3. 组委会按统一规则创建仓库,采用**匿名编号**命名:
- `contest2026-<编号>-<形态>`(形态如 `app` / `quickapp` / `vendor-st` 等)。
- 队伍 / 个人与编号的映射由组委会内部维护。
4. 组委会向你提供一条 `repo init -u <manifest 仓库地址> -b <分支>` 命令(该 manifest 仓库内的清单文件已登记好「openvela 全量源码 + 你的专属仓库」),执行后再 `repo sync` 即可一键拉取完整工程;同时把你的 GitHub 账号加为仓库协作者(开通 push 权限)。
3. 组委会按统一规则创建仓库,采用**匿名编号**命名。
4. 组委会向你提供一条 `repo init -u <manifest 仓库地址> -b dev-ai-contest-2026` 命令(该 manifest 仓库内的清单文件已登记好「openvela 全量源码 + 你的专属仓库」),执行后再 `repo sync` 即可一键拉取完整工程;同时把你的 GitHub 账号加为仓库协作者(开通 push 权限)。
5. 你即可 clone 仓库、开始开发与提交。

> 请确保提供的 GitHub 账号准确,权限按此账号配置。

## 三、如何提交代码

1. 在仓库内完成开发,按需 `git commit` 并 **git push** 到你的专属仓库。
2. **AI Coding 日志**由预置插件自动归集到仓库的 `logs/` 目录,**无需手动整理或打包**。
3. 建议的仓库目录约定(便于评委定位):
1. 在 fork 出的仓库内完成开发,`git commit` 并推送后,向你的专属仓库发起 **PR**,可自行 review 并合入。
2. 建议的仓库目录约定(便于评委定位):

```text
/ # 作品代码
/logs/ # AI Coding 日志(插件自动写入)
README.md # 作品名称、所属赛道、运行方式、简介
```

## 四、分赛道说明

| 赛道 | 涉及仓库(GitHub) | 提交方式 |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------- |
| AI 硬件产品创新 | • `packages_demos`(应用 / Demo)、`packages_ai_agent`(框架能力)<br>• (可选)`vendor_<厂商>`:上真机需改板级配置 / 加外设驱动时<br>• (可选)其他公共仓(如 `nuttx`):涉及内核级等公共改动时 | 在你的专属仓库内开发并 push(应用 / Demo 工程) |
| 快应用 | • `packages_apps`(提交目标)<br>• (可选)`vendor_<厂商>`:部署到特定开发板需改板级配置时 | 在你的(快应用)专属仓库内提交源码工程 + 生产模式打包产物 `release.rpk` |
| 新硬件适配 | • `vendor_<对应厂商>`<br>• (可选)其他公共仓(如 `nuttx` 公共内核):涉及内核级等公共改动时 | 板级适配(defconfig、`boards/` 板级代码、驱动适配与说明)提交到组委会为你**单独创建的 vendor 仓**(用于隔离)。 |

> **说明**
>
> - 上表标注(可选)的仓库,仅在确有需要时才涉及。
> - 上述可选改动适用于**所有赛道**,统一处理方式:
> - `vendor_<厂商>` 由组委会单独开仓隔离。
> - `nuttx` 等其他公共仓走 **fork + PR** 合入 `dev-ai-contest-2026` 分支(无需单独开仓)。

各赛道的详细赛题要求与评分加分项,见对应赛道入口:

- [AI 硬件产品创新赛道](./ai_hardware/ai_hardware_guide_index.md)
- [快应用(手表应用创新)赛道](./quickapp/quickapp_guide_index.md)
- [新硬件适配赛道](./hardware_porting/hardware_porting_guide_index.md)

## 五、提交物清单

- 作品代码(在仓库内)
- AI Coding 日志(插件自动归集到 `logs/`,无需手动提交)

## 六、时间与权限
## 四、时间与权限

- 开发与提交:报名审核通过后即可开始。
- **提交截止与权限收回时间:【待确认】**(截止后统一收回 push 权限,仍可查看 / clone)。

## 七、获奖之后

获奖者需按组委会要求,将作品 PR 至 openvela 上游对应仓库的 `dev-ai-contest-2026` 分支(对应仓库见[四、分赛道说明](#四分赛道说明)中各赛道的「涉及仓库」),此步骤走标准 PR + CI 流程。

## 八、注意事项
## 五、获奖之后

- 提交遵循 Apache 2.0 开源协议,作品须为原创、无版权 / 专利纠纷
获奖者需按组委会要求,将作品 PR 至 openvela 上游对应仓库的 `dev-ai-contest-2026` 分支,此步骤走标准 PR + CI 流程
Loading