项目详情
contest2026_488_buchiyali
👋 欢迎参加 2026 首届 openvela AI 硬件开发者大赛！
这是组委会为你的队伍创建的专属参赛仓库（本仓为样例/模板，队伍编号 488；你看到的将是你自己的 contest2026__）。比赛期间，你的全部参赛代码、打包产物与 AI Coding 日志都提交到这里。
本仓既是「代码仓」，又内置了一键拉取整套 openvela 工程的 repo 清单（manifest）。你只需跟它打交道，自始至终只动一个文件夹。一、先读这些官方文档
通用（所有赛道必读）：
| 文档 | 用途 |
|---|---|
| 《大赛总览》 | 赛道、流程、评分、资源，建议先通读 |
| 《参赛代码提交指南》 | 仓库获取、提交流程、时间与权限（以此为准） |
| 《AI Coding 日志归集与提交手册》 | 如何导出 AI 对话日志并提交到 logs/ |
按你的赛道选读（三选一）：
| 赛道 | 教程导航 |
|---|---|
| 快应用 / 手表应用创新 | 快应用教程导航 |
| AI 硬件产品创新 | AI 硬件赛道教程导航 |
| 新硬件适配 | 新硬件适配赛道教程导航 |
二、第一步：拉取完整工程
用组委会提供的命令一键拉取「openvela 全量源码 + 你的专属仓」：
repo init -u https://github.com/open-vela/contest2026_488_buchiyali \
-b dev-ai-contest-2026 -m contest2026_488_buchiyali.xml
repo sync -c -j8同步后，你的整个仓库位于工作区的 contest2026_488_buchiyali/，openvela 全量源码在外层（nuttx/、apps/、packages/、vendor/ 等）。
三、第二步：在哪里写代码
只在自己的仓目录 contest2026_488_buchiyali/ 里开发。 不同作品形态放在对应子目录，manifest 会通过 `` 把它们软链到 openvela 编译树该在的位置——你不用手动 copy：
| 作品形态 | 你的代码放这里 | 系统自动映射到 |
|---|---|---|
| 应用 | app/hello_app/ | packages/demos/contest2026_488_hello_app |
| 快应用 | quickapp/hello_quickapp/ | packages/apps/contest2026_488_hello_quickapp |
| 板级适配 | board/contest_board/ | vendor/openvela/boards/contest2026_488_board |
用不到的形态目录可以删掉；新增作品时按同样规则加子目录，并在 contest2026_488_buchiyali.xml 里补一条 `` 映射即可。生产仓库（packages/nuttx/vendor 等）零改动。建议仓库目录约定（便于评委定位）：
app/ | quickapp/ | board/ # 你的作品代码
logs/ # AI Coding 日志（主动导出后提交，格式见 logs/README.md）
README.md # 作品说明（提交前请改成你自己的，见第六节）仓内附带了一个
.gitignore.example，给出了编译产物等不需要进仓的文件示例。如需启用，cp .gitignore.example .gitignore后按需增删即可。注意logs/下最终导出的 AI Coding 日志必须提交，不要忽略。
logs/的目录结构与提交格式见 logs/README.md。
四、第三步：编译与运行
编译/运行步骤随作品形态不同而不同，请参考你所在赛道的教程导航：
- 快应用 / 手表应用：快应用教程导航（含模拟器与开发板部署）。
- AI 硬件产品创新：AI 硬件赛道教程导航（环境搭建、编译烧录、Skill 开发）。
- 新硬件适配：新硬件适配赛道教程导航（BSP 移植、最小 NSH 基线）。
子目录已通过 manifest 中的 ` 软链进 openvela 编译树，因此构建在 openvela 工作区**根目录**（即你这个仓的上一级）进行。openvela 使用 build.sh` 作为统一入口，接收一个 board config 路径作为参数：
# 进入 openvela 工作区根目录（你的仓的上一级）
cd ..
# 通用语法：第一个参数是 board config 路径，第二个参数可以是 menuconfig / distclean 等
./build.sh [menuconfig|distclean] [-j8]具体的 board config 路径、目标产物、模拟器/真机部署方式请以你所在赛道的教程导航为准。本仓app/quickapp/board/三个示例骨架对应的 Kconfig 选项可通过menuconfig启用。
五、第四步：提交作品
- fork 你的专属仓 → 开发 →
git commit并推送 → 向专属仓发起 Pull Request，可自行 review 并合入（无需等组委会）。 - AI Coding 日志：与 AI 工具的对话会自动记录到本机 staging（不会自动上传），需你主动导出/打包选定会话到仓内
logs/目录后一并提交。详见《AI Coding 日志归集与提交手册》。 - 若需改动 nuttx 等公共仓库，不在本仓改，而是 fork 对应公共仓、以 PR 提交到
dev-ai-contest-2026分支，由组委会 review 后合入。
⏰ 提交作品截止：9 月 20 日。截止后统一收回 push 权限，仍可查看 / clone。
获奖后再按要求将作品 PR 至 openvela 上游对应仓库（走标准 PR + CI 流程）。
关于 PR 与 CLA
- 本仓所有改动通过 Pull Request 合入（分支保护强制，可自行合入自己的 PR）。
- 首次贡献需在官网签署 CLA；PR 上会自动跑
cla/signature检查，在官网签署成功后，在 PR 评论/check-cla复检即可通过。
六、提交前：把本 README 改成你的作品说明
本文件目前是组委会给的使用说明书。作品提交前，请把它替换成你自己作品的说明，方便评委快速了解你做了什么、怎么跑起来。建议至少包含以下内容：
#
## 一、作品简介
## 二、选题方向
## 三、目录结构
- `app/xxx/` —
- `board/xxx/` —
- `quickapp/xxx/` —
- `logs/` — AI Coding 日志
- `docs/` 或其他 —
## 四、运行方式
## 五、AI Coding 使用说明
提示：将会根据「作品本身 + 你的 README 说明 + logs/ 里的 AI Coding 日志」来理解和评估你的作品，README 写清楚很重要。附：仓库命名规范
contest2026__ — 编号三位零填充；队名 slug（全小写、英文/拼音、连字符）。例：contest2026_488_buchiyali。
（仓库由组委会统一创建，每队仅一个仓，无需自行命名。）
