告别海外账号与网络限制稳定直连全球优质大模型限时半价接入中。 点击领取海量免费额度1. 仓库级代码审查为什么值得用 Roo Code 跑一遍Roo Code 是一个跑在编辑器里的 Agent 型编程助手它和普通补全工具最大的区别在于它能读取整个仓库的文件树、按需打开多个文件、执行终端命令然后基于这些上下文给出跨文件的判断。这意味着你可以让它做一件补全工具做不到的事——仓库级代码审查。我这次的目标很具体拿一个本地 FastAPI 仓库让 Roo Code 做两件事。第一检查依赖是否固定requirements 里有没有锁版本、有没有用范围符号埋雷第二检查错误处理是否规范异常有没有被吞、HTTPException 用得对不对、有没有裸 except。这两类问题单看一个文件往往看不出来必须结合路由层、服务层、依赖声明一起看正好是 Agent 的强项。适合谁看已经写过 FastAPI 项目、想让 AI 帮忙做一轮系统性检查、但不想把代码传到不确定环境里的开发者。默认供应商我们填 TaoToken模型选 GLM 5.3 Flash理由是审查任务对推理深度要求中等、对吞吐和成本敏感Flash 档位比较合适。下面按「先拿 Key → 配 Roo Code → 写审查 prompt → 看输出报告 → 处理失败分支」的顺序走一遍。2. 先拿到 Key再决定审查模型2.1 获取 API Key打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_generateutm_mediumcsdnutm_campaigngenerateutm_content 注册登录后进入控制台。左侧菜单找到 API Keys 页面新建一个 Key。建议按用途命名比如roo-code-review方便以后区分是哪个工具在用。创建后立刻复制保存页面刷新后通常不再完整显示。这个 Key 就是后面填进 Roo Code 的凭证。2.2 确认 Base URL 和模型名TaoToken 的 API 入口是 https://taotoken.net/api 注意这里不带任何查询参数配置时原样填入即可。模型名填glm-5.3-flash具体以控制台模型列表显示为准不同时间上架的命名可能微调。提示模型名和 Base URL 是两个独立字段填错任意一个都会导致请求失败。建议先在控制台确认模型可用再回到编辑器配置。2.3 为什么审查任务选 Flash 档代码审查的典型调用模式是「读多个文件 → 汇总判断 → 输出结构化报告」单次上下文可能上万 token但推理链不算特别长。Flash 档在延迟和价格上更适合这种批量读取场景。如果你要审查的是安全敏感模块可以临时切到更强的推理模型但日常仓库巡检用 Flash 足够。3. 在 Roo Code 里接入 TaoToken3.1 安装与打开设置在 VS Code 扩展市场搜索 Roo Code 安装。安装完成后侧边栏会出现图标点击进入再点右上角齿轮进入设置。Provider 列表里选择兼容 OpenAI 协议的自定义选项通常叫 OpenAI Compatible 或类似名称。3.2 填写三个关键字段在设置面板里填字段填写内容Base URLhttps://taotoken.net/apiAPI Key你在控制台创建的那串 KeyModelglm-5.3-flash保存后Roo Code 会尝试拉取模型列表或直接发一次探测请求。如果设置页显示模型可用说明接入成功。3.3 用一条命令验证连通性在配置完成但还没开始审查前我习惯先用 curl 单独验证一次排除编辑器层面的干扰curl https://taotoken.net/api/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -d { model: glm-5.3-flash, messages: [ {role: user, content: 回复两个字连通} ] }返回里能看到choices字段和正常内容就说明 Key、Base URL、模型名三者都对。这一步能省掉后面很多「到底是网络问题还是配置问题」的排查时间。3.4 打开仓库并确认工作区用 VS Code 打开你的 FastAPI 仓库根目录确保requirements.txt或pyproject.toml在根层级可见。Roo Code 的仓库级能力依赖工作区根目录如果打开的是子目录它可能读不到依赖声明文件。4. 审查 prompt 模板与执行过程4.1 审查 prompt 模板在 Roo Code 对话框里粘贴下面这段。它的结构是「角色 范围 两类检查项 输出格式」这样模型不会漫无目的地读文件你是一名 Python 后端代码审查员。请审查当前工作区的 FastAPI 仓库 只关注以下两类问题不要扩展到性能优化或架构重构。 第一类依赖固定 - 检查 requirements.txt / pyproject.toml 中每个依赖是否锁定了具体版本 - 标出使用了 、~、^ 等范围符号的条目 - 标出没有出现在任何依赖文件里、但代码中 import 了的第三方包 第二类错误处理 - 找出裸 except 或 except Exception 后直接 pass 的位置 - 检查路由函数中 HTTPException 的 status_code 是否与语义匹配 - 检查数据库/外部调用失败时是否有回滚或补偿逻辑 - 标出把内部异常信息直接返回给客户端的写法 输出要求 1. 先给一个总览表列为文件路径 | 问题类型 | 严重级别(高/中/低) | 一句话描述 2. 再对每个「高」级别问题给出代码片段和修改建议 3. 如果某类问题没有发现明确写「未发现」不要编造4.2 执行时会发生什么发出后Roo Code 会先列出仓库文件树然后按需打开requirements.txt、main.py、各个routers/下的文件。你会在对话里看到它一步步读取文件、记录发现。这个过程可能需要你点几次「批准」让它继续读取。如果仓库文件很多建议先在 prompt 里加一句「只审查 routers 和 services 目录」缩小范围能明显加快速度。4.3 一个输出报告样例审查完成后Roo Code 给出的报告大致长这样以下为结构示例实际内容取决于你的仓库## 审查总览 | 文件路径 | 问题类型 | 严重级别 | 描述 | | --- | --- | --- | --- | | requirements.txt | 依赖固定 | 高 | fastapi 使用 0.100 未锁版本 | | requirements.txt | 依赖固定 | 中 | httpx 未出现在依赖文件中 | | app/routers/user.py | 错误处理 | 高 | except Exception 后 pass吞掉数据库异常 | | app/routers/order.py | 错误处理 | 中 | 500 错误直接返回 str(e) | | app/services/pay.py | 错误处理 | 低 | 外部调用失败无重试 | ## 高优先级问题详情 ### 1. requirements.txt 版本未锁定 当前写法 fastapi0.100 建议改为 fastapi0.115.0 原因范围符号会导致不同环境安装到不同版本审查和线上行为可能不一致。 ### 2. app/routers/user.py 吞异常 当前写法 try: user await db.get_user(uid) except Exception: pass 建议至少记录日志并返回明确的 HTTPException避免请求静默失败。拿到这份报告后你可以直接按文件路径去改也可以把某一条再丢回 Roo Code 让它生成补丁。5. 可验证结果与失败分支5.1 怎么确认审查真的生效验证方式很简单故意在仓库里加一行fastapi0.100重新跑一次 prompt看报告里是否出现这条。如果出现了说明依赖检查逻辑在工作。再故意写一个except Exception: pass看错误处理检查是否命中。两次都能命中这套流程就是可复现的。5.2 常见失败分支401 未授权Key 填错或已删除。回到控制台 API Keys 页面重新生成注意不要有多余空格。404 模型不存在模型名拼错或该模型当前未在你的账号下开放。以控制台模型列表为准不要凭记忆填。只读了一个文件就结束prompt 范围太宽或仓库太大模型提前收尾。把审查范围缩小到具体目录或在 prompt 里要求「必须读取 routers 下所有 .py 文件后再输出」。报告里出现不存在的文件路径模型幻觉。遇到这种情况要求它「只引用你实际读取过的文件并列出读取记录」可以显著减少编造。请求超时仓库文件过多导致上下文过大。分批审查先依赖文件再路由文件最后服务层文件。5.3 成本与模型选择审查一个中等规模 FastAPI 仓库约 30 个 Python 文件单次全量审查的 token 消耗通常在几万到十几万之间具体取决于文件大小和模型读取策略。Flash 档的价格相对低适合反复跑。如果你要审查的是支付、鉴权这类核心模块可以临时换成推理更强的模型代价是单次成本上升、速度变慢。模型和价格会调整实际以官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_generateutm_mediumcsdnutm_campaigngenerateutm_content 控制台显示为准。长期高频使用的话可以看看 Coding Plan 是否比按量计费更划算入口在官网导航里。最后说一个我踩过的坑第一次跑审查时我没限制范围模型把测试文件也读了一遍报告里混进一堆测试代码的「问题」反而淹没了真正的依赖和异常处理项。后来在 prompt 里明确「排除 tests 目录」报告质量立刻上来了。审查范围这件事宁可窄一点分多次跑也不要一次铺太开。 告别海外账号与网络限制稳定直连全球优质大模型限时半价接入中。 点击领取海量免费额度