21 lines (18 loc) · 670 Bytes

UltraVibe 项目开发公约

技术栈

语言: TypeScript 5.5+
运行时: Node.js 20+
包管理: npm
测试框架: Vitest
代码风格: 遵循 tsconfig.json strict 模式

禁止使用

eval() / Function() 动态执行
any 类型（除非外部 API 无法避免）
@ts-ignore / @ts-expect-error（除非有明确理由并注释说明）
process.env 直接引用（应通过配置中心读取）
console.log 残留（正式代码使用 logger）

模块规范

每个模块职责单一，不跨层调用
公共类型定义在 types.ts 中集中管理
所有文件使用 UTF-8 编码，无 BOM
函数必须有显式返回类型注解