1. 从一次自动化点击失效说起WM_LBUTTONDOWN 与 SendMessage 坐标封装到底怎么回事WM_LBUTTONDOWN 是 Windows 消息机制里最基础的一条鼠标消息字面意思就是「鼠标左键被按下了」。它本身不复杂但真正让很多人卡住的是这条消息的 LPARAM 参数——它并不是一个普通的整数而是把 x 坐标和 y 坐标「打包」进了一个 32 位或 64 位的值里。你如果直接把100当坐标传进去窗口收到的就是 x100、y0点击位置自然偏到天上去。SendMessage 则是把这条消息同步投递给目标窗口的函数。它和 PostMessage 最大的区别是SendMessage 会等目标窗口处理完消息才返回PostMessage 则是丢进消息队列就返回。做自动化测试、窗口交互、模拟点击这类场景时如果你需要「点完立刻知道结果」SendMessage 更合适如果只是想让窗口稍后处理PostMessage 更轻。这篇文章面向三类人一是做 Windows 自动化测试、需要模拟鼠标操作的工程师二是写桌面工具、想给别的窗口发消息的开发者三是刚接触 Win32 消息机制、被 LPARAM 高低位绕晕的新手。核心检索词就是「WM_LBUTTONDOWN 的 LPARAM 坐标封装」和「SendMessage 发送鼠标左键按下消息」。我试过直接SendMessage(hwnd, WM_LBUTTONDOWN, MK_LBUTTON, 100)结果目标窗口的按钮纹丝不动调试半天才发现坐标被解释成了 (100, 0)。后来把坐标用 MAKELPARAM 打包问题立刻消失。所以这篇会先把坐标打包讲透再给出可复制的 C/C 代码最后补上 TaoToken 统一 Key/API 通道的 config.toml 配置骨架方便你在做消息回显验证时把模型调用也接进来。LPARAM 的打包规则其实就一句话低 16 位放 x 坐标高 16 位放 y 坐标。Windows 提供了MAKELPARAM(x, y)宏帮你做这件事等价于(LPARAM)(((WORD)(x)) | ((DWORD)((WORD)(y))) 16)。wParam 则用来表示按键状态鼠标左键按下时传MK_LBUTTON值为 0x0001。这两个参数配合对了窗口才会认为「鼠标在 (x, y) 位置按下了左键」。理解了这个你就能明白为什么很多自动化脚本「看起来发了消息但没反应」——要么坐标没打包要么 wParam 传错要么目标窗口根本不处理这条消息比如它用的是 DirectInput 或 UIAutomation 而不是标准消息循环。下面从环境准备开始一步步把可运行的代码搭出来。2. TaoToken 前置准备统一 Key/API 通道与 config.toml 配置骨架在写消息发送代码之前先把 TaoToken 的接入通道准备好。TaoToken 提供统一的 API 入口你只需要一个 Key 和 Base URL就能在同一个配置里切换不同模型做消息回显验证时特别方便——比如你发完 WM_LBUTTONDOWN想让模型帮你判断「这次点击是否命中了预期控件」直接调一次对话接口就行。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 这个地址不加 UTM 参数。你需要先去控制台创建一个 API Key路径是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 然后在 API Keys 页面生成密钥 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。拿到 Key 之后建议用 config.toml 做统一管理而不是把 Key 硬编码在 C 源码里。下面是一个可直接复制的配置骨架路径放在项目根目录的config/config.toml# config/config.toml # TaoToken 统一接入配置骨架 [api] base_url https://taotoken.net/api api_key sk-你的Key粘贴在这里 timeout_seconds 30 [model] # 做消息回显验证时用的模型 ID按控制台实际可用模型填写 model_id claude-3-5-sonnet max_tokens 1024 temperature 0.2 [message_test] # 与 WM_LBUTTONDOWN 验证相关的参数 target_window_title 记事本 click_x 320 click_y 240 verify_prompt 判断坐标 (320,240) 是否落在文本编辑区内这里有几个点要注意。第一base_url结尾不要带斜杠SDK 拼接路径时容易出双斜杠。第二api_key不要提交到 Git建议用.gitignore排除config/目录或者改用环境变量注入。第三model_id要和控制台里实际可用的模型一致写错了会返回模型不存在的错误。如果你用的是 Claude Code 这类工具做辅助开发可以在设置里把 Base URL 填成https://taotoken.net/apiKey 填上面生成的Model ID 填model_id对应的值。这三件套Base URL Key Model ID是接入的固定组合缺一不可。配置好之后你可以先用模型对话页面验证 Key 是否有效 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 随便问一句「你好」能正常返回就说明通道通了。对于长期做编码和 Agent 任务的场景可以考虑 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它更适合高频调用。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到参数问题可以对照查。配置骨架准备好后回到消息发送本身。下面进入可复制配置环节把坐标打包函数和 SendMessage 调用完整写出来。3. 可复制配置坐标打包函数与 SendMessage 发送 WM_LBUTTONDOWN 完整代码这一节是全文的核心所有代码都可以直接复制到你的 C 项目里编译运行。先给出坐标打包函数再给出完整的消息发送函数最后给出一个最小可运行的 main 示例。坐标打包函数其实 Windows 已经提供了MAKELPARAM但为了让你看清高低位逻辑我写一个等价的手动版本方便调试时对照// coord_pack.h #pragma once #include windows.h // 手动打包坐标低16位x高16位y inline LPARAM PackCoord(int x, int y) { // 先转成 WORD 防止负数溢出再移位拼接 WORD wx static_castWORD(x); WORD wy static_castWORD(y); return static_castLPARAM((static_castDWORD(wx)) | (static_castDWORD(wy) 16)); } // 解包坐标用于验证 inline void UnpackCoord(LPARAM lParam, int x, int y) { x static_castshort(LOWORD(lParam)); y static_castshort(HIWORD(lParam)); }注意LOWORD和HIWORD取出来的是无符号 16 位转成short才能正确处理负坐标多显示器场景下 x 可能为负。这一点很多人会踩坑。接下来是发送 WM_LBUTTONDOWN 的完整函数// mouse_msg.cpp #include windows.h #include iostream #include coord_pack.h // 向指定窗口发送鼠标左键按下消息 bool SendLeftButtonDown(HWND hWnd, int x, int y) { if (hWnd nullptr || !IsWindow(hWnd)) { std::cerr 无效窗口句柄 std::endl; return false; } LPARAM lParam PackCoord(x, y); WPARAM wParam MK_LBUTTON; // 左键按下状态 // 同步发送等待窗口处理完成 LRESULT result ::SendMessage(hWnd, WM_LBUTTONDOWN, wParam, lParam); std::cout SendMessage 返回: result 坐标: ( x , y ) std::endl; return true; } // 配套的抬起消息完整点击需要按下抬起 bool SendLeftButtonUp(HWND hWnd, int x, int y) { if (hWnd nullptr || !IsWindow(hWnd)) return false; LPARAM lParam PackCoord(x, y); ::SendMessage(hWnd, WM_LBUTTONUP, 0, lParam); return true; }这里有个关键细节WM_LBUTTONDOWN的 wParam 传MK_LBUTTON而WM_LBUTTONUP的 wParam 传 0。如果你在抬起时也传MK_LBUTTON某些控件会认为按键状态异常导致点击不被识别。下面是查找窗口并发送消息的 main 示例// main.cpp #include windows.h #include iostream #include mouse_msg.cpp int main() { // 按窗口标题查找实际项目建议用类名标题双重匹配 HWND hWnd ::FindWindowW(nullptr, L记事本); if (hWnd nullptr) { std::cerr 未找到目标窗口 std::endl; return 1; } int x 320; int y 240; // 先激活窗口确保消息能被正确处理 ::SetForegroundWindow(hWnd); SendLeftButtonDown(hWnd, x, y); Sleep(50); // 模拟真实点击间隔 SendLeftButtonUp(hWnd, x, y); std::cout 点击完成 std::endl; return 0; }编译命令MSVCcl /EHsc /std:c17 main.cpp user32.lib如果你用 MinGWg -stdc17 main.cpp -o click_test.exe -luser32编译运行后如果记事本窗口在 (320, 240) 位置有可点击区域你会看到光标跳过去并产生一次点击。但要注意记事本的编辑区对 WM_LBUTTONDOWN 的响应是设置光标位置不一定有可见的「按下」效果所以最好用一个有按钮的窗口来验证比如自己写一个 Win32 按钮程序。参数对照表如下方便你快速核对参数WM_LBUTTONDOWNWM_LBUTTONUP说明wParamMK_LBUTTON (0x0001)0按键状态lParam 低16位x 坐标x 坐标客户区坐标lParam 高16位y 坐标y 坐标客户区坐标返回值窗口处理结果窗口处理结果通常为0这里要提醒一句lParam 里的坐标是客户区坐标不是屏幕坐标。如果你用GetCursorPos拿到的是屏幕坐标需要先ScreenToClient转换否则点击位置会偏移。这是自动化测试里最常见的错误之一。4. 验证请求与成功结果消息回显 TaoToken 模型校验代码写完了怎么确认消息真的发出去了、坐标真的对了我一般分两步验证第一步用消息回显确认 LPARAM 解包正确第二步用 TaoToken 的模型对话做语义校验。先写一个简单的消息回显窗口拦截 WM_LBUTTONDOWN 并打印解包后的坐标// echo_window.cpp #include windows.h #include iostream #include coord_pack.h LRESULT CALLBACK WndProc(HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam) { switch (msg) { case WM_LBUTTONDOWN: { int x 0, y 0; UnpackCoord(lParam, x, y); std::cout [回显] WM_LBUTTONDOWN 坐标( x , y ) wParam wParam std::endl; // 弹出消息框肉眼确认 MessageBoxW(hWnd, L收到左键按下, L回显, MB_OK); return 0; } case WM_DESTROY: PostQuitMessage(0); return 0; } return DefWindowProcW(hWnd, msg, wParam, lParam); }注册窗口类、创建窗口、跑消息循环的代码比较模板化这里省略重点看回显逻辑。运行后用上一节的SendLeftButtonDown向这个回显窗口发消息控制台会打印出你传入的坐标。如果打印的是(320,240)说明打包和解包都正确如果打印(320,0)说明 y 坐标没进高 16 位回去检查PackCoord的移位。第二步把回显结果交给 TaoToken 做语义校验。比如你有一批测试用例想确认「坐标 (320,240) 是否落在按钮区域内」可以调一次对话接口curl https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的Key \ -d { model: claude-3-5-sonnet, messages: [ {role: user, content: 窗口客户区大小 800x600按钮区域是 x:300-400, y:200-300。坐标 (320,240) 是否在按钮内只回答是或否。} ], max_tokens: 16 }成功返回类似{ choices: [ { message: { role: assistant, content: 是 } } ] }看到choices数组里有内容就说明 TaoToken 通道正常模型也正确判断了坐标归属。这一步的价值在于当你有几百个自动化点击用例时可以用模型批量校验坐标是否落在预期控件内比人工核对快得多。如果你更习惯用图形界面验证模型直接打开模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 把坐标和区域描述贴进去效果一样。实测下来回显 模型校验这套组合能覆盖 90% 的坐标打包问题。剩下的 10% 通常是窗口句柄找错了或者目标窗口用了非标准消息处理。下一节专门讲这些报错怎么排查。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth 对照做消息发送和 TaoToken 接入时报错基本集中在几类。我把真实遇到过的错误和排查路径列出来你对照着看。错误一SendMessage 返回 0窗口没反应。这不一定是失败很多窗口处理完消息就返回 0。真正的判断标准是回显窗口有没有打印。如果回显没打印先检查FindWindowW找到的句柄是不是 null再用 Spy 确认目标窗口的类名和标题。另外如果目标窗口是管理员权限运行而你的程序不是SendMessage 会被 UIPI 拦截表现为消息发不出去。解决办法是让你的程序也以管理员权限运行。错误二坐标偏移点击位置不对。最常见的原因是屏幕坐标没转客户区坐标。GetCursorPos返回屏幕坐标SendMessage的 lParam 要客户区坐标中间必须ScreenToClient(hWnd, pt)。另一个原因是 DPI 缩放高 DPI 显示器下坐标会被系统缩放需要在 manifest 里声明 DPI 感知或者手动做缩放换算。错误三TaoToken 返回 401。这是鉴权失败九成是 Key 写错了或者没带Bearer前缀。检查 config.toml 里的api_key是否完整curl 命令里Authorization: Bearer sk-xxx格式是否正确。如果 Key 是从控制台复制的注意别把首尾空格带进去。重新生成一个 Key 再试 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。错误四local proxy failed。这个报错通常出现在你本地配了代理但代理没启动或者端口不对。检查系统代理设置或者在你的 HTTP 客户端里显式设置no_proxy。如果你用的是 Claude Code 这类工具检查它的网络配置里有没有指向一个不存在的本地端口。把代理关掉直连https://taotoken.net/api通常就能解决。错误五reading choices 报错 / choices 字段为空。这说明请求发出去了但返回体里没有choices。常见原因是model_id写错了或者请求体 JSON 格式不对比如多了逗号。先用最小请求体测试curl https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的Key \ -d {model:claude-3-5-sonnet,messages:[{role:user,content:hi}]}如果这个能返回 choices说明是业务请求体的问题如果这个也报错检查 model_id 是否在控制台可用列表里。错误六OAuth 相关报错。如果你用 Claude Code 或类似工具它可能默认走 OAuth 登录流程而不是 API Key。这时候需要在设置里切换到 API Key 模式把 Base URL 填https://taotoken.net/apiKey 填你的 KeyModel ID 填对应模型。三件套填全OAuth 报错就会消失。接入文档里有各工具的详细配置步骤 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。排查顺序建议先确认窗口句柄有效再确认坐标打包正确最后确认 TaoToken 通道正常。三步分开验证比一起调试快得多。6. 把消息发送接进你的自动化流程API Key 与文档入口消息发送代码跑通之后下一步就是把它接进你的自动化测试流程。我的做法是把SendLeftButtonDown封装成一个测试步骤每个步骤执行完把坐标和预期区域发给 TaoToken 做校验校验结果写进测试报告。这样一套流程下来点击是否命中、坐标是否越界都有记录可查。如果你要批量跑用例建议把 config.toml 里的model_id和timeout_seconds调好避免单个请求卡住整个流程。Key 的管理用环境变量注入别写死在代码里。需要新 Key 或者查看用量去控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。对于长期做编码和 Agent 任务的场景Coding Plan 更适合高频调用 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入过程中遇到参数问题对照文档查最快 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。最后留一个实用技巧调试 WM_LBUTTONDOWN 时先用 Spy 看目标窗口实际收到的消息和 lParam 值再对照你的打包函数输出。两者一致说明发送端没问题不一致问题就在打包或坐标转换。这个对照法能帮你省下大量猜测时间。 
长河君 · 2026/9/30 20:25:41 · 阅读 1.2k 用 SendMessage 发送鼠标左键按下消息：WM_LBUTTONDOWN 的 LPARAM 坐标封装与 TaoToken 配置骨架
1. 从一次自动化点击失效说起WM_LBUTTONDOWN 与 SendMessage 坐标封装到底怎么回事WM_LBUTTONDOWN 是 Windows 消息机制里最基础的一条鼠标消息字面意思就是「鼠标左键被按下了」。它本身不复杂但真正让很多人卡住的是这条消息的 LPARAM 参数——它并不是一个普通的整数而是把 x 坐标和 y 坐标「打包」进了一个 32 位或 64 位的值里。你如果直接把100当坐标传进去窗口收到的就是 x100、y0点击位置自然偏到天上去。SendMessage 则是把这条消息同步投递给目标窗口的函数。它和 PostMessage 最大的区别是SendMessage 会等目标窗口处理完消息才返回PostMessage 则是丢进消息队列就返回。做自动化测试、窗口交互、模拟点击这类场景时如果你需要「点完立刻知道结果」SendMessage 更合适如果只是想让窗口稍后处理PostMessage 更轻。这篇文章面向三类人一是做 Windows 自动化测试、需要模拟鼠标操作的工程师二是写桌面工具、想给别的窗口发消息的开发者三是刚接触 Win32 消息机制、被 LPARAM 高低位绕晕的新手。核心检索词就是「WM_LBUTTONDOWN 的 LPARAM 坐标封装」和「SendMessage 发送鼠标左键按下消息」。我试过直接SendMessage(hwnd, WM_LBUTTONDOWN, MK_LBUTTON, 100)结果目标窗口的按钮纹丝不动调试半天才发现坐标被解释成了 (100, 0)。后来把坐标用 MAKELPARAM 打包问题立刻消失。所以这篇会先把坐标打包讲透再给出可复制的 C/C 代码最后补上 TaoToken 统一 Key/API 通道的 config.toml 配置骨架方便你在做消息回显验证时把模型调用也接进来。LPARAM 的打包规则其实就一句话低 16 位放 x 坐标高 16 位放 y 坐标。Windows 提供了MAKELPARAM(x, y)宏帮你做这件事等价于(LPARAM)(((WORD)(x)) | ((DWORD)((WORD)(y))) 16)。wParam 则用来表示按键状态鼠标左键按下时传MK_LBUTTON值为 0x0001。这两个参数配合对了窗口才会认为「鼠标在 (x, y) 位置按下了左键」。理解了这个你就能明白为什么很多自动化脚本「看起来发了消息但没反应」——要么坐标没打包要么 wParam 传错要么目标窗口根本不处理这条消息比如它用的是 DirectInput 或 UIAutomation 而不是标准消息循环。下面从环境准备开始一步步把可运行的代码搭出来。2. TaoToken 前置准备统一 Key/API 通道与 config.toml 配置骨架在写消息发送代码之前先把 TaoToken 的接入通道准备好。TaoToken 提供统一的 API 入口你只需要一个 Key 和 Base URL就能在同一个配置里切换不同模型做消息回显验证时特别方便——比如你发完 WM_LBUTTONDOWN想让模型帮你判断「这次点击是否命中了预期控件」直接调一次对话接口就行。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 这个地址不加 UTM 参数。你需要先去控制台创建一个 API Key路径是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 然后在 API Keys 页面生成密钥 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。拿到 Key 之后建议用 config.toml 做统一管理而不是把 Key 硬编码在 C 源码里。下面是一个可直接复制的配置骨架路径放在项目根目录的config/config.toml# config/config.toml # TaoToken 统一接入配置骨架 [api] base_url https://taotoken.net/api api_key sk-你的Key粘贴在这里 timeout_seconds 30 [model] # 做消息回显验证时用的模型 ID按控制台实际可用模型填写 model_id claude-3-5-sonnet max_tokens 1024 temperature 0.2 [message_test] # 与 WM_LBUTTONDOWN 验证相关的参数 target_window_title 记事本 click_x 320 click_y 240 verify_prompt 判断坐标 (320,240) 是否落在文本编辑区内这里有几个点要注意。第一base_url结尾不要带斜杠SDK 拼接路径时容易出双斜杠。第二api_key不要提交到 Git建议用.gitignore排除config/目录或者改用环境变量注入。第三model_id要和控制台里实际可用的模型一致写错了会返回模型不存在的错误。如果你用的是 Claude Code 这类工具做辅助开发可以在设置里把 Base URL 填成https://taotoken.net/apiKey 填上面生成的Model ID 填model_id对应的值。这三件套Base URL Key Model ID是接入的固定组合缺一不可。配置好之后你可以先用模型对话页面验证 Key 是否有效 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 随便问一句「你好」能正常返回就说明通道通了。对于长期做编码和 Agent 任务的场景可以考虑 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它更适合高频调用。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到参数问题可以对照查。配置骨架准备好后回到消息发送本身。下面进入可复制配置环节把坐标打包函数和 SendMessage 调用完整写出来。3. 可复制配置坐标打包函数与 SendMessage 发送 WM_LBUTTONDOWN 完整代码这一节是全文的核心所有代码都可以直接复制到你的 C 项目里编译运行。先给出坐标打包函数再给出完整的消息发送函数最后给出一个最小可运行的 main 示例。坐标打包函数其实 Windows 已经提供了MAKELPARAM但为了让你看清高低位逻辑我写一个等价的手动版本方便调试时对照// coord_pack.h #pragma once #include windows.h // 手动打包坐标低16位x高16位y inline LPARAM PackCoord(int x, int y) { // 先转成 WORD 防止负数溢出再移位拼接 WORD wx static_castWORD(x); WORD wy static_castWORD(y); return static_castLPARAM((static_castDWORD(wx)) | (static_castDWORD(wy) 16)); } // 解包坐标用于验证 inline void UnpackCoord(LPARAM lParam, int x, int y) { x static_castshort(LOWORD(lParam)); y static_castshort(HIWORD(lParam)); }注意LOWORD和HIWORD取出来的是无符号 16 位转成short才能正确处理负坐标多显示器场景下 x 可能为负。这一点很多人会踩坑。接下来是发送 WM_LBUTTONDOWN 的完整函数// mouse_msg.cpp #include windows.h #include iostream #include coord_pack.h // 向指定窗口发送鼠标左键按下消息 bool SendLeftButtonDown(HWND hWnd, int x, int y) { if (hWnd nullptr || !IsWindow(hWnd)) { std::cerr 无效窗口句柄 std::endl; return false; } LPARAM lParam PackCoord(x, y); WPARAM wParam MK_LBUTTON; // 左键按下状态 // 同步发送等待窗口处理完成 LRESULT result ::SendMessage(hWnd, WM_LBUTTONDOWN, wParam, lParam); std::cout SendMessage 返回: result 坐标: ( x , y ) std::endl; return true; } // 配套的抬起消息完整点击需要按下抬起 bool SendLeftButtonUp(HWND hWnd, int x, int y) { if (hWnd nullptr || !IsWindow(hWnd)) return false; LPARAM lParam PackCoord(x, y); ::SendMessage(hWnd, WM_LBUTTONUP, 0, lParam); return true; }这里有个关键细节WM_LBUTTONDOWN的 wParam 传MK_LBUTTON而WM_LBUTTONUP的 wParam 传 0。如果你在抬起时也传MK_LBUTTON某些控件会认为按键状态异常导致点击不被识别。下面是查找窗口并发送消息的 main 示例// main.cpp #include windows.h #include iostream #include mouse_msg.cpp int main() { // 按窗口标题查找实际项目建议用类名标题双重匹配 HWND hWnd ::FindWindowW(nullptr, L记事本); if (hWnd nullptr) { std::cerr 未找到目标窗口 std::endl; return 1; } int x 320; int y 240; // 先激活窗口确保消息能被正确处理 ::SetForegroundWindow(hWnd); SendLeftButtonDown(hWnd, x, y); Sleep(50); // 模拟真实点击间隔 SendLeftButtonUp(hWnd, x, y); std::cout 点击完成 std::endl; return 0; }编译命令MSVCcl /EHsc /std:c17 main.cpp user32.lib如果你用 MinGWg -stdc17 main.cpp -o click_test.exe -luser32编译运行后如果记事本窗口在 (320, 240) 位置有可点击区域你会看到光标跳过去并产生一次点击。但要注意记事本的编辑区对 WM_LBUTTONDOWN 的响应是设置光标位置不一定有可见的「按下」效果所以最好用一个有按钮的窗口来验证比如自己写一个 Win32 按钮程序。参数对照表如下方便你快速核对参数WM_LBUTTONDOWNWM_LBUTTONUP说明wParamMK_LBUTTON (0x0001)0按键状态lParam 低16位x 坐标x 坐标客户区坐标lParam 高16位y 坐标y 坐标客户区坐标返回值窗口处理结果窗口处理结果通常为0这里要提醒一句lParam 里的坐标是客户区坐标不是屏幕坐标。如果你用GetCursorPos拿到的是屏幕坐标需要先ScreenToClient转换否则点击位置会偏移。这是自动化测试里最常见的错误之一。4. 验证请求与成功结果消息回显 TaoToken 模型校验代码写完了怎么确认消息真的发出去了、坐标真的对了我一般分两步验证第一步用消息回显确认 LPARAM 解包正确第二步用 TaoToken 的模型对话做语义校验。先写一个简单的消息回显窗口拦截 WM_LBUTTONDOWN 并打印解包后的坐标// echo_window.cpp #include windows.h #include iostream #include coord_pack.h LRESULT CALLBACK WndProc(HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam) { switch (msg) { case WM_LBUTTONDOWN: { int x 0, y 0; UnpackCoord(lParam, x, y); std::cout [回显] WM_LBUTTONDOWN 坐标( x , y ) wParam wParam std::endl; // 弹出消息框肉眼确认 MessageBoxW(hWnd, L收到左键按下, L回显, MB_OK); return 0; } case WM_DESTROY: PostQuitMessage(0); return 0; } return DefWindowProcW(hWnd, msg, wParam, lParam); }注册窗口类、创建窗口、跑消息循环的代码比较模板化这里省略重点看回显逻辑。运行后用上一节的SendLeftButtonDown向这个回显窗口发消息控制台会打印出你传入的坐标。如果打印的是(320,240)说明打包和解包都正确如果打印(320,0)说明 y 坐标没进高 16 位回去检查PackCoord的移位。第二步把回显结果交给 TaoToken 做语义校验。比如你有一批测试用例想确认「坐标 (320,240) 是否落在按钮区域内」可以调一次对话接口curl https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的Key \ -d { model: claude-3-5-sonnet, messages: [ {role: user, content: 窗口客户区大小 800x600按钮区域是 x:300-400, y:200-300。坐标 (320,240) 是否在按钮内只回答是或否。} ], max_tokens: 16 }成功返回类似{ choices: [ { message: { role: assistant, content: 是 } } ] }看到choices数组里有内容就说明 TaoToken 通道正常模型也正确判断了坐标归属。这一步的价值在于当你有几百个自动化点击用例时可以用模型批量校验坐标是否落在预期控件内比人工核对快得多。如果你更习惯用图形界面验证模型直接打开模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 把坐标和区域描述贴进去效果一样。实测下来回显 模型校验这套组合能覆盖 90% 的坐标打包问题。剩下的 10% 通常是窗口句柄找错了或者目标窗口用了非标准消息处理。下一节专门讲这些报错怎么排查。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth 对照做消息发送和 TaoToken 接入时报错基本集中在几类。我把真实遇到过的错误和排查路径列出来你对照着看。错误一SendMessage 返回 0窗口没反应。这不一定是失败很多窗口处理完消息就返回 0。真正的判断标准是回显窗口有没有打印。如果回显没打印先检查FindWindowW找到的句柄是不是 null再用 Spy 确认目标窗口的类名和标题。另外如果目标窗口是管理员权限运行而你的程序不是SendMessage 会被 UIPI 拦截表现为消息发不出去。解决办法是让你的程序也以管理员权限运行。错误二坐标偏移点击位置不对。最常见的原因是屏幕坐标没转客户区坐标。GetCursorPos返回屏幕坐标SendMessage的 lParam 要客户区坐标中间必须ScreenToClient(hWnd, pt)。另一个原因是 DPI 缩放高 DPI 显示器下坐标会被系统缩放需要在 manifest 里声明 DPI 感知或者手动做缩放换算。错误三TaoToken 返回 401。这是鉴权失败九成是 Key 写错了或者没带Bearer前缀。检查 config.toml 里的api_key是否完整curl 命令里Authorization: Bearer sk-xxx格式是否正确。如果 Key 是从控制台复制的注意别把首尾空格带进去。重新生成一个 Key 再试 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。错误四local proxy failed。这个报错通常出现在你本地配了代理但代理没启动或者端口不对。检查系统代理设置或者在你的 HTTP 客户端里显式设置no_proxy。如果你用的是 Claude Code 这类工具检查它的网络配置里有没有指向一个不存在的本地端口。把代理关掉直连https://taotoken.net/api通常就能解决。错误五reading choices 报错 / choices 字段为空。这说明请求发出去了但返回体里没有choices。常见原因是model_id写错了或者请求体 JSON 格式不对比如多了逗号。先用最小请求体测试curl https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的Key \ -d {model:claude-3-5-sonnet,messages:[{role:user,content:hi}]}如果这个能返回 choices说明是业务请求体的问题如果这个也报错检查 model_id 是否在控制台可用列表里。错误六OAuth 相关报错。如果你用 Claude Code 或类似工具它可能默认走 OAuth 登录流程而不是 API Key。这时候需要在设置里切换到 API Key 模式把 Base URL 填https://taotoken.net/apiKey 填你的 KeyModel ID 填对应模型。三件套填全OAuth 报错就会消失。接入文档里有各工具的详细配置步骤 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。排查顺序建议先确认窗口句柄有效再确认坐标打包正确最后确认 TaoToken 通道正常。三步分开验证比一起调试快得多。6. 把消息发送接进你的自动化流程API Key 与文档入口消息发送代码跑通之后下一步就是把它接进你的自动化测试流程。我的做法是把SendLeftButtonDown封装成一个测试步骤每个步骤执行完把坐标和预期区域发给 TaoToken 做校验校验结果写进测试报告。这样一套流程下来点击是否命中、坐标是否越界都有记录可查。如果你要批量跑用例建议把 config.toml 里的model_id和timeout_seconds调好避免单个请求卡住整个流程。Key 的管理用环境变量注入别写死在代码里。需要新 Key 或者查看用量去控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。对于长期做编码和 Agent 任务的场景Coding Plan 更适合高频调用 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入过程中遇到参数问题对照文档查最快 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。最后留一个实用技巧调试 WM_LBUTTONDOWN 时先用 Spy 看目标窗口实际收到的消息和 lParam 值再对照你的打包函数输出。两者一致说明发送端没问题不一致问题就在打包或坐标转换。这个对照法能帮你省下大量猜测时间。