生成时间: 2026-05-11 基于 Go 参考项目规格适配 TypeScript/Express 实现 版本: 1.0.0 批准日期: 2026-05-11
所有规范文档中的声明必须能追溯到实际源代码。当文档与代码不一致时，以代码为准。不确定的行为标记为 [NEEDS CLARIFICATION]，而非猜测。
系统采用 TypeScript 模块级别的模块化设计。每个模块拥有明确的单一职责：
src/config/ 仅负责配置加载与校验src/routes/ + src/middleware/ 仅负责 HTTP 请求路由、认证与转发src/proxy/ 仅负责反向代理的创建与请求转发src/types/ 仅负责数据结构定义与 Zod Schemasrc/logger/ 仅负责日志器初始化src/utils/ 提供 无状态 的工具函数新功能应归入最合适的现有模块，或创建新模块，避免跨职责耦合。
所有路由行为由配置文件（JSON/YAML）驱动，包括：
配置优先级：命令行参数 > 环境变量 > .env 文件 > 配置文件 > 默认值。 配置文件使用 Zod Schema 校验，确保类型安全。
所有请求和响应必须有结构化日志记录。敏感信息（API 密钥）必须脱敏处理。日志级别可配置（debug/info/warn/error）。调试模式下记录完整的请求/响应详情。使用 Pino 结构化日志，确保高性能与低开销。
rsk_ 前缀 + 48 字符）核心定位是 OpenAI 兼容 API 的反向代理。所有请求转发遵循 OpenAI chat/completions API 协议，支持流式（SSE）和非流式响应。TypeScript 类型定义与 OpenAI API 规范保持一致。
TypeScript 严格模式（strict: true）为强制性要求。所有数据结构使用 Zod Schema 进行运行时校验，编译期通过 TypeScript 类型系统保障。禁止使用 any、@ts-ignore、@ts-expect-error 绕过类型检查。
TypeScript 严格模式（strict: true）必须在所有源码文件中启用。所有配置对象必须通过 Zod Schema 验证。禁止使用 any、@ts-ignore、@ts-expect-error 抑制类型错误。配置数据使用 Zod Schema 进行运行时验证，同时通过类型推断获得编译期类型安全保障。