﻿Ultimate Shift Controller
使用者說明書
Version 3.0.9

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 1. 軟體類型與執行環境
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

本軟體為免費軟體，不收取使用費用。需要 64 位元 Windows 10/11、.NET 8 Desktop Runtime (x64)、鍵盤與滑鼠。實際行為可能因裝置、應用程式或遊戲而不同。虛擬控制器功能可能需要額外驅動程式與設定。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 2. 安裝
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

本軟體沒有安裝程式。請將 ZIP 解壓縮到可寫入的資料夾，執行 UltimateShiftController.exe，設定映射並按下[儲存]。請勿直接從 ZIP 內執行。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 3. 解除安裝
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

關閉開機自動執行，結束 USC（包含系統匣），再刪除資料夾。若要刪除設定與配置，請一併刪除[Settings]。另行安裝的虛擬控制器驅動程式需另外移除。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 4. 軟體介紹
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Ultimate Shift Controller 可組合鍵盤與滑鼠輸入，重新映射按鍵、從滑鼠按鈕執行快捷鍵，並在按住圖層觸發鍵時切換另一組映射。可用於遊戲、寫作、影像/影片編輯、直播、瀏覽器等。基本功能不需要虛擬控制器。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 5. 主要功能
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

鍵盤/滑鼠重新映射、含修飾鍵快捷鍵、單一輸入多重輸出、F1-F24、NORMAL/HYPER/ULTRA/ULTIMATE、連發、分頁、設定檔、匯入/匯出、HUD、系統匣、上層中的左/右鍵輸入，以及透過 Chrome 的本機翻譯。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 6. 基本設定
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

執行程式，選擇要編輯的圖層，在一列上方登記輸入、下方登記輸出，按下[儲存]並測試。例如：Q -> CTRL+1。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 7. 四個輸入圖層
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

NORMAL 是預設圖層。按住 HYPER 或 ULTRA 觸發鍵時使用對應圖層，同時按住兩者時使用 ULTIMATE。上方按鈕選擇編輯圖層，觸發鍵決定實際作用圖層。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 8. HYPER / ULTRA / ULTIMATE 與外接滑鼠
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

HYPER 與 ULTRA 的邏輯觸發鍵僅限 F13-F24，且兩者不能相同。

範例：HYPER=F13，ULTRA=F14。實體按鈕必須送出與 USC 相同的 F 鍵。

未啟用連發的 USC F13-F24 映射輸出也可在內部作為觸發輸入。HYPER/ULTRA/ULTIMATE 的輸入側可登記左鍵與右鍵；NORMAL 輸入側及所有輸出側仍會阻止登記，以保護一般點擊。非連發輸出會維持按下，直到放開原輸入。

[Razer Synapse 2]
Synapse 2 能儲存 F13-F24，但不會顯示按鍵名稱。以 F13 為例：在 USC 的 NORMAL 圖層暫時把實體 F1 輸出改成 F13；開啟 Synapse 2 的按鈕按鍵登記；按實體 F1；名稱未顯示也直接儲存；儲存後把 USC 的 F1 恢復成一般 F1，並將 HYPER 觸發鍵設為 F13。

[Razer Synapse 3]
若可直接選擇 F13-F24，請將 F13/F14 指派給按鈕，並在 USC 使用相同按鍵。

[Logicool/Logitech G-Shift 與 G HUB]
G HUB 可選擇 F1-F24。將 F13/F14 指派給一般或 G-Shift 按鈕，並在 USC 使用相同按鍵。

[其他裝置]
只要設定軟體能登記 F13-F24，就能使用相同方法。即使名稱未顯示，只要可儲存並實際輸出按鍵即可使用。請盡量使用 F13-F24。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 9. 分頁、設定檔與儲存
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

分頁用來整理映射，設定檔儲存全部設定。修改後務必按下[儲存]。資料位於[Settings]資料夾。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 10. 連發、HUD 與狀態
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

