1. Codex desktop app 放大后 minimise button 失效到底怎么回事
Codex desktop app 在系统缩放调到 125%、150% 或 175% 之后，标题栏右上角的 minimise button 会出现点击无响应的情况：鼠标点上去既不最小化窗口，也不触发任何日志，但把缩放调回 100% 后同一个按钮立刻恢复正常。更让人摸不着头脑的是，有时候把鼠标往按钮右下方偏移十几个像素反而能点中，就像按钮的热区整体平移了一样。这个 Bug 在 Codex desktop app 里并不是按钮事件没绑定，而是鼠标点击的物理像素坐标和控件布局使用的逻辑坐标落在了两个不同的坐标系里，命中测试算错了位置。
我试过在 4K 外接显示器上把缩放拉到 150% 复现，Codex desktop app 的标题栏按钮热区确实会整体偏移，偏移量大致等于 scale 倍率带来的差值。理解这个问题的关键在于两个概念：逻辑像素和物理像素。应用内部布局用的是逻辑像素，最终画到屏幕、鼠标事件回报的是物理像素，两者关系是物理像素 = 逻辑像素 × scale。当进程声明为 DPI Unaware，但 GUI 框架又按真实 DPI 去摆放控件时，系统回报的鼠标坐标没被框架除以 scale，框架拿物理坐标去比对逻辑矩形，热区自然错位。
Codex desktop app 这类基于 Electron 或类似跨平台框架的桌面端，config.toml 里的窗口与缩放相关配置会直接影响 DPI 感知行为。下面给出可复制的 config.toml 修复骨架，配合 TaoToken 统一 Key/API 通道接入示例，并附逐步验证动作确认 minimise button 恢复正常。如果你还没配置好 API 通道，可以先到 TaoToken 官网 了解一下统一 Key 的接入方式，再回来处理这个缩放 Bug。
2. TaoToken 前置：统一 Key 与 API 通道准备
在动手改 config.toml 之前，先把 Codex desktop app 的模型调用通道理顺。Codex 桌面端在启动时会读取配置里的 API 端点和 Key，如果这部分没配好，应用可能以异常状态启动，窗口初始化流程被打断，DPI 感知声明也可能没来得及执行。所以先把通道准备好，再处理缩放问题，顺序上更稳妥。
TaoToken 提供统一的 Key 和 API 通道，Codex desktop app 只需要在 config.toml 里填一个 base_url 和一个 api_key，就能走通模型对话和编码请求。你可以在 TaoToken API Keys 页面 生成一个 Key，然后到 接入文档 确认 Codex 桌面端支持的配置字段格式。API 基础地址用 https://taotoken.net/api 即可，不需要额外参数。
这里要提醒一点：Codex desktop app 的 config.toml 里，模型通道配置和窗口缩放配置是分开的段落，不要混在一起写。通道配置放在[model]或[api]段，窗口与 DPI 相关配置放在[window]或[display]段。下面第三节会给出完整的骨架，你直接对照替换 Key 就行。
如果你后续要做长期编码或 Agent 任务，可以了解 Coding Plan，它针对高频编码场景做了通道优化。但本篇的重点还是先把 Codex desktop app 的缩放 Bug 修掉，通道配置只是前置条件。
3. 可复制 config.toml 修复骨架
Codex desktop app 的 config.toml 通常位于用户配置目录下，Windows 在%APPDATA%\Codex\config.toml，macOS 在~/Library/Application Support/Codex/config.toml，Linux 在~/.config/Codex/config.toml。打开后按下面的骨架补齐或修改对应字段。核心修复思路是显式声明 DPI 感知，并让窗口布局使用逻辑坐标，避免固定像素定位。
# Codex desktop app config.toml 修复骨架 # 模型通道配置（TaoToken 统一 Key） [api] base_url = "https://taotoken.net/api" api_key = "sk-你的TaoTokenKey" model = "claude-sonnet-4-20250514" timeout_seconds = 120 # 窗口与显示配置：修复 Zoom In 后 minimise button 失效 [window] width = 1280 height = 800 min_width = 960 min_height = 600 # 关键：声明 DPI 感知，让系统不再对窗口做位图拉伸 dpi_awareness = "per_monitor_v2" # 关键：布局使用逻辑坐标，命中测试前统一换算 use_logical_coordinates = true # 关键：标题栏按钮使用锚定布局，不用固定像素 titlebar_layout = "anchored" # 避免 CSS zoom 制造第二套坐标变换 disable_css_zoom = true [display] # 跟随系统缩放，不强制覆盖 scale_mode = "system" # 多显示器不同缩放时重排布局 reflow_on_dpi_change = true # 窗口跨屏后强制重算热区 recompute_hitbox_on_move = true [titlebar] # 最小化按钮锚定右上角，偏移量用逻辑像素 minimise_anchor = "top-right" minimise_offset_x = 8 minimise_offset_y = 8 # 按钮热区随布局自适应 adaptive_hitbox = true配置里几个字段值得展开说。dpi_awareness = "per_monitor_v2"对应 Windows 的 Per-Monitor DPI Aware v2，进程声明后系统不会再偷偷拉伸窗口，鼠标坐标和控件坐标统一到逻辑空间。use_logical_coordinates = true要求 Codex desktop app 在命中测试前先把物理坐标除以 scale 换算回逻辑坐标，再比对控件矩形。titlebar_layout = "anchored"让 minimise button 永远贴着右上角，而不是写死place(x=300, y=10)这种绝对像素。disable_css_zoom = true是为了避免 Electron 里 CSS zoom 叠加系统缩放，制造第二套坐标变换。
改完 config.toml 后保存，完全退出 Codex desktop app 再重新启动。注意是彻底退出，不是关窗口，托盘图标也要右键退出，否则旧配置还在内存里。重启后先别急着点按钮，按第四节做验证。
4. 验证请求与成功结果确认
配置改完后，需要分两步验证：先确认模型通道通了，再确认 minimise button 在缩放后能正常响应。第一步验证 API 通道，在 Codex desktop app 里发起一次模型对话，或者直接用 curl 测端点。
curl -X POST https://taotoken.net/api/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: sk-你的TaoTokenKey" \ -d '{ "model": "claude-sonnet-4-20250514", "max_tokens": 64, "messages": [ {"role": "user", "content": "回复 OK 两个字母即可"} ] }'如果返回里能看到正常的 content 字段和OK字样，说明 TaoToken 通道没问题。如果返回 401，检查 Key 是否复制完整；返回 404，检查 base_url 是否写成了https://taotoken.net/api而不是带多余路径。通道通了之后，再验证缩放场景。
把系统缩放依次调到 125%、150%、175%，每次调整后重启 Codex desktop app，然后做三个动作：第一，把鼠标移到 minimise button 正中心点击，观察窗口是否最小化；第二，把鼠标往按钮右下方偏移 10 到 15 像素再点，如果之前偏移能点中、现在正中心也能点中，说明热区已经对齐；第三，把窗口从高缩放显示器拖到 100% 缩放的显示器，再拖回来，确认按钮依然可点。三个动作都通过，说明 config.toml 修复生效。
你还可以在 Codex desktop app 的开发者控制台里打印鼠标事件坐标和按钮矩形，确认两者量级一致。如果事件坐标是 600 而按钮矩形是 390 到 420，说明坐标没换算，use_logical_coordinates没生效；如果事件坐标是 400 而按钮矩形是 390 到 420，说明换算正确，命中测试能对上。这一步能把「点不中」和「点中但不执行」区分开，前者是坐标问题，后者是业务逻辑问题。
5. 本篇常见错排查
5.1 改了 config.toml 但 minimise button 还是点不动
最常见的原因是 Codex desktop app 没有彻底重启。托盘进程还在跑，旧配置没被重新加载。解决方法是任务管理器里结束所有 Codex 相关进程，再启动。另一个原因是 config.toml 里dpi_awareness字段拼写错误或值不被当前版本识别，可以对照 接入文档 确认字段名。还有可能是系统缩放调整后没有触发重排，把reflow_on_dpi_change设为 true 再试。
5.2 模型通道报 401 或 403
先确认 api_key 是否以sk-开头且没有多余空格。TaoToken 的 Key 在 API Keys 页面 生成后只显示一次，如果没保存需要重新生成。403 通常是 Key 权限范围不对，检查是否给这个 Key 开了对应模型的调用权限。base_url 必须是https://taotoken.net/api，不要加/v1之外的路径，Codex desktop app 会自己拼接。
5.3 多显示器不同缩放时按钮又失效
这是recompute_hitbox_on_move没生效的典型表现。窗口从 150% 缩放的显示器拖到 100% 缩放的显示器时，系统会发 DPI 变化事件，Codex desktop app 需要监听这个事件并重算布局和热区。确认 config.toml 里reflow_on_dpi_change和recompute_hitbox_on_move都是 true。如果还是不行，可能是当前版本对多显示器 DPI 变化的处理有已知问题，可以到 模型对话 里描述你的显示器组合和缩放比例，看看有没有对应的版本更新说明。
5.4 按钮能点中但窗口不最小化
这就不是坐标问题了，而是最小化逻辑被短路。检查 config.toml 里[titlebar]段有没有误配minimise_action之类的字段，或者 Codex desktop app 的插件/扩展拦截了窗口事件。排除方法是把按钮的 command 换成打印日志，确认点击事件有没有触发。如果日志打了但窗口没动，说明是窗口管理层面的问题，跟 DPI 无关。
5.5 缩放调回 100% 后按钮正常，但一放大又坏
说明dpi_awareness声明没生效。Windows 上可以用调试器看进程的 PROCESS_DPI_AWARENESS 值，如果是 0（Unaware）或 1（System Aware），说明 config.toml 的声明没被读取。检查 Codex desktop app 版本是否支持per_monitor_v2，旧版本可能只认system。另外确认 config.toml 没有被其他配置文件覆盖，有些安装方式会在多个位置放配置，优先级不同。
6. 长期编码场景的通道与配置建议
Codex desktop app 的缩放 Bug 修完之后，如果你要拿它做长期编码或 Agent 任务，建议把通道配置和窗口配置分开管理。通道部分用 TaoToken 统一 Key，换模型或换端点只改[api]段；窗口部分保持dpi_awareness = "per_monitor_v2"和use_logical_coordinates = true不动，这样以后升级 Codex desktop app 版本时，缩放相关的修复不会被覆盖掉。
对于高频编码场景，可以了解 Coding Plan，它在通道层面对连续请求做了优化，配合 Codex desktop app 的长会话更顺。如果你更习惯命令行方式，ClaudeCodeAnthropic 接入 也走同一套 Key，config.toml 里的 api_key 可以直接复用。控制台在 console，可以看请求量和通道状态。
最后留一个实用技巧：把修好的 config.toml 备份一份，Codex desktop app 每次大版本更新后对比一下[window]和[display]段有没有被重置。缩放类 Bug 往往在版本升级后复发，提前备份能省不少排查时间。
