| name | update-wiki |
| description | 放置天堂小百科/掉落查詢的更新 SOP — diff 驅動、逐檔逐頁機械式對照「上游遊戲資料的變動」(錨點=wiki-checkpoint 的 reconciledUpstreamCommit,diff 在上游 clone 做,上限=已同步到的 syncedUpstreamCommit),補進 afk-wiki.js / afk-dex.js / afk-extradata.js,測過再更新 checkpoint。當使用者說「更新小百科」「同步小百科」「補小百科內容」或 /update-wiki 時使用。 |
| disable-model-invocation | true |
/update-wiki — 小百科更新 SOP(純上游鏡像架構版)
對應 CLAUDE.md「📚 小百科/掉落查詢維護」。這是 diff 驅動、機械式逐項對照的流程,絕不可憑印象判斷「前面做過了」就跳步(踩過漏整個模式)。
架構=純上游鏡像+外掛(2026-07-19 起):遊戲資料的變動來源只有上游同步,所以 diff 一律在上游 clone(D:/otherPersonRepos/idle-lineage-class)做,錨點記「上游 commit」:
- BASE:
wiki-checkpoint.json 的 reconciledUpstreamCommit(小百科已反映到哪個上游 commit)。
- TARGET:
upstream-checkpoint.json 的 syncedUpstreamCommit(遊戲現在鏡像到哪)。只能對齊到這裡——上游更新但還沒 sync 的部分,遊戲裡沒有,不要提前寫進小百科(先跑 /sync-upstream)。
鐵則(動手前先記住)
- 🔴 先
git fetch origin && git pull --rebase origin main(本 repo,別的 session/裝置可能推過),並 git -C <clone> fetch 確認 clone 不是舊的。
- 🔴 diff 要整段逐項勾過,即使覺得做過了也要看完。
- 🔴 diff 不只看「新增的資料定義」,更要看「既有公式/機制被改」——機制改動不會以新
sk_/item 出現,純掃新增一定漏。重點讀 js/02-stats、js/04-combat、js/01-drops、js/05-kill 裡被修改的成對 -/+ 行。
- 🔴 同一主題的 wiki 內容可能同時存在兩處:「資料陣列」(如
COMBAT_SECTIONS)和「自寫 render 函式」(如 renderMode 自己 inline 建表)。改了 grep 命中的那處 ≠ 改完。 判準:改完一定要 render 實測那一頁(步驟 5),不能只靠 Edit 成功就當完成(踩過)。
- 🔴 上游 commit message 全是「1」,一律讀 diff 本身。
⚠️ 轉換期一次性任務(做完把 checkpoint note 裡的旗標拿掉)
2026-07-19 改鏡像架構時,遊戲一口氣進了所有上游功能——包含舊「選擇性移植」時代各輪未移植/略過的項目(它們從沒進過小百科)。首次跑本 skill 時,除了 BASE..TARGET diff,還要:
- 翻
upstream-reviews/*.md 四份報告的「移植進度總表/移植狀態欄」,列出所有 未移植/使用者略過 的項目——這些現在都在遊戲裡了,逐項確認小百科/掉落查詢有沒有反映,沒有就照本 SOP 補。
- 完成後在
wiki-checkpoint.json 的 note 註明「舊報告未移植項已全數掃過」,之後的輪次就不用再翻舊報告。
步驟
-
同步 + 取錨點
git fetch origin && git pull --rebase origin main;git -C <clone> fetch origin --quiet。- BASE=
wiki-checkpoint.json 的 reconciledUpstreamCommit;TARGET=upstream-checkpoint.json 的 syncedUpstreamCommit(別用 git log 猜)。BASE==TARGET 且無轉換期任務 → 回報「無需更新」結束。
-
列出所有變動的檔(不挑)
git -C <clone> diff BASE..TARGET --stat -- js/ css/- 清單上每個有變的檔都要讀,不可只挑「看起來有新東西」的。
-
逐檔讀完整 diff,照「檔 → 負責頁」對照表歸位(git -C <clone> diff BASE..TARGET -- js/<檔>,新增的 + 與修改的 -/+ 成對都讀):
| 改到的檔 | 看什麼 | 對應頁 / dex |
|---|
00-data | 新 技能/物品/套裝/武器/地圖/怪 | 職業魔法·裝備(自動) / 套裝 SETS(手動) / 掉落查詢 |
01-drops | 掉率、世界模式(席琳一般/瘋狂)、恩賜 | 席琳 / 掉落查詢 / 戰鬥機制 |
02-stats | 屬性/衍生值公式、buff、封頂 | 能力值 / 技能效果 |
03-04 combat | 傷害公式、命中、武器特效 proc、強化倍率、異常狀態 | 戰鬥機制 / 武器特性 / 強化 |
05-kill | 條件式掉落(if … gainItem)、經驗/升級 | 掉落查詢 SPECIAL_BLOCKS |
06-status-allies | 新異常狀態 kind、傭兵、召喚 | 戰鬥機制 / 傭兵 / 帶寵物 |
07-08 | 施法、裝備規則 | 職業魔法 / 裝備 |
10-ui-tabs | 物品說明產生器(buildItemDescHTML)、遺物說明 | 裝備(自動) / 遺物顯示 |
11-world-map | 地圖/領域 | 地圖 |
12-npc-quests | 任務/試煉/兌換、倉庫、收集冊 | 任務 / 掉落來源 / 卡片·裝備圖鑑 |
13-shop-save | 商店、存檔、遊戲模式(一般/經典/傳統) | 戰鬥機制(模式) / 卡片·裝備圖鑑(共用桶) |
14-craft-pandora | 製作配方、潘朵拉 | 製作 |
15-16、18 | 卡片/裝備/道具收集(掉落、積分、共用、加成) | 卡片 / 裝備·道具圖鑑 |
21-relic-book | 遺物圖鑑 | 遺物相關頁 |
22-pets、23-summons | 寵物/召喚 | 帶寵物 |
24-pandora-relic-market | 遺物市場/流浪玩家收購 | 相關頁(必要時新開) |
-
補內容(分自動 / 手動)
- 自動同步的(
MASTERY_DATA、DB.skills、DB.items、掉落表、buildItemDescHTML)通常不用改。
- 手動維護的才要補:
WEAPON_TRAITS/SETS/ENHANCE_SECTIONS/LOAD_SECTIONS/SHERINE_SECTIONS/PLEDGE_SECTIONS/TOWER_SECTIONS/QUEST_BY_CLASS/QUEST_COMMON/MAGIC_FACT(職業魔法「實際數據」金框,在 afk-wiki.js)。
- ⭐ 全域條件式掉落(
if(條件) gainItem,不在任一怪 MOB_DROPS)→ 補進 afk-dex.js 的 SPECIAL_BLOCKS(否則掉落查詢搜不到,聖地遺物踩過)。
- ⭐ 新掉落表 / 客製製作 / 純兌換成品 → 比對原作
_auditMobDrops 讀哪些表照抄進 buildIndexes(表數以它為權威,別信文件裡的張數);客製製作(如 DEMONKING_RECIPES/LUMIEL_RECIPES)補進 buildCraftIndex+renderCraft;純兌換補 afk-extradata.js 的 AFK_EXTRA.itemAcquire[id].short。
- ⭐ 翻譯:渲染結果出現連續英文(HP/MP/BOSS/Lv 除外)就是漏翻 → 補對應表(
STATUS_LABEL/STAT_LABEL/AFK_EXTRA.mapName;地圖漏翻 smoke 會擋)。
- 內容鐵則:表格優先、用程式實際數據/公式(別抄遊戲說明文字)、白話零術語、AC 用負值、不要 changelog 語氣、不要表格下方散文重述、掉率把四個倍率一次講完。
-
每動一頁就 Playwright 無頭實測該頁:數據對、無漏翻英文、無 raw key(sk_/地圖 id)、無 JS error;關鍵數字用 page.evaluate 直接呼叫遊戲函式對。
-
收尾
node scripts/stamp-code-versions.mjs(?v= 自動對齊,含 afk-*.js)+ node scripts/stamp-sw-version.mjs(或直接跑 /prepush)。- 更新
wiki-checkpoint.json:reconciledUpstreamCommit=TARGET 完整 sha、reconciledAt=台灣時間(git-bash 用 date -u -d '+8 hours'),note 寫「逐檔對過、動了哪些頁」,跟改動一起 commit。
