Skip to content
Merged
Show file tree
Hide file tree
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
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@
| [ai_agent 应用开发上手指南](./ai_agent_quickstart.md) | 从零搭建 openvela + ai_agent 环境、编译烧录、配置 LLM、开发 Skill 的完整教程。 |
| [mini-memo 应用开发指引](./mini_memo_guide.md) | 以 music_player 为模板构建 AI 记忆助手,演示主动任务、Router 路由、结构化输出。 |
| [支持的硬件平台](../hardware_porting/supported_hardware.md) | 大赛提供的开发板清单(已支持 + 待适配),可选型号参考。 |
| [参赛代码提交指南](../code_submission_guide.md) | 比赛期间如何获取仓库、提交代码、分赛道仓库说明(适用于所有赛道)。 |

## 如何选择

Expand Down
103 changes: 103 additions & 0 deletions zh-cn/contest_2026/code_submission_guide.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,103 @@
# 参赛代码提交指南

> 本指南面向已通过报名审核的参赛队伍 / 选手,说明比赛期间应如何提交代码。带「待确认」标记的内容以组委会最终公告为准。

## 全流程一览

```text
报名审核通过
组委会创建专属仓库 + 开通 push 权限
repo init + repo sync 一键拉取完整工程
在专属仓内开发 → git commit → git push
AI Coding 日志由插件自动归集到 logs/
初赛截止,组委会统一收回 push 权限(仍可 clone / 查看)
获奖后,将作品 PR 至 openvela 上游对应仓库
```

## 开始之前(前置条件)

- **开发环境**:已完成 openvela 开发环境搭建(可编译 / 运行),参见 [快速入门(Ubuntu)](../quickstart/openvela_ubuntu_quick_start.md)。
- **GitHub 账号**:使用报名时提供给组委会的**同一个 GitHub 账号**(仓库 push 权限按此账号配置)。
- **报名状态**:已通过报名审核(本指南面向审核通过后的开发与提交阶段)。
- **大赛官网**:https://www.openvela.com/#/contest(赛事介绍与最新资讯)。
- **大赛总览**:[《大赛总览》](./contest_overview.md)(赛道、流程、评分、资源一文读懂,建议先通读)。

## 一、提交总览

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

## 二、如何获得你的代码仓库

仓库由组委会统一创建,流程如下:

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

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

## 三、如何提交代码

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

```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 开源协议,作品须为原创、无版权 / 专利纠纷。
3 changes: 3 additions & 0 deletions zh-cn/contest_2026/contest_overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,7 @@ openvela 是小米开源的 AIoT 操作系统,专为轻量化、低功耗、AI

| 资源 | 链接 |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 大赛官网 | https://www.openvela.com/#/contest |
| openvela 代码仓库 | [GitHub](https://github.com/open-vela/docs/blob/dev-ai-contest-2026/README_zh-cn.md) / [Gitee](https://gitee.com/open-vela/docs/tree/dev-ai-contest-2026/) / [GitCode](https://gitcode.com/open-vela/docs/blob/dev-ai-contest-2026/README_zh-cn.md) |
| 官方文档站 | https://doc.openvela.com/document |
| 视频教程 | [B站](https://www.bilibili.com/video/BV19PsAzCEuy) / [YouTube](https://www.youtube.com/@openvela) |
Expand All @@ -61,6 +62,8 @@ openvela 是小米开源的 AIoT 操作系统,专为轻量化、低功耗、AI

## 作品提交要求

> 完整的提交流程、仓库获取方式、分赛道仓库说明,详见 [《参赛代码提交指南》](./code_submission_guide.md)。

- 参赛作品在赛事为每支队伍分配的 **GitHub public demo 仓**内开发与提交:代码直接 push 到 demo 仓,AI Coding 日志由插件自动归集到仓内 `logs/` 目录,**无需自行打包代码与日志**。
- 另需提交:作品介绍文档(.docx / .pdf / .pptx)、演示视频(不超过 5 分钟,mp4 / mov 等常见格式)、demo 仓地址。
- 大赛仅在 GitHub 进行(不在 Gitee);demo 仓为选手 sandbox,**直接 push 即可,无需 PR**。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@
| [最小可运行 NSH 系统 defconfig 参考](./defconfig_reference/minimum_nsh_baseline.md) | L0 起步 defconfig:在新开发板上先启动到 NSH 命令行提示符,再按需逐步启用文件系统、网络、传感器等子系统。 |
| [openvela 芯片移植指南](../../chip_porting/porting_guide.md) | 从零完成 BSP 移植的完整流程。 |
| [openvela 驱动开发指南](../../device_dev_guide/driver/driver_development.md) | UART/SPI/I2C 等各类驱动的适配与使用。 |
| [参赛代码提交指南](../code_submission_guide.md) | 比赛期间如何获取仓库、提交代码、分赛道仓库说明(适用于所有赛道)。 |

## 如何开始

Expand Down
1 change: 1 addition & 0 deletions zh-cn/contest_2026/quickapp/quickapp_guide_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@
| [快应用开发指南(AI 工作流)](./quickapp_ai_workflow.md) | 使用 Claude Code + VelaJS MCP 实现从需求描述到代码生成到模拟器调试的全流程自动化。适合希望快速出原型、让 AI 代劳写代码的参赛者。 |
| [openvela 快应用调用 velaclaw(端侧 AI Agent)教程](./quickapp_velaclaw.md) | 在快应用中通过 `@system.velaclaw` 调用端侧 AI Agent 能力(如自然语言问答)。适合需要在应用中集成 AI 对话功能的参赛者。 |
| [支持的硬件平台](../hardware_porting/supported_hardware.md) | 大赛提供的开发板清单(已支持 + 待适配),可选型号参考。 |
| [参赛代码提交指南](../code_submission_guide.md) | 比赛期间如何获取仓库、提交代码、分赛道仓库说明(适用于所有赛道)。 |

## 如何选择

Expand Down
2 changes: 2 additions & 0 deletions zh-cn/contest_2026/quickapp/quickapp_manual.md
Original file line number Diff line number Diff line change
Expand Up @@ -220,6 +220,8 @@ vapp hap://app/com.vela.player

## 六、提交参赛代码

> 完整的提交流程、仓库获取方式、分赛道仓库说明,详见 [《参赛代码提交指南》](../code_submission_guide.md)。

参赛代码在赛事为每支队伍分配的 **GitHub public demo 仓**内开发与提交:直接 push 到 demo 仓 main(无需 PR),AI Coding 日志由插件自动归集到仓内 `logs/` 目录。

**提交内容**:快应用**源码工程**(`src/`、`package.json`、`manifest.json` 等)+ 生产模式打包产物 **release.rpk**,二者都放入 demo 仓。
Expand Down
Loading