AI 有了实体
CodexStick 是一件可以放在桌面、拿在手里、随时按下去的 赛博文玩。
它会告诉你 Codex 还剩多少额度、当前任务进行到哪里，以及最近 24 小时消耗了多少 Token、花了多少钱。
更重要的是——按住蓝键，直接说。
不用切窗口，不用找输入框。StickS3 自带麦克风会成为 Windows 的标准 USB 麦克风，把你的声音直接交给 Codex 原生听写。
按住它，把灵感说出来
蓝键按下，开始听写。蓝键松开，完成输入。
声音通过 USB Audio 直接进入 Windows，不经过 Wi-Fi，也不经过 CodexStick 自建的转写服务。
- 使用 StickS3 自带麦克风
- 对接 Codex 原生听写
- 无需第三方音频驱动
- 不保存录音
- 不把转写内容传回设备
灵感出现的时候，不该先去找键盘。
额度，不用再点开看
CodexStick 把 Codex 额度常驻在桌面边上：
- 5 小时与 7 天剩余额度
- 重置时间与可用重置次数
- 只有 7D 数据时自动调整布局，不拿不存在的数据填满屏幕
每一次 Vibe，都有数
CodexStick 集成了 Vibe Usage，把 AI 编程消耗从 Dashboard 搬到了实体设备上。
VibeCafé 页面展示最近 24 小时的：
- Token 消耗
- 预估费用
- 活跃使用时长
- 本地设置的名称与头像
CodexStick 只读复用 Vibe Usage 已有的配置与统计结果。日志解析、同步和上传仍由 Vibe Usage 官方工具负责。
同一份统计，不多一份密钥。 API Key 留在 Windows，不会下发到 StickS3；实际 Session 内容、提示词和回答也不会出现在设备上。
也可以查看 Vibe Usage for Windows。
一块屏，三种状态
侧键短按，在三个常驻页面之间切换：
- Codex 额度 — 还剩多少，一眼就知道。
- Codex 任务 — 查看当前项目、任务状态和分支；多个活动任务可以轮播。
- VibeCafé — 查看最近 24H 的 Token、预估费用与活跃时长。
任务更新、额度刷新和 Usage 刷新都不会突然抢走当前页面。听写结束后，屏幕会回到按下蓝键前的页面。
为什么叫「赛博文玩」
它不是一块被动显示数字的小屏，也不只是一个外接麦克风。
它有自己的屏幕、按键、状态、头像和使用痕迹；你可以查看它、切换它、按住它，也可以继续修改固件，让它长出新的页面和能力。
它把抽象的 AI 使用，变成了一件有手感的东西。
它是怎么工作的
flowchart LR
Stick["CodexStick<br/>屏幕 · 按键 · 麦克风"]
Bridge["Windows Bridge<br/>状态聚合 · PTT 控制"]
Codex["Codex Desktop<br/>额度 · 任务 · 原生听写"]
Vibe["Vibe Usage<br/>Token · 费用 · 活跃时长"]
Codex --> Bridge
Vibe -->|"只读"| Bridge
Bridge -->|"Wi-Fi · 状态与控制"| Stick
Stick -->|"USB Audio · 声音"| Codex
Wi-Fi 只负责页面状态和按键控制。真正的语音音频始终通过 USB Audio 进入 Windows。
开始把玩
你需要 M5Stack StickS3、Windows 11 x64、一根支持数据传输的 USB 线、2.4 GHz Wi-Fi，以及已安装并登录的 Codex Desktop。
然后完成三件事：
- 安装 Windows Bridge
- 烧录并配置 StickS3
- 在 Codex 中选择 StickS3 麦克风
当前版本
CodexStick v1.0.0 已打通设备显示、Codex 额度、实时任务、Vibe Usage 与实体按键听写的主链路。
这是面向开发者和硬件玩家的早期版本。目前支持 Windows 11 x64、单台 M5Stack StickS3、单个 Windows 交互用户和可信局域网环境；它还不是经过长期压力测试、安全审计或量产认证的消费级硬件。
文档
声明
本仓库目前没有项目级开源许可证。代码公开可见不等于获得复制、修改、分发或商业使用授权；第三方组件和字体继续受各自许可证约束，详见 THIRD_PARTY_NOTICES.md。
CodexStick 是独立社区项目，不是 OpenAI、M5Stack、VibeCafé 或 Vibe Usage 的官方产品，也未获得其背书。相关名称与标识归各自权利人所有。