1. 无边框窗口拉伸的难点OnNcHitTest 的方向判断不止“四边”1.1 WS_POPUP 建出来之后拉伸职责全落到自己手上WTL/ATL 无边框窗口没有系统边框时WM_NCHITTEST 的方向判断是绕不开的一步。我在把 Codex 的模型通道切到 TaoToken 之前主要靠手写三个消息映射然后一遍遍编译试。现在流程改成了先打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 注册并创建 API Key把 Codex 的 Base URL 指到 https://taotoken.net/api然后把 CreateEx(WS_POPUP) 和 BEGIN_MSG_MAP_EX 里那三个消息处理函数贴给 Codex让它按同一套映射审查返回值与光标分支。请求跑通就验证完成拉伸逻辑仍由 WTL 原生处理思路比反复编译干净不少。原文的场景是用wndMain.CreateEx(NULL, NULL, WS_CLIPCHILDREN | WS_CLIPSIBLINGS | WS_POPUP)创建无边框窗口关键就在于WS_POPUP而不是WS_SIZEBOX。想保留系统自带边框、不想自己写拉伸就在样式里加上WS_SIZEBOX一旦拿掉WS_SIZEBOX系统就不再把“鼠标落在边缘”当作可缩放区域所有命中测试要么返回HTCLIENT要么返回HTCAPTION窗口自然拉不动。所以必须自己接三个消息WM_NCHITTEST告诉系统鼠标落在窗口的哪个非客户区部位WM_SETCURSOR把光标换成上下、左右、斜向箭头WM_NCLBUTTONDOWN发出WM_SYSCOMMAND SC_SIZE让系统完成缩放。这三者的关系是OnNcHitTest给方向OnSetCursor给视觉反馈OnNcLButtonDown给动作任何一环返回值对不上表现就是“光标变了但拉不动”或“能拉但光标不对”。1.2 四角优先、四边其次顺序错了就出鬼OnNcHitTest里最常见的错误是四角被四边抢走。窗口左上角同时满足“左边”和“上边”两个条件如果代码先判断HTLEFT或HTTOP左上角的斜向拉伸就永远触发不了。所以原文把RESIZE_REGION_SIZE定义为 5并在函数开头先处理四个角再处理四条边。这个顺序是审查的重点我重写过的版本是这样const int RESIZE_REGION_SIZE 5; UINT CMainFrame::OnNcHitTest(CPoint pt) { RECT rc{}; ::GetWindowRect(m_hWnd, rc); const bool hitLeft (pt.x rc.left RESIZE_REGION_SIZE); const bool hitRight (pt.x rc.right - RESIZE_REGION_SIZE); const bool hitTop (pt.y rc.top RESIZE_REGION_SIZE); const bool hitBottom (pt.y rc.bottom - RESIZE_REGION_SIZE); // 四角优先判断 if (hitTop hitLeft) return HTTOPLEFT; if (hitTop hitRight) return HTTOPRIGHT; if (hitBottom hitLeft) return HTBOTTOMLEFT; if (hitBottom hitRight) return HTBOTTOMRIGHT; // 再判断四边 if (hitLeft) return HTLEFT; if (hitRight) return HTRIGHT; if (hitTop) return HTTOP; if (hitBottom) return HTBOTTOM; // 其余区域按标题栏处理无边框窗口才能被拖动 return HTCAPTION; }这段代码直接放进CMainFrame就能参与消息映射。要注意HTCAPTION是一把双刃剑它让窗口的空白区域可以拖动但如果窗口上有按钮、编辑框等子控件这些区域在命中测试里会先被HTCAPTION截走导致控件收不到点击。原文后面提到“标题栏的按钮能随着拉伸后改变位置”实际上还牵涉两层问题一是OnNcHitTest不能无脑返回HTCAPTION二是拉伸后布局要靠OnSize重新排。这两点我在后面会专门展开也是让 Codex 审查代码时必须关注的上下文字段。2. 准备材料Key、Base URL、Codex 的 config.toml统一指到 TaoToken2.1 去官网拿 Key先分清落地页和接口地址这里要做的不是安装任何插件而是拿到一把可用于 Codex 的 API Key。打开 TaoToken 注册登录进入控制台创建 Key。创建时留意两点一是 Key 只显示一次复制下来存好别在后面多带空格或换行二是复制的是YOUR_API_KEY所在的位置不是官网首页地址。官网落地页https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content只干三件事注册、建 Key、看模型广场和用量。真正填进 Codex 的是接口地址https://taotoken.net/api末尾不要加/v1也不要带任何追踪参数。这两个地址容易混落地页是人点的接口地址是机器请求的写错位置就等着 404 或连接失败。2.2 Codex 的 config.toml把模型供应商切成 TaoTokenCodex 的配置文件和 Claude Code 不是一套别把ANTHROPIC_BASE_URL这类环境变量搬过来。Codex 读取的是~/.codex/config.toml要新增一个模型供应商并把它设为默认model YOUR_MODEL_ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api这里的YOUR_MODEL_ID不是随便填的要以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 模型广场当时列出的 ID 为准。不同时期同一个名字的模型可能升级换代ID 后缀也会变直接抄别人博客里的模型名最容易踩空。改完配置后如果本机设置过OPENAI_BASE_URL之类的全局变量它可能会覆盖config.toml里的base_url这时需要在终端里确认环境变量没有残留。Codex 发起请求时会拼接兼容路径所以https://taotoken.net/api后面不要画蛇添足补/v1。3. OnSetCursor 与 OnNcLButtonDown让 Codex 对照两张映射表3.1 OnSetCursor 的光标分支要覆盖 OnNcHitTest 的全部返回区域OnSetCursor的输入参数nHitTest就是OnNcHitTest刚才返回的HT*值所以它本质是一张查询表哪个区域返回哪种光标。最容易漏的是只写了四边、漏了四角以及default分支没有返回FALSE。如果default返回TRUE但不设置光标鼠标会保持原来的箭头看起来就像“没有反应”。完整的写法BOOL CMainFrame::OnSetCursor(CWindow wnd, UINT nHitTest, UINT message) { LPCTSTR cursorId nullptr; switch (nHitTest) { case HTTOP: case HTBOTTOM: cursorId IDC_SIZENS; break; case HTLEFT: case HTRIGHT: cursorId IDC_SIZEWE; break; case HTTOPLEFT: case HTBOTTOMRIGHT: cursorId IDC_SIZENWSE; break; case HTTOPRIGHT: case HTBOTTOMLEFT: cursorId IDC_SIZENESW; break; default: return FALSE; } ::SetCursor(::LoadCursor(nullptr, cursorId)); return TRUE; }这段代码本身不复杂但和OnNcHitTest放在一起看时很容易出现“四角区域在命中测试里返回了HTTOPLEFT光标表里却只写了HTLEFT和HTTOP”的错位。手工查这种错位很费眼神让 Codex 同时读这两个函数按区域清单逐个对照一次就能找齐。3.2 OnNcLButtonDown 的八个 SC_SIZE 分支OnNcLButtonDown是无边框拉伸的最后一步根据nHitTest决定向WM_SYSCOMMAND发送哪个WMSZ_*参数。八个方向对应八个参数少一个就有一个方向拉不动。这里建议用局部变量承接方向值最后统一SendMessage比每个分支都写一长串SendMessage更清楚void CMainFrame::OnNcLButtonDown(UINT nHitTest, CPoint point) { int wmsz 0; switch (nHitTest) { case HTTOP: wmsz WMSZ_TOP; break; case HTBOTTOM: wmsz WMSZ_BOTTOM; break; case HTLEFT: wmsz WMSZ_LEFT; break; case HTRIGHT: wmsz WMSZ_RIGHT; break; case HTTOPLEFT: wmsz WMSZ_TOPLEFT; break; case HTTOPRIGHT: wmsz WMSZ_TOPRIGHT; break; case HTBOTTOMLEFT: wmsz WMSZ_BOTTOMLEFT; break; case HTBOTTOMRIGHT: wmsz WMSZ_BOTTOMRIGHT; break; default: SetMsgHandled(FALSE); return; } SendMessage(WM_SYSCOMMAND, SC_SIZE | wmsz, MAKELPARAM(point.x, point.y)); }注意default分支调用SetMsgHandled(FALSE)而不是直接return。在 WTL 的BEGIN_MSG_MAP_EX里SetMsgHandled(FALSE)会把消息继续传给后面的CHAIN_MSG_MAP(CUpdateUICMainFrame)和CHAIN_MSG_MAP(CFrameWindowImplCMainFrame)让原有框架行为不被破坏。如果这里漏掉窗口标题栏的拖动和其他系统级非客户区操作可能变得不正常。3.3 把三段函数和消息映射一起贴给 Codex 的检查清单接入 TaoToken 只改变了 Codex 的模型通道不改变 WTL 的拉伸逻辑。让 Codex 审查时不要只贴一个函数应当把下面这些内容一起放进对话CreateEx那行让它看到WS_POPUP和没有WS_SIZEBOX、消息映射片段、OnNcHitTest、OnSetCursor、OnNcLButtonDown。然后可以这样提问这是一个 WTL 无边框窗口的拉伸实现样式是 WS_POPUP有三个处理函数。 请检查 1. OnNcHitTest 的四角和四边返回值是否完整顺序是否合理 2. OnSetCursor 是否覆盖了 OnNcHitTest 返回的全部 HT 区域default 分支是否正确 3. OnNcLButtonDown 是否遗漏任何 WMSZ 参数default 分支的 SetMsgHandled(FALSE) 是否正确 4. 如果窗口里有 Button 或 Edit 子控件OnNcHitTest 直接返回 HTCAPTION 会导致什么问题 5. 如果标题栏按钮在窗口拉伸后位置错乱应该在哪个消息里重新布局这种审查不是让 Codex 替你“写”代码而是让它对照你现有的实现找遗漏。它不能直接执行你的窗口程序所以最后编译运行、把鼠标放到边框上试仍然要在本地完成。Codex 只负责在代码层面把方向判断的错位找出来改完后再把新代码贴回对话做二次比对。4. HTCAPTION 与子控件布局无边框窗口的第二个坑4.1 不要一把梭返回 HTCAPTION很多无边框窗口的拉伸代码在OnNcHitTest末尾统一返回HTCAPTION好处是窗口任意空白区域都能按住拖动坏处是如果窗口上有按钮、复选框、编辑框这样的子控件这些区域的命中结果也会变成HTCAPTION鼠标左键按下时系统认为你要移动窗口而不是点击控件。一个可行的修正方案是在返回HTCAPTION前先判断鼠标位置是否落在某个子窗口范围内若是就用MapWindowPoints换算坐标找出光标下的子窗口返回HTCLIENT让控件正常接收鼠标消息。这个逻辑有没有副作用取决于窗口的布局复杂度。让 Codex 审查时可以专门把OnNcHitTest的结尾部分提出来“这个窗口里有若干个按钮返回 HTCAPTION 前需要排除子窗口区域请给出判断条件。”还有一个容易忽略的地方HTCAPTION返回区域在双击时还会触发系统最大化和还原逻辑。如果无边框窗口本身没有实现最大化按钮这把双击行为是保留还是屏蔽要在需求里明确告诉 Codex否则它可能替你加一段处理。4.2 拉伸之后标题栏按钮的位置靠 OnSize 而不是靠系统原文里提到“无边框窗口拉伸后标题栏的按钮能随着拉伸后改变位置”这句话的前提是系统标题栏不存在了所有按钮的位置都要自己在OnSize里重新计算。比如窗口变宽后右上角的关闭按钮要贴到新边距窗口变矮后按钮垂直位置要保持居中或者贴顶。这类布局计算和拉伸消息无关但经常和OnNcHitTest一起出现因为无边框窗口的“标题栏区域”其实就是你在OnNcHitTest里返回HTCAPTION的那块矩形。这块矩形的坐标可能是一个固定RECT也可能是客户区顶部的某个百分比区域。拉伸后这些数值都会变OnSize里必须重新取一次客户区宽度否则按钮会停在原来的位置。Codex 在审查这段时通常会建议把“标题栏区域”和“按钮布局区域”抽成两个独立函数一个负责命中测试哪些区域返回HTCAPTION一个负责布局按钮坐标随窗口大小变化。这样改完以后OnNcHitTest里的魔数RESIZE_REGION_SIZE和布局用的边距不会互相干扰。审查时让 Codex 对比这两个函数能更早发现“拉宽后按钮越过窗口边缘”这类问题。5. 验证与排障先分清是通道错还是拉伸逻辑错5.1 先验证模型通道401 和 404 各是什么配置改完后先不要急着拿大段 WTL 代码测试。用 Codex 发一条最简单的请求比如让它解释WM_NCHITTEST的作用——这条请求如果能正常返回说明通道已经跑通。如果收到401第一反应不是检查 WTL 代码而是去控制台看YOUR_API_KEY是否复制完整、有没有多出空格、Key 是否已经失效。如果收到404优先怀疑两处一是base_url是不是被写成了https://taotoken.net/api/v1多出的/v1要删掉二是model字段写的模型 ID 是否真的在模型广场存在。模型广场的列表以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 当时显示为准不要照搬网上文章里写的旧 ID。通道验证通过后再谈拉伸逻辑的调试两者不要混在一起排查否则你会分不清 401 是 Key 问题还是代码问题。5.2 本地验证拉伸编译运行后把四角和四边都过一遍拉伸逻辑是否正确的最终标准是你自己编译运行后在屏幕上试出来的。建议按这个顺序过一遍先把窗口放在屏幕中间鼠标分别移动到左边、右边、上边、下边确认光标分别变成左右、上下箭头然后移动到四个角确认出现斜向箭头接着按住某个角拖动确认窗口按预期方向缩放鼠标拖动过程中光标不跳回默认箭头最后把窗口拉宽拉高观察标题栏按钮是否跟随新尺寸移动到正确位置。这些操作全部在本地完成Codex 不参与运行它只负责对照代码找逻辑漏洞。发现问题后把对应的那个函数贴回对话让它重新检查。比如“按住左上角拖动时窗口会闪烁但尺寸不变”多半是OnNcLButtonDown的HTTOPLEFT分支写成了WMSZ_TOP方向参数不对一眼就能从代码里看出来。6. 跑通之后去控制台对一下这次调用验证完这轮拉伸代码审查回控制台把账目对一下在 TaoToken 模型对话 里用同一把 Key 发一条测试消息确认 Key 和模型 ID 没有填错要长期写代码就打开 Coding Plan 看套餐够不够Key 不够用就到 控制台 API Keys 新建。如果之后想让 Claude Code 也走同一个通道环境变量的对照关系在 Claude Code 接入文档 里。请求记录和用量统计都在控制台里能看到确认这次调用被正确记上后续再切换模型或调整 Key 就有据可查。