連發會重複輸出。US HUD 顯示目前圖層。CLEAN 嘗試清除殘留按下狀態。Keyboard Lock 暫時鎖定鍵盤，可用滑鼠解除。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 11. 重要設定
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[Kill 已映射輸入]可防止原始輸入與映射輸出同時作用。圖層中停用未映射輸入會阻止未指定輸入在 HYPER/ULTRA/ULTIMATE 中直接通過。另有系統匣與 Windows 啟動選項。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 12. 虛擬控制器
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

此為進階功能，可能需要驅動程式、實體/虛擬控制器分離與遊戲輸入設定。設定錯誤可能造成雙重輸入。圖文說明：
https://github.com/Lu-ci-el/UltimateShiftController/blob/main/Instructions_en.md

只使用鍵盤、滑鼠、圖層與快捷鍵時不需要此功能。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 13. 疑難排解
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

確認已儲存、觸發鍵一致；雙重輸入時檢查 Kill；用滑鼠解除 Keyboard Lock；殘留狀態時使用 CLEAN；無法儲存時避免使用 Program Files 等不可寫入位置。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 14. 聯絡方式與錯誤回報
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

https://github.com/Lu-ci-el/UltimateShiftController/issues

請提供問題、步驟、發生頻率、環境與記錄檔。不保證逐一回覆、立即修正或支援所有環境。不接受惡意用途或客製開發要求。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 15. 注意事項
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

定期備份[Settings]，更新前結束 USC，確認快捷鍵衝突與遊戲/服務規則。請勿用於作弊、騷擾或干擾他人。作者不對使用本軟體造成的損失負責。


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ USC_TRANSLATION_3_0_4 / 翻譯功能
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

- 翻譯功能需要 64 位元 Google Chrome 與 Chrome 支援的本機模型；不會回退到 Microsoft Edge。
- 在設定中啟用翻譯並開啟翻譯設定。[翻譯鍵]只能選擇 F13-F24 邏輯鍵，不能與 HYPER 或 ULTRA 的邏輯觸發鍵相同。
- 在[觸發鍵]輸入欄按滑鼠左鍵可開始擷取，按右鍵可清除。可登記實體鍵盤/滑鼠/控制器組合，或目前圖層中未啟用連發的 USC 映射輸出。不會把實體輸入與內部輸出各取一部分混合判定。
- 選取的外語文字會翻譯成 USC 目前選擇的自己語言；自己語言的文字會翻譯成最近一次成功使用的對話語言，尚無記錄時使用預設目標語言。
- 結果顯示在簡易視窗中。取得選取文字時，USC 只會向前景應用程式送出一次 Ctrl+C，並以獨立掃描碼事件依 Left Ctrl DOWN → C DOWN → C UP → Left Ctrl UP 的順序送出，在按下 C 前短暫保持 Ctrl。絕不會先送出 C，也不會在複製失敗後再次送出 C。只有確認剪貼簿已更新的文字才會翻譯；取得失敗時不翻譯，並在簡易視窗中提示。不會使用螢幕擷取或 OCR。
- USC 內建 14 種語言可批次準備。其他語言可在 Chrome 支援時使用 BCP-47 標籤個別準備。
- 開啟設定、按下更新或選擇 Pack 列不會開始下載。只有明確按下 DL 或標準語言批次 DL 才具有下載權限。
- 明確 DL 會在一般 Chrome 中開啟短時間、受 token 保護的本機頁面。Chrome 已經執行時也可使用，且必須在 Chrome 頁面中點擊後才會開始。不會開啟外部網站，模型始終由 Chrome 管理。
- 一般翻譯透過標準輸入/輸出使用隱藏的一次性 Helper，不會開啟 Chrome 頁面、分頁、視窗或 localhost listener，也不會自動下載缺少的模型。
- USC 只在 [Settings\Translation] 中儲存設定與輕量證據。Chrome 的設定檔、TranslateKit、語言 Pack、模型、元件、runtime 與快取不會複製到 USC。
- Markdown、URL、程式碼、引號、段落與換行會在模型外保護，在有限長度內分段後重新組合。永久儲存請使用 USC 主視窗的[儲存]。
