Repository navigation
Codex Maid Widget v0.3.12
Codex Maid Widget v0.3.12
First public release / 首次公开发布
Install / 安装
Installers include Electron, the widget, artwork and the optional Codex MCP connector. Node.js, npm and source files are not required. Install and sign in to Codex to use live quota.
两端版本统一为 0.3.12。安装包内置运行环境、挂件、角色和可选 Codex 本地工具连接器,无需 Node.js、npm 或源码。真实额度需要本机已安装并登录 Codex。
Highlights / 功能亮点
-
Live quota windows and reset countdowns; device-local daily, weekly and last-turn token usage.
-
A companion that bounces with a little “duang” after a newly observed completed turn, or when you interact with it.
-
Login helper and automatic follow of Codex desktop; configurable sound, artwork, phrases and desktop placement.
-
Two built-in characters, custom image library, character-aware themes, dragging, snapping, always-on-top and click-through.
-
Optional local MCP controls using the bundled runtime.
-
额度、重置倒计时,以及本机今日/本周/最近一轮 token。
-
新完成一轮或主动互动时“duang”一下,提醒自己放下手机、回到任务。
-
登录自启动助手,跟随 Codex 启停;音效、形象、台词和桌面位置可调整。
-
两个内置角色、本机形象库、自动配色、拖动吸附、置顶和鼠标穿透。
-
可选本地 MCP 聊天控制,不需要另装 Node.js。
Before installing / 安装前说明
Windows installer is unsigned. The Mac application is ad-hoc signed; the package is unsigned and not Apple-notarized. Your OS may ask you to confirm the download source. Verify the attached SHA256SUMS.
Windows 安装包未签名;Mac 应用采用 ad-hoc 签名,安装包未签名且未完成 Apple 公证。系统可能要求确认来源,请核对随附 SHA256SUMS。
Automated checks cover Windows installation, startup, controls, MCP, upgrade and uninstall, and the same Mac package on Apple Silicon and Intel including real launchd helper registration and removal. Broader real-account and manual Mac display/audio/login-session testing remains welcome.
已验证 Windows 安装、启动、控制、MCP、升级和卸载,以及同一 Mac 通用包在 Apple 芯片与 Intel 环境的安装、运行和真实后台助手清理。欢迎补充真实账号与 Mac 多屏、声音、重新登录等人工体验反馈。
License and credit / 许可与致谢
Code: MIT. Original character illustrations and application icon artwork: generated with GPTimage2.5, distributed under CC BY 4.0. Third-party marks retain their respective rights.
Inspired by MeteorNOX/DeepSeek-Balance-Whale-Widget; Yang-huai406/Codex-Whale-Public was studied as a desktop companion reference. See README, NOTICE and ARTWORK_LICENSE.md for full acknowledgements.
代码采用 MIT。原创角色和图标由 GPTimage2.5 生成,采用 CC BY 4.0;第三方标志归原权利人所有。感谢 DeepSeek/DSH 小鲸鱼原项目和 Codex 小鲸鱼参考方案,完整致谢见 README、NOTICE 与素材许可。