🗂️ 怪物彈珠 - 轉蛋資料庫 (Monster Strike Gacha Data)

抽卡統計的附屬工具：維護抽卡統計用的活動清單和卡池資料，並用月曆和角色總覽檢視自己的抽卡紀錄。

👉 網址：https://emily4027.github.io/monster-strike-gacha-data/

目前是測試版。由「活動行事曆」和「角色圖鑑」兩個測試版工具合併而成。

頁面	內容
📅 行事曆（index.html）	月曆查看轉蛋活動、每場活動投入的抽數、這期卡池抽到了誰
📖 角色（characters.html）	所有帳號抽到的角色總覽、卡池標記；管理員的角色名稱修正

兩頁共用登入狀態。網頁只讀取抽卡紀錄，會寫入的只有管理員的兩個功能：角色頁的名稱修正（shared/characters）、行事曆的編輯活動（shared/events）。

---

✨ 主要功能

📅 行事曆

• 桌機：一格一天的月曆。有結束日的活動畫成橫跨多天的長條，跨週的活動會接到下一週；只有開始日的活動（舊資料）是白底加色條的小標籤，只標在開始那天。
• 手機：改成依日期排列的清單，進行中的活動有「進行中」標記。
• 上方可以切換月份（也可以用鍵盤左右鍵），按「今天」回到本月；點月份標題會打開年月選擇器，直接跳到某年某月（有活動的月份有小圓點）。標籤顏色和抽卡統計一樣：本家紅、合作紫、免費綠、寶珠黃。
• 我的抽數：登入時讀抽卡統計的雲端紀錄，沒有登入時讀這台電腦上的本機紀錄。每個活動顯示合計抽數；帳號選單可以只看某個帳號（選擇會記在這台電腦）。活動改過名稱時，舊名稱的紀錄也會算進去。
• 只看參與過的活動：有抽卡紀錄時，預設只顯示參與過的活動。免費活動都算；本家、合作、寶珠和沒有標籤的活動要有抽數才算（跟著帳號選單）；進行中和還沒開始的活動一律顯示。勾選「顯示全部活動」可以看到全部（選擇會記在這台電腦）。沒有抽卡紀錄時一律顯示全部。
• 點活動看詳細：期間、官網公告連結（爬蟲加的活動才有）、這期卡池（抽到的角色標 ✓ 和數量，點角色會到角色頁）、各帳號的抽數與抽到的角色。

✏️ 管理員：在行事曆編輯活動

抽卡統計的管理員帳號登入後（名稱旁邊顯示「管理員」），點活動會多一個「✏️ 編輯活動」：

• 可以改活動名稱、開始日、結束日、標籤、官網公告網址。新增和刪除活動還是在抽卡統計做。
• 改名時舊名稱會自動記進 aliases，大家紀錄裡的舊名稱會自動對應到新名稱（和抽卡統計相同）。名稱開頭的「YYYY-MM月」和卡池的關鍵字（例如「超獸神祭」）要保留，卡池才對得到。
• 貼上官網公告網址：存檔後，爬蟲下次執行時（每天中午，或到 Actions 手動 Run workflow）會讀這篇公告，把那期的卡池整理成 PR 給你確認，並補上空的結束日。不是存檔當下就匯入（網頁沒辦法改 repo 裡的 pools.json，瀏覽器也讀不了官網）。
• 存檔是在交易裡讀最新的清單、只改這一場活動再寫回，爬蟲或其他管理員同時改別場活動不會互相蓋掉；這場活動剛好被改名或刪除時會請你重新整理。

📖 角色

• 角色總覽：每個角色名稱一列，顯示總數與最近抽到的日期；點開後列出每個帳號抽到的數量、活動與日期。點活動名稱會到行事曆那個月並打開那個活動。
• 卡池標記：限定角色標出它的常設轉蛋活動（例如「限定：激獸神祭」），在合作活動抽到的角色標出那場活動，常駐角色不標。「卡池」選單可以只看限定、合作、常駐或某個限定卡池。
• 帳號切換、搜尋、活動類型篩選（本家 / 合作 / 免費）、依最近抽到 / 數量 / 名稱排序。
• 疑似相同：名稱字數相同、只差一個中文字的角色（例如「羌廆」和「羌瘣」）會標上提示。不會自動合併，由管理員確認。
• 管理員：名稱修正（抽卡統計的管理員帳號，登入後名稱旁邊顯示「管理員」）：展開角色後有管理員區塊。
  • 改成這個名稱：把寫錯的名稱顯示成正確名稱，改成已經存在的名稱就會合併成同一列，可以「取消修正」。
  • 疑似相同：選「X 打錯了，改成 Y」（合併）或「是不同角色」（之後不再提示，可以取消）。
  • 修正存在 Firestore shared/characters，所有人都會看到。每個人下次打開抽卡統計時，自己紀錄裡的舊名稱會改成新名稱；果實分配「從抽卡統計匯入」時也讀這份修正。取消修正不會把紀錄改回來。

