Codex Window Button

一个轻量的 Windows 桌面悬浮按钮，一键把 Codex 窗口恢复为居中的小窗口。

下载最新便携版 · 完整使用说明 · PolyForm Noncommercial 1.0.0

许可：禁止商业用途

自 v1.1.1 起，本项目按 PolyForm Noncommercial License 1.0.0 提供，属于源码可见的非商业许可项目。

个人学习、研究及其他许可允许的非商业用途可以使用；销售、商业捆绑、收费服务及营利企业内部业务使用不在本许可授权范围内，须取得另行书面授权。再分发时必须附上许可证及 NOTICE.txt 中的 Required Notice。具体权利和例外以许可证原文为准。

v1.1.0 曾按 MIT 发布；本次变更不声称撤销旧版本已经授予的权利，旧标签和发行说明保留历史许可信息。

快速使用

1. 从 Releases 下载 CodexWindowButton-Portable-1.1.1-win-x64.zip。
2. 完整解压到可写文件夹。
3. 打开 Codex 桌面客户端，再双击 CodexWindowButton.exe。
4. 点击“恢复小窗口”。按住左侧图标可以拖动；三点菜单或右键可以退出。

特点

• 一键恢复：解除最大化，将客户端客户区恢复为居中的 1440 × 810；小屏幕按比例缩小。
• 悬浮胶囊：紫青渐变边框、悬停动效和成功反馈。
• 随身携带：恢复逻辑内置 EXE，设置保存在同目录 data/，复制整个文件夹即可迁移。
• 原生运行：无需安装动画插件、Python、Node 或恢复脚本；按钮操作不会弹出命令行。

支持范围

Windows 10 / 11 x64，需系统已有 .NET Framework 4.8 或更新兼容版本；微软版本说明。

当前按 OpenAI.Codex_* 应用包身份识别其中的 ChatGPT.exe / Codex.exe，可适应客户端版本升级；不处理浏览器网页版、CLI 或其他安装渠道的同名程序。

• 真正进入 F11 全屏时，请先在客户端按 F11，再点击按钮。
• 同一会话只运行一个按钮；打开便携版前请先退出已运行的旧版按钮。
• 检测到多个符合条件的客户端窗口时，会提示保留一个窗口后重试。
• 使用 DragonCodexBoot 时，请等待动画结束后再恢复。

这是独立的社区工具，与 OpenAI 无隶属关系。

从源码构建

使用 Windows 自带的 .NET Framework x64 C# 编译器和 WPF 程序集：

powershell.exe -NoProfile -File .\src\build.ps1

输出在 dist/CodexWindowButton-Portable-1.1.1-win-x64/。运行以下命令制作含源码、说明、预览和校验值的便携包：

powershell.exe -NoProfile -File .\package.ps1

发布文件写入 release/。脚本不会覆盖已存在的同版本发布包。

验证

# 不修改桌面窗口：检查几何定位、边框补偿、客户端身份过滤。
.\dist\CodexWindowButton-Portable-1.1.1-win-x64\CodexWindowButton.exe --self-check .\self-check.json

# 会实际恢复已运行的客户端窗口，并生成按钮各状态的预览与结果。
.\dist\CodexWindowButton-Portable-1.1.1-win-x64\CodexWindowButton.exe --ui-check .\ui-check

v1.1.1 已在 Windows x64 实机验证：压缩包逐文件校验、包含中文与空格的解压路径、不同工作目录启动、实际按钮点击，以及最大化窗口恢复。几何检查覆盖小屏幕、竖屏、负坐标副屏和客户区边框补偿。其他电脑、客户端渠道和混合 DPI 多屏仍需目标环境确认。

目录

src/              界面、内置恢复逻辑、图标、DPI 清单和构建脚本
assets/           界面预览
package.ps1       便携包与 SHA-256 清单生成脚本
使用说明.md       完整说明
LICENSE.txt       非商业许可证

data/、本机日志、测试输出和生成的发布文件均不提交到源码仓库。便携版运行时会在自身目录保存按钮位置和最近一次窗口边界记录。