VibeStick-Codex v0.3.1

VibeStick-Codex v0.3.1

This patch release improves first-time Wi-Fi setup and keeps StickS3 WAIT
notifications compatible with current Codex approval calls.

Highlights

• Opens the protected Wi-Fi setup page automatically after a phone joins the
  temporary StickS3 access point.
• Redirects captive-network DNS requests locally and handles common GET,
  HEAD, and fallback POST probes.
• Keeps http://192.168.4.1 available as a manual fallback.
• Recognizes nested JavaScript-style Codex tool calls that require human
  approval, restoring WAIT state and sound notifications on StickS3.
• Preserves authenticated Bridge discovery, saved Wi-Fi recovery, and the
  Codex + Hourglass dual-application switching layout.

Downloads

File	Purpose
VibeStick-Codex-v0.3.1-app.bin	Codex-slot update for an already verified dual-app device; write only at 0x320000
VibeStick-Codex-v0.3.1-full-install.bin	Full standalone installation at 0x0; replaces the existing firmware layout
VibeStick-Bridge-macOS-Apple-Silicon-v0.3.1.dmg	Self-contained Apple Silicon macOS Bridge
VibeStick-Bridge-Windows-v0.3.1-Setup.exe	64-bit Windows Bridge preview installer
SHA256SUMS and individual .sha256 files	Download verification

Warning

Verify the physical device identity, partition table, image, and address
before flashing. On a supported Codex + Hourglass dual-app device, update
Codex only with the application image at 0x320000. The full-install image
replaces the bootloader, partition table, OTA metadata, and application at
0x20000.

The macOS package is ad-hoc signed but not Developer ID signed or notarized.
The Windows package remains unsigned preview software pending broader real-PC
acceptance. See the bilingual README for installation and first-launch steps.

VibeStick-Codex v0.3.0

VibeStick-Codex v0.3.0

本版本提供无需重新编译固件的永久 Wi-Fi 配网、安全 Bridge 配对、网页语音服务设置，以及可直接安装的 macOS 和 Windows Bridge。

主要更新

• 首次启动自动打开密码保护的 StickS3 配网热点，页面可选择附近 2.4GHz Wi-Fi。
• 正常 Codex 界面同时按住两键 3 秒即可重新配网；失败时恢复旧网络。
• 配网页面可填写电脑端本地生成的 Bridge Token，经过身份验证的局域网发现会自动跟随电脑 IP 变化。
• Bridge 内置仅限本机访问的语音服务设置页，已保存的 API Key 不会回显。
• Apple Silicon macOS DMG 包含自包含 Bridge、HUD、自启动配置和卸载工具，无需 Python 或命令行。
• Windows 预览版使用单个当前用户安装 EXE，包含 Bridge、HUD、自启动、Codex 控制和自动粘贴。

下载文件

• VibeStick-Codex-v0.3.0-app.bin
  • 已确认身份和布局的 Codex + Hourglass 双固件设备，只写入 0x320000。
  • 不改动 Hourglass 槽、分区表、OTA 元数据和 NVS。
• VibeStick-Codex-v0.3.0-full-install.bin
  • 从 0x0 写入的完整独立安装镜像。
  • 会替换 bootloader、分区表、OTA 元数据和 0x20000 应用。
• VibeStick-Bridge-macOS-Apple-Silicon-v0.3.0.dmg
  • Apple Silicon Mac 自包含安装包。
• VibeStick-Bridge-Windows-v0.3.0-Setup.exe
  • 64 位 Windows 当前用户安装包；目前仍为预览支持。
• SHA256SUMS
  • 上述四个主要文件的 SHA-256 校验值。

Warning

双固件设备更新 Codex 时只能把 application-only 镜像写入 0x320000。不要把完整安装镜像写入双固件设备，否则会替换 Hourglass 和现有多固件布局。

Warning

macOS 安装包为临时签名，未使用 Developer ID 签名或公证；Windows 安装包尚未代码签名。请只从本 Release 下载并校验 SHA-256。Windows 版本已通过 GitHub Windows CI 构建与测试，但尚未在实体 Windows 电脑和 StickS3 上完成验收。

隐私与验证

• 公开固件从隔离的 Git 跟踪内容构建，Wi-Fi、Bridge 地址和 Bridge Token 均为空。
• 安装包不包含预设 API Key 或固定配对 Token；首次运行在用户电脑本地生成私人配置。
• 91 项 Bridge 测试通过。
• ESP-IDF 5.5.3 固件构建通过，应用镜像校验与 SHA-256 校验通过。
• GitHub main 的 Bridge、macOS 和 Windows CI 全部通过。
• 发布前检查了当前提交、全部可达 Git 历史和发布文件；GitHub Secret Scanning 与 Push Protection 已启用。

---

VibeStick-Codex v0.3.0 adds permanent on-device Wi-Fi provisioning, authenticated Bridge pairing and discovery, loopback-only voice configuration, a self-contained Apple Silicon macOS DMG, and a single Windows preview Setup EXE. Public firmware and installers contain no user Wi-Fi password, API key, fixed pairing token, device identifier, or computer address.

VibeStick-Codex v0.2.0

VibeStick-Codex v0.2.0

本版本强化了 StickS3 横屏状态反馈，并统一了固件、Bridge、协议文档和发布说明的版本号。

