Skip to content

Codex Micro Simulator v0.1.0 / Codex Micro 桌面模拟器

Pre-release
Pre-release

Choose a tag to compare

View all tags
@gantrol gantrol released this 18 Jul 15:47
codex-micro-v0.1.0
811398e

Codex Micro Simulator

Codex Micro Simulator v0.1.0

This prerelease introduces a second implementation route alongside Agent Controller: an independent desktop simulation of the Codex Micro keypad. The virtual keypad has now completed end-to-end bring-up against the Codex desktop app through a Microsoft VHF/UMDF2 virtual HID.

Highlights

  • Transparent, resizable WPF keypad that opens at 75% of its design size.
  • Always-on-top toggle, notification-area menu, hover help, and a custom app icon.
  • Codex Micro buttons, push-to-talk, draggable joystick, directional recesses, and encoder input.
  • White encoder wheel/drag navigation with click-to-open or click-to-confirm behavior.
  • Lower-left settings knob opens the Codex Micro settings page; right-click reconnects the HID.
  • Direct observation of Codex Micro mappings and six Agent lighting slots, independent of Agent Controller.
  • Single-instance protection prevents duplicated encoder steps and multiple processes from splitting Agent-light reports.
  • Separate restricted VHF keyboard child for the native Full access confirmation dialog; only Tab, Shift+Tab, and Enter are accepted.

Downloads

  • CodexMicroSimulator-v0.1.0-win-x64-portable.zip — self-contained Windows x64 desktop app; no separate .NET runtime is required.
  • CodexMicroSimulator-v0.1.0-win-x64-portable.zip.sha256 — SHA-256 checksum for the portable archive.
  • CodexMicroVhfUm-v0.1.0-win-x64-UNSIGNED-DEVELOPER.zip — prebuilt x64 UMDF2/VHF developer package for audit and local secondary signing; not installable as a production driver in its downloaded state.
  • CodexMicroVhfUm-v0.1.0-win-x64-UNSIGNED-DEVELOPER.zip.sha256 — SHA-256 checksum for the unsigned developer package.

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

Unsigned developer driver package

The developer archive contains the prebuilt UMDF2 DLL, unsigned catalog, INF, statically linked native PnP helper, relevant source, and the local signing/install script. It includes no certificate or private key. The DLL, catalog, and helper were checked as NotSigned after clean extraction.

For local development, install Visual Studio/Build Tools 2022 with Desktop development with C++, MSVC v143 x64/x86 tools, x64/x86 Spectre-mitigated libraries, Windows SDK 10.0.26100.0, and MSBuild. Restore pinned WDK NuGet package Microsoft.Windows.WDK.x64 10.0.26100.6584, then run Install-CodexMicroDriver.ps1 from an elevated PowerShell. The script creates a non-exportable certificate on that computer, signs the DLL, regenerates the catalog with the new DLL hash, signs the catalog, installs the device, and verifies it. No C/C++ compilation is needed when using the prebuilt developer archive.

Building from source uses the same driver toolchain. .NET SDK 9 is required only for the simulator app and tests, not for the UMDF2 driver itself.

Validation

  • Codex desktop 26.715.3651.0 compatibility probe passed.
  • Microsoft VHF device connected with both vendor HID and restricted keyboard children.
  • Protocol tests: 5 passed.
  • Desktop tests: 29 passed.
  • Clean desktop, UMDF2 driver, and native installer builds completed.
  • The driver DLL and native installer now statically link their C/C++ runtimes; clean dependency inspection shows no Visual C++ Redistributable dependency.
  • A locally signed installation of the packaged driver returned protocol magic VCM1, version 1, flags 0x3, and zero dropped output reports.
  • The unsigned archive was extracted and verified: 21 files, no certificate/private-key/debug artifacts, three executable artifacts all NotSigned, and all internal SHA-256 entries matched.
  • The portable archive was extracted into a clean directory and started successfully without a separately installed .NET runtime.
  • Repeated launch regression: the second process exits cleanly and exactly one simulator remains active.

Known issues

  • Agent lights can occasionally lag or miss one state update; a later full six-slot snapshot normally restores the display.
  • The driver build can emit NU1603 when NuGet resolves Windows SDK C++ package 10.0.26100.1 in place of 10.0.26100; the tested build still completes successfully.
  • Codex desktop updates can change its Micro protocol or mappings and may require a compatibility update.
  • Windows 10/11 x64 only.

中文说明

这是 Agent Controller 手柄路线之外的第二种实现：一套完全独立的 Codex Micro 桌面虚拟小键盘。目前虚拟键盘已经通过微软 VHF/UMDF2 虚拟 HID 与 Codex 桌面端完成实际联调，按键、旋钮、摇杆、Micro 设置路由和 Agent 状态报告均已走通。

Release 现已提供 self-contained Windows x64 便携应用，不需要另外安装 .NET Runtime；同时提供一个明确标为 UNSIGNED-DEVELOPER 的预编译驱动开发包。它省掉 C/C++ 编译步骤，适合审计和本机二次签名，但下载状态下不是可直接安装的正式驱动。

未签名开发包不包含证书或私钥。安装 Visual Studio/Build Tools 2022、C++ 桌面工作负载、v143 x64/x86 工具、Spectre 缓解库、Windows SDK 10.0.26100.0 和 MSBuild，并还原固定的 WDK NuGet 包 10.0.26100.6584 后，在管理员 PowerShell 运行 Install-CodexMicroDriver.ps1。脚本会在本机生成不可导出的测试证书，依次签 DLL、重新生成并签 catalog，然后安装和验证设备；使用预编译包时无需重新编译 C/C++。

公开生产分发仍需走适用的微软驱动签名流程；本机测试签名不能替代正式签名。

这是实验性预发布版本，与 OpenAI、Codex 或 Work Louder 没有隶属、授权或背书关系。

Assets 7
Loading