用途:为 JARVIS AI Assistant 代码库(含 Vue 组件、API 路由、3D 渲染与状态管理)提供 TypeScript 类型安全开发规范,风险等级标注为 MEDIUM。
主要能力:严格模式编译配置(strict、noUncheckedIndexedAccess、noImplicitOverride、exactOptionalPropertyTypes 等);用 Zod 做外部数据运行时校验;品牌类型区分 UserId、SessionId、CommandId;可辨识联合建模状态机;泛型约束的 HUD 指标组件;类型守卫收窄 unknown;DeepReadonly 等工具类型;记忆化、懒加载、防抖节流、Map/Set 查找、Promise.all 并行等性能模式;以及避免类型断言、any、忽略空值等安全反模式。
使用方式:按 TDD 先写失败测试,再最小实现、重构,最后运行 npx vitest run、npx eslint . --ext .ts,.tsx、npx tsc --noEmit 验证。推荐依赖 typescript ^5.3.0、zod ^3.22.0、@types/node ^20.0.0。
适用场景:JARVIS 系统数据接口定义、外部输入校验、可复用 HUD 组件、状态机与错误处理。
限制:TypeScript 类型在运行时消失,所有外部数据边界必须做运行时校验;资料未提供具体安装命令、收费信息或平台支持范围。