修復 Harmonica OS 平板電腦的觸控螢幕校準問題：選擇合適的 Linux 修復方案

首先，請確認您指的是哪一個「口琴作業系統」。

如果您指的是 HamoniKR（韓國 Linux 發行版），那麼觸控螢幕的行為取決於平板電腦硬體、Linux 核心驅動程式、輸入協定堆疊以及桌面會話的共同作用。我無法找到適用於所有型號的通用 HamoniKR 平板電腦校準精靈或單一解決方案。 HamoniKR 專案發布了版本化的手冊，但以下校準步驟使用的是已記錄的 Linux 輸入工具，並且取決於您的平板電腦使用的驅動程式。如果您指的是華為鴻蒙作業系統或其他名為 Harmonica OS 的產品，則這些 Linux 指令不適用。

更實際的做法是在安裝校準器或更改系統檔案之前先診斷問題所在。如果觸摸點持續偏移，則可能需要校準。如果指針旋轉、映射到錯誤的顯示器，或僅在解析度變更後才出現不準確的情況，通常需要校正顯示器映射。隨機觸摸、漏觸或幽靈觸摸可能是驅動程式或硬體問題導致的，更改校準值無法解決這些問題。

HamoniKR 的版本化使用者指南是查看與您已安裝版本相關的詳細資訊的最佳方法。以下輸入層指南是基於libinput 設定文件和Ubuntu 中 xinput_calibrator 的手冊頁。

哪一種解決方法最符合症狀？

你注意到了什麼	可能的類別	最佳首選
每次點擊落點距離大致相同。	校準或顯示變換	檢查解析度和旋轉角度；然後使用與會話和驅動程式相容的校準介面。
觸控功能在一個螢幕上有效，但顯示在另一個螢幕上。	輸出映射	暫時斷開其他顯示器的連接，並修正觸碰顯示器的指派。
座標系已旋轉或鏡像	方向錯位	請先設定顯示器方向，然後在校準前重新測試。
觸覺時斷時續、缺失，或無需接觸即可啟動。	驅動程式、內核、韌體或硬體	檢查設備檢測和內核訊息；校準不太可能解決問題。
手指輸入準確，但觸控筆不準確。	獨立的數位化儀或筆配置	檢查筆式裝置及其支援的設置，而不是更改手指觸控螢幕。

這種差異可以節省時間：校準只是調整觸控感應器到顯示器的座標映射方式。它無法使不支援的控制器工作，也無法修復損壞的數位化儀。

更改校準前應該檢查哪些內容？

記錄平板電腦型號和作業系統版本。在終端中，檢查/etc/os-release並記下確切的設備型號。檢查已安裝的 HamoniKR 版本是否與平板電腦型號相容。
清潔螢幕並移除任何可能影響接觸的物品。擦去水分或碎屑，如果條件允許，請在測試時移除較厚或損壞的螢幕保護貼。分別用手指和觸控筆進行測試。
將顯示器設定為其原生解析度和正常方向。使用桌面顯示設定。如果在旋轉平板電腦、變更縮放比例或連接顯示器後精確度發生變化，請暫時撤銷這些變更並再次測試。
重新啟動系統並套用相關的系統更新。更新可能包含核心和輸入驅動程式的修復。在編輯持久性配置之前執行此操作，尤其是在升級後出現問題的情況下。
檢查 Linux 是否辨識到觸控螢幕。運行命令libinput list-devices。如果您使用的是 X.Org 會話，xinput list則可以顯示 X 輸入裝置。這些命令用於識別設備，但不會校準設備。

若要識別會話類型，請執行命令echo "$XDG_SESSION_TYPE"。輸出結果x11表示 X.Org；wayland表示 Wayland 合成器管理實體輸入。這一點很重要，因為 X.Org 實用程式無法透過 Xwayland 可靠地配置實體觸控螢幕。

是否應該使用 X.Org 校準工具？

僅當您處於真正的 X.Org 會話中，且程式將您的實體觸控螢幕列為可校準裝置時才選擇此選項xinput_calibrator。 Ubuntu 手冊將其描述為 X.Org 實用程序，並解釋新值是否持久取決於驅動程式。在某些情況下，它可以為當前會話應用值或列印配置片段；對於其他驅動程序，自動校準不可用。

如果該工具已安裝，請先列出支援的設備：

xinput_calibrator --list

如果您的觸控螢幕出現在清單中，請按照螢幕上的指示操作並查看輸出結果。在儲存任何值之前，請在全螢幕範圍內測試結果。不要因為實用程式列印了輸出片段就將其貼到系統目錄中：請先確認該片段中包含您的裝置名稱，並且與正在使用的驅動程式相符。

