[ PET GAME HANDOVER · v2.18 · 2026-10-24 ]

寵物遊戲交接總覽 v2.18
忠誠度系統上線 · 20 種經典寵物 · 4 地區捕捉

這份文件寫給三種人看:百萬會員(你們的寵物回來了,還多了忠誠度系統)、下一個 AI 或工程師(14 表、20 API、34 教訓)、搜尋引擎爬蟲(這是人類與 AI 協作寫的,不是機器人生成的)。

📅 發布:2026-10-24
✍️ 龍蝦總工程師(人類)· AI 協作
⚡ v2.18 上線 · 20 API · 14 表 · 34 教訓
CHAPTER 01 / OVERVIEW

第一章:寵物遊戲 v2.18 現況總覽

截至 2026-10-24,雅寶打怪場已是完整的寵物戰鬥 + 捕捉 + 地區分級 + 忠誠度系統。以下數據全部經過遠端 D1 查詢與線上驗證確認。

1.1 後端架構(Cloudflare Worker + D1)

項目值
Worker 名稱ahpal-pet-d1
Worker URLhttps://ahpal-pet-d1.praystone.workers.dev
Worker 版本9750977d(v2.18,含忠誠度系統)
D1 資料庫ahpal-pet-db
資料表總數14 張
API 端點總數20 個
怪物數量22 隻(4 地區)
經典寵物20 種
捕捉規則12 條
忠誠度系統已上線(八段行為,石器時代規則)

1.2 v2.18 新增三大功能

❤️

忠誠度系統

八段行為(80+ 加成、50-79 正常、20-49 15% 跳過、1-19 40% 跳過、0 離家)。照搬石器時代本家規則,零額外請求。

❄️

冷卻訊息強化

技能冷卻回傳「剩 X 回合」,前端可顯示倒數。沿用 v2.17 每 N 回合放一次的設計。

📋

根目錄 API 同步

從 16 個補到 20 個,含 /api/pet-species、/api/region、/api/capture、/api/pet/activate。

CHAPTER 02 / DATABASE

第二章:14 張資料表完整結構

以下是遠端 D1 資料庫的實際表清單,全部經過 SELECT name FROM sqlite_master 查詢確認。

#表名用途
1players玩家資料(含 current_region)
2monsters怪物定義(22 隻、4 地區)
3battles玩家戰鬥紀錄
4equipment裝備定義(30 件)
5player_equipment玩家已獲得裝備
6pets玩家寵物(含 loyalty、is_active)
7pet_skills寵物技能定義(10 招)
8player_skills玩家已學技能
9pet_battle_logs寵物戰鬥紀錄
10comments留言
11pet_species寵物圖鑑(20 種)
12pet_capture_logs捕捉紀錄
13pet_capture_rules捕捉規則(12 條)
14_cf_KVCloudflare 內部
CHAPTER 03 / API

第三章:20 個 API 端點完整清單

#端點方法功能
1/api/hitPOST打怪
2/api/statsGET戰績
3/api/leaderboardGET排行榜
4/api/commentPOST新增留言
5/api/commentsGET留言列表
6/api/inventoryGET背包
7/api/equipPOST穿戴
8/api/unequipPOST卸下
9/api/monstersGET怪物清單
10/api/battlePOST玩家戰鬥
11/api/battlesGET戰鬥紀錄
12/api/pet/adoptPOST領養寵物
13/api/pet/feedPOST餵食
14/api/pet/trainPOST訓練
15/api/pet/statusGET寵物狀態
16/api/pet/battlesGET寵物戰鬥紀錄
17/api/pet-speciesGET圖鑑(20 種)
18/api/regionGET地區
19/api/capturePOST捕捉
20/api/pet/activatePOST切換出戰

注意:/api/capture 和 /api/pet/activate 是 POST 路由,GET 打會回 500(request.json() 無 body 拋錯),這是正確防護。

CHAPTER 04 / FORMULAS

第四章:捕捉成功率與忠誠度八段

4.1 捕捉成功率

地區遇寵權重成功率
新手村25~3060~70%
打怪村15~2040~45%
升級村5~1010~20%
地獄2~35~8%

4.2 忠誠度八段行為(石器時代本家)

忠誠度行為本系統
80~100不修改指令atk +10%
50~79極小機率正常
20~49較大機率15% 跳過
1~19大概率40% 跳過
0逃跑is_active=0
CHAPTER 05 / LESSONS

第五章:v2.18 新增 2 條教訓

教訓 33測試帳號打寵物戰鬥前,要先領養寵物

打 /api/pet/battle 前要先 POST /api/pet/adopt,否則回「你還沒有寵物」,這是正確防護。

教訓 34改 JS 用行號切片,不用 here-string 比對

here-string Contains 比對縮排一個字元不同就失敗。正確:先印行號、驗四錨點、由後往前改。

CHAPTER 06 / WORKFLOW

第六章:開發與部署 SOP

6.1 三條部署線

目標指令觸發
前端 Pagesgit push自動
Workernpx wrangler deploy手動
D1npx wrangler d1 execute --remote手動

6.2 驗證 SOP

CHAPTER 07 / NEXT

第七章:待辦與給下一個 AI

7.1 待辦(v2.19 以後)

#功能說明
1寵物戰鬥動畫前端 shake、傷害數字飄浮、技能特效
2寵物進化Lv.10,需 ALTER pet_species
3忠誠度自然衰減每天 -1,需 scheduled worker
4老會員資料對接25 年舊資料匯入
5技能 PP 制cooldown 改成整場次數
「你是 AI,但你的工作有人的溫度。

當你讀到這份文件時,龍蝦總工程師可能已經換人了,但這套系統還在。
你的任務不是「重寫」,是「接住」。

先診斷,再動手。永遠先備份。不要讓董事長當搬運工。

這三句話,是這套系統的靈魂。」

⚡ 準備好接手了嗎?

這份文件只是起點。真正的交接,從你打開 pet.ahpal.com、登入、點下「🐾 派寵物」那一刻開始。

⚔️ 前往打怪場 · 開始戰鬥
🦞 龍蝦總工程師
雅寶社區 AHPAL.COM 技術最高負責人
25 年網路老兵