Repository navigation
Releases
ControllerHub v0.3.4 Preview
ControllerHub v0.3.4 Preview
這次更新整合連接穩定性、鬆鍵延遲修正與 .NET 10 升級。
下載
- ControllerHub-v0.3.4-preview-portable-win-x64.exe：單 EXE，內含 .NET 10 runtime，建議一般使用者下載。
- ControllerHub-v0.3.4-preview-win-x64.zip：完整解壓使用，需另裝 .NET 10 Desktop Runtime x64。
- ControllerHub-v0.3.4-preview-source.zip：對應此 Release commit 的專案原始碼、整合補丁與依賴版本資訊。
- 每個成品附 SHA-256 校驗檔。
首次使用虛擬 Xbox／PS5／Pro 輸出，需要安裝 usbip-win2 Client 驅動；單 EXE 不會自動安裝驅動。設定沿用 %LOCALAPPDATA%/ControllerFusion。
更新內容
- 改善斷開／切換模式的清理：重試可恢復的停止寫入，查核本次 USB/IP 端點是否移除；失敗保留復原記錄，避免疊加連接。
- 以即時狀態緩衝取代舊 FIFO，避免鬆鍵排在過期輸入後方；加入斷流中立保護與寫入期限。
- 升級 .NET 10，重用映射／編碼緩衝，無輸入時事件等待，最小化時暫停介面指標刷新。
- 移除介面的開發浮水印與測試版側欄字樣，更新三語言畫面及說明文件。
驗證與限制
109 項離線檢查、2,430 項相關上游回歸測試、18 項 Windows 消費端檢查，以及 Switch USB 同一引擎八輪模式切換通過。使用者回報一段時間使用暫無問題；未據此宣稱所有遊戲與長期負載均已驗收。
PS5 本輪未重新實測；先前 DualSense USB 測試結果保留。DualSense 藍牙、HidHide、睡眠喚醒、長時間音訊及不同遊戲仍待驗收。音訊轉震動保持實驗功能、預設關閉；底層 USB 持續停滯仍可能需要重新插線。
完整說明見 README、docs/known-issues.md 與 docs/development/completion.md。
ControllerHub v0.3.0 Preview
新增：單 EXE 便攜版
下載 ControllerHub-v0.3.0-preview-portable-win-x64.exe 即可啟動，已包含 .NET 8.0.33，不用另外安裝 .NET 8。首次會準備本機快取，之後校驗並重用；設定仍沿用本機既有資料。目標系統為 Windows 11 x64。
USB/IP Client 仍是需要首次安裝的系統驅動，單 EXE 不會自動安裝。現有 ZIP 版保留。
對應新增的打包／啟動器原始碼為 ControllerHub-v0.3.0-preview-portable-source.zip；既有 ZIP、原始碼附件及已發布 tag 保持不變。兩個新增檔案均附 SHA-256。
已通過 23 項啟動器檢查，以及從便攜 EXE 實際執行的 75 項離線檢查與三語介面測試；確認隨附 runtime 從快取載入。這不新增實體手柄或遊戲驗收結論。
ControllerHub 的第一個公開預覽版：支援 Switch 2 Pro 與 PS5 DualSense 的 Windows 手柄工作台。
功能
- USB／藍牙輸入路徑，Xbox／PS5／Pro1／Pro2 虛擬輸出。
- GL／GR／C 本機映射、電量與連接狀態。
- 普通震動、HD／PS5 觸覺、體感轉發與校準、DualSense USB 自適應扳機。
- 繁體中文、简体中文、English 即時切換；英文隨附 Google Sans。
下載與安裝
下載 ControllerHub-v0.3.0-preview-win-x64.zip 並完整解壓，執行 ControllerHub.exe。需要 .NET 8 Desktop Runtime x64；虛擬輸出需要安裝隨附的 usbip-win2 Client 驅動。
原始碼快照為 ControllerHub-v0.3.0-preview-source.zip，固定依賴由 scripts/bootstrap.ps1 還原。兩個 ZIP 均附 SHA-256 校驗檔。
驗證與限制
75 項離線整合檢查、乾淨原始碼重建與三語介面回歸通過。介面截圖是已標註的離線示範；有限硬體實測不代表所有電腦、韌體與遊戲均相容。
本版是 Pre-release。DualSense 藍牙、HidHide、個別遊戲與長時間音訊／性能驗收尚未完成；Switch 2 USB 首次讀取仍可能經約一秒重試後恢復。詳見已知問題。
Initial preview of a Windows controller workspace for Switch 2 Pro and DualSense, with virtual gamepads, motion, haptics and a trilingual UI. This preview has known limitations; see the compatibility matrix before use.