Repository navigation
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:
- Fix the widget growing unexpectedly while dragging, including repeated movement at fractional Windows display scaling.
- 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.
- 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.
- 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 / 安装包
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.