lyrics-everywhere

Chrome Web Store & Edge Add-ons 上架資訊

本文件提供 Chrome 應用程式商店（Chrome Web Store Developer Dashboard）與 Microsoft Edge Add-ons（Partner Center）上架表單所需的文字與填寫說明。

1. 單一用途聲明（Single-Purpose Statement）

在瀏覽器側邊欄為 YouTube、YouTube Music 與 Spotify Web 提供同步滾動歌詞、讀音標註與本機音訊字幕。

2. 擴充功能名稱與說明

商店顯示名稱

Lyrics Everywhere 耳邊字幕

簡短說明（Short Description，≤132 字元）

在 YouTube、YouTube Music、Spotify Web 播放時於側欄顯示 LRCLIB 同步歌詞與空耳；無歌詞影片可在本機辨識建立字幕。

詳細說明（Long Description，繁體中文）

【Lyrics Everywhere 耳邊字幕】

在瀏覽器側欄（Side Panel）隨開隨唱！支援 YouTube、YouTube Music 與 Spotify Web，自動取得同步滾動歌詞與發音轉寫；無歌詞的冷門歌曲或翻唱混音，更可透過本機 WebGPU 辨識模型自動產生字幕。

主要特色：
• 側邊欄隨行播放：直接整合 Chrome / Edge 側邊欄，不遮擋主要網頁，工作或娛樂時隨時跟唱。
• 多平台同步歌詞：支援 YouTube / YouTube Music / Spotify Web，自動向開放歌詞庫 LRCLIB 查詢動態時間軸歌詞。
• 日韓多語言讀音標註：
  - 日語：離線整合 Kuromoji IPADIC 辭典，自動為漢字標註平假名與羅馬拼音。
  - 韓語：整合諺文發音規則轉寫系統。
• 手動時間軸校時：遇到開頭有 MV 劇情或空白的影片，隨時微調時間偏移量（秒數），校時設定本機自動記錄。
• 本機 AI 語音辨識（WebGPU）：
  - 無現成歌詞的混音、翻唱或現場收音影片，可透過瀏覽器內建 WebGPU 於本機執行 Whisper 模型產生時間戳記字幕。
  - 音訊完全在本機處理，不錄音、不上傳雲端伺服器，嚴格保護隱私。
• 隱私優先、無追蹤：不含廣告、無追蹤分析代碼、不蒐集個人資料。

使用方式：
1. 開啟 YouTube、YouTube Music 或 Spotify Web 播放歌曲或影片。
2. 點擊瀏覽器工具列上的「Lyrics Everywhere」圖示開啟側欄。
3. 側欄即自動顯示同步歌詞與讀音；如需校時可於下方輸入微調秒數。

3. 權限宣告原因（Permission Justifications）

商店審查時針對每個權限的簡要用途說明（英文與中文對照）：

API 權限 (`permissions`)

權限	審查用途說明（Justification）
`sidePanel`	用於在瀏覽器側邊欄顯示歌詞使用者介面，讓使用者在瀏覽播放頁面時不需切換視窗即可同步查看歌詞。 (Used to display the synchronized lyrics and transcription UI in the browser side panel.)
`tabCapture`	僅在使用者點擊「建立字幕」時，擷取當前播放分頁的音訊串流，直接交由本機 WebGPU Web Worker 進行 Whisper 語音辨識，絕不上傳。 (Captures tab audio stream only upon explicit user request (“建立字幕”) to perform local on-device speech-to-text with WebGPU.)
`activeTab`	當使用者點擊擴充功能工具列圖示時，獲取當前分頁授權以啟動側欄與連接音訊擷取。 (Grants temporary tab access when user clicks the extension action icon to open the panel and authorize capture.)
`storage`	於使用者本機儲存外觀設定、各影片的手動歌詞校時偏移量、手動選擇之歌詞編號與排除自動比對紀錄。 (Stores user UI preferences, manual lyric timing offsets, and lyric selections locally on the user device via chrome.storage.local.)
`scripting`	在使用者開啟擴充功能且分頁尚未載入播放腳本時，動態向播放分頁注入 content script 以回報播放進度。 (Injects content scripts into active playback tabs to establish playback position reporting when not already injected.)

主機權限 (`host_permissions`)

主機	審查用途說明（Justification）
`https://huggingface.co/` `https://.huggingface.co/` `https://hf.co/` `https://.hf.co/`	僅在使用者於側欄點擊「載入辨識模型」時，由瀏覽器向 Hugging Face 下載開源 Whisper ONNX 權重檔並快取於本機。 (Downloads open-source Whisper ONNX model weights to the local browser cache when the user initiates local transcription.)
`https://lrclib.net/*`	依據當前播放歌曲的曲名與歌手，查詢開源 LRCLIB 資料庫中的同步動態歌詞。 (Queries open-source LRCLIB API for synchronized time-coded lyrics matching current track title and artist.)
`https://www.youtube.com/` `https://music.youtube.com/` `https://open.spotify.com/*`	於支援的播放頁面注入 content script 讀取播放器時間、曲名與播放狀態，以及在使用者切換分頁時進行分頁清單查詢。 (Executes content scripts on supported media pages to detect playback time, track title, and media state for lyrics synchronization.)

4. 資料隱私與使用宣告表單（Data Usage & Privacy）

在 Chrome Web Store 的「隱私權實務」（Privacy practices）分頁填寫：

