diff --git a/zh-cn/contest_2026/code_submission_guide.md b/zh-cn/contest_2026/code_submission_guide.md index 0ab44277..cafc4b1a 100644 --- a/zh-cn/contest_2026/code_submission_guide.md +++ b/zh-cn/contest_2026/code_submission_guide.md @@ -7,13 +7,11 @@ ```text 报名审核通过 ↓ -组委会创建专属仓库 + 开通 push 权限 +组委会创建专属仓库 + 开通权限 ↓ repo init + repo sync 一键拉取完整工程 ↓ -在专属仓内开发 → git commit → git push - ↓ -AI Coding 日志由插件自动归集到 logs/ +fork 专属仓库开发 → 发起 PR → 自行 review 合入 ↓ 初赛截止，组委会统一收回 push 权限（仍可 clone / 查看） ↓ @@ -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 流程）。 @@ -43,61 +41,27 @@ AI Coding 日志由插件自动归集到 logs/ 1. 队长确认队伍组建完成（个人参赛者本人确认即可）。 2. 运营收集：队长 / 个人参赛者的 **GitHub 账号**、**队伍 / 个人名称**、（如需）**开发板需求**。 -3. 组委会按统一规则创建仓库，采用**匿名编号**命名： - - `contest2026-<编号>-<形态>`（形态如 `app` / `quickapp` / `vendor-st` 等）。 - - 队伍 / 个人与编号的映射由组委会内部维护。 -4. 组委会向你提供一条 `repo init -u -b <分支>` 命令（该 manifest 仓库内的清单文件已登记好「openvela 全量源码 + 你的专属仓库」），执行后再 `repo sync` 即可一键拉取完整工程；同时把你的 GitHub 账号加为仓库协作者（开通 push 权限）。 +3. 组委会按统一规则创建仓库，采用**匿名编号**命名。 +4. 组委会向你提供一条 `repo init -u -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`（框架能力）
• （可选）`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 开源协议，作品须为原创、无版权 / 专利纠纷。 +获奖者需按组委会要求，将作品 PR 至 openvela 上游对应仓库的 `dev-ai-contest-2026` 分支，此步骤走标准 PR + CI 流程。