v0.4.9：修复港股填 4 位代码时不显示

ESP8266 AI 状态时钟 v0.4.9

修复版：港股自选股填 4 位代码时不显示的问题。仅客户端（macOS / Windows）逻辑修复，固件无功能改动，可只升级客户端。

修复：港股代码填 4 位时股票不显示

• 腾讯行情接口要求港股代码补零到 5 位（如小米 hk01810、中芯国际 hk00981）。此前填 4 位代码（hk1810 / hk0981）会被接口判为无匹配，导致 /stock 返回空、设备股票页显示不出来。
• 桥接端（Mac/Win）的代码规范化现在会自动把港股代码补零到 5 位，填 4 位也能正常识别；沪深（sh/sz/bj）、美股（us）不受影响。

下载

固件

• esp8266-ai-firmware-v0.4.9.bin：刷入地址 0x0（esptool / 网页版刷写均可）。本版固件仅版本号变更，无功能改动，已在 v0.4.8 的可不重复刷。
• esp8266-ai-firmware-v0.4.9.elf：调试符号，一般用不到。

macOS 客户端

• AIClockBridge-v0.4.9-macOS.dmg：推荐，打开后拖入 Applications。
• AIClockBridge-v0.4.9-macOS.zip：ZIP 包装版。
• Universal Binary（Apple Silicon + Intel），最低 macOS 12；ad-hoc 签名未 notarize，首次启动可能需在「系统设置 → 隐私与安全性」允许并授权本地网络。

Windows 客户端

• AIClockBridge-v0.4.9-Windows-x64.exe：单文件自包含版，无需安装 .NET。
• AIClockBridge-v0.4.9-Windows-x64.zip：轻量版，需已安装 .NET 8 Desktop Runtime。

v0.4.8：修复 Codex 额度显示（取消 5h 窗口适配）

ESP8266 AI 状态时钟 v0.4.8

修复版：适配 Codex 取消 5 小时额度窗口后的新接口结构（#9）。固件与 macOS / Windows 客户端建议一起升级。

修复：Codex 额度显示（#9）

• Codex 官方已取消 5 小时额度窗口，用量接口的 primary_window 现在装的是周窗口、secondary_window 为空。旧版把它当 5h 解析，导致周用量顶到 5h 栏、Wk 栏为空、额度环不准，部分场景显示"Codex 用量请求失败"。
• 桥接端（Mac/Win）改为按窗口时长归类（≥2 天算周窗口），新旧两种接口结构都能正确解析；Codex 会话日志里的 rate_limits 同样适配。
• 固件：Codex 只有周窗口时，额度环改用周额度，额度文字区显示居中单列 Wk；额度用满倒计时不受影响。
• 客户端镜像窗口同步适配（仅周窗口时显示单行 Weekly）。
• 用量接口网络报错现在会带上底层原因（超时 / DNS 等），方便区分接口问题和本机网络问题。
• Claude 的 5h / 7 天额度显示不受影响。

下载

固件

• esp8266-ai-firmware-v0.4.8.bin：刷入地址 0x0（esptool / 网页版刷写均可）。
• esp8266-ai-firmware-v0.4.8.elf：调试符号，一般用不到。

macOS 客户端

• AIClockBridge-v0.4.8-macOS.dmg：推荐，打开后拖入 Applications。
• AIClockBridge-v0.4.8-macOS.zip：ZIP 包装版。
• Universal Binary（Apple Silicon + Intel），最低 macOS 12；ad-hoc 签名未 notarize，首次启动可能需在「系统设置 → 隐私与安全性」允许并授权本地网络。

Windows 客户端

• AIClockBridge-v0.4.8-Windows-x64.exe：单文件自包含版，无需安装 .NET。
• AIClockBridge-v0.4.8-Windows-x64.zip：轻量版，需已安装 .NET 8 Desktop Runtime。

只升级客户端不刷固件时，设备额度区会显示"5h -"+ 周用量（功能正常但布局旧）；建议固件一起刷。

