[AI] 我的 openpilot 分支改了什麼？（上）分支定位、繁體中文與介面調整
前面分享了 comma four／C4 的硬體資訊，也整理了在 Windows 上跑 openpilot UI 模擬器的方法。不過一直還沒好好介紹，我自己維護的分支到底改了什麼。
打開 GitHub，commit 一長串，光看名稱其實不太容易知道跟平常使用有什麼關係。所以這次分成上下兩篇整理，也當作自己的版本筆記。上集先聊分支的來源，以及最容易直接看到的中文介面和顯示調整；下集再談 Caddy Mk5、提醒邏輯與更新流程。
版本範圍：本文記錄 2026 年 9 月 10 日整理時的 KingChang168/openpilot master（da4dac60），比較基準是 IC 的 a6c755d8。之後分支會繼續更新，內容以這次版本為準。
一、這個分支是從哪裡來的？
我目前維護的是 KingChang168/openpilot，這次整理的基礎來自 infiniteCable2/openpilot，也就是下面簡稱的 IC 分支，其中包含 sunnypilot 的上游工作。
模型管理、既有設定架構和許多控制功能，都有原本的開發來源。這篇主要介紹我在這個基礎上額外保留的修改，避免把整個專案的功能都算到自己頭上。
目前修改的重心很直接：Caddy Mk5 的資料適配、繁體中文介面，以及幾個影響日常使用的細節。不是每項都看起來很厲害，有些只是少一個不適用的資訊，或讓一段中文不要擠在一起，但每天會看到的東西，整理好還是有差。
二、先看這次改了哪些部分
| 上集：畫面與使用介面 | 下集：車型與程式行為 |
|---|---|
| 繁中翻譯整合 繁中字型、字級與換行 停用螢幕保護程式 電池資訊顯示條件 | Caddy Mk5 攝影機側雷達資料 方向燈與盲點警示 前車起步提醒過濾 更新流程與控制程式修正 |
以這次主程式的比較範圍來看，共有 8 筆額外 commit、49 個檔案變更。不過其中很大一部分是翻譯和字型相關內容，不能拿檔案數或新增行數直接當作功能增加多少。
三、繁體中文：不只把設定名稱翻成中文
這次把繁中支援集中整理，涵蓋設定、離車警示、行車警示、模型資訊、軟體頁面，以及安裝與更新相關畫面。C4 的小畫面與其他 UI 路徑也一起處理，減少不同頁面各做各的情況。
翻譯本身只是其中一部分。原本直接寫在程式裡的文字，也需要接上翻譯機制；否則就算翻譯檔補了，畫面仍可能顯示英文。
我希望整理後，常用功能的名稱和說明能比較一致。程式或模型的專有名稱，則保留必要的英文，方便跟設定、文件和錯誤訊息對照。全部硬翻成中文，有時候反而不知道原本在講哪個東西。
四、中文字型、大小和換行一起處理
字有出現，跟字好不好讀，是兩件事。這版繁中字型改用 思源黑體繁中 Source Han Sans TC，同時調整含非 ASCII 字元的繁中文本尺寸，程式內設定的額外倍率為 1.18。
這裡調的是文字繪製尺寸，並不是把整個畫面放大 18%。純英文、數字與中文字串仍有不同的字型處理路徑，部分符號也另外使用備援字型。
字變大以後，還要一起處理文字量測和換行。如果畫面拿舊的字寬計算位置，實際卻用新的尺寸畫出來，就容易出現文字超出按鈕或提早換行的情況。因此這次也調整了標籤、文字量測與換行相關程式。
前一篇介紹的 UI 模擬器，就適合先看這些地方：設定項目是否塞得下、警示是否容易閱讀、長句有沒有被切掉。最後還是要回到 C4 實機看，因為電腦視窗裡看得清楚，不代表裝在車上也一樣。
五、停用螢幕保護程式
這次另外停用了上游的 Screen Saver，並移除顯示設定中的螢幕保護開關和持續時間選項。
這項修改針對的是低亮度狀態下，螢幕保護畫面可能干擾行車 UI 的情況。程式直接將螢幕保護狀態設為關閉，讓這個功能不再介入畫面。
這不表示亮度、自動調光或所有關閉螢幕的邏輯都被移除。文章這裡講的是 Screen Saver 這一項，不要跟其他顯示功能混在一起。
六、電池資訊只留給適用的平台
另一個顯示調整，是把電池詳細資訊限制在 Volkswagen MEB 平台。程式會同時檢查車廠與 MEB 旗標，條件符合才顯示。
所以這不是替 Caddy 多做一個 12V 電瓶健康檢測。它的用途是讓原本的電池資訊出現在適用的車型上，避免其他車型看到沒有對應意義的資訊。
功能多不一定比較好，資料不適用的時候，畫面少放一點反而比較清楚。
七、這篇先整理到這裡
上集的修改，大多是平常直接會接觸到的畫面：中文顯示完整一點、文字尺寸和換行一起處理，再把不適用或可能干擾操作的顯示項目整理掉。
下集接著整理比較靠近車輛資料與程式行為的部分，包括 Caddy Mk5 的雷達資料、盲點和前車起步提醒，以及更新流程的小修正。程式改了什麼、預期改善什麼、實際驗證到哪裡，會分開說明。
版本與參考資料
整理日期：2026-09-10｜KingChang with AI 協助整理。本文為分支修改紀錄，未附實車效果比較數據。
留言
張貼留言