把 M10 這輪三平台 build 踩的雷整理成 troubleshooting 文件,供未來 build 安裝包時參考。 涵蓋 9 條逐項 troubleshooting(統一格式:症狀 → 根因 → 為什麼發生 → 解法 → 如何根治)、快速症狀索引表、5 條橫向教訓、KneronPLUS 2.0.0 vs 3.1.2 版本相容附錄、build 驗收 checklist。 核心教訓:症狀常不指向根因(Error 12 是 input size、pip 秒退是 wheels 多版本、中文亂碼是 stdio code page),macOS 開發環境測不到大量 Windows-only 問題(編碼、DLL 路徑、SDK 版本差異)。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>