單一用途： 是（Yes）
遠端程式碼（Remote Code）： 否（No，所有程式碼均隨擴充功能打包；模型權重為資料檔，由本機已打包之 ONNX Runtime WASM 執行）。
資料蒐集聲明：
- 網站內容（Website Content）： 本機處理（由 content script 讀取播放進度與曲名，僅於本機記憶體與 LRCLIB 查詢使用，不蒐集或外傳個人身分）。
- 使用者活動（User Activity）： 不蒐集。
- 個人身分資訊（Personally Identifiable Information）： 不蒐集。
- 驗證憑證（Authentication Information）： 不蒐集。
- 財務與付款資訊（Financial and Payment Information）： 不蒐集。
- 健康資訊（Health Information）： 不蒐集。
資料銷售承諾：
- 我保證不會向第三方出售使用者資料。
- 我保證不會將使用者資料用於或轉移至與核心功能無關的目的。
- 我保證不會將使用者資料用於信用評估或貸款核准目的。
隱私權政策網址（Privacy Policy URL）：
- 填入 GitHub Pages 網址：https://des86532.github.io/lyrics-everywhere/（需先在 repo Settings → Pages 將 Source 設為「GitHub Actions」，並合併後等 Deploy privacy policy site 工作流程成功）。

5. 商店素材清單（Store Assets Checklist）

所有素材均已產生並存放於專案根目錄之 store-assets/，亦可隨時透過 pnpm run build:store-assets 重新產出：

商店圖示（Store Icon）：
- 檔案：store-assets/store-icon-128x128.png
- 規格：128×128 PNG（透明度背景，無外框圓角，商店自動切圓角）
螢幕截圖（Screenshots，共 4 張）：
- 規格：1280×800 PNG（符合商店 16:10 強制比例）
- store-assets/screenshot-1-synced-lyrics.png：YouTube 播放畫面 + 側欄動態歌詞滾動，日語漢字振假名與中文空耳標註，珊瑚粉螢光筆高亮（主視覺）。
- store-assets/screenshot-2-timing-settings.png：時間軸即時校正設定彈窗（微調秒數偏移記憶）與空耳顯示偏好（中文近音字/羅馬拼音）。
- store-assets/screenshot-3-manual-lyrics.png：Spotify 播放畫面 + 手動搜尋 LRCLIB 完整開放歌詞庫，多版本即時預覽切換。
- store-assets/screenshot-4-local-transcription.png：現場 Live / 翻唱影片使用本機 WebGPU Whisper 離線辨識自動生成時間戳字幕（強調 100% 隱私保護）。
宣傳橫幅（Promo Tiles）：
- 小型宣傳橫幅（Small Promo Tile，必填/建議）：
  - 檔案：store-assets/promo-tile-small-440x280.png
  - 規格：440×280 PNG
- 大型促銷橫幅（Marquee Promo Tile，選填）：
  - 檔案：store-assets/promo-tile-marquee-1400x560.png
  - 規格：1400×560 PNG

6. 上架操作步驟指南（Step-by-Step Submission Guide）

步驟 1：開發者帳號註冊與登入

開啟 Chrome Web Store 開發者控制台 (Developer Dashboard)。
登入 Google 帳號（請確保已啟用雙重驗證 2FA）。
首次註冊需支付一次性註冊費 $5 美元 並填寫開發者聯絡資訊。

步驟 2：打包並上傳擴充功能套件

於終端機執行：
```
pnpm run package:extension
```
產出套件位於：release/lyrics-everywhere-extension.zip。
在開發者控制台右上角點擊 「新增項目 (New Item)」，上傳該 zip 檔案。

步驟 3：填寫商品資訊（Store Listing）

商品名稱：填入 Lyrics Everywhere 耳邊字幕
摘要（Short Description）：填入第 2 節之簡短說明（≤132 字元）
詳細說明（Detailed Description）：複製第 2 節之詳細說明 Markdown 內容
圖示：上傳 store-assets/store-icon-128x128.png
螢幕截圖：依序上傳 store-assets/screenshot-1-synced-lyrics.png 至 screenshot-4-local-transcription.png
小型宣傳橫幅：上傳 store-assets/promo-tile-small-440x280.png
類別（Category）：選擇 實用工具 (Workflow & Planning / Tools) 或 娛樂 (Entertainment)
官方網站 / 支援網址：填入專案網址或 GitHub 儲存庫

步驟 4：填寫隱私權實務問卷（Privacy Practices）

單一用途聲明：複製第 1 節內容。
權限原因（Permissions）：
- 依序複製第 3 節提供的 Justification（可填中文或英文）。
資料使用情形（Data Usage）：
- 勾選「網站內容 (Website Content)」，說明文字填寫：「依據播放頁面標題與時間於本機進行動態歌詞同步查詢與顯示，不蒐集或外傳個人身分資料。」
- 其餘項目皆勾選「否 (No)」。
- 勾選三項承諾（不向第三方出售資料、不將資料用於非核心功能、不進行信用評估）。
隱私權政策網址：填入已部署的隱私權政策網頁（如 Cloudflare Pages 或 GitHub Pages，對應本專案 site/index.html）。

步驟 5：分發設定（Distribution）

可見度（Visibility）：選擇「公開 (Public)」。
定價（Pricing）：選擇「免費 (Free)」。
發布區域：預設全球所有國家/地區。

步驟 6：提交審查（Submit for Review）

確認所有必填項目皆有綠色勾號。
點擊右上角 「提交以供審查 (Submit for Review)」。
審查時間通常為 1 至 3 個工作天（若遇週末或重大版本更新可能延長至 5 天）。