1. 从取色器说起为什么我要用 Win32 API 写这个小工具做前端或者 UI 的时候经常遇到一个很实际的问题设计稿上某个颜色我想知道它精确的 RGB 值是多少或者调试界面时想确认某个像素点到底渲染成了什么颜色。系统自带的放大镜取色功能太慢第三方取色器又经常弹广告。最省事的办法其实是用 Win32 API 自己写一个几十行的小程序实时打印鼠标坐标和该坐标下的屏幕颜色 RGB 值。这个场景里用到的核心 API 就两个GetCursorPos负责拿到鼠标在屏幕坐标系里的位置GetPixel负责读取指定坐标的像素颜色。听起来简单但真写起来会碰到几个坑屏幕 DC 的获取与释放、颜色值的位分解、轮询刷新时的性能控制以及——如果你还想把这个小工具接入 AI 辅助编码流程怎么让模型稳定地帮你补全和排错。这篇就按「先跑通原生 Win32 逻辑再接入 TaoToken 统一 Key/API 通道」的顺序来写。前半段是可直接编译运行的 C 代码后半段给出config.toml骨架和 Cline / CC Switch 的配置片段最后附上验证步骤确认坐标与颜色值能实时正确输出。适合有基础 C 环境、想快速做一个桌面取色小工具同时希望把 AI 编码助手接进日常开发流的同学。2. TaoToken 前置统一 Key 与 API 通道准备在写代码之前先把 AI 辅助这一侧的通道准备好。TaoToken 的作用是把不同模型的调用收敛到一个统一的 Key 和 API 入口上这样你在 Cline、CC Switch 或者自己写的脚本里不用为每个模型单独维护一套鉴权和地址。你需要先拿到一个 API Key。进入控制台后创建 Key建议按用途命名比如win32-tool-dev方便后面区分。创建完成后API 的基础地址是https://taotoken.net/api这个地址在配置里会反复用到。这里有个细节值得说清楚Key 只在创建时完整显示一次后面再进列表只能看到前缀。所以创建后立刻复制到你的密码管理器或者本地.env里别等关了页面再找。我试过因为没及时保存只能删掉重建白白浪费一次配额。如果你只是想让模型帮你解释GetPixel的返回值为什么是COLORREF而不是直接的 RGB 三元组用模型对话页面就够了但如果你打算让 AI 持续参与这个项目的编码比如自动补全ReleaseDC的调用位置、帮你把轮询逻辑改成事件驱动那就更适合用 Coding Plan 这类长期编码通道。两者的 Key 是同一套区别在于使用方式和额度策略。3. 可复制配置config.toml 骨架与 Cline / CC Switch 片段先给一份通用的config.toml骨架。这个文件放在你的项目根目录或者用户配置目录下具体路径取决于你用的客户端。核心字段就三个base_url、api_key、model。# config.toml - TaoToken 统一接入配置骨架 [provider] name taotoken base_url https://taotoken.net/api api_key sk-你的Key粘贴在这里 timeout_seconds 60 [model] default claude-sonnet-4-20250514 fallback gpt-4o-mini [request] max_tokens 4096 temperature 0.2 stream truetemperature设成 0.2 是因为写 Win32 代码时我更希望模型给确定性的补全而不是发挥创意。stream true让输出边生成边显示调试长代码时体验好很多。如果你用的是 ClineVS Code 里的编码助手插件配置入口在设置里的 API Provider 部分。选择自定义 OpenAI 兼容接口然后填{ apiProvider: openai, openAiBaseUrl: https://taotoken.net/api, openAiApiKey: sk-你的Key, openAiModelId: claude-sonnet-4-20250514 }CC Switch 的配置思路类似它本质上是帮你切换不同模型通道的工具。在它的配置文件里增加一个 provider 段把 base_url 指向 TaoToken 的 API 地址Key 填进去模型名按你实际要用的填。切换的时候选这个 provider 就行不用每次改代码。注意base_url 末尾不要多加斜杠也不要写成/v1之类的路径客户端一般会自动拼接。多写一层路径会导致 404这个坑我踩过。配置完成后建议先用模型对话页面发一条测试消息确认 Key 和通道是通的再去配编辑器插件。这样出问题时能快速定位是 Key 的问题还是插件配置的问题。4. 核心代码GetCursorPos 与 GetPixel 的完整实现现在进入正题。下面这份代码可以直接用 MSVC 或者 MinGW 编译。相比原始版本我做了几处改进去掉了goto循环改用while加刷新节流把颜色输出格式化成#RRGGBB更符合日常习惯增加了对GetPixel返回CLR_INVALID的判断。#include iostream #include windows.h #include iomanip // 判断鼠标是否移动过用于控制刷新频率 bool IsMouseMove(POINT last) { POINT cur; GetCursorPos(cur); if (cur.x ! last.x || cur.y ! last.y) { last cur; return true; } return false; } int main() { POINT last { -1, -1 }; std::cout 移动鼠标查看实时坐标与颜色按 CtrlC 退出\n; while (true) { POINT p; GetCursorPos(p); if (IsMouseMove(last)) { HDC hDC GetDC(NULL); // 获取整个屏幕的设备上下文 COLORREF clr GetPixel(hDC, p.x, p.y); if (clr CLR_INVALID) { std::cout 坐标 ( p.x , p.y ) 读取颜色失败\n; } else { int r GetRValue(clr); int g GetGValue(clr); int b GetBValue(clr); std::cout 坐标: ( std::setw(5) p.x , std::setw(5) p.y ) RGB: ( std::setw(3) r , std::setw(3) g , std::setw(3) b ) HEX: # std::hex std::setfill(0) std::setw(2) r std::setw(2) g std::setw(2) b std::dec std::setfill( ) \n; } ReleaseDC(NULL, hDC); // 必须释放否则句柄泄漏 } Sleep(30); // 约 33fps兼顾流畅与 CPU 占用 } return 0; }几个关键点解释一下。GetDC(NULL)拿到的是整个屏幕的 DC传NULL表示桌面窗口。GetPixel返回的是COLORREF它本质上是一个 32 位整数低字节是红色依次是绿色、蓝色所以要用GetRValue/GetGValue/GetBValue来分解不能直接强转。ReleaseDC这一行千万别漏。每次循环都GetDC而不释放句柄会持续累积跑几分钟后程序就会因为资源耗尽而卡死。这是新手最容易犯的错。Sleep(30)是节流。如果不加循环会以极高频率空转CPU 占用直接拉满。30 毫秒大约对应 33 帧肉眼看已经足够流畅。编译命令MinGW 为例g mouse_color.cpp -o mouse_color.exe -lgdi32 -luser32 -O2MSVC 的话在开发者命令行里cl /EHsc mouse_color.cpp user32.lib gdi32.lib /O2运行后移动鼠标就能看到坐标和颜色实时刷新。5. 验证请求确认坐标与颜色值实时输出正确代码跑起来后怎么确认它输出的是对的给你几个可复现的验证方法。第一个方法把鼠标移到屏幕左上角。坐标应该显示(0, 0)附近颜色取决于你的桌面壁纸或任务栏。如果坐标不是 0 开头说明多显示器环境下坐标系原点可能不在主屏左上角这是正常的。第二个方法打开画图工具画一个纯红色矩形把鼠标移上去。RGB 应该输出(255, 0, 0)HEX 是#ff0000。画纯绿、纯蓝同理。这个方法能直接验证GetPixel和颜色分解是否正确。第三个方法验证刷新逻辑。快速甩动鼠标输出应该跟着变停住不动输出应该停止刷新因为IsMouseMove返回 false。如果你发现停住后还在疯狂刷屏说明移动判断逻辑有问题。如果你在 AI 辅助流程里让模型帮你改这段代码比如加一个「按空格键冻结当前颜色」的功能可以用模型对话页面先让它给出方案再贴回编辑器。验证 AI 给的代码时重点看它有没有正确处理ReleaseDC和CLR_INVALID这两个是高频出错点。6. 本篇常见错排查报错一undefined reference to GetPixel或链接失败。这是没链接 gdi32 库。MinGW 加-lgdi32MSVC 加gdi32.lib。GetCursorPos在 user32 里同样要链接。报错二颜色值一直是(255, 255, 255)或者全黑。先确认GetPixel的返回值是不是CLR_INVALID。如果是通常是 DC 获取失败检查GetDC(NULL)的返回值。另外在某些受保护的内容区域比如某些视频播放窗口GetPixel会读不到真实颜色返回黑色这是系统层面的限制不是代码问题。报错三程序跑一会儿就卡死。九成是ReleaseDC漏了或者GetDC在循环外获取但循环内反复使用导致状态异常。确保每次GetDC都配对一次ReleaseDC。报错四CPU 占用过高。检查Sleep是不是被删了或者IsMouseMove里的判断逻辑写反了导致每轮都刷新。报错五AI 插件配置后请求 401。先确认 Key 有没有多余空格再确认 base_url 是不是https://taotoken.net/api不要自己加/v1。如果还不行去控制台看 Key 是否被禁用或额度耗尽。报错六多显示器下坐标对不上。Win32 的屏幕坐标系是虚拟屏幕多屏时原点可能在主屏左上副屏坐标可能是负数。这是预期行为不是 bug。如果需要限制在某个显示器内得用MonitorFromPoint之类的 API 做判断。7. 把 AI 编码接进日常CTA 分流建议这个 Win32 小工具本身不复杂但它是个很好的练手项目用来把 AI 编码助手接进你的开发流。根据你的使用场景可以这样分流如果你主要是排障和接入配置比如 Key 怎么填、base_url 怎么写、插件报 401 怎么查建议直接看 API Keys 和接入文档那里有最准确的字段说明和示例。如果你想让模型帮你解释COLORREF的位结构、GetPixel的边界行为或者对比不同取色方案的优劣用模型对话就够了随问随答不用配编辑器。如果你打算长期用 AI 辅助写这类桌面工具甚至让它帮你维护一个小的工具集那 Coding Plan 更合适。它的额度策略和上下文管理是为持续编码场景设计的比单次对话更省心。配置这件事一次配好后面就是复制粘贴。真正花时间的还是把 Win32 那些句柄、DC、坐标系的细节搞清楚。工具跑通之后你会发现取色、量坐标这类小事再也不用开笨重的软件了。 用 Win32 API 写一个获取鼠标坐标与颜色 RGB 值的小程序：TaoToken 配置与验证
1. 从取色器说起为什么我要用 Win32 API 写这个小工具做前端或者 UI 的时候经常遇到一个很实际的问题设计稿上某个颜色我想知道它精确的 RGB 值是多少或者调试界面时想确认某个像素点到底渲染成了什么颜色。系统自带的放大镜取色功能太慢第三方取色器又经常弹广告。最省事的办法其实是用 Win32 API 自己写一个几十行的小程序实时打印鼠标坐标和该坐标下的屏幕颜色 RGB 值。这个场景里用到的核心 API 就两个GetCursorPos负责拿到鼠标在屏幕坐标系里的位置GetPixel负责读取指定坐标的像素颜色。听起来简单但真写起来会碰到几个坑屏幕 DC 的获取与释放、颜色值的位分解、轮询刷新时的性能控制以及——如果你还想把这个小工具接入 AI 辅助编码流程怎么让模型稳定地帮你补全和排错。这篇就按「先跑通原生 Win32 逻辑再接入 TaoToken 统一 Key/API 通道」的顺序来写。前半段是可直接编译运行的 C 代码后半段给出config.toml骨架和 Cline / CC Switch 的配置片段最后附上验证步骤确认坐标与颜色值能实时正确输出。适合有基础 C 环境、想快速做一个桌面取色小工具同时希望把 AI 编码助手接进日常开发流的同学。2. TaoToken 前置统一 Key 与 API 通道准备在写代码之前先把 AI 辅助这一侧的通道准备好。TaoToken 的作用是把不同模型的调用收敛到一个统一的 Key 和 API 入口上这样你在 Cline、CC Switch 或者自己写的脚本里不用为每个模型单独维护一套鉴权和地址。你需要先拿到一个 API Key。进入控制台后创建 Key建议按用途命名比如win32-tool-dev方便后面区分。创建完成后API 的基础地址是https://taotoken.net/api这个地址在配置里会反复用到。这里有个细节值得说清楚Key 只在创建时完整显示一次后面再进列表只能看到前缀。所以创建后立刻复制到你的密码管理器或者本地.env里别等关了页面再找。我试过因为没及时保存只能删掉重建白白浪费一次配额。如果你只是想让模型帮你解释GetPixel的返回值为什么是COLORREF而不是直接的 RGB 三元组用模型对话页面就够了但如果你打算让 AI 持续参与这个项目的编码比如自动补全ReleaseDC的调用位置、帮你把轮询逻辑改成事件驱动那就更适合用 Coding Plan 这类长期编码通道。两者的 Key 是同一套区别在于使用方式和额度策略。3. 可复制配置config.toml 骨架与 Cline / CC Switch 片段先给一份通用的config.toml骨架。这个文件放在你的项目根目录或者用户配置目录下具体路径取决于你用的客户端。核心字段就三个base_url、api_key、model。# config.toml - TaoToken 统一接入配置骨架 [provider] name taotoken base_url https://taotoken.net/api api_key sk-你的Key粘贴在这里 timeout_seconds 60 [model] default claude-sonnet-4-20250514 fallback gpt-4o-mini [request] max_tokens 4096 temperature 0.2 stream truetemperature设成 0.2 是因为写 Win32 代码时我更希望模型给确定性的补全而不是发挥创意。stream true让输出边生成边显示调试长代码时体验好很多。如果你用的是 ClineVS Code 里的编码助手插件配置入口在设置里的 API Provider 部分。选择自定义 OpenAI 兼容接口然后填{ apiProvider: openai, openAiBaseUrl: https://taotoken.net/api, openAiApiKey: sk-你的Key, openAiModelId: claude-sonnet-4-20250514 }CC Switch 的配置思路类似它本质上是帮你切换不同模型通道的工具。在它的配置文件里增加一个 provider 段把 base_url 指向 TaoToken 的 API 地址Key 填进去模型名按你实际要用的填。切换的时候选这个 provider 就行不用每次改代码。注意base_url 末尾不要多加斜杠也不要写成/v1之类的路径客户端一般会自动拼接。多写一层路径会导致 404这个坑我踩过。配置完成后建议先用模型对话页面发一条测试消息确认 Key 和通道是通的再去配编辑器插件。这样出问题时能快速定位是 Key 的问题还是插件配置的问题。4. 核心代码GetCursorPos 与 GetPixel 的完整实现现在进入正题。下面这份代码可以直接用 MSVC 或者 MinGW 编译。相比原始版本我做了几处改进去掉了goto循环改用while加刷新节流把颜色输出格式化成#RRGGBB更符合日常习惯增加了对GetPixel返回CLR_INVALID的判断。#include iostream #include windows.h #include iomanip // 判断鼠标是否移动过用于控制刷新频率 bool IsMouseMove(POINT last) { POINT cur; GetCursorPos(cur); if (cur.x ! last.x || cur.y ! last.y) { last cur; return true; } return false; } int main() { POINT last { -1, -1 }; std::cout 移动鼠标查看实时坐标与颜色按 CtrlC 退出\n; while (true) { POINT p; GetCursorPos(p); if (IsMouseMove(last)) { HDC hDC GetDC(NULL); // 获取整个屏幕的设备上下文 COLORREF clr GetPixel(hDC, p.x, p.y); if (clr CLR_INVALID) { std::cout 坐标 ( p.x , p.y ) 读取颜色失败\n; } else { int r GetRValue(clr); int g GetGValue(clr); int b GetBValue(clr); std::cout 坐标: ( std::setw(5) p.x , std::setw(5) p.y ) RGB: ( std::setw(3) r , std::setw(3) g , std::setw(3) b ) HEX: # std::hex std::setfill(0) std::setw(2) r std::setw(2) g std::setw(2) b std::dec std::setfill( ) \n; } ReleaseDC(NULL, hDC); // 必须释放否则句柄泄漏 } Sleep(30); // 约 33fps兼顾流畅与 CPU 占用 } return 0; }几个关键点解释一下。GetDC(NULL)拿到的是整个屏幕的 DC传NULL表示桌面窗口。GetPixel返回的是COLORREF它本质上是一个 32 位整数低字节是红色依次是绿色、蓝色所以要用GetRValue/GetGValue/GetBValue来分解不能直接强转。ReleaseDC这一行千万别漏。每次循环都GetDC而不释放句柄会持续累积跑几分钟后程序就会因为资源耗尽而卡死。这是新手最容易犯的错。Sleep(30)是节流。如果不加循环会以极高频率空转CPU 占用直接拉满。30 毫秒大约对应 33 帧肉眼看已经足够流畅。编译命令MinGW 为例g mouse_color.cpp -o mouse_color.exe -lgdi32 -luser32 -O2MSVC 的话在开发者命令行里cl /EHsc mouse_color.cpp user32.lib gdi32.lib /O2运行后移动鼠标就能看到坐标和颜色实时刷新。5. 验证请求确认坐标与颜色值实时输出正确代码跑起来后怎么确认它输出的是对的给你几个可复现的验证方法。第一个方法把鼠标移到屏幕左上角。坐标应该显示(0, 0)附近颜色取决于你的桌面壁纸或任务栏。如果坐标不是 0 开头说明多显示器环境下坐标系原点可能不在主屏左上角这是正常的。第二个方法打开画图工具画一个纯红色矩形把鼠标移上去。RGB 应该输出(255, 0, 0)HEX 是#ff0000。画纯绿、纯蓝同理。这个方法能直接验证GetPixel和颜色分解是否正确。第三个方法验证刷新逻辑。快速甩动鼠标输出应该跟着变停住不动输出应该停止刷新因为IsMouseMove返回 false。如果你发现停住后还在疯狂刷屏说明移动判断逻辑有问题。如果你在 AI 辅助流程里让模型帮你改这段代码比如加一个「按空格键冻结当前颜色」的功能可以用模型对话页面先让它给出方案再贴回编辑器。验证 AI 给的代码时重点看它有没有正确处理ReleaseDC和CLR_INVALID这两个是高频出错点。6. 本篇常见错排查报错一undefined reference to GetPixel或链接失败。这是没链接 gdi32 库。MinGW 加-lgdi32MSVC 加gdi32.lib。GetCursorPos在 user32 里同样要链接。报错二颜色值一直是(255, 255, 255)或者全黑。先确认GetPixel的返回值是不是CLR_INVALID。如果是通常是 DC 获取失败检查GetDC(NULL)的返回值。另外在某些受保护的内容区域比如某些视频播放窗口GetPixel会读不到真实颜色返回黑色这是系统层面的限制不是代码问题。报错三程序跑一会儿就卡死。九成是ReleaseDC漏了或者GetDC在循环外获取但循环内反复使用导致状态异常。确保每次GetDC都配对一次ReleaseDC。报错四CPU 占用过高。检查Sleep是不是被删了或者IsMouseMove里的判断逻辑写反了导致每轮都刷新。报错五AI 插件配置后请求 401。先确认 Key 有没有多余空格再确认 base_url 是不是https://taotoken.net/api不要自己加/v1。如果还不行去控制台看 Key 是否被禁用或额度耗尽。报错六多显示器下坐标对不上。Win32 的屏幕坐标系是虚拟屏幕多屏时原点可能在主屏左上副屏坐标可能是负数。这是预期行为不是 bug。如果需要限制在某个显示器内得用MonitorFromPoint之类的 API 做判断。7. 把 AI 编码接进日常CTA 分流建议这个 Win32 小工具本身不复杂但它是个很好的练手项目用来把 AI 编码助手接进你的开发流。根据你的使用场景可以这样分流如果你主要是排障和接入配置比如 Key 怎么填、base_url 怎么写、插件报 401 怎么查建议直接看 API Keys 和接入文档那里有最准确的字段说明和示例。如果你想让模型帮你解释COLORREF的位结构、GetPixel的边界行为或者对比不同取色方案的优劣用模型对话就够了随问随答不用配编辑器。如果你打算长期用 AI 辅助写这类桌面工具甚至让它帮你维护一个小的工具集那 Coding Plan 更合适。它的额度策略和上下文管理是为持续编码场景设计的比单次对话更省心。配置这件事一次配好后面就是复制粘贴。真正花时间的还是把 Win32 那些句柄、DC、坐标系的细节搞清楚。工具跑通之后你会发现取色、量坐标这类小事再也不用开笨重的软件了。