1. 代码里的 TODO 越攒越多Todo Tree 把它们拉回视野写代码时随手敲下的// TODO: 这里要加缓存、// FIXME: 并发下会丢数据过两周自己都忘了在哪。项目一大靠 CtrlShiftF 全局搜 TODO结果把 node_modules 和打包产物里的注释也翻出来噪音比信号还多。我试过在十几个文件里手动翻找待办最后干脆放弃等线上出问题才想起来「哦当时标过」。Todo Tree 解决的就是这件事它扫描工作区里的注释标签把散落各处的 TODO、FIXME、HACK、NOTE 聚合成侧边栏一棵可点击的树点一下直接跳到对应行。它是什么一个 VSCode 插件读取你定义的标签规则实时维护一份待办清单。能做什么集中展示、按标签分组、按文件路径折叠、点击跳转、还能在树里直接改。适合谁任何在代码里写注释待办的开发者尤其是同时维护多个模块、待办跨文件跨目录的人。但光有清单还不够。清单上写着「补全这个函数」「给这段逻辑加注释」你还得切到浏览器或另一个 AI 工具去处理Key 散落在各个插件配置里换一个工具就要重新填一遍。所以这篇把两件事合在一起用 Todo Tree 管待办用 TaoToken 统一 AI 调用的 Key 和 API 通道让「看到待办」和「顺手让 AI 处理」在同一个编辑器里完成。下面从安装讲到可复制配置再到验证请求最后把常见报错挨个排掉。2. 安装 Todo Tree 并接入 TaoToken 的前置准备先说 Todo Tree 的安装这一步没有坑。打开 VSCode左侧活动栏点扩展图标搜索框输入Todo Tree认准作者 Gruntfuggly 那个点安装。装完侧边栏会多一个树形图标默认快捷键没有你可以后面自己绑。装好后随便打开一个有// TODO注释的文件侧边栏就能看到条目说明插件已经在工作。接下来是 TaoToken 的前置。TaoToken 在这里扮演的角色是「统一的 AI 调用入口」你不再给每个 AI 插件单独配一家厂商的 Key而是把 Base URL 指向 TaoToken 的 API 地址Key 用 TaoToken 生成的模型 ID 按需选。这样 Todo Tree 旁边挂的 AI 辅助工具无论是补全还是生成注释都走同一条通道换模型只改一个 Model ID。你需要准备三样东西我把它叫「三件套」后面配置里反复出现项目值说明Base URLhttps://taotoken.net/api所有兼容 OpenAI 协议的客户端填这个API Key在控制台生成形如sk-...只显示一次复制存好Model ID按需选择例如对话/补全类模型填控制台里列出的准确 ID获取 Key 的路径打开 TaoToken 控制台进入 API Keys 页面新建一个 Key复制。注意 Key 只在创建时完整显示关掉页面就看不到了所以先粘到安全的地方。模型 ID 在文档或控制台的模型列表里能查到填的时候要一字不差大小写和连字符都算。注意Base URL 填https://taotoken.net/api不要自己加/v1或结尾斜杠具体以接入文档为准。不同客户端对路径拼接方式不一样多一个斜杠就可能 404。前置做完你手里应该有装好的 Todo Tree、一个 TaoToken Key、一个确认存在的 Model ID。下面进入配置环节先配 Todo Tree 的标签规则再配 AI 工具的 Base URL。3. 可复制的 settings.json 配置与标签自定义规则Todo Tree 的全部行为都通过 VSCode 的settings.json控制。打开方式CtrlShiftP 输入Open User Settings (JSON)或者在工作区建.vscode/settings.json只对当前项目生效。我建议先放用户设置里全局可用。下面这段可以直接复制我按「标签规则 树展示 高亮」三块拆开注释{ todo-tree.general.tags: [ TODO, FIXME, HACK, NOTE, BUG ], todo-tree.general.tagGroups: { 待处理: [TODO, FIXME, BUG], 说明类: [NOTE, HACK] }, todo-tree.highlights.defaultHighlight: { foreground: #ffffff, background: #ff6b6b, type: text }, todo-tree.highlights.customHighlight: { TODO: { background: #4dabf7, icon: check }, FIXME: { background: #ff6b6b, icon: flame }, NOTE: { background: #51cf66, icon: book } }, todo-tree.tree.showCountsInTree: true, todo-tree.tree.groupedByTag: false, todo-tree.tree.expanded: true, todo-tree.filtering.excludeGlobs: [ **/node_modules/**, **/dist/**, **/build/**, **/.git/** ], todo-tree.regex.regex: (//|#|!--|;|/\\*|^|^\\s*(-|\\d.))\\s*($TAGS) }逐块解释。general.tags是你认可的标签集合只有写进这里的词才会被扫描。tagGroups把标签分组侧边栏可以按组折叠比如「待处理」一组、「说明类」一组一屏看清轻重缓急。highlights控制编辑器里的高亮颜色TODO 用蓝色、FIXME 用红色、NOTE 用绿色扫一眼就知道性质。excludeGlobs是关键把 node_modules、dist、build 排除掉否则树里全是依赖包的注释根本没法看。最后regex.regex定义匹配模式$TAGS会被替换成你上面定义的标签前面的(//|#|!--...)覆盖了 JS、Python、HTML、Shell 等常见注释前缀。配完保存侧边栏的 Todo Tree 会立刻刷新。如果没刷新点树顶部的刷新按钮或者 CtrlShiftP 执行Todo Tree: Refresh。Todo Tree 配好后接着把 AI 工具的 Base URL 改到 TaoToken。以常见的 OpenAI 兼容客户端为例配置文件通常长这样路径按你实际用的工具放这里给通用结构{ baseURL: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: 你的ModelID }如果你用的是 Claude Code 这类工具配置走环境变量或它自己的 settings 文件核心三件套不变Base URL 填https://taotoken.net/apiKey 填 TaoToken 的Model ID 填控制台里的准确值。Cline、Continue 这类 VSCode 内的 AI 插件在设置里找 Provider 选 OpenAI Compatible然后把上面三个值填进去。Codex 的auth.json同理把 base URL 和 key 换成 TaoToken 的。注意改完配置一定要重启对应的 AI 插件或重载窗口CtrlShiftP → Reload Window很多插件只在启动时读一次配置不重启不生效。4. 验证请求从 Todo Tree 跳转到 AI 调用成功配置写完不算完得验证两件事Todo Tree 能不能正确聚合AI 通道能不能通。先验 Todo Tree。在任意文件里写一行// TODO: 验证 Todo Tree 聚合保存。侧边栏应该立刻出现这条点它能跳到该行编辑器里该行有蓝色高亮。再写一行// FIXME: 验证分组看它是否归到「待处理」组。如果没出现检查general.tags里有没有这个词以及文件是否被excludeGlobs排除了。再验 AI 通道。最直接的办法是用 curl 打一次 TaoToken 的接口确认 Key 和 Base URL 没问题curl https://taotoken.net/api/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -d { model: 你的ModelID, messages: [ {role: user, content: 用一句话解释什么是 TODO 注释} ] }返回里如果能看到choices数组和一段正常回复说明通道通了。这一步很关键它把「Key 对不对」「Base URL 对不对」「Model ID 存不存在」三个问题一次性验证掉。如果返回 401是 Key 问题返回 404多半是 Base URL 路径写错返回模型不存在的错误是 Model ID 填错。curl 通了之后回到 VSCode 里的 AI 插件触发一次补全或让它生成注释。比如选中一段没有注释的函数让 AI 生成注释看它是否正常返回。如果插件报错但 curl 是通的问题在插件配置不在 TaoToken。实测下来把 Todo Tree 和 AI 工具并排放在侧边栏工作流是这样的Todo Tree 里看到// TODO: 给 parseConfig 加边界检查点过去选中函数让 AI 生成检查逻辑或注释处理完把 TODO 删掉树里这条自动消失。一屏之内完成「发现—处理—销账」。5. 常见报错排查401、local proxy failed、reading choices、OAuth配置过程中最容易撞的几个错我按真实报错逐个拆。401 Unauthorized。这是 Key 的问题。先确认 Key 复制完整没有多余空格或换行。再确认请求头格式是Authorization: Bearer sk-...Bearer 和 Key 之间一个空格。如果 Key 是在别的工具里能用的唯独这里 401检查是不是把 Key 填到了错误的字段比如填成了 model 字段。还有一种情况Key 被删了或过期了去控制台重新生成一个。local proxy failed / connection refused。这个报错通常出现在客户端试图走本地代理但本地没有代理服务在跑。检查你的客户端配置里有没有proxy字段指向127.0.0.1:某端口如果有删掉它让请求直连https://taotoken.net/api。另外确认 Base URL 没有写成http://开头必须是https://。reading choices / cannot read property choices of undefined。这个错说明客户端拿到了响应但响应结构里没有choices字段它按 OpenAI 格式去读读不到就崩。原因通常是 Base URL 路径不对请求打到了别的端点返回了一个 HTML 错误页或另一种 JSON。把 Base URL 严格设成https://taotoken.net/api不要自己拼/v1/chat/completions让客户端按它的约定去拼。如果客户端要求填完整端点就填https://taotoken.net/api/chat/completions以接入文档为准。OAuth 相关报错 / 登录失败。有些 AI 工具默认走 OAuth 登录流程而不是 API Key。如果你要用 TaoToken 的 Key得在工具设置里把认证方式从 OAuth 切成 API Key然后填三件套。切完重启插件。如果工具不支持 API Key 模式那它就没法接 TaoToken换一个支持 OpenAI 兼容协议的客户端。排查顺序建议固定下来先 curl 验通道再验插件配置最后看插件日志。VSCode 里按 CtrlShiftP 执行Developer: Open Webview Developer Tools或看输出面板里对应插件的日志能看到真实的请求 URL 和响应体比猜快得多。注意任何报错里如果出现「代理」「proxy」字样先检查是不是客户端自带的代理设置而不是网络环境问题。把客户端里的 proxy 配置清空直连 TaoToken 的 API 地址。6. 把待办清单和 AI 调用收进同一条工作流Todo Tree 的价值不只是「看到待办」而是让待办变成可执行的动作。配合 TaoToken 统一通道后你可以在侧边栏看到// FIXME: 这里没处理空数组点过去选中代码让 AI 补上边界判断改完删掉标签树里自动少一条。整个过程不离开编辑器不用切浏览器不用在多个 Key 之间倒腾。几个实用技巧。第一给 Todo Tree 绑个快捷键比如CtrlAltT一键展开收起清单。第二用tagGroups把「必须修」和「有空再看」分开FIXME 和 BUG 归一组NOTE 和 HACK 归另一组优先级一目了然。第三AI 工具的 Model ID 可以按任务切换生成注释用轻量模型重构逻辑用强一点的模型只改配置里的一个字段Base URL 和 Key 不动。如果你还没生成 TaoToken 的 Key去控制台建一个顺手把接入文档过一遍确认 Base URL 和 Model ID 的准确写法。需要长期在编辑器里跑 AI 补全和 Agent 任务的可以看下 Coding Plan把调用额度规划好避免写到一半断掉。通道通了之后Todo Tree 管「要做什么」TaoToken 管「用什么做」两件事在同一个窗口里闭环。