Cursor 的 @Codebase 又胡诌了：你问购物车怎么加载商品，它却回你一段 jQuery 时代的 ajax 回调，还顺手引用了早就删掉的 cart.js。很多人第一反应是查 .cursorignore、再点 Resync Index，可索引明明没毛病。这时该怀疑模型通道了——去 TaoToken（https://taotoken.net/?utm_source=taotoken_aicg_blog_end）创建一把 Key，把 Cursor 的 Base URL 换成 https://taotoken.net/api，再重新同步索引，问题往往就露出真面目：要么是索引没覆盖到 CartService.ts，要么是模型压根没吃到最新代码。
这篇不重复讲「索引像图书馆目录」那套比喻，直接按排障顺序走：先复现 jQuery 旧方案这个具体症状，再把 .cursorignore、Resync Index、模型 Base URL 三条线索分开验证，最后回到 authMiddleware.ts 上确认 @Codebase 是否真的能定位到中间件。
1. 复现 @Codebase 胡诌 jQuery 的现场
1.1 用一句话把问题逼出来
先固定一个可复现的提问：「@Codebase 购物车是怎么加载商品的？」这个问法足够短，短到模型没有太多空间东拉西扯，一旦它开始输出 jQuery 的$.ajax或者$.getJSON，基本可以判定它拿到的上下文要么是旧文件，要么根本没拿到CartService.ts。
复现时建议只开一个干净会话，不要接着之前聊崩的上下文继续问。旧会话里残留的代码片段会污染新一轮回答，这一点比很多人想的更影响结果。把问题原样敲三遍，如果三遍都指向 jQuery，说明这不是随机抽风，而是稳定复现的通道或索引问题。
1.2 分清「索引没找到」和「模型没看到」
这是排障里最容易混的一步。索引没找到，指的是 Cursor 的 Codebase Indexing 没有把src/services/CartService.ts收进可检索范围，@Codebase 检索阶段就返回空；模型没看到，指的是索引里有这个文件，但请求发出去时模型通道不认、降级、或者被截断，模型只能凭训练记忆编。
两种症状表面都是胡言乱语，处理手法完全不同。前者要动 .cursorignore 和 Resync Index，后者要动 Base URL 和 Key。判断办法很简单：先在 Cursor 的 Codebase Indexing 面板里搜文件名，能搜到就是索引在，搜不到就先去处理忽略规则。
1.3 别急着改代码，先留一份证据
在动任何配置之前，把当次回答原样复制到一个临时文件里，标上时间。改完设置之后再问同样的问题，两份答案放一起对比，你才能确认是配置生效了，还是模型这次心情好。排障最怕来回改十项设置，最后不知道哪一项起了作用。
2. 三步验证都做了，为什么 @Codebase 还在念旧稿
2.1 .cursorignore 有没有误伤 src/services
先看项目根目录的 .cursorignore。常见写法是这样：
# 构建产物 dist/ build/ *.apk # 第三方依赖 node_modules/ vendor/ # 本地配置 config.json .env这份配置本身没问题，问题出在有人为了「只索引 src」写了一行*再加白名单。这种写法在大型项目里确实能提速，但只要白名单少写一层，src/services/就会被整体挡在外面，CartService.ts自然进不了索引。
检查方法很土但有效：把 .cursorignore 里所有!开头的白名单行抄出来，逐条对着目录树看一遍，确认src/services、src/middleware这两个目录没有被任何一条规则排除。改完保存，不要立刻去问 @Codebase，先做下一步。
2.2 Resync Index 的进度条走完不等于生效
打开 Settings > Codebase Indexing，点 Resync Index，等进度条到 100%。这一步原文提过，但有个细节容易被忽略：进度条走完只代表这一轮扫描结束，不代表新规则已经替换掉旧缓存。
稳妥做法是等进度条结束后，先在索引面板里手动搜一次CartService，看到文件路径再继续。搜不到就说明忽略规则仍然挡着它，或者索引服务需要重启一次 Cursor 才会重新读 .cursorignore。
2.3 被原文漏掉的一步：模型通道是谁给的
到这里，.cursorignore 没误删核心文件，Resync Index 也执行了，索引面板能搜到CartService.ts，可 @Codebase 输出的还是 jQuery。那就该把注意力从索引挪到模型通道上。
Cursor 自己带模型入口，但当官方额度受限、或者你想在多个模型之间切换时，就需要一个统一的 API 通道。TaoToken 在这里只解决两件事：给你一把 Key，给你一个 Base URL。它不碰你的索引，不扫描你的仓库，也不改变 .cursorignore 的任何行为。
准备好这两样东西，索引侧的问题和通道侧的问题就能彻底分开排查。
3. 带 Key 回 Cursor：把模型通道指到 TaoToken
3.1 先创建 YOUR_API_KEY
打开 TaoToken 注册并登录，进控制台创建一把 API Key。本文所有配置里，这把 Key 都写成占位符YOUR_API_KEY，你替换成自己复制到的那串就行。Key 只在创建时完整显示一次，建议当场存进密码管理器，别只放在剪贴板里。
创建完不要马上关页面，顺手在模型广场看一眼当前可用的模型列表。这一步很重要，因为下一步要填的模型 ID 必须和列表里一致，凭记忆写很容易填出一个不存在的名字。
3.2 Cursor Settings 里的 Base URL 就是 https://taotoken.net/api
回到 Cursor，打开 Settings > Models。在 OpenAI 兼容的那一栏填 API Key，也就是刚才复制的YOUR_API_KEY；在 Override Base URL 一栏填：
https://taotoken.net/api两个细节必须注意。第一，末尾不要加/v1，Cursor 自己会拼路径，你多写一层就会 404。第二，这个地址后面不要挂任何查询参数，UTM 是给浏览器里点的落地页用的，填进工具的接口地址保持干净。
填完保存，回到对话窗口新开一个会话，先问一句和代码无关的测试问题，比如「用一句话说明什么是依赖注入」。这句能正常回，说明通道通了；如果报 401 或直接超时，先回去检查 Key 有没有复制完整、有没有多带空格。
3.3 模型 ID 从模型广场抄，不要凭记忆写
在 Cursor 的模型配置区域，找到可以手填模型 ID 的位置，把刚才在模型广场看到的名字原样粘进去。模型列表会调整，所以本文不写死任何 ID，以 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 模型广场当时列表为准。
一个经验：如果你在模型广场看到某个模型有多个变体，优先选上下文窗口大的那个做代码库问答。@Codebase 会把多个文件片段拼进上下文，窗口小很容易在拼接阶段被截断，表现就是「明明索引里有这个文件，模型却像没看到」。
3.4 配置参数对照表
| 配置项 | 填什么 | 常见错误 |
|---|---|---|
| API Key | YOUR_API_KEY | 多复制了空格或换行 |
| Base URL | https://taotoken.net/api | 末尾加了/v1，或挂了 UTM 参数 |
| 模型 ID | 模型广场当时列表里的名字 | 凭记忆手写、加日期后缀 |
| 官网入口 | https://taotoken.net/?utm_source=taotoken_aicg_blog_end | 和接口地址混用 |
这张表建议截图存一下。切换工具、换机器、帮同事配环境时，九成的报错都能在这里找到原因。
4. 重新 Resync Index，用 authMiddleware.ts 验收
4.1 两条必问的验证提问
通道配好之后，别急着回去改业务代码，先把索引和模型一起验一遍。回到 Settings > Codebase Indexing，再点一次 Resync Index，等它跑完，然后依次问这两句：
第一句：@Codebase 现在忽略哪些文件？
这句用来确认新的忽略规则已经生效，模型能说出你 .cursorignore 里的规则，说明它至少读到了配置文件。
第二句：@Codebase 查找用户登录时的 token 验证逻辑，优先看中间件文件
这句是原文里的精准提问公式，验收目标很明确：它应该定位到authMiddleware.ts，而不是泛泛地说「通常在 middleware 目录下找找」。如果它能报出具体文件路径，甚至指出大致行号，说明索引和通道都正常了。
4.2 三种返回各说明什么
返回里出现authMiddleware.ts的具体路径和代码片段：通道和索引都没问题，可以回去继续你的业务问题。
返回里提到中间件但说不出文件名，或者给了一个不存在的路径：索引大概率还是没有覆盖到src/middleware，回去查 .cursorignore 的白名单。
返回里又开始讲 Express 的通用写法、或者干脆编一个verifyToken.js：通道可能没真正切过去，回 Settings > Models 确认 Base URL 和 Key 保存成功，并新开一个会话重试。
这三类结果基本能覆盖排障时的所有分支。把判断标准写下来，比每次凭感觉猜要快得多。
5. 仍然念旧稿的四种剩余情况
5.1 .cursorignore 白名单写反了
再检查一次那种「先全忽略再放行」的写法。它的正确形态应该是第一行*，后面每行用!放行一个目录。漏掉!src/就是全项目失明，漏掉!docs/api/就是文档查不到。这种写法在五万文件级别的项目里确实有用，但每加一层目录都要重新同步一次索引。
5.2 提问太笼统，模型只能靠猜
「登录功能有问题」这种问法，模型没有检索锚点，只能拿训练记忆里的通用方案顶着，jQuery 旧代码就是这么冒出来的。改成带文件名、带目录倾向、带具体行为的问法，命中率立刻不一样。
5.3 改了文件却没重新同步
新增、删除、重命名文件之后，索引不会立刻跟上。尤其是删除文件，旧内容可能还留在索引里，模型引用的就是已经被你删掉的代码。养成改完目录结构就点一次 Resync Index 的习惯，比事后排查省事。
5.4 会话上下文里还挂着旧答案
最后一种最容易被忽略：同一个会话里，前面已经有一轮 jQuery 的回答，后面你再问，模型会顺着自己的旧答案往下编。换会话、换提问措辞，把旧上下文彻底切断，比在原会话里反复纠正有效得多。
6. 收尾：这次调用记没记账，去控制台看一眼
配置改完、索引重同步、authMiddleware.ts能被准确定位之后，建议做一次闭环确认。在 模型对话 里用同一把 Key 发一条测试消息，确认模型 ID 和 Base URL 都对得上；如果你打算把 @Codebase 当日常开发主力，可以顺手看看 Coding Plan 的额度是否够用。
Key 的管理和用量记录都在 控制台 API Keys 里，配完这一轮可以去核对刚才那几次请求有没有记上。除了 Cursor，如果你还在用命令行工具跑同一批模型，接入方式可以参考 Claude Code 接入文档，Base URL 的填法逻辑是一样的。
排障这件事，最怕一上来就改十项设置。把索引问题、通道问题、提问方式问题分三层剥开，每一层留一个可验证的提问，下一次 @Codebase 再甩 jQuery 方案时，你就知道该先看哪一栏了。
