1. 概述EGL 初始化与 DRM 光标绘制为什么容易绕晕DRM 光标绘制流程理不清通常卡在 test.c 主函数、EGL 初始化和 drm_cursor 三者之间的调用顺序上。我习惯先在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建一把 Key把 Codex 的通道切到 TaoToken然后让 Codex 沿着 test.c → EGL 初始化 → 光标绘制的顺序逐段读源码。TaoToken 在这里只负责给 Codex 提供可用的 Key 和兼容通道不参与 DRM 内存管理和光标绘制本身。这样排障时Codex 替我按函数调用链拆解源码我只需要对照 drm-cursor 的实际代码验证它说的每一步是否成立。原始文章分析的是 Linux 直接渲染管理器DRM绘制硬件光标的完整过程代码来自 JeffyCN 的 drm-cursor 仓库。很多开发者拿到这套代码后第一反应是从 test.c 的 main 函数开始读结果发现 main 函数里注册了一批回调、创建了 EGL 上下文、又调用了 drm_cursor 的接口三件事纠缠在一起不知道谁是入口、谁是核心、谁只是辅助。再加上 EGL 的初始化顺序和 DRM 的 modeset 顺序并不完全一致读起来更容易断片。这次排障的思路很简单不自己从头硬读而是把 Codex 接到 TaoToken 上让它按我指定的顺序解释源码。Codex 读代码的能力不错但前提是它能稳定拿到模型通道。官方额度紧张时多 Key 来回切换很容易打断思路所以我在 TaoToken 上创建 Key把 Codex 的 base_url 指到 https://taotoken.net/api模型 ID 以模型广场当时的列表为准。下面先介绍 drm-cursor 代码结构再逐步走通 test.c 和 EGL 初始化。2. 代码介绍drm-cursor 的仓库结构与排障切入点2.1 仓库结构里每个文件是干什么的drm-cursor 的代码量不大但文件划分很典型。顶层目录里有 test.c、drm_cursor.c、drm_cursor.h、渲染相关文件和辅助工具。test.c 是应用层入口负责初始化 EGL、创建窗口表面、注册输入事件drm_cursor.c 才真正操作 DRM 的 cursor plane包括加载光标图片、移动光标、更新光标属性。原始文章特别强调drm-cursor 的核心目的是简化光标的加载、移动和更新过程并优化性能所以它把 DRM 的底层 ioctl 封装成了几个简单接口。我在 TaoToken 的模型广场里确认了可用的模型 ID 后把 Codex 配通然后让它做的事只有一件从 test.c 的 main 函数开始把从 EGL 初始化到 drm_cursor 接口调用之间的函数调用关系列出来。Codex 给出的第一版梳理就点破了问题所在——test.c 里 EGL 初始化的目的并不是为了画光标而是为了创建一个 OpenGL 上下文用来做测试画面的渲染光标绘制走的是 drm_cursor 里基于 DRM 的 hardware cursor 路径与 EGL 渲染是两个相对独立的子流程。2.2 为什么排障时要先分清 EGL 与 DRM 的职责原始文章里有一张整体软件栈架构图图中 EGL 属于图形库层DRM 属于内核显示层。光标绘制如果走硬件光标通常不经过 EGL 渲染而是直接操作 DRM 的 cursor plane如果走软件光标才需要把光标合成到渲染画面里。drm-cursor 这套实现更偏向前者因此 test.c 里的 EGL 初始化更多是为了验证 OpenGL 输出与光标绘制的关系是“并行存在”而不是“前后依赖”。理解这一点后排障的方向就清晰了当光标不显示或绘制异常先确认 drm_cursor 初始化是否成功再确认 EGL 初始化有没有抢占 DRM 的资源最后再看 test.c 里两个子流程之间是否互相干扰。为了让 Codex 能结合源码具体分析我在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建了 Key并按照下一节的配置让 Codex 读取仓库文件。这里的 Key 只用于模型接口调用不会影响 DRM 代码的运行逻辑。3. 实现过程test.c 主函数入口的调用链拆解3.1 main 函数里到底先做了什么原始文章把 test.c 的主函数入口分析作为整个实现过程的第一步。Codex 在分析 test.c 时给出的调用链是main 函数先解析命令行参数再初始化窗口系统然后创建 EGL 显示与上下文最后进入事件循环。这里最容易被误读的是初始化窗口系统时用到的 drmModeSetCrtc 等函数看起来像是“绘制”操作实际上只是把扫描输出设备配好真正的图像内容由后续渲染或光标更新来填充。我把 Codex 的视角缩小到“只看 test.c 中与 DRM 相关的调用”它很快就定位到几个关键函数drmModeGetResources、drmModeGetConnector、drmModeGetEncoder、drmModeSetCrtc。Codex 解释这些函数的作用时特别强调 drmModeSetCrtc 的第四个参数是 mode而不是画面内容它只决定显示模式不理解像素。这个区分让我在后续读 drm_cursor.c 时不再把 modeset 和光标绘制混为一谈。3.2 注册回调与事件循环的时机test.c 里通常用 DRM 的事件循环监听画面更新drm_cursor 也会注册自己的回调。Codex 指出事件循环的注册顺序会影响光标更新的及时性如果 drm_cursor 的 flip 回调注册在所有渲染初始化之后那么光标移动指令可能要先排队等当前帧完成。原始文章虽然没有展开讲事件循环但调用逻辑的顺序对排障同样重要。我让 Codex 对照 test.c 源码指出哪些代码是必须的、哪些是示例性冗余。Codex 给出的答案是test.c 里创建 EGL 上下文的代码块是示例性渲染用的如果只关心 DRM 光标绘制可以暂时跳过 EGL 相关段直接读 drm_cursor.c 的入口函数。但这个建议反过来也帮助我理解了 EGL 初始化在整套代码里的位置——它不是光标绘制的依赖项而是并行的一条测试渲染通道。4. EGL 初始化过程Codex 接入 TaoToken 后逐段对照源码4.1 把 Codex 的模型通道指到 TaoToken排障过程中我需要在 Codex 里连续提问并且希望它记住 test.c 的结构再分析 EGL 初始化因此一个稳定的模型通道是关键。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册并创建 API Key 后在本地 Codex 的配置文件~/.codex/config.toml里加入下面的 providermodel_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY然后设置环境变量export TAOTOKEN_API_KEYYOUR_API_KEY注意base_url末尾不要加/v1直接填https://taotoken.net/api。模型 ID 不能靠记忆猜要以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 模型广场当时列出的为准。配置完成后Codex 会走 TaoToken 的统一 API 通道请求模型我的 API Key 也能在同一个控制台里查看调用记录。4.2 EGL 初始化为什么容易打断 DRM 的流程把 Codex 接到 TaoToken 后我让它专门分析 test.c 里的 EGL 初始化步骤。它给出的解释很直接EGL 初始化包含 eglGetDisplay、eglInitialize、eglChooseConfig、eglCreateContext 四个标准步骤。在 test.c 里eglGetDisplay 的参数通常是某个 DRM 设备或窗口系统如果 EGL 与 DRM 共用同一个显示设备那么 EGL 初始化时可能会重置显示状态导致 drame_cursor 之前设置的属性丢失。这个点正是原始文章里 EGL 初始化过程最容易被忽略的地方。Codex 对照 drm-cursor 源码指出drm_cursor 初始化时通过 drmModeSetCursor2 设置光标位置和热点但 EGL 初始化如果触发了 modeset有些驱动会重建 crtc 状态使之前设置的光标属性被清掉。因此排障时要看 test.c 中 EGL 初始化与 drm_cursor_init 的先后顺序如果 drm_cursor_init 在 EGL 初始化之前EGL 的 modeset 可能会覆盖光标状态反过来则安全很多。4.3 光标绘制前必须确认的 EGL 状态Codex 还提醒我检查 test.c 里是否有 eglSwapBuffers 的调用。这个调用会触发显示缓冲区的交换如果光标绘制依赖 EGL 渲染的画面合成那么 eglSwapBuffers 的时机就与光标更新直接相关。但在 drm-cursor 这套实现中光标走的是硬件 cursor plane与 EGL 的扫描输出并行两者互不阻塞。所以最终结论是EGL 初始化在 test.c 里更像一个“陪跑”角色真正画光标的是 drm_cursor.c 中的 drmModeSetCursor2 和 drmModeMoveCursor不需要 EGL 参与。为了让这个结论可验证我让 Codex 输出 test.c 中 EGL 相关代码的逐行注释再与 drm_cursor.c 的调用顺序做对比。Codex 在回答里明确标出了哪些 EGL 函数可注释掉而不影响光标显示这省去了不少二分注释源码的时间。这里再次说明TaoToken 只是给 Codex 提供了稳定的模型通道没有改动 DRM 的行为全部结论仍然来自源码本身。5. 光标绘制过程从加载到移动的完整路径5.1 加载光标图片与创建 buffer 对象drm-cursor 的光标绘制步骤在原始文章里分为加载和移动两段。Codex 对照drm_cursor_load函数分析了加载过程首先从文件读取光标位图然后用drmModeAddFB2创建 framebuffer再把位图数据拷贝到显存最后通过drmModeSetCursor2将 framebuffer 关联到 cursor plane。这个过程的排障点通常是drmModeAddFB2返回的句柄为空原因往往是位图格式不是驱动支持的格式。Codex 给出了一个实际的排查建议在调用drmModeAddFB2之前打印drmModeGetCapabilities获取DRM_CAP_ADDFB2_MODIFIERS能力位有些驱动需要显式传入 modifier 才能创建成功。这个建议我没有在原始文章里看到但结合源码来看很合理属于模型对 DRM 通用机制的知识补充。5.2 移动光标与更新热点移动光标的接口是drmModeMoveCursor它只接受设备 fd、crtc id、x、y 四个参数执行时机非常轻量。Codex 指出在高分辨率屏幕下如果直接调用drmModeMoveCursor移动可能不够平滑因为该接口更新的是硬件光标位置没有经过 VSync 同步。drm-cursor 代码中并没有做插值处理所以需要应用层自己控制移动频率。这时 Codex 建议我在 test.c 的事件循环里用drmWaitVBlank来同步光标移动而不是在收到鼠标事件后立即调用drmModeMoveCursor。原始文章里也有类似暗示——优化性能的关键在于减少 ioctl 的频率把移动操作合并到垂直同步周期内。这个结论来自源码Codex 只是帮我把它显式化。5.3 排障对照EGL 初始化失败时光标是否受影响一个常见的疑问是EGL 初始化失败会不会导致光标不显示实测下来如果 d临_cursor 使用的 DRM 设备和 EGL 设备是同一个EGL 失败通常不会直接清掉 cursor plane但可能会让主流程提前退出根本没机会调用光标绘制函数。这时要检查 test.c 的错误处理分支看 EGL 失败后是否直接 return 了。Codex 给出的建议是在 test.c 的 EGL 初始化失败分支里保留一个“仅光标模式”跳过 EGL 渲染只初始化 DRM 和 drm_cursor。这样即使 EGL 环境不完整也能验证光标绘制链路是否正常。这个思路对排障很有用也让 EGL 初始化和光标绘制的关系更加清晰——它们是两个独立模块可以分别启停。6. 总结让 Codex 只解释不执行的排障节奏回到开头的困惑test.c 主函数、EGL 初始化、光标绘制之间的调用关系其实并没有那么复杂只是三个模块的职责需要分开。test.c 负责启动和事件循环EGL 初始化负责提供 OpenGL 渲染上下文与硬件光标绘制是平行关系drm_cursor 直接操作 DRM 的 cursor plane是光标绘制的真正执行者。理清这个顺序后再回头读源码每一步都有明确目标。这次排障里Codex 通过 TaoToken 提供的兼容通道稳定跑完了整个源码分析过程。我只让它生成解释、画出调用链、指出哪些函数可以暂时注释所有代码修改和运行验证都在本地完成。具体来说我在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建 Key 后把 Codex 的模型通道切到 TaoToken剩下的就是来回追问直到整个 EGL 初始化与 DRM 的边界变得清楚。如果你也遇到类似问题建议先不要在源码里乱加打印先让 Codex 按“main→EGL→光标”的顺序输出函数调用链再逐段验证。这样的排查过程不会污染代码也能快速定位是初始化顺序问题还是驱动能力问题。配置上注意一点Codex 的base_url只填 https://taotoken.net/api不要加/v1模型 ID 以 TaoToken 模型广场 当时的列表为准。TaoToken 在这里只充当模型接口通道DRM 的行为最终仍由驱动和内核决定。配置跑通之后可以打开 TaoToken 模型对话 用同一把 Key 发一条测试消息确认模型 ID 和 Base URL 都没问题。如果要持续写代码排查再看看 Coding Plan 是否适合当前调用量Key 在 控制台 API Keys 创建Claude Code 的环境变量对照资料在 接入文档 里也能找到参考。这次排障教会我一件事源码读不顺的时候与其反复看同一段 EGL 初始化不如让模型按模块拆开讲再自己动手验证调用关系。