用途:为 TypeScript 项目提供类型设计、编译器诊断排查、tsconfig 与模块解析、声明生成(declaration emit)、JavaScript 迁移及版本升级方面的指导。资料称其内容对照 2026-08-29 的 TypeScript 7.0.2 检查,并提示“最新”应以官方发布为准。
主要能力与工作方式:先检查 package.json、锁文件、所有适用的 tsconfig*.json 及其 extends 链,再给建议;确认失败命令实际使用的编译器,因为 vue-tsc、svelte-check、Angular、Astro、MDX 等可能内嵌或限定不同 TypeScript 版本;用项目现有脚本和本地依赖复现诊断,不擅自下载最新编译器;用最小且不改变运行时行为的改动修复最早的根因,并汇报编译器版本、命令、结果及遗留限制。
决策规则:局部值优先推断,公共边界按需标注;不可信值以 unknown 接收并在运行时校验收窄;状态用可辨识联合,有限调用面用重载,泛型仅在保持真实输入输出关系时使用;把 as、非空断言、any、@ts-ignore 等视为需调查的信号;@ts-expect-error 仅用于有意且有测试的负向用例。不要为通过类型检查而改变运行时行为,不要单独推荐编译器标志,module、moduleResolution、target、lib、emit 与文件选择应作为整体匹配实际运行时或打包器;保留框架生成的选项与项目引用,不要用通用模板替换现有 tsconfig;为库验证声明生成与消费方模块解析。
验证方式:优先运行仓库脚本(如 typecheck)。否则通过检测到的包管理器调用已安装二进制:npm exec -- tsc --noEmit;pnpm exec tsc --noEmit;yarn exec tsc --noEmit;bun run tsc --noEmit。加 --noEmit 前需确认项目是否依赖声明或 JavaScript 输出;构建模式、项目引用、框架项目或声明库应使用现有构建命令。
限制:资料未提供计费、平台支持范围或具体使用步骤;升级时须阅读现代 TypeScript 发布说明,TypeScript 7 尚无稳定编程 API,并非所有内嵌 TypeScript 的工具都可直接替换,官方 7.0 指导要求下部分工具应保持在 TypeScript 6。