SOLID CUDA 13
硬性限制
- 每个源文件在可行时最多 400 行
- 每个类最多 30 个方法
- 保持解码器、管道、遥测模块分离
类型与边界
- 在公共边界处优先使用具体类型而非
Any - 将厂商 SDK 对象包装在窄适配器后面
- 清晰命名 GPU 资源(
surface、decoder、stream) - 文档化设备所有权及重置/重新打开行为
可靠性
- 将流重连/解码器重置作为一等路径处理
- 使用显式错误报告;不要吞掉 CUDA 初始化失败
- 保持 CPU 编排层薄;繁重工作保留在设备代码路径上
检查清单
- 在 API 边界处没有新的
Any而没有类型包装计划 - 资源生命周期(创建/重置/关闭)是明确的
- 文件/模块专注于一个 GPU 关注点