ESP8266 AI 状态时钟 v0.4.7

ESP8266 AI 状态时钟 v0.4.7

三个大项：股票行情页、USB 有线直连（免配网 / 抗客户端隔离）、音乐页卡死修复。固件与 macOS / Windows 客户端建议一起升级。

新功能：股票行情页

• 「屏幕显示」菜单新增股票行情：最多 4 只自选股，大字价格 + 涨跌幅，涨红跌绿，中文股票名（Mac/Win 渲染位图下发），5 秒刷新、局部重绘不闪烁。
• 数据来自腾讯免费行情接口（无需任何 key），支持 A股（sh/sz）、港股（hk）、美股（us） 混合批量查询。
• 右键菜单 / 托盘「设置自选股…」配置（如 sh600519,hk00700,usAAPL），默认上证指数；客户端镜像窗口同步显示（含中文名）。

新功能：USB 有线直连

• 设备用 USB 线插到电脑上即可通信：桥接程序自动发现串口并推送全部数据（状态/额度/网速/CPU内存/股票）。
• 解决路由器"客户端隔离"导致 WiFi 下设备连不上电脑的问题；甚至可以完全不配 WiFi——全新设备插上 USB 直接可用（配网屏有提示）。
• 有线优先：串口有数据时自动停用 HTTP 轮询，拔线后 15 秒内自动切回 WiFi。
• 限制：音乐封面和股票中文名走 HTTP 位图，纯有线（无 WiFi）时音乐页不自动切入、股票只显示代码。
• 本版仅 macOS 支持有线，Windows 串口支持在计划中。

修复

• 音乐页卡死：播放器停止或退出后 music_playing 一直为 true，自动模式下设备永久停在音乐页、额度页回不来（MediaRemote 残留快照 + 进度外推钉在结尾导致）。感谢 @Kewanvk 的分析与修复（#8）。

下载

固件

• esp8266-ai-firmware-v0.4.7.bin：刷入地址 0x0（esptool / 网页版刷写均可）。
• esp8266-ai-firmware-v0.4.7.elf：调试符号，一般用不到。

macOS 客户端

• AIClockBridge-v0.4.7-macOS.dmg：推荐，打开后拖入 Applications。
• AIClockBridge-v0.4.7-macOS.zip：ZIP 包装版。
• Universal Binary（Apple Silicon + Intel），最低 macOS 12；ad-hoc 签名未 notarize，首次启动可能需在「系统设置 → 隐私与安全性」允许并授权本地网络。

Windows 客户端

• AIClockBridge-v0.4.7-Windows-x64.exe：单文件自包含版，无需安装 .NET。
• AIClockBridge-v0.4.7-Windows-x64.zip：轻量版，需已安装 .NET 8 Desktop Runtime。

新固件配旧客户端时股票页无数据；旧固件配新客户端不受影响。

ESP8266 AI 状态时钟 v0.4.6

ESP8266 AI 状态时钟 v0.4.6

网速页新增 CPU / 内存占用显示，曲线观感全面改进。固件与 macOS / Windows 客户端需一起升级（CPU/内存数据由客户端下发）。

新功能：网速页显示 CPU / 内存占用

• 网速页图表下方常显电脑当前的 CPU 占用 和 内存占用，大号数字、固定两栏排版（数值位数变化不会引起排版跳动），每 2 秒刷新。
• macOS 采样自系统 CPU 时钟差分 + 虚拟内存统计（口径接近活动监视器）；Windows 采样自 GetSystemTimes + GlobalMemoryStatusEx（口径同任务管理器）。
• 客户端镜像窗口的网速页同步显示同款信息。

改进：网速曲线

• 量程自适应：图表满量程改为「窗口内峰值 × 1.15」，峰值恒定顶在图表约 87% 高度，网速起伏一眼可见（原 1/2/5 阶梯量程最差会把曲线压到不足一半高度）。
• 线条加粗：设备端 3px → 10px（按 1.54" 小屏的物理尺寸校准）；客户端镜像维持细线（窗口大，同样粗细会过肥）。

