Jun 4, 2026

olSync: 用於 osu! 的資料同步工具

olSync 是一款基於 Electron 開發的桌面應用程式，整合了譜面恢復、圖譜包下載、隨機選圖與遊玩統計等多項實用功能，讓玩家能夠更有效率地管理自己的 osu! 遊戲資訊。

功能一覽

olSync 目前提供以下五大核心功能，涵蓋從資料同步到遊玩輔助的各種需求：

收藏夾整合 (單向 for osu!stable)

這是 olSync 最初的核心功能。它可以讀取 osu!stable 與 osu!lazer 各自的收藏夾（Collections）列表，將兩邊的收藏資料合併後輸出回 osu!stable。對於長期在兩個客戶端之間切換、卻又希望收藏夾保持一致的玩家來說，這個功能可以省去大量手動整理的時間。

譜面恢復

譜面恢復功能提供兩種資料來源：

osu! API v2 線上成績：透過官方 API 取得你帳號上的線上成績紀錄，能夠補回本地遺失或尚未同步的成績資料。
本地成績資料：直接讀取本地端已有的成績資料進行整理與恢復。

這項功能特別適合重新安裝系統、更換電腦的玩家使用。

圖譜包下載

olSync 內建了圖譜包（Beatmap Pack）下載功能，基於 osu! API v2 取得官方圖譜包列表，並支援多種篩選條件：

特定類型圖譜包：可選擇標準包、段位包、主題包等不同類型。
指定時間範圍：只下載某個時間區間內發布的圖譜包。
特定遊戲模式：可選擇 osu! / taiko / catch / mania 等模式專屬圖譜包。
差異下載：基於本地成績資料進行比對，快速篩選出你尚未擁有的譜面，避免重複下載已經存在的圖譜。

這個功能對於想要補齊舊圖譜、或是建立完整練習圖庫的玩家非常實用。

選圖器（Map Picker）

選圖器是一個本地端的隨機選圖輔助工具，運作邏輯完全基於本地已載入的圖譜資料，不需要連網即可使用。其特色包括：

自訂篩選條件：可依照難度、星數、模式等條件縮小選圖範圍。
比重設定：調整各項條件的權重，讓隨機選出的圖譜更符合你的偏好。
成績列表與 PP 計算：在選圖結果中顯示各譜面的理論 PP 值，以及 aim / speed / accuracy 各分項數值。這些數值透過 rosu-pp-js 在本地即時計算，無需呼叫外部 API。

無論是不知道該打什麼圖、想挑戰特定難度區間，或是單純想隨機抽一張圖來打，選圖器都能提供良好的輔助。

統計（Statistics）

統計功能幫助玩家深入分析自己的遊玩歷史，所有資料皆來自本地成績檔案，因此分析速度快且隱私性高。主要功能包括：

遊玩歷史分析：基於本地成績資料統計整體遊玩趨勢。
視覺化圖表：以圖表呈現以下資訊：
- 每日遊玩次數
- 分數變化趨勢
- 命中率（Accuracy）分布
- 評價等級（SS / S / A 等）分布比例
多用戶支援：可切換不同 osu! 使用者帳號查看各自的統計資料，並會自動記憶上次瀏覽的用戶。
日期範圍篩選：可自由設定起始與結束日期，查看特定時間區間內的遊玩表現。

對於想要追蹤自己進步幅度、或是回顧某段時間遊玩狀況的玩家，統計功能提供了相當直觀的數據呈現。

使用方式

基本設定

首次使用 olSync 時，請先點擊介面上的齒輪圖示（設定），填入你的 osu! 安裝路徑。設定完成後，大部分本地端功能（如收藏夾同步、選圖器、統計）即可正常使用。

啟用 API 功能

部分進階功能（如譜面恢復、圖譜包下載）需要透過 osu! API v2 來獲取線上資料。若要使用這些功能，你需要自行建立一個 OAuth 應用程式來取得 API 憑證：

前往 osu! 帳號設定頁面的 OAuth 區塊。
點擊「New OAuth Application」建立一個新的應用程式。
建立完成後，你會取得 Client ID 與 Client Secret。
回到 olSync 的設定畫面，將這兩組數值填入對應欄位。

⚠️ 安全提醒：Client ID 與 Client Secret 屬於敏感資訊，olSync 會將它們以明碼形式儲存在本地的 config.json 檔案中（通常位於 olsync 資料夾內的 data 目錄）。請務必妥善保管，不要隨意分享或上傳至公開場合。

總結

olSync 是一款功能豐富且專注於 osu! 生態的資料管理工具。從最基礎的收藏夾同步，到進階的譜面恢復、圖譜包下載、本地選圖器與遊玩統計，它幾乎涵蓋了玩家在 stable 與 lazer 雙端切換時會遇到的各種資料管理需求。

如果你同時使用兩個客戶端，或者希望更系統化地管理自己的圖譜、成績與遊玩紀錄，olSync 值得列入你的工具清單中。