1. 从一次卡顿说起CursorWindow 到底在什么时候读 DB如果你写过 Android 上的列表页大概率遇到过这种体验query()秒回moveToFirst()卡一下滑到列表中间又卡一下。很多人第一反应是「SQL 太慢」但把 SQL 拿到命令行里跑几十毫秒就出结果。问题往往不在 SQL而在CursorWindow这块共享内存的填充时机。CursorWindow是 Android SQLite 读取链路里的核心缓冲结构它决定了「什么时候真正打开文件句柄、什么时候把行数据拷进内存、什么时候清空重填」。理解它你就能解释三个高频现象为什么query不耗时、为什么moveToPosition会突然卡、为什么忘记close()会泄漏 1M 到 2M 的共享内存。这篇我会沿着SQLiteDatabase.query→SQLiteCursor.onMove→fillWindow→nativeExecuteForCursorWindow这条源码链路走一遍把每一步的触发条件讲清楚。同时因为这类源码阅读经常需要在编辑器里边看边问、边改边验证我会顺带把 TaoToken 的统一 Key/API 通道接进 Cline 或 CC Switch给你一份可直接复制的settings.json/config.toml骨架让「读源码 问模型 验证结论」在一个工作流里跑通。适合已经会写 Android SQLite、但想搞明白底层读取时序的同学。2. 前置准备把 TaoToken 接进你的编码工具读 AOSP 源码是个体力活CursorWindow.cpp、SQLiteCursor.java、android_database_SQLiteConnection.cpp分散在好几个目录来回跳转很容易断思路。我的做法是把模型对话能力接进编辑器选中一段源码直接问「这里的requiredPos是怎么算出来的」比全局搜索快得多。TaoToken 在这里的角色是统一入口一个 Key、一套 API 地址兼容 OpenAI 风格的调用方式Cline、CC Switch 这类工具都能直接填。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 注意 API 地址不带 UTM 参数配置时别把查询串抄进去。先拿 Key打开 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 新建一个 Key 并复制。建议按项目建独立 Key读源码这种临时任务用一个长期编码任务用另一个方便后面按用量排查。如果你只是想先验证模型通不通用模型对话页最快 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果打算长期在 Cline 里做源码问答和 Agent 任务走 Coding Plan 更划算 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入细节和字段说明统一看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。3. 可复制配置Cline 的 settings.json 与 CC Switch 的 config.tomlCline 的配置走 VS Code 的settings.json。打开命令面板搜「Preferences: Open User Settings (JSON)」把下面这段合并进去。注意baseUrl只写到/api不要带任何查询参数apiKey换成你刚复制的那串。{ cline.apiProvider: openai, cline.openAiApiKey: sk-你的TaoTokenKey, cline.openAiBaseUrl: https://taotoken.net/api, cline.openAiModelId: claude-sonnet-4-20250514, cline.openAiModelInfo: { maxTokens: 8192, contextWindow: 200000, supportsImages: true } }几个字段的坑我踩过openAiBaseUrl末尾不要加/v1Cline 会自己拼路径多写一层会 404openAiModelId必须和你在模型对话页看到的名称一致写错会返回 model not foundcontextWindow建议按实际模型填填太小会导致长文件被截断读SQLiteCursor.java这种几百行的文件时尤其明显。CC Switch 用的是config.toml结构更扁平适合在终端里快速切模型default_provider taotoken [providers.taotoken] type openai base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model claude-sonnet-4-20250514 max_tokens 8192 [profiles.source-reading] provider taotoken system_prompt 你在帮我阅读 Android SQLite 源码回答时给出文件路径和函数名。base_url同样只到/api。profiles这一段是可选的但读源码时很有用把 system prompt 固定成「给文件路径和函数名」模型回答会明显更聚焦不会泛泛而谈。配置完保存重启一下编辑器或终端会话让配置生效。4. 验证请求从 query 到 fillWindow 的完整链路配置好之后先做一次最小验证确认通道是通的。在 Cline 里新建对话输入一句「用一句话说明 Android SQLite 的 CursorWindow 是什么」。能正常返回就说明 Key、地址、模型三项都对。如果报 401检查 Key 是否复制完整报 404检查baseUrl是不是多写了路径。通道通了之后我们回到源码本身。下面这条链路建议你对着 AOSP 源码逐段看我按触发顺序拆开。第一步SQLiteDatabase.query()系列函数。它做的事情只是构造SQLiteQuery对象把 SQL、绑定参数、排序信息打包好不会真正执行查询。所以你在代码里调用query()之后立刻打日志会发现耗时几乎为零。这一步对应源码里SQLiteDatabase.rawQueryWithFactory到SQLiteQuery构造的过程。第二步Cursor.moveToFirst()或moveToPosition()。第一次移动时SQLiteCursor.onMove会被调用Override public boolean onMove(int oldPosition, int newPosition) { if (mWindow null || newPosition mWindow.getStartPosition() || newPosition (mWindow.getStartPosition() mWindow.getNumRows())) { fillWindow(newPosition); } return true; }判断条件很关键只有当目标位置不在当前窗口范围内时才会触发fillWindow。也就是说如果你连续读同一段数据第二次不会重新填窗这就是「窗口内读取不卡」的原因。第三步fillWindow是真正耗时的地方。它会打开文件句柄、分配共享内存、执行 SQL、把行数据拷进CursorWindow。在 native 层对应nativeExecuteForCursorWindow核心逻辑在android_database_SQLiteConnection.cpp里。这里有个容易忽略的细节当请求位置超出窗口且窗口已满时会发生清空重填CopyRowResult cpr copyRow(env, window, statement, numColumns, startPos, addedRows); if (cpr CPR_FULL addedRows startPos addedRows requiredPos) { window-clear(); window-setNumColumns(numColumns); startPos addedRows; addedRows 0; cpr copyRow(env, window, statement, numColumns, startPos, addedRows); }window-clear()这一句就是多线程读的隐患来源。两个线程同时读同一个 Cursor一个线程触发清空重填另一个线程手里的位置信息就失效了。SQLite 的并发本质是串行执行但「可以并发读」这个说法在 CursorWindow 清空机制面前要打个问号。第四步fillWindow的填充策略。Android 4.0 之后填充不是只填目标位置那一行而是以目标位置为中心前后各填一段。这样做的目的是减少「往回读旧数据」时的二次填充。不同版本这段逻辑有差异如果你在做低版本兼容值得把对应版本的fillWindow源码翻出来对比。验证动作可以这样设计写一个测试query出 10000 条数据分别在moveToFirst、moveToPosition(7500)前后打时间戳。你会看到query几乎不耗时moveToFirst有一次明显耗时moveToPosition(7500)因为超出初始窗口范围又出现一次耗时。这个实测结果和源码判断条件完全对得上。5. 本篇常见错排查报错一配置后请求返回 404。九成是baseUrl写成了https://taotoken.net/api/v1或带了查询参数。正确写法只到/api路径由工具自己拼。改完记得重启会话。报错二模型名不识别。openAiModelId必须和模型对话页展示的名称完全一致大小写、日期后缀都不能差。不确定就先在模型对话页发一条消息看它实际用的是哪个模型名。报错三Cursor 忘记 close 导致内存增长。这条不是配置问题是源码层面的坑。Cursor被 GC 回收时会走finalize()但finalize()只解绑观察者不会释放 CursorWindow。真正释放共享内存的路径是close()→releaseReference()→onAllReferencesReleased()→dispose()→nativeDispose()。所以显式调用close()不是可选项是必须项否则那块 1M 或 2M 的共享内存会一直挂着。报错四多线程读同一 Cursor 数据错乱。回到第 4 节的window-clear()一个线程触发清空后另一个线程的startPos和addedRows就对不上了。解决办法是每个线程用独立 Cursor或者把读取收敛到单线程再分发。报错五低版本设备行为和高版本不一致。高版本 Android 对 SQLite 做了不少改进fillWindow的填充策略、窗口大小都有变化。如果线上有低版本设备可以考虑把 SQLite 源码带进工程让低版本也用上高版本的实现同时避开一部分兼容性问题。这一步改动量不小建议先在小范围验证。6. 把源码阅读和模型问答串成一条流水线读CursorWindow这类源码最怕的是「看懂了但记不住」。我的做法是在 Cline 里选中onMove那段代码直接问「如果newPosition刚好等于getStartPosition() getNumRows()会走哪个分支」让模型基于你选中的上下文回答而不是凭记忆泛答。这样每次问答都锚定在真实代码上结论可验证。需要长期做这类源码问答和 Agent 任务的用 Coding Plan 把额度固定下来 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。只是临时验证模型或跑几个问题模型对话页就够了 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。Key 管理和接入字段说明分别在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 和 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后留一个我自己的习惯每次读完一段 native 源码就在config.toml的 profile 里加一条备注记下「这个函数在哪个版本改过、改动点是什么」。下次再遇到类似卡顿翻备注比重新读源码快得多。