下载

固件

• esp8266-ai-firmware-v0.4.6.bin：刷入地址 0x0（esptool / 网页版刷写均可）。
• esp8266-ai-firmware-v0.4.6.elf：调试符号，一般用不到。

macOS 客户端

• AIClockBridge-v0.4.6-macOS.dmg：推荐，打开后拖入 Applications。
• AIClockBridge-v0.4.6-macOS.zip：ZIP 包装版。
• Universal Binary（Apple Silicon + Intel），最低 macOS 12；ad-hoc 签名未 notarize，首次启动可能需在「系统设置 → 隐私与安全性」允许并授权本地网络。

Windows 客户端

• AIClockBridge-v0.4.6-Windows-x64.exe：单文件自包含版，无需安装 .NET。
• AIClockBridge-v0.4.6-Windows-x64.zip：轻量版，需已安装 .NET 8 Desktop Runtime。

旧固件配新客户端不受影响；新固件配旧客户端时 CPU/内存行不显示（其余功能正常）。

ESP8266 AI 状态时钟 v0.4.5

ESP8266 AI 状态时钟 v0.4.5

新增屏幕亮度调节，固件与 macOS / Windows 客户端同步更新。

新功能：屏幕亮度调节

• 客户端滑条：左键点托盘 / 菜单栏图标打开镜像首页，底部新增 ☀ 亮度滑条，拖动实时调光（0 = 熄屏）。
• 设备网页：浏览器打开设备 IP，同样有亮度滑条。
• API：POST /api/brightness（level=0-100），/api/info 回报当前亮度。
• 背光为 PWM 调光（2kHz，无可见频闪），设置存入设备 LittleFS，断电重启自动恢复。

修复

• macOS：修复旧版本桥接可能与新版本同时启动、轮流抢占 8765 端口的问题（LaunchAgent 统一以 /Applications/AIClockBridge.app 为准）。

下载

固件

• esp8266-ai-firmware-v0.4.5.bin：刷入地址 0x0（esptool / 网页版刷写均可）。
• esp8266-ai-firmware-v0.4.5.elf：调试符号，一般用不到。

macOS 客户端

• AIClockBridge-v0.4.5-macOS.dmg：推荐，打开后拖入 Applications。
• AIClockBridge-v0.4.5-macOS.zip：ZIP 包装版。
• Universal Binary（Apple Silicon + Intel），最低 macOS 12；ad-hoc 签名未 notarize，首次启动可能需在「系统设置 → 隐私与安全性」允许并授权本地网络。

Windows 客户端

• AIClockBridge-v0.4.5-Windows-x64.exe：单文件自包含版，无需安装 .NET。
• AIClockBridge-v0.4.5-Windows-x64.zip：轻量版，需已安装 .NET 8 Desktop Runtime。

固件和客户端建议一起升级：旧客户端配新固件时亮度只能通过设备网页调。

ESP8266 AI 状态时钟 v0.4.4

ESP8266 AI 状态时钟 v0.4.4

本次更新 ESP8266 固件，围绕屏幕显示做了三项改进；macOS / Windows 客户端功能无变化，随版本同步打包。

固件改进

额度数字更大更粗

• 精灵图下方的额度信息改为两栏布局：灰色小标签「5h」「Wk」+ 大号加粗的白色百分比，一眼可读。

消除周期性整屏闪烁

• 修复每 5 秒桥接轮询后整屏清黑重绘导致的闪烁：改为原地局部刷新，进度环和文字只在数值变化时重绘，动画观感不再被打断。

额度用满显示重置倒计时

• 5 小时或周额度用满（≥99.9%）时，桌宠自动换成橙色大字倒计时，显示距额度窗口重置还有多久；两者都满时优先显示周倒计时（标签「Wk RESET IN」/「5h RESET IN」区分）。
• 倒计时精确到秒（桥接只下发分钟精度，固件本地走秒并按轮询校准）；超过 100 小时显示 时:分，否则 时:分:秒。
• 额度恢复后自动换回桌宠。

