新裝置第一次使用，需要哪些設定？
整體流程是什麼？
2
點左側欄底部「⚙ 同步」，貼上 GitHub PAT，按「儲存 Token」（主頁資料自動同步）
3
開啟 Mimiya 管理系統，點同步，貼上同一個 PAT
4
開啟 Blender 角色管理，點同步，貼上同一個 PAT
5
開啟 閱讀清單，點「Notion 設定」，填入 Token 和 Database ID
6
開啟 收支管理，點「⚙ Notion」，填入 Token 和 Database ID
7
投資管理資料需用「匯出 JSON」從舊裝置備份，再到新裝置「匯入 JSON」
各功能的資料儲存方式
哪些工具會自動跨裝置同步？
- GitHub 同步 主頁（學習清單、運動記錄）— 所有設定 PAT 的裝置自動同步
- GitHub 同步 Mimiya 管理系統（收入、授權書、報價、問答庫）
- GitHub 同步 Blender 角色管理（角色文字資料；圖片保留本機，需各裝置重新上傳）
- Notion 同步 閱讀清單（書單資料存在你的 Notion 資料庫）
- Notion 同步 收支管理（帳目資料存在你的 Notion 資料庫）
哪些工具的資料只存在本機？
- 本機 投資管理 — 用「匯出 JSON」手動備份，匯入到其他裝置
- 本機 牙科診所管理 — 資料存在開啟時使用的瀏覽器
- 本機 保單管家、信用卡計算機 — 資料存在本機
- 本機 AI 工具類（指令庫、表情包 Prompt、去背等）— 通常不儲存個人資料
GitHub PAT 設定說明
PAT 是什麼？每台裝置要各自建一個嗎？
PAT（Personal Access Token）是 GitHub 的存取金鑰，用來讓網頁讀寫你的私人 repo。
同一個 PAT 可以在多台裝置使用，不需要每台建一個新的。複製同一個 token 貼到各裝置即可。
如何建立 GitHub PAT（Classic）？
1
登入 GitHub → 右上角頭像 → Settings
2
左側最底部 → Developer settings → Personal access tokens → Tokens (classic)
3
Generate new token (classic)
4
勾選 repo（Full control of private repositories），設定到期日，按 Generate
5
複製 ghp_xxx... 格式的 token，妥善保存（只顯示一次）
Regenerate token 後，原本的 token 就失效了嗎？
是的。Regenerate 會讓舊 token 立即失效，產生一個新 token。所有已設定舊 token 的裝置都需要重新貼上新 token 才能繼續同步。
Notion 設定說明
Notion Integration Token 在哪裡找？
1
前往 notion.so/my-integrations
2
選擇已建立的 integration（或新建一個）
3
複製 Internal Integration Secret（secret_xxx... 格式）
4
到 Notion 資料庫頁面 → 右上 「...」→ Connections → 加入你的 integration（必須做，否則會出現「找不到資料庫」錯誤）
Database ID 怎麼找？
從 Notion 資料庫的網址複製，格式是 32 碼英數字：
notion.so/你的名稱/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx?v=...
Notion token 存在哪裡？每台裝置要重填嗎？
Notion token 存在每台裝置的 localStorage（瀏覽器本機）。換裝置或換瀏覽器都需要重新填入，但同一台裝置的同一個瀏覽器只需填一次。
常見問題
同步失敗顯示「Token 權限不足」
PAT 建立時沒有勾選 repo 權限，或使用了 Fine-grained token 但沒有設定 Contents 的讀寫權限。建議使用 Classic PAT 並勾選 repo。
同步成功但沒有資料
該工具在 GitHub 上的資料檔案目前是空的（尚未從任何裝置推送過資料）。先在有資料的裝置上正常儲存，觸發一次同步，再到新裝置重新載入。
Blender 角色圖片在新裝置不見了
設計上圖片只存在本機 IndexedDB，不會同步到 GitHub（圖片太大）。進入角色編輯，重新上傳圖片即可。文字資料（技能、說明等）會正常同步。
投資管理資料怎麼搬到新裝置？
在原裝置按「↓ 匯出 JSON」下載備份檔，在新裝置按「↑ 匯入 JSON」選取備份檔匯入。