用途:诊断 Module Federation 项目中的类型问题,覆盖三类场景:生产者类型文件生成失败(TYPE-001)、消费者未拉取远程类型、tsconfig 未配置远程类型路径映射。
主要能力:先调用 mf-context 技能收集 MFContext,再将其序列化为 JSON 传给检查脚本:node scripts/type-check.js --context '<MFContext-JSON>'。随后按输出 results 数组中的 scenario 字段执行对应修复方案。
使用方式:
- TYPE_GENERATION_FAILED:若 enhancedVersion > 2.0.1,读取 .mf/diagnostics/latest.json 获取错误信息与临时 TS 配置路径,用 npx tsc --project <tmp-tsconfig> 复现并修复;若版本较旧,请用户运行 npx mf dts 或提供含临时配置路径的报错信息。可临时用 "skipLibCheck": true 规避。
- TYPES_NOT_PULLED:@mf-types 缺失时,用 mf-module-info 获取远程类型文件 URL(@mf-types.zip),按 URL 可达性判断是生产者未生成/未部署类型,还是 tsconfig 问题。
- TSCONFIG_PATHS_MISSING:在 tsconfig.json 的 compilerOptions.paths 中加入 "": ["./@mf-types/"],合并而非覆盖已有映射,再用 npx tsc --noEmit 验证。
- ENV_INCOMPLETE:缺少 tsconfig.json 时提示创建并配置 paths;缺少 typescript 时提示安装 pnpm add -D typescript。
限制:该技能只做配置与依赖层面的检查,仅在获得有效临时 TS 配置路径时才运行 npx tsc,不会盲目对整个项目执行 tsc。具体版本兼容与更多细节以官方文档为准。