看到 labuladong 官网新上线了「初学读者题单」和「速成读者题单」,我的 vscode 左侧却一直没出现「速成读者题单」。按官方说法,vscode 插件版本要 >= v3.0.0 且登录网站后,题单才会显示。第一反应是去插件市场核对版本,但版本号、登录状态、题单入口这三件事容易绕晕。这次我换了条路线:先打开 TaoToken 创建 API Key,把 Codex 的 Base URL 指到 TaoToken,再让 Codex 照着官方说明帮我列出检查步骤。整个过程里,TaoToken 不负责渲染插件列表,它只做一件事:给 Codex 提供可用的 API Key。Codex 也不会直接改动你的 vscode 插件,而是根据你贴过去的官方说明和本机信息,生成核对命令和升级路径。你只需要把命令在本地跑一下,再把输出贴回对话,就能定位问题。下面把我的排障过程完整写下来。
1. 左侧没有「速成读者题单」:先分清版本、登录和入口
1.1 我遇到的具体现象
labuladong 官方公告说,vscode 插件版本 >= v3.0.0 且登录网站后,「初学读者题单」和「速成读者题单」会在左侧显示;Jetbrains 插件则在左侧筛选栏出现 QuickMaster 和 Beginner。我的 vscode 插件已经是 v3.0.0 以上,左侧还是只有之前的算法目录,没有题单入口。于是第一反应是去插件市场看是不是没更新,但插件市场显示“最新版本”,再点进去看详情页,版本号没变。
1.2 问题可能出在三处
第一,vscode 窗口没重载,插件更新后需要重启或执行“重新加载窗口”才能读到新功能。第二,虽然插件版本够了,但网站登录态过期,插件不知道你登录了哪个账号,题单入口就不显示。第三,左侧目录树和题单列表可能折叠在两个不同的面板里,需要展开看看。为了不瞎猜,我把官方说明和我的实际版本信息整理成一段文字,交给 Codex 判断。
2. 给 Codex 配上 TaoToken:从创建 Key 到填写 Base URL
2.1 在 TaoToken 官网创建 API Key
打开 TaoToken 注册账号,进入控制台的 API Keys 页面,点“创建新 Key”,复制后保存到本地。注意 Key 只显示一次,页面刷新后就看不到完整值了。如果丢了下一次需要重新生成。这个 Key 后面要填进 Codex 的环境变量,所以先放在一个临时文件里,方便核对。
2.2 配置 Codex 读取 TaoToken 的兼容通道
Codex 默认直连 OpenAI,要改走 TaoToken,需要在~/.codex/config.toml里加一个 model_provider。编辑文件,在[model_providers]下面新增一项,指向https://taotoken.net/api,环境变量用TAOTOKEN_API_KEY。不要在这里加/v1,TaoToken 的 Base URL 是https://taotoken.net/api,不是https://taotoken.net/api/v1。
# ~/.codex/config.toml model = "你的模型ID" # 以 TaoToken 模型广场为准 model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY"然后在终端设置环境变量:
export TAOTOKEN_API_KEY=YOUR_API_KEY注意:YOUR_API_KEY是从 模型广场 创建的那把 Key,不要照抄这里的占位符。如果你用了 zsh,可以把 export 写进~/.zshrc,避免每次重开终端都设置一遍。
2.3 验证 Codex 通路是否已通
保存配置后,先运行一条最简单的指令,比如在终端执行codex,输入“用 Python 写一个读取 json 文件的函数”。如果它能正常返回代码,说明 Key、Base URL、模型 ID 三要素都填对了。如果报 401,优先检查 Key 是否多复制了空格;如果报 404,优先检查模型 ID 是否写成了其他家的命名,去 TaoToken 模型广场复制官方 ID。
3. 让 Codex 辅助核对 vscode 插件版本和升级步骤
3.1 准备一份“官方说明 + 本机现状”的对话素材
Codex 没有直接读取你 vscode 插件的能力,所以你要把素材贴给它。我的做法是:从 labuladong 官网复制插件升级公告里关于版本和登录的描述,再在 vscode 的扩展面板复制插件版本号,一起丢给 Codex。为了让 Codex 更清楚,我写了一段提问模板。
3.2 给 Codex 的提问模板
我在 vscode 中使用 labuladong 插件,左侧看不到「速成读者题单」。 官方说明:vscode 插件版本 >= v3.0.0 且登录网站后,题单在左侧显示。 我当前插件版本是 X.Y.Z(请替换为实际版本),已经登录网站,但左侧没有题单。 请分步骤教我排查,重点包括: 1) 怎么看这个插件的实际版本而不是插件市场显示的最新版本; 2) 如何确认插件是否已成功登录网站; 3) 如果版本低于 v3.0.0,在 Windows 和 macOS 上分别怎么升级; 4) 升级后需要执行什么操作才能让新入口生效。3.3 根据回复执行本地操作
Codex 会输出一版检查步骤,大概率包含:打开 vscode 扩展面板、查看 labuladong 插件条目下的版本号;执行Developer: Reload Window重载;在插件里重新登录一次。这些命令都要你在 vscode 里手动执行,Codex 只负责解释和对照。执行完把结果贴回对话,让它继续判断是版本问题还是登录态问题。这一步是安全的,Codex 不会也不能远程改你的 vscode。
4. 验证调用、看用量,以及刷题顺序提醒
4.1 去 TaoToken 对一下这次调用是否记上了
Codex 成功回答问题后,打开 TaoToken 控制台,在用量记录里应该能看到刚才的一次请求。如果记录为空,说明 Codex 并没有真的走 TaoToken,检查config.toml里base_url是不是写成了https://taotoken.net/api/v1,或者环境变量没生效。这一步能确认是 Key 的问题还是配置的问题,不用靠猜。
4.2 在模型对话里用同一把 Key 测一条消息
如果不想开终端,可以在 TaoToken 模型对话 里用同一把 Key 发一条消息,确认 Key 有效。这样能区分“Key 问题”和“Codex 配置问题”。长期刷题的读者可以看 Coding Plan,新 Key 在 控制台 API Keys 创建。
4.3 题单显示后的正确打开方式
按 labuladong 的说法,“初学读者题单”和“速成读者题单”里的题目都配有解题思路、Java/C++/Python/JavaScript/Golang 解法代码和算法可视化。但他也提醒,最好先把网站算法框架过一遍,形成自己的解题方法论,再用题单复习巩固。直接对着题单硬刷,效率低,效果也会打折扣。我在前面修复插件时顺便把这句话抄进了笔记,提醒自己别贪快。
4.4 如果还查不出来
如果 Codex 给出的步骤都做完了,题单还是不出现,可以换一种问法:把 vscode 的“开发者工具”控制台报错信息(可能涉及插件启动异常)复制给 Codex,让它分析是否是插件和 vscode 版本兼容问题。到这里,排障就回到了“描述现象 → 让 Codex 给命令 → 本地执行 → 回贴结果”的循环里。TaoToken 在这条路上只负责 Key 和 API 通道,不替代插件本身。如果你也卡在题单不显示,不妨按这个方法试一次。