下载

固件（本次更新内容）

• esp8266-ai-firmware-v0.4.4.bin：刷入地址 0x0（esptool / 网页版刷写均可）。
• esp8266-ai-firmware-v0.4.4.elf：调试符号，一般用不到。

macOS 客户端（功能同 v0.4.3，仅版本号更新）

• AIClockBridge-v0.4.4-macOS.dmg：推荐，打开后拖入 Applications。
• AIClockBridge-v0.4.4-macOS.zip：ZIP 包装版。
• Universal Binary（Apple Silicon + Intel），最低 macOS 12；ad-hoc 签名未 notarize，首次启动可能需在「系统设置 → 隐私与安全性」允许并授权本地网络。

Windows 客户端（功能同 v0.4.2，仅版本号更新）

• AIClockBridge-v0.4.4-Windows-x64.exe：单文件自包含版，无需安装 .NET。
• AIClockBridge-v0.4.4-Windows-x64.zip：轻量版，需已安装 .NET 8 Desktop Runtime。

已在用旧版客户端的可以不升级：倒计时所需的重置时间字段桥接端早已下发，本版固件直接解析使用。

ESP8266 AI 状态时钟 v0.4.3

ESP8266 AI 状态时钟 v0.4.3

本次仅更新 macOS 客户端，修复会导致桥接程序退出并显示“无法连接 ESP8266”的稳定性问题。

macOS 修复

• 修复网卡切换、VPN 状态变化或睡眠唤醒后，系统网络累计计数下降时触发 Swift 无符号整数溢出的问题。
• 计数器重置时现在会安全地重新建立采样基线，不再导致 AIClockBridge 崩溃或产生异常网速峰值。
• 新增回归测试覆盖计数增长和计数下降两种情况。

下载

• AIClockBridge-v0.4.3-macOS.dmg：推荐，打开后拖入 Applications。
• AIClockBridge-v0.4.3-macOS.zip：ZIP 包装版。
• Universal Binary：同时支持 Apple Silicon 和 Intel Mac，最低 macOS 12。
• ad-hoc 签名，未 notarize；首次启动可能需要在“系统设置 → 隐私与安全性”中允许，并重新授权本地网络访问。

其他平台

• ESP8266 固件没有变化，仍为 v0.4.2，无需重新刷写。
• Windows 客户端没有变化，继续使用 v0.4.2。

验证

• swift test：2 个测试全部通过。
• Release 通用构建：arm64 + x86_64。
• ZIP 解包后通过 codesign --verify --deep --strict。

ESP8266 AI 状态时钟 v0.4.2

ESP8266 AI 状态时钟 v0.4.2

本次为 Mac / Windows 客户端更新（配对自愈），固件除版本号（0.4.2）外与 v0.4.1
一致，已装 v0.4.1 的设备无需重刷。

客户端变化（Mac + Windows 同步）

• 配对自愈：修复"全新/整片擦除的设备永远配不上桥接"的死锁——设备不知道
  bridge 地址就不会来轮询，桥接端的被动发现（记录来访 IP）永远不触发。现在
  桥接端每 60 秒检查一次：超过 3 分钟没被设备轮询，就主动查找设备（先试上次
  见过的 IP 和已配置地址，再扫描本机 /24 网段，扫描 5 分钟限流一次）；找到后
  若设备的 bridge 为空、或它配置的地址已经拉不到数据（last_update_s 停滞
  超过 60 秒），自动把本机 ip:8765 推送给设备。
• 效果：刷完固件重新配网后什么都不用点，几分钟内额度数据自动恢复显示；
  桥接机器换 IP（DHCP 变更）后同样自动修复。

下载（推荐，免解压）

• macOS：AIClockBridge-v0.4.2-macOS.dmg —— 打开后把 AIClockBridge 拖进
  Applications 即完成安装（Universal arm64 + x86_64；ad-hoc 签名未 notarize，
  首次打开需在「系统设置 → 隐私与安全性」中允许）
