如何安裝、設定或自行建立 Logitech G HUB 巨集

區分原生巨集、Lua 與內建記憶體

G HUB 對同一裝置提供數種不同機制。應依目標與邏輯執行位置選擇，而不是照搬其他滑鼠型號的選單。

.lua 屬於第二種，在 Assignments 錄製的序列屬於第一種。On-Board Memory 不會把兩者轉成無限制的韌體自動化。

準備 G HUB、裝置與復原方案

載入前記錄初始狀態，可避免把錯誤設定檔或誤改主按鍵當成硬體故障。

• 使用官方 G HUB。 完成更新，重新連接目標滑鼠，並確認裝置頁面與設定可正常開啟。
• 檢查下載內容。 解壓縮、掃描並閱讀說明；若應該只有資料或指令碼，卻出現未知執行檔，請勿執行。
• 儲存目前配置。 截圖記錄作用中設定檔與按鍵，保留一般主點擊，敏感測試時準備備用滑鼠。
• 選擇真正的應用程式設定檔。 連結主執行檔。Desktop Default 是中性備援，並非所有巨集的必要位置。
• 從一次性動作開始。 使用側鍵與安全視窗，直到啟動、時序與停止都清楚。

建立並指派 G HUB 原生巨集

內建編輯器適合快捷鍵、可控制點擊、文字與應用程式命令。先製作短版並驗證，穩定後再加入重複。

1. 開啟正確裝置。

   選擇目前連接的滑鼠，並核對畫面顯示的應用程式設定檔。

2. 進入 Assignments → Macros。

   按 Create New Macro，並以應用程式與用途命名。

3. 明確選擇播放方式。

   先用 No Repeat，其他方式只在停止條件清楚時使用。

4. 加入動作。

   錄製鍵盤、滑鼠、文字或支援命令，並刪除意外輸入。

5. 核對延遲與放開。

   保留應用程式處理時間，確保每個按下都有對應放開。

6. 指派到按鍵。

   儲存後拖到滑鼠示意圖，測試前確認新標籤。

若巨集已在清單中，但實體按鍵仍執行舊功能，表示錄製完成而指派或作用中設定檔有誤，不必再建立副本。

正確載入設定檔 Lua 指令碼

G HUB 執行時，Lua 會回應設定檔中的支援事件。只有目標設定檔確實提供 Scripting 時才使用此方式。

1. 選擇目標設定檔。

   儲存在 Desktop 或其他遊戲下的指令碼不會自動跟隨正確程式。

2. 開啟 Scripting。

   若沒有該項，請檢查型號、平台、韌體與目前支援。

3. 備份原有程式碼。

   匯入可能覆蓋內容，因此先另存為帶日期的文字檔。

4. 載入 .lua。

   使用開啟或匯入，先閱讀設定、註解與事件處理，再儲存。

5. 啟用設定檔。

   切換到連結的應用程式，並在記錄中確認設定檔與預期按鍵事件。

6. 只做一次受控測試。

   使用安全環境與明確停止方式；事件未到達時不要先亂改時序。

讓按鍵與應用程式設定檔可預測

許多偶發問題其實是設定檔切換。G HUB 可依程式切換，而持續設定檔會在所有位置鎖定同一配置。請分別測試。

1. 核對執行檔。

   連結主程序，而不是只連結啟動器、更新器或捷徑。

2. 選擇安全觸發鍵。

   先用可程式化側鍵，沒有替代控制時不要更改主點擊。

3. 檢查標籤。

   原生巨集名稱應顯示在按鍵旁；Lua 則監聽支援的按鍵事件。

4. 觀察自動切換。

   在 Desktop 與目標程式之間切換，查看目前設定檔名稱。

5. 持續設定檔只用於診斷。

   短暫鎖定已知設定，找到原因後恢復應用程式自動切換。

依內建記憶體限制選擇播放方式

桌面 G HUB 與滑鼠內部不是同一執行環境。先在軟體模式驗證，再判斷簡單便攜指派是否足夠。

開啟 On-Board Memory 後，G HUB 無法以一般方式編輯滑鼠。修改時回到 software mode，或僅在支援型號使用 Onboard Memory Manager。

設計容易理解的自訂巨集

好維護的巨集只完成一項允許的任務，觸發明確，且有可觀察的結束。錄製前先用文字描述。

1. 確定一個結果。

   例如應用程式命令、允許的固定文字或短小的輔助快捷鍵。

2. 拆成按下、等待與放開。

   記錄每個事件和預期的應用程式狀態。

3. 選最簡單工具。

   線性序列用 Macros，支援條件用 Lua，基礎便攜操作用內建記憶體。

4. 建立最小版本。

   刪除意外輸入，並清楚命名設定檔、巨集與備份。

5. 測試一個循環。

   觀察順序，每次只改一個延遲，穩定性優先於速度。

6. 記錄有效狀態。

   保存裝置、模式、設定檔、按鍵、播放方式與日期。

使用 Lua 時，先在記錄中確認設定檔啟用與按鍵事件。觸發沒有到達時，重寫執行區塊無法解決問題。

整理設定檔、版本與備份

保留一個按鍵普通的中性 Desktop，並為每個應用程式建立獨立設定檔。描述性名稱能在自動切換時立刻說明目前配置。

驗證後，在安裝目錄外保存按鍵圖、Lua 原始碼，以及裝置、G HUB 版本、exe 路徑、播放方式與日期說明。

如需適用於支援滑鼠與應用程式的準備檔案，請查看 EasyMacro 商店，並在購買前核對軟體、型號與設定要求。

Logitech G HUB 巨集無法運作時

依裝置、檔案類型、設定檔、觸發、權限與規則的順序檢查。盲目重裝可能刪除線索，卻沒有修正錯誤設定檔。

如需有畫面的輔助步驟，也可查看 TopMacro 繁體中文 Logitech 巨集文章。

只在規則允許的情境使用自動化

G HUB 是官方軟體，但不是所有操作序列都被每款遊戲允許。發行商、伺服器、聯賽與賽事可限制多項動作、重複、後座力補償或無人操作。

請閱讀具體遊戲、伺服器和模式的最新規則。生產力、輔助功能、創作工具與離線測試用途更明確，但任何賣家都不能保證未來判定。

保留普通設定檔，從有限測試開始，並確保隨時停止。良好設定應可理解、可復原，且在目前情境獲准使用。