diff --git a/zh-cn/contest_2026/ai_hardware/ai_hardware_guide_index.md b/zh-cn/contest_2026/ai_hardware/ai_hardware_guide_index.md index 35e555af..2df0d207 100644 --- a/zh-cn/contest_2026/ai_hardware/ai_hardware_guide_index.md +++ b/zh-cn/contest_2026/ai_hardware/ai_hardware_guide_index.md @@ -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) | 比赛期间如何获取仓库、提交代码、分赛道仓库说明（适用于所有赛道）。 | ## 如何选择 diff --git a/zh-cn/contest_2026/code_submission_guide.md b/zh-cn/contest_2026/code_submission_guide.md new file mode 100644 index 00000000..0ab44277 --- /dev/null +++ b/zh-cn/contest_2026/code_submission_guide.md @@ -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 -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`（框架能力）
• （可选）`vendor_<厂商>`：上真机需改板级配置 / 加外设驱动时
• （可选）其他公共仓（如 `nuttx`）：涉及内核级等公共改动时 | 在你的专属仓库内开发并 push（应用 / Demo 工程） | +| 快应用 | • `packages_apps`（提交目标）
• （可选）`vendor_<厂商>`：部署到特定开发板需改板级配置时 | 在你的（快应用）专属仓库内提交源码工程 + 生产模式打包产物 `release.rpk` | +| 新硬件适配 | • `vendor_<对应厂商>`
• （可选）其他公共仓（如 `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 开源协议，作品须为原创、无版权 / 专利纠纷。 diff --git a/zh-cn/contest_2026/contest_overview.md b/zh-cn/contest_2026/contest_overview.md index 13dfea05..9ba1117c 100644 --- a/zh-cn/contest_2026/contest_overview.md +++ b/zh-cn/contest_2026/contest_overview.md @@ -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) | @@ -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**。 diff --git a/zh-cn/contest_2026/hardware_porting/hardware_porting_guide_index.md b/zh-cn/contest_2026/hardware_porting/hardware_porting_guide_index.md index 4444c5c3..c5b40648 100644 --- a/zh-cn/contest_2026/hardware_porting/hardware_porting_guide_index.md +++ b/zh-cn/contest_2026/hardware_porting/hardware_porting_guide_index.md @@ -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) | 比赛期间如何获取仓库、提交代码、分赛道仓库说明（适用于所有赛道）。 | ## 如何开始 diff --git a/zh-cn/contest_2026/quickapp/quickapp_guide_index.md b/zh-cn/contest_2026/quickapp/quickapp_guide_index.md index 26e8c51e..9dc4fbaa 100644 --- a/zh-cn/contest_2026/quickapp/quickapp_guide_index.md +++ b/zh-cn/contest_2026/quickapp/quickapp_guide_index.md @@ -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) | 比赛期间如何获取仓库、提交代码、分赛道仓库说明（适用于所有赛道）。 | ## 如何选择 diff --git a/zh-cn/contest_2026/quickapp/quickapp_manual.md b/zh-cn/contest_2026/quickapp/quickapp_manual.md index 3fb4c835..8d8318e4 100644 --- a/zh-cn/contest_2026/quickapp/quickapp_manual.md +++ b/zh-cn/contest_2026/quickapp/quickapp_manual.md @@ -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 仓。