Skip to content

Codex Micro Simulator v1.0.0 / Codex Micro 桌面模拟器

Choose a tag to compare

View all tags
@gantrol gantrol released this 19 Jul 02:27
codex-micro-v1.0.0
b2866e0

Codex Micro Simulator

Codex Micro Simulator v1.0.0

Codex Micro Simulator is an independent Windows desktop implementation of the Codex Micro keypad. This release is only for the simulator and its companion virtual HID driver; it does not contain an Agent Controller release.

Highlights

  • Transparent, resizable keypad window that opens at 75% scale, with Always on Top, notification-area controls, hover help, and an original simulator icon.
  • Direct Codex Micro communication through a Microsoft VHF/UMDF2 virtual HID, including a restricted VHF keyboard child for native confirmation dialogs.
  • Responsive white encoder navigation by wheel or vertical drag, click-to-open/confirm behavior, live menu-position feedback, bounded input coalescing, and stale-input rejection.
  • Six Agent slots driven by Codex lighting reports; hover text shows project › task title when the official recent-task roster can be proven from local Codex state.
  • Codex action keys, push-to-talk, draggable joystick with directional recesses, Micro settings routing, and HID reconnect controls.
  • Single-instance protection prevents duplicate pointer hooks, repeated encoder input, and split Agent-light snapshots.

Downloads

  • Codex Micro Simulator — CodexMicroSimulator-v1.0.0-win-x64-portable.zip: self-contained Windows x64 application; no separate .NET runtime is required.
  • CodexMicroSimulator-v1.0.0-win-x64-portable.zip.sha256: SHA-256 checksum for the portable archive.
  • Companion unsigned developer driver — CodexMicroVhfUm-v1.0.0-win-x64-UNSIGNED-DEVELOPER.zip: prebuilt x64 UMDF2/VHF package for audit and local secondary signing.
  • CodexMicroVhfUm-v1.0.0-win-x64-UNSIGNED-DEVELOPER.zip.sha256: SHA-256 checksum for the driver archive.

The portable archive contains the application only. Install the VHF driver first, extract the complete app archive, and run CodexMicroSimulator.exe as a normal user.

The driver archive is intentionally unsigned and contains no certificate or private key. It is not directly installable as a production driver. Follow the English signing and installation guide or the 中文说明.

Validation

  • Desktop tests: 45 passed.
  • Protocol tests: 5 passed.
  • App, UMDF2 driver, and native installer rebuilt from the final release branch.
  • Portable app verified as version 1.0.0.0: 473 files, no PDB files.
  • Driver archive verified: 21 files, all 20 internal SHA-256 entries matched, no certificate/private-key/debug artifacts.
  • Driver DLL, catalog, and native installer verified as NotSigned; no dynamic Visual C++ runtime dependency was found.
  • Both external archive checksums matched after clean extraction.
  • Single-instance launch regression passed: the second process exited cleanly while exactly one responsive simulator remained.

Windows 10/11 x64 only. Codex desktop updates can change its Micro protocol or mappings and may require a compatibility update.

This independent project is not affiliated with, authorized by, or endorsed by OpenAI, Codex, or Work Louder.

中文说明

Codex Micro Simulator 是一套独立的 Windows 桌面 Codex Micro 虚拟小键盘。本次正式版 Release 仅发布模拟器及其配套虚拟 HID 驱动，不包含 Agent Controller 的版本发布。

主要改进

  • 透明、可缩放的小键盘窗口，默认以 75% 比例打开；支持置顶、系统托盘、悬停说明和自制模拟器图标。
  • 通过微软 VHF/UMDF2 虚拟 HID 直接连接 Codex Micro；原生确认对话框使用受限的 VHF 键盘子设备。
  • 白色旋钮支持滚轮和上下拖动，单击打开或确认；可实时显示菜单位置，并会合并输入、丢弃过期刻度，避免卡顿后补发跳动。
  • 六个 Agent 槽位由 Codex 灯光报告驱动；能从 Codex 本地官方最近任务状态可靠匹配时，悬停显示“所属项目 › 会话标题”。
  • 已包含 Codex 动作键、按住说话、可拖动摇杆及阴刻方向、Micro 设置入口和 HID 重连控制。
  • 单实例保护避免重复鼠标钩子、重复旋钮输入和 Agent 灯光快照被多个进程拆分。

下载

  • Codex Micro Simulator — CodexMicroSimulator-v1.0.0-win-x64-portable.zip：Windows x64 self-contained 便携应用，无需另装 .NET Runtime。
  • CodexMicroSimulator-v1.0.0-win-x64-portable.zip.sha256：便携应用压缩包的 SHA-256。
  • 配套未签名开发者驱动 — CodexMicroVhfUm-v1.0.0-win-x64-UNSIGNED-DEVELOPER.zip：用于审计和本机二次签名的预编译 x64 UMDF2/VHF 包。
  • CodexMicroVhfUm-v1.0.0-win-x64-UNSIGNED-DEVELOPER.zip.sha256：驱动压缩包的 SHA-256。

便携压缩包只包含应用。请先安装 VHF 驱动，再完整解压应用包，并以普通用户运行 CodexMicroSimulator.exe。

驱动包有意保持未签名，且不包含证书或私钥；它不是可直接用于生产环境的驱动安装包。请按照中文二次签名与安装说明操作，也可参阅英文说明。

验收结果

  • 桌面端测试 45 项通过，协议测试 5 项通过。
  • 应用、UMDF2 驱动和原生安装辅助程序均从最终发布分支重新构建。
  • 便携应用版本为 1.0.0.0：共 473 个文件，不含 PDB。
  • 驱动包共 21 个文件，20 条内部 SHA-256 全部匹配，不含证书、私钥和调试产物。
  • 驱动 DLL、catalog 和原生安装辅助程序均验证为 NotSigned，且没有动态 Visual C++ Runtime 依赖。
  • 两个压缩包解压后外部 SHA-256 均匹配。
  • 单实例启动回归通过：第二个进程正常退出，只保留一个可响应的模拟器实例。

仅支持 Windows 10/11 x64。Codex 桌面端更新可能改变 Micro 协议或映射，届时可能需要兼容更新。

本独立项目与 OpenAI、Codex 或 Work Louder 没有隶属、授权或背书关系。

Assets 7
Loading