状态与动画

• 横屏新增 RUNNING、WAITING、DONE 三种像素小人动画。
• 等待人工权限或批准时，WAITING 优先于普通近期活动，避免继续误显示为运行中。
• 调整时钟、电池、自然月 Token、任务计数和额度颗粒矩阵的尺寸与位置。
• 收录经过检查的动画源图、设备预览和固件 Sprite 素材。

Token 说明

• 横屏顶部 Token 是当前自然月累计的输入 Token 加输出 Token。
• 缓存上下文包含在输入 Token 中，因此总处理量可能远高于新输入文字或非缓存输入。
• 该数字不是 OpenAI 订阅额度或实际账单；旁边的美元数值仅为按模型价格估算的 API 等值费用。

文档与测试

• README 与中文 README 已补充状态动画、WAIT 优先级和 Token 统计口径。
• Bridge、固件、协议、硬件及问题模板版本统一为 0.2.0。
• 67 项 Bridge、协议和设备保护测试通过。
• ESP-IDF 5.5.3 纯净公开配置构建通过。
• GitHub Actions CI 通过。

隐私与安全

• 发布前已检查完整 Git 历史、工作区、未跟踪素材和图片内容。
• 历史中的私人提交邮箱已替换为 GitHub noreply，其他贡献者署名保持不变。
• 公开固件不包含 Wi-Fi、密码、Bridge 地址、Bridge Token、API Key、本机路径或设备标识。
• GitHub Secret Scanning 与 Push Protection 已启用，开放 Secret Scanning 告警为 0。

固件文件

• VibeStick-Codex-v0.2.0-app.bin
  • 双固件设备只写入 0x320000，更新 ota_1 中的 VibeStick-Codex。
  • 不要写入 0x20000；双固件布局中该位置属于 VibeStick Hourglass Liquid。
• VibeStick-Codex-v0.2.0-full-install.bin
  • 从 0x0 写入的完整独立安装镜像。
  • 会覆盖 bootloader、分区表、OTA 元数据和 0x20000 应用，不适合双固件设备的日常更新。
• VibeStick-Codex-v0.2.0.zip
  • 包含两个固件、SHA-256、安装说明、NOTICE 和第三方许可证。

公开固件不含私人网络配置，因此首次启动会显示离线。请按照 README 在被 Git 忽略的 vibe_stick_secrets.h 中填写配置并在本地重新构建。

---

VibeStick-Codex v0.2.0 adds animated landscape status characters, reliable human-approval detection, refined compact-screen layout, clearer monthly Token documentation, aligned package versions, and privacy-safe public firmware artifacts.

VibeStick-Codex v0.1.5

VibeStick-Codex v0.1.5

这是 VibeStick-Codex 的第一个 GitHub Release，面向 M5Stack StickS3。

横屏更新

• 顶部显示 StickS3 实际电量与百分比。
• 顶部中间显示当前自然月累计 Token。
• 显示按模型价格表换算的 API 等值美元估算；该数值不是 OpenAI 实际账单。
• 一周额度重置倒计时显示为“天＋小时”，5 小时额度倒计时显示为“小时＋分钟”。
• RUN、WAIT、FIN 分别显示运行中、等待操作和当前本地自然日内已完成的任务数。
• 5H 与 1W 颗粒矩阵分别显示 5 小时和一周额度剩余比例。
• 重新对齐电池、日期分隔点、蓝色分隔线和额度矩阵，清除了分隔线旁多余颗粒。

其他改进

• 新增基于硬件 MAC 的 StickS3 设备识别与烧录保护，避免把两台设备当成同一台。
• Bridge 新增当月 Token、API 等值美元和两个额度重置分钟数。
• 中英文 README 已完整说明横屏与竖屏各项数据。
• 公开构建不包含 Wi-Fi、密码、Bridge 地址、Bridge Token、API Key、本机路径或设备标识。

固件文件

• VibeStick-Codex-v0.1.5-app.bin
  • 双固件设备仅写入 0x320000，用于更新 ota_1 中的 VibeStick-Codex。
  • 不要写入 0x20000；双固件布局中该位置属于 VibeStick Hourglass Liquid。
• VibeStick-Codex-v0.1.5-full-install.bin
  • 从 0x0 写入的完整独立安装镜像。
  • 会重写 bootloader、分区表、OTA 元数据和 0x20000 应用，因而会覆盖现有双固件布局。
• VibeStick-Codex-v0.1.5.zip
  • 包含两个固件、SHA-256、安装说明、NOTICE 和第三方许可证。

公开固件没有私人网络配置，因此首次启动会显示离线。请按照 README 在被 Git 忽略的 vibe_stick_secrets.h 中填写自己的配置并在本地重新构建。

验证

• 66 项 Bridge/协议/设备保护测试通过。
• ESP-IDF 5.5.3 公开配置构建通过。
• GitHub Actions bridge-tests 通过。
• GitHub Secret Scanning 与 Push Protection 已启用，发布前告警为 0。

---

First GitHub release for M5Stack StickS3. It adds the redesigned landscape dashboard, real battery level, calendar-month token usage, API-equivalent USD estimates, quota reset countdowns, daily task counters, hardware-MAC flash protection, bilingual display documentation, and privacy-safe firmware artifacts.