OHM Pet v0.1.0 — First Stable Release / 首个稳定版本

OHM Pet v0.1.0 — First Stable Release / 首个稳定版本

OHM Pet is a lightweight native desktop pet for macOS and Windows, written in Rust without Electron, Tauri, WebView, a browser engine, or a game engine.

OHM Pet 是一个使用 Rust 编写的轻量级原生桌面宠物，支持 macOS 和 Windows，不依赖 Electron、Tauri、WebView、浏览器引擎或游戏引擎。

Highlights / 主要功能

• Native transparent, borderless desktop-pet windows on macOS and Windows
• Event-driven rendering designed for continuous low-resource background operation
• Dragging with immediate lifted/jump feedback
• Mouse gaze, autonomous actions, and persisted window position
• Optional always-on-top behavior
• Occasional walking along the top edge of foreground non-maximized windows
• Pet switching, directory refresh, animation controls, and costume controls
• The pet right-click menu and system-tray menu expose the same commands
• Windows GUI subsystem build with no console window
• Windows pet window excluded from the taskbar and normal Alt-Tab list
• Tray refreshes update the existing icon in place, including after Agent integration changes

Coding Agent Integrations / 编程 Agent 集成

OHM Pet can react to local lifecycle events from:

• Claude Code
• Codex
• Pi Agent

Integrations are installed from the pet or tray menu and preserve unrelated user configuration. Communication uses local hooks/extensions and localhost IPC rather than terminal scraping.

Codex currently exposes only its supported notify event surface, so its lifecycle coverage is more limited than Claude Code and Pi Agent.

Pet Package Support / 宠物包支持

OHM Pet directly loads visual assets from:

• Codex v2 (pet.json + spritesheet.webp)
• Shimeji-ee
• wl_shimeji (.wlshm)
• Ukagaka / 伪春菜 Shells
• UkagakaW-style loose bitmap resources
• MaidChan/DesktopPet-style visual shells

Ukagaka bind-overlay costumes are supported through both the tray menu and pet right-click menu. Costume selections are persisted per pet.

External packages are treated as visual data only. OHM Pet never executes third-party EXE, DLL, JAR, SAORI, SHIORI, Java behavior code, ghost code, package scripts, or plugins.

Downloads / 下载

macOS Lite

OHM-Pet-macos-lite.zip

Contains only the bundled OHM-1「欧姆鸦」pet. Extract the ZIP and open OHM Pet.app.

只包含内置的 OHM-1「欧姆鸦」。解压后打开 OHM Pet.app。

If macOS blocks the first launch, use System Settings → Privacy & Security → Open Anyway.

Windows x64 Lite

OHM-Pet-windows-x64-lite.zip

Contains only OHM-1「欧姆鸦」. Extract the complete archive and run OHM Pet.exe; keep the adjacent pets/ directory beside the executable.

只包含 OHM-1「欧姆鸦」。请完整解压后运行 OHM Pet.exe，不要把 EXE 单独移出，旁边的 pets/ 目录需要保留。

Lite and Collection Editions / 精简版与合集版

The public GitHub Release contains license-safe Lite packages with only OHM Raven.

公开 GitHub Release 只发布许可证安全的 Lite 包，仅内置欧姆鸦。

Local Collection builds can additionally include tested visual assets for:

• 茶兔 / 果殼, including three available hat costumes
• 女仆酱 / MaidChan
• KuroShimeji
• UkagakaW Visual Pet

These third-party artworks are not uploaded to the public release until their redistribution rights are separately confirmed.

Verification / 验证

This release passed:

• cargo fmt --all --check
• cargo test --workspace — 21 tests
• cargo clippy --workspace --all-targets -- -D warnings
• macOS release build and packaging
• Windows x64 release build and packaging
• Windows GUI-subsystem and embedded-icon checks
• Synthetic external-format and costume tests

Known Limitations / 已知限制

• Real-device interaction testing is still recommended for Windows taskbar/Alt-Tab behavior, tray behavior, layered transparency, roaming, and multi-monitor coordinates.
• macOS foreground-window selection and multi-monitor coordinate behavior may vary with desktop layout and permissions.
• External action mapping is heuristic when a package does not provide semantic action names.
• The macOS app is ad-hoc signed rather than notarized.

Full Changelog: https://github.com/DrayChou/ohm-pet/commits/v0.1.0