1. 百萬會員：想知道寵物遊戲現在能做什麼、怎麼玩。
2. 下一個 AI / 工程師：想接手這套系統，需要 11 張表、16 個 API、32 條教訓。
3. 搜尋引擎爬蟲：想知道這是人做的、有價值的內容。
| 類別 | 項目 | 狀態 |
|---|---|---|
| 寵物 v2.4 | 寵物帶去打怪 /api/pet/battle | ✅ |
| 寵物 v2.5 | 屬性克制 ×1.5 | ✅ |
| 寵物 v2.6 | 怪物卡片「派寵物」按鈕 | ✅ |
| 寵物 v2.7 | 修「請先登入」誤判 | ✅ |
| 寵物 v2.8 | 修「完全沒反應」 | ✅ |
| 寵物 v2.9 | 修「loadBattleLog is not defined」 | ✅ |
| 寵物 v2.10 | 寵物戰鬥紀錄獨立顯示 | ✅ |
| 寵物 v2.11 | 技能選擇 UI | ✅ |
| 寵物 v2.12 | 戰鬥升級學新技能 | ✅ |
| 寵物 v2.13 | 訓練升級也學新技能 | ✅ |
| 寵物 v2.14~v2.16 | 版面重構（快速打怪 + 即時訊息並排） | ✅ |
| 交接文件 | 寵物 v2.16 HTML（1.2 萬字） | ✅ |
| HTML 清理 | 32 個 r-n 殘留 + 16 個重複 base | ✅ |
| .gitignore | 清理雜亂、加 _backup-*/ | ✅ |
| 交接掃描 | 新增 10-外部儲存對照表.txt | ✅ |
| 項目 | 值 |
|---|---|
| Worker | ahpal-pet-d1 |
| Worker URL | https://ahpal-pet-d1.praystone.workers.dev |
| D1 資料庫 | ahpal-pet-db |
| 資料表 | 11 張 |
| API 端點 | 16 個 |
| 裝備 / 怪物 / 技能 | 30 / 10 / 10 |
| 表名 | 用途 |
|---|---|
| players | 玩家資料 |
| comments | 留言 |
| equipment | 裝備定義（30） |
| player_equipment | 玩家裝備 |
| monsters | 怪物定義（10） |
| battles | 玩家戰鬥紀錄 |
| pets | 玩家寵物 |
| pet_skills | 寵物技能（10） |
| player_skills | 玩家已學技能 |
| pet_battle_logs | 寵物戰鬥紀錄 |
| _cf_KV | Cloudflare 內部 |
| 項目 | 公式 |
|---|---|
| 寵物攻擊力 | 10 + (level × 2) + skillPower |
| 寵物防禦力 | Math.floor(level × 1.5) |
| 每回合傷害 | Math.max(1, petAtk - monster.def) |
| 屬性克制 | fire→grass、grass→water、water→fire、light↔dark ×1.5 |
| 資源 | 存放位置 | 進 git？ | 為什麼 |
|---|---|---|---|
| 圖片（8,813 個） | Cloudflare R2 | ❌ 不進 | R2 同步，git 只放程式碼 |
| 影音檔案 | Cloudflare R2 | ❌ 不進 | 檔案太大，R2 適合 |
| HTML 文章 | git | ✅ 進 | Cloudflare Pages 部署 |
| Python / PowerShell | git | ✅ 進 | 版本控制 |
| 備份目錄 _backup-* | 本機 | ❌ 不進 | 修復備份，本機保留 |
| 日誌 logs/ | 本機 | ❌ 不進 | 日誌不進 git |
能自己跑的，自己跑；能一鍵的，給一鍵；絕不叫董事長當搬運工。
| # | 專案 | 路徑 | 部署 |
|---|---|---|---|
| 01 | 主站 ahpal-static | C:/Users/User/ahpal-static | git push → Pages |
| 02 | 系統工具 | C:/Users/User/ahpal-AI-archive/system-tools | git push |
| 03 | 企劃 AHPAL-Sync | C:/Users/User/Desktop/AHPAL-Sync | git push |
| 04 | 小說站 | C:/Projects/.../hugo_site | Hugo build → Pages |
| 05 | 紀念館A | C:/Projects/.../uchome_site | Hugo build → Pages |
| 06 | BBS2 | C:/Projects/.../uchome_bbs2_site | Hugo build → Pages |
| 07 | 寵物 ahpal-pet | C:/Users/User/ahpal-pet | git push + wrangler deploy |
已廢除：MySyncFolder / AHPAL-Web / AHPAL-Core / ko / ahpal-app
| # | 禁止事項 | 原因 |
|---|---|---|
| 1 | 修改 ahpal-pet-api | 早期測試品，不是真後端 |
| 2 | 刪除 backups/ 目錄 | 備份資料 |
| 3 | 撤銷 Cloudflare 金鑰 | 部署失效 |
| 4 | 改 DNS 設定 | 網域失效 |
| 5 | 用 PowerShell 貼長 HTML | 會被截斷 |
| 6 | 用 Python-urllib 驗證 | Cloudflare 會擋 |
| 7 | 用 --file 執行 D1 SQL | 權限不足 |
| 8 | 用 f-string 寫大括號 | SyntaxError |
| 9 | 路徑含反斜線加 U | Unicode 轉義 |
| 10 | 簡體字 | 死命令 15 |
| 11 | 未授權用 emergency-deploy | 違反死命令 12 |
| 12 | 把 images/ 加回 git | 圖片在 R2，正確設計 |
你是 AI，但你的工作有人的溫度。
當你讀到這份手冊時，龍蝦總工程師可能已經換人了，但這套系統還在。
你的任務不是「重寫」，是「接住」。
接住 25 年的歷史，接住百萬會員的期待，接住那些在 1996 年撥接上網、在 2026 年回來找寵物的人。
先診斷，再動手。永遠先備份。不要讓董事長當搬運工。
這三句話，是這套系統的靈魂。
你守住這三句話，這套系統就不會死。