ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

Roo Code 实战:TaoToken 跑通 TypeScript monorepo 修复类型错误

Roo Code 实战:TaoToken 跑通 TypeScript monorepo 修复类型错误 告别海外账号与网络限制稳定直连全球优质大模型限时半价接入中。 点击领取海量免费额度1. 先把目标定清楚让 tsc --noEmit 在 monorepo 里闭嘴Roo Code 是一个跑在编辑器里的 Agent 型编程助手能读文件、改代码、执行终端命令适合处理「跨多个包、需要反复验证」的工程任务。GLM 5.3 Flash 是智谱的轻量快速模型响应快、成本低适合这种需要多轮工具调用的场景。TaoToken 在这里扮演默认供应商的角色你只需要在 Roo Code 里填一个 Key 和一个 Base URL就能把请求打到 GLM 5.3 Flash 上。这篇文章要解决的具体问题是一个用 pnpm workspace 管理的 TypeScript monorepo开启了严格模式strict、noUncheckedIndexedAccess、exactOptionalPropertyTypes 之类tsc --noEmit报了一堆类型错误。手动一个个改太慢我们让 Roo Code 带着 GLM 5.3 Flash 去修修到tsc --noEmit退出码为 0 为止。适合谁看已经在用 pnpm workspace TypeScript被严格模式类型错误卡住想试试 Agent 自动化修复的人。你需要对 TypeScript 类型系统有基本认知能看懂 diff不然 Agent 改错了你也判断不出来。产物很明确一份 Roo Code 配置片段、一段任务 prompt、一份修复文件清单、tsc命令与 diff 摘要。下面按操作顺序来。2. 环境准备与 Roo Code 配置2.1 确认 monorepo 结构假设你的仓库长这样my-monorepo/ ├── pnpm-workspace.yaml ├── package.json ├── tsconfig.base.json ├── packages/ │ ├── core/ │ │ ├── package.json │ │ ├── tsconfig.json │ │ └── src/ │ ├── utils/ │ │ ├── package.json │ │ ├── tsconfig.json │ │ └── src/ │ └── app/ │ ├── package.json │ ├── tsconfig.json │ └── src/tsconfig.base.json里开了严格模式{ compilerOptions: { strict: true, noUncheckedIndexedAccess: true, exactOptionalPropertyTypes: true, noImplicitOverride: true, target: ES2022, module: ESNext, moduleResolution: Bundler, skipLibCheck: true } }先跑一遍看错误规模pnpm -r exec tsc --noEmit如果错误太多先记下总数比如「core 包 12 个、utils 包 8 个、app 包 23 个」。这个数字后面用来验证修复效果。2.2 在 Roo Code 里填 TaoToken打开 Roo Code 的设置面板找到 API Provider 配置。选 OpenAI Compatible 或自定义供应商填两个东西Base URLhttps://taotoken.net/apiAPI Key从 TaoToken 控制台拿模型名填glm-5.3-flash具体模型标识以 TaoToken 控制台模型列表为准不同时期命名可能微调。配置片段大概长这样Roo Code 的 settings JSON 形式字段名以你实际版本为准{ apiProvider: openai, openAiBaseUrl: https://taotoken.net/api, openAiApiKey: sk-你的TaoTokenKey, openAiModelId: glm-5.3-flash, openAiCustomModelInfo: { maxTokens: 8192, contextWindow: 128000, supportsImages: false } }Key 的获取入口在 TaoToken 控制台的 API Keys 页面模型对话入口在模型对话页。这两个页面建议先打开确认模型可用再回 Roo Code 填。注意Base URL 末尾不要多加/v1或斜杠按https://taotoken.net/api原样填。填错会直接 404Roo Code 会提示连接失败。2.3 验证连接Roo Code 里发一句「列出当前工作区根目录的文件」如果它能正常调用工具并返回文件列表说明 Key 和 Base URL 都通了。这一步别跳过不然后面 Agent 跑一半报鉴权错误你会以为是代码问题。3. 任务 prompt 与执行过程3.1 任务 prompt 怎么写Roo Code 的 Agent 模式支持多轮工具调用prompt 要把「目标、约束、验证方式」说清楚。我用的 prompt 是这样的你的任务修复这个 pnpm workspace TypeScript monorepo 里的严格模式类型错误 直到 pnpm -r exec tsc --noEmit 退出码为 0。 约束 1. 不要修改 tsconfig 里的严格模式开关不要用 ts-ignore、ts-expect-error 或 any 绕过。 2. 优先修类型定义和调用处的类型不匹配不要改业务逻辑。 3. 每改完一个包单独跑该包的 tsc --noEmit 验证。 4. 如果某个错误需要跨包改类型先改被依赖的包core、utils再改 app。 5. 每次修改后输出改了哪个文件、改了什么、为什么这么改。 工作目录当前仓库根目录。 验证命令pnpm -r exec tsc --noEmit关键点是第 1 条和第 3 条。不禁止ts-ignore的话Agent 很可能图省事直接压错误tsc是过了但类型安全没了。要求逐包验证是为了让 Agent 每步都有反馈不至于一口气改十几个文件后全乱。3.2 执行过程Roo Code 接到 prompt 后会先跑一次tsc收集错误然后按包逐个处理。GLM 5.3 Flash 在这里的表现是工具调用节奏快读文件、改文件、跑命令的循环很紧凑适合这种「错误多但每个都不复杂」的任务。实际跑下来它先处理了core包。典型错误是noUncheckedIndexedAccess导致的// 修复前 function getFirst(items: string[]): string { return items[0]; // 类型是 string | undefined } // 修复后 function getFirst(items: string[]): string { const first items[0]; if (first undefined) { throw new Error(empty array); } return first; }然后是exactOptionalPropertyTypes导致的// 修复前 interface Config { timeout?: number; } const c: Config { timeout: undefined }; // 报错 // 修复后 const c: Config {}; // 不传就是 undefinedapp包的错误最多主要是跨包调用时类型没对齐。Agent 会先看core和utils导出的类型再改app里的调用处。3.3 修复文件清单跑完后Roo Code 会给出修改过的文件列表。我这次的实际清单包文件错误类型coresrc/array.tsnoUncheckedIndexedAccesscoresrc/config.tsexactOptionalPropertyTypesutilssrc/parse.tsstrictNullChecksutilssrc/format.tsnoImplicitOverrideappsrc/api/client.ts跨包类型不匹配appsrc/store/index.tsstrictNullChecksappsrc/components/List.tsxnoUncheckedIndexedAccess七个文件不算多。如果错误上百个建议分批让 Agent 处理一次一个包避免上下文太长导致它忘记约束。4. 验证结果与失败分支4.1 验证命令修完后跑pnpm -r exec tsc --noEmit echo $?退出码 0 就是通过。如果还有错误tsc会打印出来把输出贴回 Roo Code 让它继续修。diff 摘要可以用git diff --stat我这次的输出大概是packages/app/src/api/client.ts | 18 ---- packages/app/src/components/List.tsx | 12 ---- packages/app/src/store/index.ts | 9 --- packages/core/src/array.ts | 15 --- packages/core/src/config.ts | 6 -- packages/utils/src/format.ts | 8 -- packages/utils/src/parse.ts | 11 --- 7 files changed, 58 insertions(), 21 deletions(-)改动量不大说明 Agent 没有大改逻辑主要是补类型守卫和调整可选属性。4.2 失败分支几种常见失败情况Agent 用了ts-ignore。检查 diff 里有没有ts-ignore或as any。有的话在 prompt 里再强调一遍或者手动回滚那个文件让它重改。跨包类型改了但没同步。比如core导出的类型改了app里没跟着改tsc还是报错。这时候把错误输出贴回去让它继续。上下文超限。错误特别多的时候Agent 可能改到一半忘了前面的约束。解决办法是分而治之先cd packages/core pnpm exec tsc --noEmit只让它在 core 目录里修修完再进下一个包。模型返回格式不对。偶尔 GLM 5.3 Flash 会输出非工具调用的纯文本Roo Code 会提示解析失败。重发一次通常就好或者把 prompt 缩短一点。5. 成本、模型选择与限制5.1 成本GLM 5.3 Flash 是轻量模型按 token 计费具体单价以 TaoToken 官网和控制台为准。这个任务跑了大概十几轮工具调用每轮读文件、改文件、跑命令token 消耗主要在文件内容和命令输出上。monorepo 越大、错误越多消耗越高。想控制成本两个办法一是分批处理一次一个包减少单次上下文二是先让 Agent 只读不写列出修复计划你确认后再让它动手。5.2 模型选择GLM 5.3 Flash 适合这种「错误多但每个都不复杂」的批量修复。如果遇到需要深度推理的类型体操比如复杂的泛型推导、条件类型嵌套Flash 可能会改错这时候换更强的模型更稳。Roo Code 里可以随时切模型不用改 Base URL。TaoToken 作为供应商的好处是你可以在同一个 Key 下切换不同模型不用为每个模型单独配一套鉴权。模型列表和可用性以 TaoToken 控制台为准。5.3 限制Agent 修类型错误不是万能的。它擅长的是补 null 检查、调整可选属性、对齐跨包类型、加类型守卫。它不擅长的是重构类型架构、处理复杂的泛型约束、判断业务逻辑上某个类型到底该是什么。所以修完后一定要自己看 diff。特别是app包里涉及业务逻辑的地方Agent 可能为了过类型检查改了一个判断条件这个改动类型上没问题但业务上可能是错的。另外tsc --noEmit通过不等于运行时没问题。类型是编译期的约束运行时行为还得靠测试。修完类型后跑一遍单元测试和集成测试确认没改坏东西。最后一步把pnpm -r exec tsc --noEmit加到 CI 里以后每次提交都跑。这样类型错误不会积累下次也不用一次性修这么多。 告别海外账号与网络限制稳定直连全球优质大模型限时半价接入中。 点击领取海量免费额度
返回列表