• Windows：AIClockBridge-v0.4.2-Windows-x64.exe —— 自包含单文件，双击直接
  运行，无需安装 .NET 运行时（Windows 10 19041+ / Windows 11；首次启动允许防火墙
  授权，设备才能从局域网访问 8765 端口；SmartScreen 提示时选「仍要运行」。
  开机自启：Win+R → shell:startup 放入 exe 快捷方式）

其他 Assets

• AIClockBridge-v0.4.2-macOS.zip：Mac app 的 zip 包装版（内容同 dmg）
• AIClockBridge-v0.4.2-Windows-x64.zip：Windows framework-dependent 轻量版
  （7MB，需要先安装 .NET 8 Desktop Runtime x64）
• esp8266-ai-firmware-v0.4.2.bin：ESP8266 固件（仅版本号变化，v0.4.1 用户无需重刷）
• esp8266-ai-firmware-v0.4.2.elf：调试符号
• SHA256SUMS.txt：校验和

刷固件

网页版刷写工具（浏览器 + USB 线），或本地：
cd firmware && pio run -t upload

Firmware size

• RAM: 49.0% (40116 / 81920 bytes)
• Flash: 78.9% (823851 / 1044464 bytes)

ESP8266 AI 状态时钟 v0.4.1

ESP8266 AI 状态时钟 v0.4.1

固件更新（配网体验 + 默认动画 + 版本显示），Mac / Windows 客户端与 v0.3.0 功能一致（重新打包）。

固件变化

• 配网页面全中文：首次配置 WiFi 时手机连上 AI-Clock-Setup 热点后打开的
  配网门户（192.168.4.1）整套界面改为中文——WiFi 列表、名称/密码表单、保存
  提示、错误信息（密码错误 / 找不到网络 / 连接失败）、设备信息页等。
• 首次配置无需填写 Bridge 地址：配网页面移除了 Bridge host (ip:port)
  输入框，只需选 WiFi 输密码。桥接由 Mac / Windows 客户端自动发现设备并配对
  （也可在设备网页或 POST /api/bridge 手动设置）。
• 默认动画更新：编译内置的 Claude / Codex 默认精灵图动画替换为当前正在使用
  的角色动画（各 6 帧）。恢复默认动画（/sprite/*/reset）后显示的就是这套。
• 首次配网屏幕显示固件版本：设备处于配网模式时屏幕底部显示 Firmware v0.4.1；/api/info 新增 fw 字段方便远程查询版本。

下载（推荐，免解压）

• macOS：AIClockBridge-v0.4.1-macOS.dmg —— 打开后把 AIClockBridge 拖进
  Applications 即完成安装（Universal arm64 + x86_64；ad-hoc 签名未 notarize，
  首次打开需在「系统设置 → 隐私与安全性」中允许）
• Windows：AIClockBridge-v0.4.1-Windows-x64.exe —— 自包含单文件，双击直接
  运行，无需安装 .NET 运行时（Windows 10 19041+ / Windows 11；首次启动允许防火墙
  授权，设备才能从局域网访问 8765 端口；SmartScreen 提示时选「仍要运行」。
  开机自启：Win+R → shell:startup 放入 exe 快捷方式）

其他 Assets

• AIClockBridge-v0.4.1-macOS.zip：Mac app 的 zip 包装版（内容同 dmg）
• AIClockBridge-v0.4.1-Windows-x64.zip：Windows framework-dependent 轻量版
  （7MB，需要先安装 .NET 8 Desktop Runtime x64）
• esp8266-ai-firmware-v0.4.1.bin：ESP8266 固件（本次有更新，建议刷写）
• esp8266-ai-firmware-v0.4.1.elf：调试符号
• SHA256SUMS.txt：校验和

刷固件

网页版刷写工具（浏览器 + USB 线），或本地：
cd firmware && pio run -t upload

Firmware size

• RAM: 49.0% (40116 / 81920 bytes)
• Flash: 78.9% (823851 / 1044464 bytes)