HUMMINGG / HumminggOS

USER MANUAL 小白版

照着点,
就能用起来。

装系统、升级、装应用、用 AI 做应用。
每一步都写了你会看到什么、该点哪里。

不用懂代码按页面顺序走失败了怎么救也写了
适用站点
watch.hummingg.com
对应固件
在安装页查看当前发布版本与 ABI;下文启动与协议提示中的 ABI 数字以页面实际检测为准。
适用硬件
微雪 ESP32-S3-Touch-AMOLED-2.06(2.06 寸那款),别的板子不要照做

0. 先看这一页:网站有四个入口

入口 地址 干什么 什么时候用
应用商店/列出所有应用,每个都能下载 .wapp想看有哪些应用
安装/升级系统/firmware/给手表装系统(固件)新手表第一次装;或系统有新版本
安装应用/install/用数据线把应用装进手表电脑上有 .wapp 文件时
创作应用/builder/用 AI 写一个自己的应用想自己做点东西

记住一句话:系统和应用是分开装的。 先装系统,再装应用。

1. 开始前的准备

你需要

  1. 一台电脑(Windows 或 Mac 都行)。
  2. Chrome 或 Edge 浏览器。Safari、Firefox 不行,手机也不行。
  3. 一根能传数据的 USB 线。很多线只能充电、不能传数据,换了线还是找不到设备,多半就是这种线。
  4. 手表和它的数据线都在手边。

动手前先做三件事

  • 关掉其他会占串口的软件:串口助手、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:连接手表并备份

  1. "连接方式"保持自动进入下载模式,"传输速度"保持 460800。
  2. 点 "连接手表(会复位) ↗"。
  3. 浏览器会弹出串口选择框,选那个带 usbmodem 字样的设备,点"连接"。
  4. 连上后,设备信息会显示类似:ESP32-S3 · 32MB Flash · 下载模式已连接(仍需由你核对屏幕板型)。
  5. 点 "读取完整 16MB 备份",等进度到 100%(通常几分钟)。
  6. 点 "保存备份到电脑",确认文件真的存到了电脑上。
  7. 勾选 "我已确认最初的备份文件完整保存到电脑"。
这个备份是什么? 是手表前 16 MB 的快照(整片 Flash 有 32 MB,网页只读前 16 MB),万一装坏了,它是唯一的退路。 备份不上传,只保存在你的电脑里。 备份文件名类似 watch-backup-xxxx-时间戳.bin,大小约 16 MB。别删,别覆盖,别改名后搞混。
如果 Chrome 提示"这种类型的文件可能会损害你的计算机",点 保留。不点保留,文件就只存在于下载列表里,实际没落地。

步骤 03:确认并刷写

  1. 勾选 "我理解首次安装 / 恢复会覆盖原系统、Wi-Fi、用户公钥和已装应用的数据"。
  2. 点 "安装 / 恢复系统 →"。
  3. 弹出确认框,读一遍,点确定。
  4. 页面进入"正在写入;请勿拔线"。
  5. 等它自己走到"逐段回读并校验 SHA-256"→"全部写入区域回读校验通过"。
进度 100% 不等于成功了。 真正的成功标志是回读校验通过 + 下一步的启动检测。

步骤 04:确认系统真的启动了

  1. 页面提示你松开 BOOT(如果你按住了)。
  2. 手表正常启动后,点 "重新连接,检测系统启动"。
  3. 看到 "系统已启动 · ABI 11 · USBAPP / USBKEY 已就绪",才算装好。
提示里会写"屏幕和触摸仍需你在真机确认"——这句话是真的,网页验证不了屏幕。自己看一眼屏幕亮不亮、点一下有没有反应。

3. 已经能开机的手表:升级系统(保数据)

升级和首次安装的流程几乎一样,只有三个不同:

  1. "安装类型"选 "升级已有 HumminggOS"。
  2. 页面会先检查兼容性:分区表、启动槽位、系统名、当前版本。四项全过才允许写。
  3. 只写系统区,不碰 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 确认并安装

  1. 勾选 "我信任此应用"。
  2. 点 "安装到手表 →"。
  3. 等它显示 "应用安装成功"。
  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 生成 → 预览 → 改

  1. 点 "生成应用↗",等它写完。
  2. 页面会先做静态检查(漏声明的权限自动补、最低固件版本自动抬高、没有返回键会自动打开),然后在右侧真的跑起来。
  3. 预览里点画面 = 点手表屏幕,可以先用鼠标试。
  4. 用到网络的应用,AI 会顺手生成「预览数据」:把接口返回的示例内容填进去,预览里就能看到列表、详情这些界面。可以自己改,它只影响预览,不会打进应用包。
  5. 不满意就在"继续改"里说清楚要改什么,点 "改一版↗"。模型看到的是当前这版代码,不是从头再来。

5.4 打包 → 安装

  1. 点 "打包并下载 .wapp →",得到一个签名过的应用包。
  2. 点 "带到安装页 ↗",会在新标签页打开安装页并把包带过去;创作页原样留着,装完回来还能接着改。
  3. 按第 4 节装进手表。
必须先登记本机密钥,否则手表会拒收你自己签的包。这是"只装可信应用"的底线,不是 bug。

6. 在手表上用应用商店

手表自己就能逛商店,不需要电脑。

  1. 手表先连上 Wi-Fi(设置里配一次)。
  2. 回桌面,点 STORE 磁贴(就是应用商店)。
  3. 点一个应用 → 安装。
  4. 装完回桌面打开。
商店地址是出厂时写进系统的,固件只会从 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. 出问题了:按这个顺序处理

  1. 停下来。 关掉其他串口页面和工具。不要反复点"安装",不要整片擦除。
  2. 保备份。 最初的 16 MB 备份文件别动。
  3. 换线、换口、换 115200 再试一次连接。
  4. 进不了下载模式:彻底断电 → 按住 BOOT → 重新上电 → 松开。页面上选"我已手动按 BOOT 进入下载模式"。
  5. 重新连接后,选同一种安装类型重试。升级不兼容时不要为了绕过检查去清数据。
  6. 回读通过了但还是黑屏:松开 BOOT 后重新上电,点"检测系统启动"。
  7. 还是不行:保留日志和备份,别把失败当成功,找人看。

从备份恢复: 网页 /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. 三条保命规则

  1. 写入过程中别拔线。 进度条不动了先等,别急着拔。
  2. 最初的备份别丢。 它是唯一的退路,失败后的新备份不能替代它。
  3. 别整片擦除。 网页不提供这个功能,也不需要。分区结构没变的情况下,整片擦除只会让你多丢一份数据。

附:这版系统的已知情况

  • 网页验证的是"系统启动了、接口就绪",屏幕和触摸要你自己看。
  • 备份读取偶尔会超时,根因未确认(生产站也会),改 115200 重试一般能过。这不是你操作错了。
  • 首次安装会清空 Wi-Fi、密钥和应用数据,这是设计如此,页面上有勾选确认。

附二:本手册的更新记录

日期 改了什么
2026-10-20备份可以整片写回:固件页新增第 05 步「从备份恢复」,把 16 MB 完整备份写回手表(整片写 + 逐块回读校验);备份里是原厂系统也能恢复,恢复后网页的装应用与启动检测不再适用。创作页写入了手表四角圆角规范(当时约 38 像素;2026-10-21 已改用实机标定的 120 像素规则),生成的代码不会把字画进切角里。全站统一系统名 HumminggOS。
2026-10-19创作页与安装页上线,导航统一为五页;固件页可下载完整 16 MB 备份,写入中断后按第 8 节的顺序恢复。