當平板電腦使用相容的 X.Org 驅動程式且誤差為穩定偏移時，此方法較為便利。但如果系統使用 Wayland、設備不在校準器清單中，或誤差為非線性或間歇性，則此方法並不理想。手冊指出，四點校準無法校正非線性螢幕變形。如果程式重複報告誤點擊，請停止操作並檢查裝置支援情況，而不是強制設定數值。

如果問題出在旋轉角度或顯示錯誤呢？

在嘗試校準之前，請先修正顯示設定。在 HamoniKR 的顯示設定中恢復平板電腦的預期方向、解析度和縮放比例。如果連接了外接顯示器，請斷開連接並單獨測試內建螢幕。如果觸控功能恢復正常，則問題可能出在輸出對映或旋轉。

對於配備多個顯示器的桌上型電腦或二合一電腦，觸控螢幕可能會被指派到不同的輸出裝置。通常情況下，在 Linux 顯示管理器或桌面設定中進行修正風險最低。在 Wayland 會話中，請使用桌面環境的控制項；從終端更改 XInput 屬性可能只會影響 Xwayland 應用程序，而不會影響實體設備。

顯示映射和感測器校準相關但又有所不同。映射決定哪個輸出接收觸控座標，以及如何旋轉或縮放這些座標。校準則校正數位化儀所測量的觸控位置與該輸出上可見點之間的關係。首先修正錯誤的輸出或方向，然後再重新檢查物理偏移。

libinput校準矩陣何時適用？

只有當您的裝置支援校準且您擁有該特定面板的可靠校準值時，才使用 libinput 矩陣。 libinput 解釋說，校準僅適用於部分直接輸入設備，校準結果以變換矩陣的形式呈現，通常透過桌面環境或其他呼叫程式存取。其libinput list-devices輸出結果可以幫助顯示本地設備上可用的配置。

持久化的 Linux 配置通常涉及每個裝置的 udev 屬性，例如 `<mode>` LIBINPUT_CALIBRATION_MATRIX，但正確的值取決於裝置、螢幕方向和驅動程式。對於“Harmonica OS 平板電腦”，沒有通用的安全矩陣。請勿從其他平板電腦複製矩陣或猜測係數：錯誤的規則會使螢幕更難使用，並且可能需要鍵盤、遠端 shell 或復原環境才能撤銷操作。

這種高級方法適用於已經確定了確切輸入設備、測量了所需轉換值，並且能夠在觸控功能停止工作時恢復系統的管理員。對於沒有測量工具或恢復方案的單設備家用平板電腦，使用相容於 X.Org 的工具（如果適用）或驅動程式/供應商提供的修復程序是更安全的選擇。

如何驗證結果？

多次輕敲中心點和四個角點，然後測試它們之間的點。如果角點準確但邊緣不準確，則可能表示存在基本校準無法修正的問題。
將平板電腦旋轉並恢復到正常方向後，重複測試。
分別測試手指和觸控筆的輸入。它們可能顯示為不同的設備，並支援不同的校準方式。
任何持久性更改後請重新啟動電腦並再次測試。僅在登出或重啟前有效的設定不會持久保存。
在進行進階變更之前，請先嘗試使用已知可正常運作的外部鍵盤或滑鼠，以便保留備用輸入方式。

成功的修復應該使點擊操作在整個螢幕上都落在觸控點附近，重啟後仍然保持正確，並且避免在不同的螢幕方向下產生新的偏移。如果仍出現隨機失靈、幽靈觸控、盲點或裝置無法辨識等情況libinput list-devices，請檢查核心驅動程式、韌體、連接器或數位化儀，而不是增加校準調整。

在現有方法中進行選擇

如果偏移是在顯示變更後產生的，請先重設解析度和方向；這樣可以快速輕鬆地恢復。對於相容於 X.Org 驅動程式識別的觸控屏，請使用xinput_calibrator並評估驅動程式特定的輸出；這種方法更直接，但並非涵蓋所有現代輸入協定堆疊。對於已測量值的支援的 libinput 設備，使用設備級矩陣可以實現持久性，但配置和恢復成本最高。對於間歇性輸入、不支援的硬體或物理損壞，故障排除驅動程式或維修設備比校準更合適。

HamoniKR 的版本和平板電腦型號決定了實際可用的路徑。在安裝校準軟體或變更系統級輸入規則之前，請檢查這些詳細資訊。