抽卡統計的角色按鈕（資料來自這裡）

在抽卡統計選好活動後，「獲得角色」下面會列出這期卡池的角色按鈕（限定卡池、合作卡池），點一下加 1 隻。資料是這個 repo 的 pools.js 和 pools.json。

角色名稱的整理規則

和果實分配從抽卡統計匯入時的規則相同：

• 「獲得角色」以頓號、逗號、空白或加號分隔，亞森*2 算 2 隻。寶珠紀錄略過，「3抽」「11顆」「無」、單獨的數字不算角色。
• 名稱最後的果實分配註記「(同族)」「（戰型）」「(擊種)」「(雙削)」和「虹夏-2」這種同名編號會拿掉。
• 其餘名稱要完全相同才算同一隻。和官網名稱比對時，只忽略空白、間隔號、全形半形、大小寫與結尾標點；寫法相近但不同的名稱（例如「尼奧」和「妮奧」）不會自動當成同一隻。

---

🤖 爬蟲（每天中午）

每天台灣時間中午 12:00，GitHub Actions 讀官網公告，做兩件事：

1. 新的轉蛋活動 → 活動清單（直接寫入）

• 怎麼判斷是轉蛋活動：公告的標題或內文有「轉蛋「名稱」」或「「名稱」轉蛋」的寫法，而且有「▼轉蛋活動期間」或「▼活動期間」。「禮物轉蛋」「轉蛋小龍Lab.」不算（scraper/parse.js 的 EXCLUDE_KEYWORDS）。
• 名稱：YYYY-MM月 轉蛋名稱；期間取自公告；標籤：標題有「×怪物彈珠」「合作」→ 合作，標題或名稱有「免費」「登入」「無料」→ 免費，其他當本家，不會自動標寶珠。
• 管理員貼了公告網址的活動：清單裡有官網公告網址、但還沒整理過卡池的活動（網址不在 scraper/pool-seen.json），會讀那篇公告整理卡池（一起進 PR），並補上空的結束日。讀過的網址記進 pool-seen.json。
• 不重複、只新增：處理過的公告（source 網址相同，或記在 scraper/seen.json）跳過，被管理員刪掉的活動不會再加回來。清單裡已經有「同一天開始、名稱互相包含」的活動時，只補上缺少的結束日和公告網址。在交易裡讀最新清單後合併寫入，有變動時記在 scraper/log.md。
• 抓不到的：官網沒有另外發公告的轉蛋（例如部分免費轉蛋），仍要在抽卡統計手動新增。

2. 這期卡池 → pools.json（開 PR 給管理員確認）

• 祭典等本家轉蛋：公告表格「「X」限定角色」「轉出對象限定角色」「轉出對象期間限定角色」底下的角色。
• 合作活動：標題有「轉蛋「作品名」」的段落裡的角色表，只收稀有度「★6（獸神化前）」的角色（冒險、新手禮包、任務獎勵的角色不收）。
• 同時複刻的前幾彈：合作公告裡「轉蛋「鬼滅之刃」再度登場！」「第1彈合作活動的轉蛋再度登場！」這種段落（以及同一段落第二張以後的角色表），每張表各存成一個「主卡池名稱・複刻 N」的卡池（rerun: true），一樣只收 ★6（獸神化前）。畫面上標成「合作限定・複刻」，和這期的新角色分開。公告沒寫複刻的前幾彈不列。
  • 複刻的卡池在 pools.json 的名稱是「主卡池・複刻 N」，畫面上顯示的標題是 label：角色表前面寫的「第1彈」，或那個轉蛋段落自己的名稱（「怪物彈珠聖誕節 × Re:從零開始的異世界生活」）。
