截至 2026-10-24,雅寶打怪場已是完整的寵物戰鬥 + 捕捉 + 地區分級 + 忠誠度系統。以下數據全部經過遠端 D1 查詢與線上驗證確認。
1.1 後端架構(Cloudflare Worker + D1)
| 項目 | 值 |
|---|
| Worker 名稱 | ahpal-pet-d1 |
| Worker URL | https://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。
以下是遠端 D1 資料庫的實際表清單,全部經過 SELECT name FROM sqlite_master 查詢確認。
| # | 表名 | 用途 |
|---|
| 1 | players | 玩家資料(含 current_region) |
| 2 | monsters | 怪物定義(22 隻、4 地區) |
| 3 | battles | 玩家戰鬥紀錄 |
| 4 | equipment | 裝備定義(30 件) |
| 5 | player_equipment | 玩家已獲得裝備 |
| 6 | pets | 玩家寵物(含 loyalty、is_active) |
| 7 | pet_skills | 寵物技能定義(10 招) |
| 8 | player_skills | 玩家已學技能 |
| 9 | pet_battle_logs | 寵物戰鬥紀錄 |
| 10 | comments | 留言 |
| 11 | pet_species | 寵物圖鑑(20 種) |
| 12 | pet_capture_logs | 捕捉紀錄 |
| 13 | pet_capture_rules | 捕捉規則(12 條) |
| 14 | _cf_KV | Cloudflare 內部 |
| # | 端點 | 方法 | 功能 |
|---|
| 1 | /api/hit | POST | 打怪 |
| 2 | /api/stats | GET | 戰績 |
| 3 | /api/leaderboard | GET | 排行榜 |
| 4 | /api/comment | POST | 新增留言 |
| 5 | /api/comments | GET | 留言列表 |
| 6 | /api/inventory | GET | 背包 |
| 7 | /api/equip | POST | 穿戴 |
| 8 | /api/unequip | POST | 卸下 |
| 9 | /api/monsters | GET | 怪物清單 |
| 10 | /api/battle | POST | 玩家戰鬥 |
| 11 | /api/battles | GET | 戰鬥紀錄 |
| 12 | /api/pet/adopt | POST | 領養寵物 |
| 13 | /api/pet/feed | POST | 餵食 |
| 14 | /api/pet/train | POST | 訓練 |
| 15 | /api/pet/status | GET | 寵物狀態 |
| 16 | /api/pet/battles | GET | 寵物戰鬥紀錄 |
| 17 | /api/pet-species | GET | 圖鑑(20 種) |
| 18 | /api/region | GET | 地區 |
| 19 | /api/capture | POST | 捕捉 |
| 20 | /api/pet/activate | POST | 切換出戰 |
注意:/api/capture 和 /api/pet/activate 是 POST 路由,GET 打會回 500(request.json() 無 body 拋錯),這是正確防護。
教訓 33測試帳號打寵物戰鬥前,要先領養寵物打 /api/pet/battle 前要先 POST /api/pet/adopt,否則回「你還沒有寵物」,這是正確防護。
教訓 34改 JS 用行號切片,不用 here-string 比對here-string Contains 比對縮排一個字元不同就失敗。正確:先印行號、驗四錨點、由後往前改。
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 年網路老兵