不会编程
也能做一个应用。

先把徽章连上电脑

用一根带数据功能的 Type-C 线把「谷仓电子徽章」连到电脑（普通充电线可能只供电、不能传数据）。这一步要在让 AI 动手之前完成——只有连着设备，AI 才能替你烧录、截图、验证效果。

让 AI 检查开发环境

把这句话复制给你的 AI 助手（WorkBuddy / Claude Code / Cursor 任选其一）：

请先克隆这个仓库：https://github.com/SDGOODS/SDGOODS-ESP32S3
然后按里面 docs/ENVIRONMENT.md 的要求，
检查并配置这台电脑的开发环境。缺什么装什么，每一步都告诉我在做什么；
装完跑一次环境检查，把结果汇总给我。

AI 会自动检查并安装 Python、ESP-IDF 工具链和 USB 驱动，最后给你一份环境报告。过程中弹出的「是否允许」点确认即可。

生成并烧录第一个应用

环境好了，再把这句发给 AI，先跑通一个最小的「Hello SDGOODS!」例子：

请先克隆这个仓库：https://github.com/SDGOODS/SDGOODS-ESP32S3
然后按里面的 README 与 AGENTS.md 规范，
用 tools/new_app_project.py 生成一个叫 HelloApp 的独立应用工程，
把屏幕问候语改成 Hello SDGOODS!，编译后烧进连着的谷仓电子徽章，烧完截屏给我看效果。

AI 会生成一个最小应用，圆屏中央显示 Hello SDGOODS!，然后烧录到徽章并截图给你看。看到画面就说明整条链路跑通了。

把「Hello」换成你想要的应用

跑通之后，用大白话把你想做的应用描述给 AI（计时器、相册、小游戏、时钟天气、待办……都可以），它会在 HelloApp 的基础上改出来：

请把 HelloApp 改造成一个「番茄钟」应用：圆屏中央显示倒计时，
点一下开始/暂停，顶部下滑的控制中心保持默认就好。
改完编译烧录到徽章，并截图给我看效果。

（上面「番茄钟」换成你自己的想法即可。）AI 改代码时都会遵守仓库里的 AGENTS.md 规范，不用你操心细节。

让 AI 帮你发布（推荐）

把这句话发给 AI，它会引导你生成一个开发者令牌，然后自动打包、填信息、配截图、提交审核：

请帮我把 HelloApp 发布到谷仓开放平台。
我会在平台开发者设置里生成一个 sdg_ 开头的开发者令牌发给你，
你负责打包固件、填名称 / 简介 / 分类、配好截图并提交审核，完成后把结果告诉我。

AI 会先让你去平台的「开发者设置」里生成一个 sdg_ 开头的开发者令牌（粘贴给 AI 一次即可），剩下的自动完成。过审即上架。

或自己在网页上发

不想用 AI，也可以自己动手：

① 先跟 AI 说一句「帮我把 HelloApp 打包成能上传的 app.bin」；② 打开 sdgoods.ai 登录，进入「我的中心 → 上传固件」；③ 上传那个 app.bin，填名称 / 分类 / 简介（中英文）/ 截图（最多 4 张，360×360，第一张作封面），截图可以点「从设备截图」直接连真机抓图；④ 提交审核。

等审核上架

提交后进入审核队列（状态显示「审核中」），通常 1-2 个工作日 通过，过审即公开上架到市场。想再改可以先存成草稿，之后随时回来完善再提审。

打开固件市场

在市场页面找到想安装的固件，点开详情，点击底部的 安装 按钮（不是下载 .bin 文件）。

浏览器弹出串口授权

Chrome 会弹窗让你选择 USB 串口设备。找到 SDGOODS · USB-JTAG/serial 这一项，点连接。

const port = await navigator.serial.requestPort({
  filters: [{ usbVendorId: 0x303A }]   // Espressif VID
});

开始烧录

浏览器接管 USB 后会自动 擦除 → 写入 → 校验 → 重启。屏幕会显示绿色进度条，整个过程不需要你动手。

> connecting... OK
> erasing flash... 100%
> writing 0x10000 / 0x80000 [████░░]
> verifying... OK
> restarting device... OK
// 你的固件已经在徽章上跑起来了