Spicy Lyrics MeCab Furigana

English · 下載完整安裝包 · 版本與校驗碼

替 官方 Spicy Lyrics 加上日文假名。支援整句 MeCab 分析、詞典候選、手動校正，以及逐字播放、模糊、hover 和 Spicy Lyric Translator（SLT）。獨立載入，不修改 Spicy Lyrics 或 SLT 的原始碼／載入網址。

下載後安裝

目前提供 Windows 10／11 x64 的完整安裝包。 先有可正常使用的 Spicetify 和 官方 Spicy Lyrics。SLT 是選用項目。

1. 下載 SpicyLyricsFurigana-windows-x64.zip。請下載 Releases 裡的這個檔案；GitHub 的「Source code」ZIP 是給開發者的，沒有執行環境和字典。
2. 對 ZIP 按右鍵，選「全部解壓縮」。不要在壓縮檔內直接執行。
3. 開啟解壓後的資料夾，雙擊 Install.cmd。使用一般使用者權限即可，不需要系統管理員。等待顯示 Installed Spicy Lyrics MeCab Furigana。
4. 正常關閉 Spotify，再開啟一次。在 Spicy Lyrics 播放日文歌曲，工具列會出現 「あ」 與 鉛筆 按鈕。

安裝包內已包含 Python 3.14.6、Fugashi 1.5.2／原生 MeCab、完整 UniDic 3.1.0 字典。不用另外安裝 Python、MeCab、字典、pip、Node.js 或 Bun；安裝時不下載相依。下載約 514 MiB（539 MB），解壓與安裝請預留約 3 GB 空間。Spotify／Spicy Lyrics 取得歌曲與歌詞仍需要原本的網路連線。

安裝會將專用執行環境複製到 %LOCALAPPDATA%\SpicyLyricsFurigana，並設定本機分析服務在登入時啟動。安裝成功後可刪除下載／解壓的資料夾。本機分析服務只監聽 127.0.0.1:18766；歌詞不會送到外部分析服務，也不會寫入後端日誌。

首次安裝會加入單一 Spicetify 擴充項目，並執行 spicetify --no-restart apply；不會自動重啟 Spotify。更新已載入的外掛只替換資產，無須重新套用整個 Spicetify。安裝程式不清除 Spotify 資料、不重設 SLT、不切換翻譯開關、不升降版 Spotify。

一般安裝使用 Spicetify 的 Extensions 載入，不會新增 Marketplace 的「已安裝」卡片；安裝狀態可用 Diagnose.cmd 查看。

使用與校正

• あ：開啟／關閉假名；通常的歌詞點擊仍保留 Spicy Lyrics 原本的跳轉功能。
• 鉛筆：開啟校正模式，再點選詞語。可以選 MeCab 的整詞候選，或輸入整個詞的假名，再按「儲存讀音」。片假名及半形片假名會轉成平假名。
• 恢復自動讀音：移除這個詞語位置的手動校正。校正面板支援 Tab、Enter 與 Escape。

校正存在本機 Spotify 儲存空間，依 歌曲、原文句子、同句第幾次出現、主唱／背景聲部、詞語位置 分別記住，不會把其他歌曲的同一個漢字一起改掉。請勿清除 Spotify 網站／使用者資料，否則校正也可能遺失。

目前以原文歌詞是否包含平假名／片假名判斷日文，繁體中文、簡體中文、英文與翻譯行不加假名。整首完全沒有假名的漢字歌詞無法可靠區分中日文，因此會保守略過。若開啟 Spicy Lyrics 的羅馬字模式，請先關閉羅馬字以顯示漢字假名。

MeCab 根據文字上下文與字典判讀，沒有聽取歌曲音訊。人名、當て字、歌手特殊唱法可能不在字典中；這些位置請用手動校正。詞典候選不保證涵蓋每種演唱讀法。

更新、移除與故障排除

更新：下載新版完整 ZIP、全部解壓縮、執行 Install.cmd，完成後正常關閉 Spotify 再開啟一次。自己的校正及其他外掛設定會保留。早期 Marketplace 本機安裝會更新其兩份既有資產，沿用相容的本機 MeCab 服務，避免重複載入。

移除：重新解壓完整包，執行 Uninstall.cmd，再正常關閉並開啟 Spotify。只移除本安裝程式管理的載入項目、執行環境與啟動項目；保留校正及其他外掛設定。早期 Marketplace 安裝的項目請另在 Marketplace 停用／移除；原有 MeCab 服務不會由新版安裝程式刪除。

沒有假名：在解壓資料夾執行 Diagnose.cmd。若 MeCab 顯示 unavailable，執行 Start-service.cmd 後再看日文歌詞。若 18766 被其他程式佔用，請先處理該程式。確認「あ」已開啟、原文是日文、羅馬字模式已關閉、Spicy Lyrics 本身能顯示歌詞。

安裝中斷：重新解壓完整 ZIP 並執行 Install.cmd，可重試而不增加第二個載入項目。自訂 Spicetify 位置可在 PowerShell 執行：

.\runtime\python.exe -I .\app\install.py install --spicetify 'D:\Tools\spicetify\spicetify.exe'

Spicetify apply 失敗：先依 Spicetify 錯誤訊息修復其現有安裝，再重跑本安裝程式。請使用與 Spicetify 相容的 Spotify 版本；本專案不自動更新或回退 Spotify，也不保證未來 Spotify／Spicy Lyrics 版本。開發驗證環境為 Spotify 1.2.92.148、Spicetify 2.45.3、官方 Spicy Lyrics 和 SLT 2.2.4。

不要接連執行 spicetify apply 與 spicetify restart。 apply 可能已自動重啟；這個連續強制重啟流程曾在開發環境重現 Spotify Local Storage 設定遺失。本安裝程式固定用 --no-restart，完成後只需要正常開啟一次 Spotify。

目前沒有 macOS／Linux／Windows ARM64 免相依成品，前端 JS 單獨下載也不包含分析服務。開發者可依 開發說明 自行架設後端。

原始碼與授權

完整原始碼 採 AGPL-3.0-only，完整安裝包也附 source.zip。下載來源與 SHA-256 固定於 tools/runtime-lock.json。

本專案承接 Spicy Lyrics PR #290 的假名處理移植工作；來源基底為 Spikerko/spicy-lyrics@e1d49d86eadd24c9ab9e410953757c16a2fccd9f。感謝 Spicy Lyrics、Fugashi、MeCab、UniDic 及 Material Design Icons 的作者。第三方授權與來源見 THIRD-PARTY-NOTICES.txt 和 licenses/；此專案不是 Spotify 或 Spicy Lyrics 的官方發行版本。