name	release
description	放置天堂加掛版發版 — 用「日期 tag + 原作者版本號」開一個 GitHub Release（與同步 CI 同一套規則）。當使用者說「發版」「發 Release」「出新版」「發佈新版本」或 /release 時使用。
disable-model-invocation	true

/release — 發版 SOP

與 .github/workflows/sync-upstream.yml 的自動發版同一套規則，差別只在這支是人工觸發（同步 CI 只在「有跟到上游」時才發，加掛版自己改了東西不會觸發）。

tag：vYYYYMMDD-HHMM（台灣時間）
標題：《<遊戲名>》加掛版 <TAG>（原版 <上游 GAME_VERSION>）
說明：固定文字（不列改動清單・2026-07-22 使用者明訂）

不再維護加掛版自己的 semver。version.json 的 app 欄位已無人顯示（afk-syncinfo 首頁只顯示「最後同步原版」），發版不要去動它。

步驟

確認狀態乾淨且已上線
- git fetch origin && git status：工作區要乾淨、本地不落後 origin/main。
- 有未 push 的改動 → 先走 /prepush + push、等 GitHub Pages 上線，再回來發版（發版對象必須是線上已生效的內容）。

取兩個變數

TAG="v$(date -u -d '+8 hours' +%Y%m%d-%H%M)"                                   # 台灣時間（git-bash 的 TZ= 不生效）
VER=$(sed -n "s/.*GAME_VERSION = '\([^']*\)'.*/\1/p" js/00-data.js | head -1)  # 上游版本號
GAME=$(sed -n 's/.*<title>\([^<]*\)<\/title>.*/\1/p' index.html | head -1)     # 遊戲名

三個都要有值才往下走（空值代表核心結構被改過，停下來回報）。

寫說明檔（中文走檔案、不走命令列參數，避免 git-bash 重編碼）

用 Write 工具寫 .scratch/relnotes.md，內容照下面這段固定文字，只把 <遊戲名>／<原版版本> 換掉。 ⚠️ 這段與 .github/workflows/sync-upstream.yml 的 printf 範本必須逐字一致（自動／人工發版是同一套說明），改一邊就要改另一邊：

《<遊戲名>》加掛版 — 已同步原作者最新版（原版版本 <原版版本>），外掛層照常疊加、不改動原遊戲內容（手機版面／掉落查詢／小百科／木人場／賽狗場等，遊戲內「外掛開關」可逐一管理）。

原始碼請由下方 Source code (zip / tar.gz) 下載。
線上遊玩：https://pp771007.github.io/idle-lineage-class/

打 tag + 開 Release

git tag "$TAG" && git push origin "$TAG"
gh release create "$TAG" --title "《${GAME}》加掛版 ${TAG}（原版 ${VER}）" --notes-file .scratch/relnotes.md

同名 tag 已存在（同一分鐘內重跑）→ 等一分鐘換新 TAG，不要 -f 覆蓋既有 release。
用完刪掉 .scratch/relnotes.md。

回報：附 Release 連結給使用者（訊息從 Telegram 來就用 reply）。

判準備忘

不 bump 任何版本號、不 commit、不用等 Pages：這支只打 tag + 開 Release，不動 repo 內容（跟舊版最大的差別）。
舊的 semver tag（v3.4.x）留著當歷史，不要再往下接——version.json 的 app 停在 3.4.10 是已知且無害的（沒有任何畫面讀它）。

Más de este repositorio

mismo repositorio

sync-upstream

pp771007/idle-lineage-class

把本 repo 同步到原作者(shines871)最新版——核心整包換上游原文、資產鏡像、套錨點補丁、重產 manifest/版本、smoke。當使用者說「同步原版」「同步上游」「更新上游」「跟進原作者」或 /sync-upstream 時使用。

2026-07-237

update-wiki

pp771007/idle-lineage-class

放置天堂小百科/掉落查詢的更新 SOP — diff 驅動、逐檔逐頁機械式對照「上游遊戲資料的變動」(錨點=wiki-checkpoint 的 reconciledUpstreamCommit,diff 在上游 clone 做,上限=已同步到的 syncedUpstreamCommit),補進 afk-wiki.js / afk-dex.js / afk-extradata.js,測過再更新 checkpoint。當使用者說「更新小百科」「同步小百科」「補小百科內容」或 /update-wiki 時使用。

2026-07-197

prepush

pp771007/idle-lineage-class

放置天堂專案 push 前的完整檢查與準備 — bump 改動外掛的 ?v=、重算 sw.js 版本、跑 Playwright smoke、檢查衝突標記，全綠才建議 push。當使用者說「準備 push」「push 前檢查」「跑 prepush」或 /prepush 時使用。

2026-07-197

/release — 發版 SOP

tag：vYYYYMMDD-HHMM（台灣時間）

標題：《<遊戲名>》加掛版 <TAG>（原版 <上游 GAME_VERSION>）

說明：固定文字（不列改動清單・2026-07-22 使用者明訂）

不再維護加掛版自己的 semver。version.json 的 app 欄位已無人顯示（afk-syncinfo 首頁只顯示「最後同步原版」），發版不要去動它。

步驟

確認狀態乾淨且已上線

git fetch origin && git status：工作區要乾淨、本地不落後 origin/main。
有未 push 的改動 → 先走 /prepush + push、等 GitHub Pages 上線，再回來發版（發版對象必須是線上已生效的內容）。

取兩個變數

TAG="v$(date -u -d '+8 hours' +%Y%m%d-%H%M)"                                   # 台灣時間（git-bash 的 TZ= 不生效）
VER=$(sed -n "s/.*GAME_VERSION = '\([^']*\)'.*/\1/p" js/00-data.js | head -1)  # 上游版本號
GAME=$(sed -n 's/.*<title>\([^<]*\)<\/title>.*/\1/p' index.html | head -1)     # 遊戲名

三個都要有值才往下走（空值代表核心結構被改過，停下來回報）。

寫說明檔（中文走檔案、不走命令列參數，避免 git-bash 重編碼）

《<遊戲名>》加掛版 — 已同步原作者最新版（原版版本 <原版版本>），外掛層照常疊加、不改動原遊戲內容（手機版面／掉落查詢／小百科／木人場／賽狗場等，遊戲內「外掛開關」可逐一管理）。

原始碼請由下方 Source code (zip / tar.gz) 下載。
線上遊玩：https://pp771007.github.io/idle-lineage-class/

打 tag + 開 Release

git tag "$TAG" && git push origin "$TAG"
gh release create "$TAG" --title "《${GAME}》加掛版 ${TAG}（原版 ${VER}）" --notes-file .scratch/relnotes.md

同名 tag 已存在（同一分鐘內重跑）→ 等一分鐘換新 TAG，不要 -f 覆蓋既有 release。
用完刪掉 .scratch/relnotes.md。

回報：附 Release 連結給使用者（訊息從 Telegram 來就用 reply）。

判準備忘

不 bump 任何版本號、不 commit、不用等 Pages：這支只打 tag + 開 Release，不動 repo 內容（跟舊版最大的差別）。

舊的 semver tag（v3.4.x）留著當歷史，不要再往下接——version.json 的 app 停在 3.4.10 是已知且無害的（沒有任何畫面讀它）。