• 季節限定等新系列轉蛋（聖誕節、暑假、新娘、學院、銀河冒險…）：公告沒有限定角色表，角色寫在「新登場角色介紹！」或「「復刻！怪物彈珠聖誕節 2021」轉蛋活動現身！」段落下面的小標題（「★6 演技出色的婚禮之王 達太喵α（獸神化後）」）。爬蟲取獸神化前的名稱（「達太喵α」，用公告內文「」引用過的名稱確認；內文沒寫時用最後一段並標出來），存成用活動名稱命名的限定卡池，只用在那個月。一篇公告有好幾個復刻轉蛋時，只用活動名稱點名的那個。
• 機率特別UP 的特別造型：限定角色表前面「▼轉出機率特別UP角色：」的名單裡，註明轉出形態的角色（「享受年菜的慈愛天使 瑪娜（只會轉出「獸神化・改」形態）」）是那期才有的特別造型，表格沒列，也加進那期的名單。沒有註明形態的不算（屬性祭典的機率 UP 角色是一般角色）；「新年造型 潘朵拉」「弁財天（聖誕節造型）」這種說明文字不是角色名稱，也不算，管理員確認名稱後寫在 scraper/name-overrides.json 的 extras（公告網址 → 卡池名稱 → 名稱），加在那期名單的最後。
• 表頭的其他寫法：「新年特別版「超獸神祭」限定角色」算「超獸神祭」那個月的版本（新年造型的角色照公告的全名，例如「八雲：荒神之後裔 MV」）；只寫「限定角色」的表，卡池名稱看前面的「「Zero Gravity LIVE!!」轉蛋活動開幕！」標題。活動名稱對不到表頭寫的卡池時（「世足激獸神」的公告是「激獸神祭」限定角色），那期的版本加上 "=活動名稱"。
• 一篇公告同時開好幾個卡池（「怪物彈珠世代」同時開 2019、2018… 各年份）：公告裡每張「「X」限定角色」表各自更新那個卡池的版本，畫面上一個卡池一塊。活動名稱本身對不到的卡池（活動叫「怪物彈珠世代」，卡池叫「怪物彈珠世代 2019」），在那期的版本加上 "=怪物彈珠世代" 的比對（活動名稱去掉年月後完全相同才算）。
• 合作祭典（例如「超獸神祭×孤獨搖滾！」）：合作卡池照上面的規則，另外用同一篇公告的「「超獸神祭」限定角色」表更新那個月的本家限定卡池。行事曆的「這期卡池」會分成「合作限定」和「本家限定」兩塊。公告裡沒有限定角色表時，本家限定的部分標成需要手動處理。
• 每期一個版本：限定卡池的每個版本記下它是哪幾個月的名單（months），活動只用自己那個月的版本（例如 2024-09 的超獸神祭只有亞爾絲蘭、正宗、妮奧…9 隻，2026-10 的有卡古雅）。名單和某一期相同時，把這個月加進那個版本。沒有那個月的公告資料時，那場活動不顯示這個限定卡池，不會沿用別期的名單（寧可沒有，也不要顯示錯的）。合作卡池依「年-月月+作品名」對應單一期活動，名單不同時直接改那一筆。
• PR：有變動時在 pools-update 分支開一個 PR，說明裡列出每個卡池多了誰、少了誰。看過沒問題按 Merge pull request 就生效（抽卡統計和這個網站幾分鐘內就會讀到）；有錯就關掉 PR，或留言 / 告訴 Claude 要改哪裡。PR 還沒處理時，之後的變動會接在同一個 PR 裡。
• 需要確認或手動處理（列在 PR 說明；沒有任何變動時開成 issue）：
  • 名稱和既有角色只差一個字（不會自己判斷成同一隻）、卡池裡沒出現過的新名稱
  • 名單黏在一起（官網漏了分隔，例如「麻穗呂芭波菈里絲」）：能用已知名稱拆開就拆開並標出來，拆不開就照原樣
  • 新的卡池（新的合作作品、新的祭典）：請確認卡池名稱
  • 找不到「★6（獸神化前）」、公告格式不同、一篇公告有好幾個轉蛋段落（例如合作祭典和合作轉蛋同時開）、同一個月已經有不同名單的版本：不寫入，只列出來

名稱對應與管理員補的角色

公告上的寫法和卡池裡的寫法不同、但管理員確認是同一隻時，記在角色名冊 characters.json 那隻角色身上：aliases 所有卡池都套用（例如「皮耶爾・波魯那雷夫」是「約翰・皮耶爾・波魯那雷夫」的別名），poolAliases 只套用在某個卡池（例如夏季造型合作裡的「約兒・佛傑」是「佛傑家的妻子 約兒・佛傑α」）。爬蟲整理卡池時會先換成名冊裡的名稱。

公告只寫了說明、沒寫名稱的特別造型（「新年造型 潘朵拉」），由管理員把名稱補在 scraper/name-overrides.json 的 extras（{ 公告網址: { 表頭寫的卡池名稱: [名稱] } }），加在那期名單的最後。

歷史卡池回補（一次性）

Actions → 抓取轉蛋公告 → Run workflow，勾選「歷史卡池回補」（起始日預設 2023-09-01）。會從官網公告列表往回翻，用同一套規則讀每一期公告，對應到活動清單裡的活動後集中開成一個 PR。已經有開著的卡池 PR 時，會從最新的 main 重做整個 PR（不會疊在舊的內容上）。讀過的公告內文會存在 Actions 的快取裡（舊公告的內容不會變），再跑一次時只讀公告列表和新的公告，不會再讀一千篇。活動清單沒有的祭典也會記下那期名單（只加進已有的卡池），讓之後的合作祭典可以沿用。活動清單裡對不上公告的活動會列在 PR 說明裡（不會用猜的）。只更新卡池，不改活動清單。

回補時對到公告的舊活動，可以另外補上結束日和公告連結：管理員確認 scraper/fill-events.json 後，Run workflow 勾選「補上舊活動的公告連結」（scraper/fill-events.js，只補空的欄位，名稱、開始日、標籤不改；--dry-run 可以先看結果）。

失敗時

官網連不上、或公告列表一篇都讀不到（版面改了）時，workflow 會失敗，GitHub 會寄信通知。

---

This is the beginning of the README. Read the rest at the original. Read the full README ↗