0. 先看这一页:网站有四个入口
| 入口 | 地址 | 干什么 | 什么时候用 |
|---|---|---|---|
| 应用商店 | / | 列出所有应用,每个都能下载 .wapp | 想看有哪些应用 |
| 安装/升级系统 | /firmware/ | 给手表装系统(固件) | 新手表第一次装;或系统有新版本 |
| 安装应用 | /install/ | 用数据线把应用装进手表 | 电脑上有 .wapp 文件时 |
| 创作应用 | /builder/ | 用 AI 写一个自己的应用 | 想自己做点东西 |
记住一句话:系统和应用是分开装的。 先装系统,再装应用。
1. 开始前的准备
你需要
- 一台电脑(Windows 或 Mac 都行)。
- Chrome 或 Edge 浏览器。Safari、Firefox 不行,手机也不行。
- 一根能传数据的 USB 线。很多线只能充电、不能传数据,换了线还是找不到设备,多半就是这种线。
- 手表和它的数据线都在手边。
动手前先做三件事
- 关掉其他会占串口的软件:串口助手、
idf.py monitor、Arduino 串口监视器、另一个开着这个网站的标签页。 - 别用扩展坞 / USB Hub 试第一次,直接插电脑。
- 手表电量别太低。
串口是什么? 就是手表和电脑之间那根 USB 线里的"数据通道"。同一时间只能有一个程序用它,被别人占了,网站就找不到手表。
2. 第一次给手表装系统(首次安装)
⚠️ 这一步会清空手表里的 Wi-Fi 密码、密钥和已装应用。 新手表无所谓;已经用过的手表,先看第 3 节走升级。
步骤 01:检查固件和板型
打开 https://watch.hummingg.com/firmware/。
- 页面会自动下载并校验六段系统文件,显示"六段镜像的大小与 SHA-256 校验通过"。
- 然后勾选这句话:"我已核对完整板型,确实是上述 ESP32-S3 2.06 板"。
- "安装类型"选"首次安装 / 恢复系统"。
为什么要你勾板型?因为网页只能通过 USB 看到芯片型号,看不到屏幕大小。勾错了会装错系统。
步骤 02:连接手表并备份
- "连接方式"保持自动进入下载模式,"传输速度"保持 460800。
- 点 "连接手表(会复位) ↗"。
- 浏览器会弹出串口选择框,选那个带
usbmodem字样的设备,点"连接"。 - 连上后,设备信息会显示类似:
ESP32-S3 · 32MB Flash · 下载模式已连接(仍需由你核对屏幕板型)。 - 点 "读取完整 16MB 备份",等进度到 100%(通常几分钟)。
- 点 "保存备份到电脑",确认文件真的存到了电脑上。
- 勾选 "我已确认最初的备份文件完整保存到电脑"。
这个备份是什么? 是手表前 16 MB 的快照(整片 Flash 有 32 MB,网页只读前 16 MB),万一装坏了,它是唯一的退路。 备份不上传,只保存在你的电脑里。 备份文件名类似
watch-backup-xxxx-时间戳.bin,大小约 16 MB。别删,别覆盖,别改名后搞混。如果 Chrome 提示"这种类型的文件可能会损害你的计算机",点 保留。不点保留,文件就只存在于下载列表里,实际没落地。
步骤 03:确认并刷写
- 勾选 "我理解首次安装 / 恢复会覆盖原系统、Wi-Fi、用户公钥和已装应用的数据"。
- 点 "安装 / 恢复系统 →"。
- 弹出确认框,读一遍,点确定。
- 页面进入"正在写入;请勿拔线"。
- 等它自己走到"逐段回读并校验 SHA-256"→"全部写入区域回读校验通过"。
进度 100% 不等于成功了。 真正的成功标志是回读校验通过 + 下一步的启动检测。
步骤 04:确认系统真的启动了
- 页面提示你松开 BOOT(如果你按住了)。
- 手表正常启动后,点 "重新连接,检测系统启动"。
- 看到 "系统已启动 · ABI 11 · USBAPP / USBKEY 已就绪",才算装好。
提示里会写"屏幕和触摸仍需你在真机确认"——这句话是真的,网页验证不了屏幕。自己看一眼屏幕亮不亮、点一下有没有反应。
3. 已经能开机的手表:升级系统(保数据)
升级和首次安装的流程几乎一样,只有三个不同:
- "安装类型"选 "升级已有 HumminggOS"。
- 页面会先检查兼容性:分区表、启动槽位、系统名、当前版本。四项全过才允许写。
- 只写系统区,不碰 Wi-Fi、密钥、已装应用。
如果页面提示"现有分区布局不兼容,拒绝升级":
- 这是保护,不是故障。它不会偷偷改成首次安装。
- 你的选择只有两个:留在现在这版,或者接受首次安装(会清数据)。不要为了跳过检查去整片擦除。
4. 装应用(用数据线)
打开 https://watch.hummingg.com/install/。
4.1 连接手表
- 点 "连接手表 ↗",选串口设备。
- 注意:装应用时手表要正常开机,不是在下载模式。
- 连上会显示"安装协议已就绪 · 固件 ABI 11"。
4.2 登记本机密钥(每台电脑只做一次)
- 点 "登记到手表 ↗"。
- 这一步是告诉手表:"这台电脑签的应用,我信得过。"
每台电脑、每个浏览器各登记一次,互不影响。 手表最多记 4 把。换电脑后旧的会一直占着位置,不用了可以在页面里删掉;删掉只影响那台电脑以后还能不能装应用,不影响已经装好的应用。
4.3 选择应用包
- 点 "+ 选择 .wapp 文件",选你下载好的
.wapp。 - 限制:文件最大 256 KiB,入口代码最大 32 KiB。
- 选完页面会显示应用名、版本、权限和"格式与摘要检查通过"。
如果显示"不是本机密钥签名(由手表判断信任)",意思是:这个包不是这台电脑签的。不一定是坏事——比如商店签的包也长这样。最终能不能装,手表说了算。
4.4 确认并安装
- 勾选 "我信任此应用"。
- 点 "安装到手表 →"。
- 等它显示 "应用安装成功"。
- 去手表桌面点开应用。网页不会自动帮你启动它。
更新同一个应用时,只要 ID 相同就会覆盖旧版本。要保留应用里的数据,先想清楚再更新。
5. 自己做一个应用(AI 创作)
打开 https://watch.hummingg.com/builder/。
5.1 先接上你自己的 AI
- 选服务商、模型、接口地址,填 API Key。
- 网站没有服务器,也不替你付钱:请求从你的浏览器直接发到 AI 服务商,Key 只存在你这台电脑的浏览器里。
- 公共电脑用完,点"忘记 Key"。
5.2 描述你想要什么
写得越具体越好。对比一下:
| 写法 | 结果 |
|---|---|
| ❌ "做个时钟" | AI 只能靠猜 |
| ✅ "屏幕上显示大号时间 HH:MM,每秒刷新;点一下切换显示秒;长按回到桌面" | 能一次做对大半 |
还可以勾选允许的权限(屏幕、触摸、六轴、电量、网络、存储、麦克风、喇叭)。不勾就让 AI 自己决定,生成后会如实列出来。
5.3 生成 → 预览 → 改
- 点 "生成应用↗",等它写完。
- 页面会先做静态检查(漏声明的权限自动补、最低固件版本自动抬高、没有返回键会自动打开),然后在右侧真的跑起来。
- 预览里点画面 = 点手表屏幕,可以先用鼠标试。
- 用到网络的应用,AI 会顺手生成「预览数据」:把接口返回的示例内容填进去,预览里就能看到列表、详情这些界面。可以自己改,它只影响预览,不会打进应用包。
- 不满意就在"继续改"里说清楚要改什么,点 "改一版↗"。模型看到的是当前这版代码,不是从头再来。
5.4 打包 → 安装
- 点 "打包并下载 .wapp →",得到一个签名过的应用包。
- 点 "带到安装页 ↗",会在新标签页打开安装页并把包带过去;创作页原样留着,装完回来还能接着改。
- 按第 4 节装进手表。
必须先登记本机密钥,否则手表会拒收你自己签的包。这是"只装可信应用"的底线,不是 bug。
6. 在手表上用应用商店
手表自己就能逛商店,不需要电脑。
- 手表先连上 Wi-Fi(设置里配一次)。
- 回桌面,点 STORE 磁贴(就是应用商店)。
- 点一个应用 → 安装。
- 装完回桌面打开。
商店地址是出厂时写进系统的,固件只会从
https://watch.hummingg.com 拉包。如果手表上商店打不开,先检查 Wi-Fi,再看是不是系统版本太旧。 商店打开时会自动重新拉清单,所以刚发布的新应用,退出再进就能看到。 商店清单是签过名的:手表用系统内置的官方公钥核对清单,改过一点的清单会被直接丢掉。屏幕上出现 STORE LIST NOT SIGNED,说明商店地址被人改过或系统太旧,重试没用。7. 常见问题
| 你遇到的 | 原因 | 怎么办 |
|---|---|---|
| 页面里"连接手表"是灰的 | 还没勾板型确认,或固件还在校验 | 等校验完,勾上板型那句话 |
| 点了连接,什么也没发生 | 别的程序占着串口 | 关掉串口助手、idf.py monitor、其他标签页,然后刷新页面重试 |
| 弹不出串口选择框 | 浏览器卡住或权限状态乱了 | 关掉这个标签页,重新开一个;还不行就重启浏览器 |
| 备份读到一半显示"设备响应超时" | 数据线或 USB 链路不稳定 | 把"传输速度"改成 115200,重新连接再读;换线、换 USB 口 |
| 备份下载被标成"未确认" | Chrome 对 .bin 的安全提示 | 点"保留",确认文件真的在下载文件夹里 |
| 装应用提示"不支持 USB 安装" | 系统版本太旧,没有 USB 装应用功能 | 先用 /firmware/ 升级系统 |
| 装应用显示"不是本机密钥签名" | 包不是这台电脑签的 | 正常提示。手表拒收的话,先在安装页登记本机密钥,或用商店签的包 |
| 装完手表上找不到应用 | 网页装完不会自动启动 | 回桌面找图标;没有就重启手表再看 |
| 手表上的商店一直转圈或空白 | 网络慢,或上一次请求失败了 | 按返回回到桌面,再点一次 STORE;还不行检查 Wi-Fi |
| 升级被拒绝,说布局不兼容 | 两个系统的分区/启动结构不同 | 只能留在现版本,或做首次安装(会清数据)。不要整片擦除 |
| 手表黑屏、不进系统 | 刷写中途出问题 | 按第 8 节恢复;先保住备份,别反复点安装 |
| 手表进不了下载模式 | 带电时"拔 USB"不等于断电 | 彻底断电(带电池的要断电池),按住 BOOT 再上电 |
8. 出问题了:按这个顺序处理
- 停下来。 关掉其他串口页面和工具。不要反复点"安装",不要整片擦除。
- 保备份。 最初的 16 MB 备份文件别动。
- 换线、换口、换 115200 再试一次连接。
- 进不了下载模式:彻底断电 → 按住 BOOT → 重新上电 → 松开。页面上选"我已手动按 BOOT 进入下载模式"。
- 重新连接后,选同一种安装类型重试。升级不兼容时不要为了绕过检查去清数据。
- 回读通过了但还是黑屏:松开 BOOT 后重新上电,点"检测系统启动"。
- 还是不行:保留日志和备份,别把失败当成功,找人看。
从备份恢复: 网页 /firmware/ 第 05 步可以选入最初那份 16 MB 备份,把它整片写回手表。恢复会覆盖当前系统、配网、本机公钥和已装应用,用时和备份差不多;写完会逐块回读比对,再让你按第 04 步确认系统真的启动。备份里可以是 HumminggOS,也可以是刷机前手表原来的系统;只检查 16 MB 长度、ESP32-S3 标识、分区和应用镜像头。结构检查不能检测所有字节损坏,也不能替你核对屏幕板型;请核对备份来源和保存时的原始摘要。别用别人手表的备份,那会把对方的数据写进你的手表——网页不能证明这份备份属于哪一块手表,这里只做镜像结构检查,不代表实际启动已验证。恢复原厂系统后,网页的装应用和启动检测用不了。
网页恢复只做两件事:重装本站支持的系统,或写回本页读出并校验通过的完整备份。不接受任意
.bin,也不能用别人给的镜像顶替。9. 名词小抄
| 词 | 白话解释 |
|---|---|
| 固件 / 系统 | 手表自己的操作系统,决定屏幕、触摸、Wi-Fi 能不能用 |
应用 / .wapp | 装在系统上的小程序,格式是签过名的 .wapp |
| 串口 | USB 线里的数据通道,同一时间只能一个程序用 |
| 下载模式(BOOT) | 手表的"刷机模式",网页靠它读写 Flash |
| ABI | 系统给应用提供的接口版本。ABI 对不上,应用就跑不了 |
| 签名 | 给应用包盖个章,证明"这个包是谁做的"。手表只认商店的章和你自己登记的章 |
| 备份 | 手表前 16 MB 的快照,坏了能救回来 |
| OTA / 启动槽位 | 系统用来决定"下次从哪块区域启动"的记号 |
| 回读校验 | 写完再读一遍,确认写进去的和文件一模一样 |
10. 三条保命规则
- 写入过程中别拔线。 进度条不动了先等,别急着拔。
- 最初的备份别丢。 它是唯一的退路,失败后的新备份不能替代它。
- 别整片擦除。 网页不提供这个功能,也不需要。分区结构没变的情况下,整片擦除只会让你多丢一份数据。
附:这版系统的已知情况
- 网页验证的是"系统启动了、接口就绪",屏幕和触摸要你自己看。
- 备份读取偶尔会超时,根因未确认(生产站也会),改 115200 重试一般能过。这不是你操作错了。
- 首次安装会清空 Wi-Fi、密钥和应用数据,这是设计如此,页面上有勾选确认。
附二:本手册的更新记录
| 日期 | 改了什么 |
|---|---|
| 2026-10-20 | 备份可以整片写回:固件页新增第 05 步「从备份恢复」,把 16 MB 完整备份写回手表(整片写 + 逐块回读校验);备份里是原厂系统也能恢复,恢复后网页的装应用与启动检测不再适用。创作页写入了手表四角圆角规范(当时约 38 像素;2026-10-21 已改用实机标定的 120 像素规则),生成的代码不会把字画进切角里。全站统一系统名 HumminggOS。 |
| 2026-10-19 | 创作页与安装页上线,导航统一为五页;固件页可下载完整 16 MB 备份,写入中断后按第 8 节的顺序恢复。 |