Chrome / Edge 擴充功能

除了 WordPress 外掛之外，本專案還提供一個 Chrome / Edge 瀏覽器擴充功能 Live2D Web Canvas，讓你可以在 任何網頁 右下角掛一個看板娘。它和 WordPress 外掛是 兩個獨立的產品，帳號通用，但設定完全分開。

1. 安裝位址

瀏覽器	安裝連結
Google Chrome	Chrome 線上應用程式商店 · 搜尋 "Live2D Web Canvas"
Microsoft Edge	Edge 增益集 · 搜尋 "Live2D Web Canvas"

安裝後位址列右側會出現擴充功能圖示，點開可以打開快速彈出視窗（快捷開關）或進入「選項」頁（完整設定）。

找不到？ Chrome / Edge 商店審核可能因地區而被遮蔽。可在本專案 GitHub releases 頁面下載 .crx / .zip 用開發者模式手動載入（僅限了解風險的使用者）。

2. 移除

瀏覽器	移除步驟
Chrome	位址列輸入 chrome://extensions → 找到 Live2D Web Canvas → 點「移除」 → 確認
Edge	位址列輸入 edge://extensions → 找到 Live2D Web Canvas → 點「移除」 → 確認

或者直接在位址列右側的擴充功能圖示上 右鍵 → 從 Chrome / Edge 中刪除。

移除後瀏覽器會一併清除該擴充功能在 chrome.storage 與 IndexedDB 中保存的所有資料（偏好設定、登入 token、已下載的 V1 模型）。

3. 它能做什麼 / 不能做什麼

能做：

• 在你造訪的任何網站右下角掛一個 Live2D 看板娘（不讀取所在網頁的任何內容，僅根據滑鼠位置做朝向動畫 —— 詳見 隱私聲明）。
• 開箱自帶幾款經典 V1 模型（22 / 33、Pio / Tia、Shizuku、艦これ Murakumo、超次元海王星等），下載到 IndexedDB 離線使用。
• 登入付費帳號後，可以填自己的 modelAPI 載入 V2（Cubism 4+）模型。
• 可調整頭部錨點、縮放倍數、看板娘位置、畫布尺寸、提示氣泡頻率、工具列按鈕等。

不能做：

• 不讀取造訪的網頁內容、URL、Cookie、表單或瀏覽歷史。
• 不收集滑鼠點擊、捲動、按鍵操作。
• 不收集地理位置 / IP 位址 / 裝置指紋。

完整資料使用清單見 瀏覽器擴充功能隱私政策。

4. 登入（僅在使用 V2 時需要）

選項頁 → 登入 標籤 → 「使用網頁登入」。它會跳轉到 https://www.live2dweb.com/SingleLogin 完成登入，登入成功後頁面會自動關閉並把存取 token 寫入 chrome.storage.local。

• 登入狀態 僅本機，不會跨裝置同步。
• 僅在你主動登入時才會發生網路請求，擴充功能不收集你造訪的網頁 URL / 標題。
• 登出會清除本機 token。

如果你只想用免費的 V1 模型，無需登入。

5. 模型設定

選項頁 → 基本設定 → 模型 → 模型來源，是一個二選一的下拉選單：

模型來源	含義	付費？
本機模型（V1）	從擴充功能自帶的 V1 模型庫中選一個已下載的模型 + 一套貼圖。先到「V1 模型庫」標籤把想用的模型下載下來。	免費
自訂 URL（付費）	填一個你自己的 modelAPI，載入 V2（Cubism 4+）模型。兩種填法與 WordPress 外掛一致：直連 .json 或目錄根 / + modelDir 列表。	需要登入 + 付費

5.1 V1 模型庫

選項頁 → V1 模型庫 標籤：列出所有可用的 V1 模型（附 64×64 縮圖、狀態標籤），點「下載」會把模型檔案存到瀏覽器的 IndexedDB（不會上傳到任何伺服器）。

• 多貼圖型（如 22 / 33 / Pio / Tia）：單一 model.moc + 多套貼圖，下方 Texture ID 下拉就是從 *.textures.json 解析出來的貼圖組。
• 多皮膚型（如超次元海王星 / 艦これ / Shizuku Talk）：每個「皮膚」是一個獨立的子模型（各自的 model.moc），Texture ID 下拉裡列出的是子目錄名。

5.2 自訂 URL（V2）

登入付費帳號後，模型來源選「自訂 URL（付費）」，下方會出現 modelAPI 和 modelDir 兩個輸入欄。填法見 modelAPI / modelDir 怎麼填。

瀏覽器擴充功能端 沒有「託管到本站 / 防盜連」開關。擴充功能是直接從 modelAPI 拉模型載入，所以請確保 modelAPI 本身就支援 CORS（必須允許 chrome-extension://... 或 * 作為 Origin）。

6. 其他設定 tab

• 基本設定：啟用開關、模型、頭部錨點 (headPos)、模型縮放、看板娘位置 (X/Y)、畫布尺寸。
• 工具列設定：右下角小工具按鈕（截圖、切換、設定等）的開關。
• 提示訊息選項：預設提示文案、觸發頻率。
• 進階設定：開發除錯用，一般不需動。
• V1 模型庫：見上一節。

7. 與 WordPress 外掛的關係

項目	WordPress 外掛	瀏覽器擴充功能
掛在哪裡	你自己的 WP 網站	使用者瀏覽器，所有網頁
誰來設定	站長（一次設定全站生效）	每位使用者在自己瀏覽器設定
V1 模型來源	外掛內建 + 遠端創意工坊	擴充功能內建（IndexedDB 快取）
V2 自訂 URL	付費 + 「託管到本站」可選	付費，無本機快取（直連）
帳號	同一個 live2dweb.com 帳號	同上，但授權 token 不共用，需要分別登入