SOLID CUDA 13
硬性限制
- 每個原始碼檔案實務上最多 400 行
- 每個類別最多 30 個方法
- 請將解碼器 / 管線 / 遙測模組分開存放
型別與邊界
- 在公開邊界上,優先使用具體型別而非
Any - 將廠商 SDK 物件包裝在狹窄的適配器 (adapter) 後方
- 清楚命名 GPU 資源(
surface、decoder、stream) - 記錄裝置所有權以及重設/重新開啟的行為
可靠性
- 將串流重新連線 / 解碼器重設視為第一級路徑
- 明確地以錯誤訊息失敗;不要吞沒 CUDA 初始化失敗
- 保持 CPU 協調層精簡;繁重的工作應留在裝置程式碼路徑中
檢查清單
- 在 API 邊界處沒有新的
Any,除非已有型別包裝器的計畫 - 資源生命週期(建立/重設/關閉)是明確的
- 檔案/模組僅專注於一個 GPU 關注點