Codex Maid Widget v0.3.21

Codex Maid Widget v0.3.21

中文

1018更新：

1.解决了拖动异常变大的问题；

2.加入“固定在 Codex 窗口内”可选项，可将小龙娘固定在codex窗口，不在其他应用或桌面显示，并优化随窗口收起与展开的动画流畅性；

3.加入“底角吸附时只露头部”模式，拽出时显示全身，并优化了拽出与吸附动画；

4.为“气泡收起时长”增加3秒与5秒可选项，并默认设置为5秒。

补充说明：

• Windows 的窗口内模式使用原生子窗口，人物随 Codex 主窗口移动，并参与系统收起与展开动画。其他应用和弹窗按正常窗口层级遮挡人物，不会将人物提升到它们上方。macOS 使用独立窗口跟随 Codex 的范围和显隐，在切换到其他应用或 Codex 最小化时隐藏，没有采用 Windows 的原生子窗口嵌入。
• 窗口内显示、底角探头均默认关闭，与“跟随 Codex 桌面端”启动设置分别保存。关闭窗口内显示后恢复桌面位置与置顶偏好。
• 只在左下与右下底角吸附；拖过屏幕或 Codex 窗口的中线时，人物会即时转向。底角探头支持连续拖动，向内拽出时逐渐露出全身，回位动画可被新的拖动接续。
• 升级保留已保存的气泡收起时长、用户设置、导入形象与原图；5 秒为未保存该偏好时的默认值。

验证范围与限制：

• 本次 Windows 与 Mac 源码测试共 514 项通过；本机 Windows 主程序、后台助手及 MCP 均为 0.3.21，已核对非演示状态、实时额度、本地控制及 MCP 通信。
• 本次 Windows 安装包的 12 项隔离安装、运行、MCP、升级、卸载和数据保留验证已通过。Mac 通用包已通过原生 CI 构建，并在 Apple 芯片与 Intel runner 上安装同一安装包，完成启动、内置 MCP、跟随及 launchd 助手验证。
• CI 与人工实机体验分别记录；Mac 真实登录账号、多屏、Spaces、全屏、Retina、音频与重新登录系统的人工体验尚未验收。
• Windows 安装包没有开发者分发证书。Mac 应用使用 ad-hoc 签名，安装包未签名且未经过 Apple 公证。

English

October 18 update:

1. Fix the widget growing unexpectedly while dragging, including repeated movement at fractional Windows display scaling.
2. Add an optional mode to keep the character inside the Codex window, with smoother minimization and restoration. Windows uses native child-window attachment; macOS follows with a separate widget window and hides it when another app is active or Codex is minimized.
3. Add optional head peeking at the two bottom corners. Drag inward to reveal the full character, with continuous pointer tracking and smoother settling when it snaps back.
4. Add 3-second and 5-second bubble auto-collapse options, with 5 seconds as the default.

Both optional display modes start disabled. Other windows and dialogs cover the Windows character according to normal window ordering. Turning window display off restores the saved desktop position and always-on-top preference. The character mirrors as it crosses the midpoint of its screen or Codex window. Upgrades retain saved bubble timeouts, settings, imported characters and original images.

Validation and limitations:

• All 514 Windows and Mac source tests passed. The running Windows app, background helper and MCP report 0.3.21; non-demo live quota, local controls and MCP communication have been checked on this machine.
• The Windows installer passed 12 isolated installation, runtime, MCP, upgrade, uninstall and data-preservation checks. The same universal Mac package passed native build, installation, startup, bundled MCP, follow and launchd-helper checks on Apple Silicon and Intel runners.
• Automated runner checks are separate from hands-on acceptance. Mac signed-in accounts, multiple displays, Spaces, full screen, Retina scaling, audio and logout/login sessions have not received manual acceptance.
• The Windows installer has no developer distribution certificate. The Mac app is ad-hoc signed; the installer is unsigned and not Apple-notarized.

Installers / 安装包

• Windows x64 installer · SHA-256
• macOS 13+ universal installer (Apple Silicon and Intel) · SHA-256

Installers include the runtime and optional local Codex-plugin connector. The official Codex desktop app must be installed and signed in for real quota. See the English README or 简体中文 README for installation, data handling, acknowledgements and licenses.

Codex Maid Widget v0.3.13

Codex Maid Widget v0.3.13

Install / 安装

• Windows x64 installer
• macOS universal installer — Apple Silicon and Intel, macOS 13+

Both installers include the runtime and optional local Codex MCP connector. Windows and macOS share version 0.3.13.

两端版本统一为 0.3.13，安装包已包含运行环境和可选的本地 Codex MCP 连接器。

Changes / 修改

• Imported filenames and edited character labels still appear normally in the local widget. MCP tool results now use fixed built-in labels or a generic custom-character label, so personal labels do not enter tool results.

• Added an explicit way to disconnect the widget's local Codex plugin. Use Disconnect Codex plugin in the Windows Start menu or Codex-Maid-Widget-断开 Codex.command in Mac Applications before removing the widget. Only this widget's plugin is removed; other plugins, images and settings remain.

• The Windows interactive uninstaller offers to disconnect first and stops if that step fails. Silent uninstallation keeps Codex configuration unchanged; disconnect beforehand when needed.

• The Windows app-server handshake now reads its version from the application manifest, matching macOS.

• 图片文件名和自己修改的形象名称照常保留在本地界面。MCP 工具只返回固定的内置名称或“自定义形象”，不带出这些私人标签。

• 两端新增明确的本地插件断开入口。卸载前可运行 Windows 开始菜单中的 Disconnect Codex plugin，或 Mac“应用程序”中的 Codex-Maid-Widget-断开 Codex.command。只移除挂件自己的插件，其他插件、图片和设置均保留。

• Windows 交互卸载会询问是否先断开；断开失败时保留挂件。静默卸载不修改 Codex 配置，请提前按需断开。

• Windows 内部 app-server 握手版本改为读取应用清单，与 Mac 一致。

Ordinary image filenames are not treated as a severe vulnerability. The local naming behavior is preserved; this change limits unnecessary information in MCP results. This release does not publish a GPT or marketplace plugin.

普通图片名本身不属于严重漏洞。这次保留原来的命名习惯，只收紧 MCP 的输出范围。本次没有发布 GPT 插件或上架插件市场。

Installation notes / 安装说明

Restart Codex after connecting or disconnecting the local plugin. Live quota still requires an installed, signed-in Codex app. Verify the attached SHA256SUMS before installing.

连接或断开本地插件后，请重启 Codex。真实额度仍需要本机已安装并登录 Codex。安装前可核对随附的 SHA256SUMS。

Windows installer is unsigned. The Mac app is ad-hoc signed; the installer is unsigned and has not been notarized by Apple. Automated runner checks do not replace manual Mac testing with real accounts, multiple displays, Spaces, audio and login sessions.

Windows 安装包未签名；Mac 应用采用 ad-hoc 签名，安装包未签名且未经过 Apple 公证。自动化 runner 验证不能替代真实账号以及 Mac 多屏、Spaces、声音和重新登录等人工体验验收。

Code: MIT. Project artwork generated with GPTimage2.5: CC BY 4.0. Full credits remain in the bilingual README and NOTICE.

代码采用 MIT；GPTimage2.5 生成的项目原创图片采用 CC BY 4.0。完整致谢见中英文 README 和 NOTICE。

Codex Maid Widget v0.3.12

Codex Maid Widget v0.3.12

First public release / 首次公开发布

Install / 安装

• Windows x64 installer
• macOS Universal installer — Apple Silicon and Intel, macOS 13+

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 与素材许可。