用途:指导使用 pnpm workspaces 搭建与组织 TypeScript 多包仓库,覆盖微服务、Web 应用、移动应用和共享库的目录结构、构建编排与开发环境。涉及新项目初始化、packages 目录划分、共享库(common、node-common、react-common)配置、ES 模块路径别名、集中式配置(TypeScript、ESLint、Vitest)及 Docker Compose 编排。
主要能力:按包类型给出依赖层级(common → node-common → node-{service};common → react-common → react-{app}/mobile-app);用根 package.json、pnpm-workspace.yaml(含 catalog 版本统一)、tsconfig.json 项目引用协调构建顺序;使用 #src/* 路径别名在编译与运行时均可解析;用 workspace:* 声明内部依赖、catalog: 统一版本;通过 compose.yml 与 Traefik 提供开发环境。
使用方式与限制:命令保持原样,如 pnpm install、pnpm build、pnpm test、pnpm -r build、tsc -b、tsc -p ./tsconfig.build.json、tsc-alias -p ./tsconfig.build.json、docker compose up -d。仅适用于 pnpm 与 TypeScript;单包项目、Yarn/npm workspaces、非 TypeScript 仓库或已有不同约定的仓库不适用。资料还列出循环依赖、缺少 .js 扩展名、catalog 版本漂移等常见问题与排查方法。具体收费与价格暂未提供。