這份 HTML 是「補充說明」。真正的交接正門是 `ai-handover-scan.ps1` 產出的 11 個 .txt，放在 `C:\Users\User\ahpal-AI-archive\ai交接-YYYY-MM-DD_HH-MM-SS\`。下一個 AI 請先讀那 11 個 txt，再讀這份 HTML。
記錄「腳本掃不出來的東西」：工作原則、決策脈絡、血淚教訓、SOP。掃描檔給事實，這份給判斷。
能自己跑的自己跑，能一鍵的給一鍵。禁止叫董事長複製貼上長字串。
沒看到真實資料，不准下斷言、不准幻想。
改動前備份，寫入前後檢查大小 > 5000。
PowerShell 貼長 HTML 會被截斷清空。
Worker: npx wrangler deploy / Pages: npx wrangler pages deploy / D1: --remote
嚴禁簡體字。
改功能前先看現有程式碼與資料。
「已更新」不代表成功，要用 requests 抓線上內容。
失敗就說失敗，不掩蓋。
技術決策直接做，只有安全性疑慮（撤金鑰、刪備份、改 DNS）才請示。
「能自己跑的，自己跑；能一鍵的，給一鍵；絕不叫董事長當搬運工。」
| # | 專案 | 路徑 | 檔案數 | 大小 |
|---|---|---|---|---|
| 01 | 主站 | C:\Users\User\ahpal-static | 27,474 | 1008 MB |
| 02 | 系統工具 | C:\Users\User\ahpal-AI-archive\system-tools | 345 | 101 MB |
| 03 | 企劃 | C:\Users\User\Desktop\AHPAL-Sync | 402 | 190 MB |
| 04 | 小說站 | C:\Projects\...\hugo_site | 39,534 | 2962 MB |
| 05 | 紀念館A | C:\Projects\...\uchome_site | 21,812 | 763 MB |
| 06 | BBS2 | C:\Projects\...\uchome_bbs2_site | 24,469 | 995 MB |
| 07 | 寵物遊戲 | C:\Users\User\ahpal-pet | 43 | 0.32 MB |
MySyncFolder / AHPAL-Web / AHPAL-Core / ko / ahpal-app
| 表名 | 用途 | 筆數 |
|---|---|---|
| players | 玩家 | 動態 |
| comments | 留言 | 動態 |
| equipment | 裝備定義 | 30 |
| player_equipment | 玩家裝備 | 動態 |
| monsters | 怪物定義 | 10 |
| battles | 戰鬥紀錄 | 動態 |
| pets 🆕 | 玩家寵物 | 動態 |
| pet_skills 🆕 | 寵物技能定義 | 10 |
| player_skills 🆕 | 玩家已學技能 | 動態 |
| pet_battle_logs 🆕 | 寵物戰鬥紀錄 | 動態 |
| _cf_KV | Cloudflare 內部，不動 | - |
| 方法 | 端點 | 功能 |
|---|---|---|
| POST | /api/hit | 打怪（含掉落） |
| GET | /api/stats | 查戰績 |
| GET | /api/leaderboard | 排行榜 |
| POST | /api/comment | 留言 |
| GET | /api/comments | 留言列表 |
| GET | /api/inventory | 背包 |
| POST | /api/equip | 穿戴 |
| POST | /api/unequip | 卸下 |
| GET | /api/monsters | 怪物列表 |
| POST | /api/battle | 回合制戰鬥 |
| GET | /api/battles | 戰鬥紀錄 |
| POST | /api/pet/adopt 🆕 | 領養寵物 |
| POST | /api/pet/feed 🆕 | 餵食（+20 飢餓） |
| POST | /api/pet/train 🆕 | 訓練（+10 exp、-10 飢餓） |
| GET | /api/pet/status 🆕 | 寵物狀態 + 技能 |
17KB HTML 貼上變 0 bytes。解法：Python 腳本寫檔。
Windows 的 npx 是 .cmd，subprocess.run(["npx",...]) 找不到。解法：shell=True 或 npx.cmd。
OAuth Token 對 import 端點權限不夠。解法：改用 --command 逐條跑，SQL 壓成單行。
query 端點不支援多行。解法：壓成單行（" ".join(s.split())）。
urllib 預設 UA 被擋成 403/404。解法：用 requests + 瀏覽器 UA。
f"… {x} …} …" 會 SyntaxError。解法：改用字串串接。
比較大小寫變化要用 -cne。
-replace 和 .Replace() 沒先確認字串存在，會靜默失敗。
不是 main 的話，push 只產生 Preview，pet.ahpal.com 不動。
不需要「手動拉」，看到 ed06c363.ahpal-pet.pages.dev 是部署識別碼，pet.ahpal.com 會自動跟上。
漏了 ahpal-pet 的話，[Z] 安全同步不會含寵物遊戲。
上次插入造成 "},\n}," 連續兩個逗號，PowerShell 語法錯誤。
| 情境 | 動作 |
|---|---|
| 出門前（工作機） | cd C:\Users\User\ahpal-AI-archive\system-tools; .\git-manager.ps1 → [Z] |
| 回家後（外出機） | 同上，跑 [Z] |
| 不確定時 | 跑 [Z]，永遠不會錯 |
| 改前端（Pages） | git push 到 main → 自動部署（Production branch=main 已確認） |
| 改 Worker | cd worker; npx wrangler deploy（永遠手動） |
| 改 D1 | npx wrangler d1 execute --remote（永遠手動） |
system-tools / ahpal-static / AHPAL-Sync / ahpal-novels / ahpal-memories / ahpal-memories-bbs2 / ahpal-pet
| 用途 | 指令 |
|---|---|
| 交接掃描（產 11 txt） | cd C:\Users\User\ahpal-static; .\scripts\ai-handover-scan.ps1 -NoPause |
| 雙機同步（7 repo） | cd C:\Users\User\ahpal-AI-archive\system-tools; .\git-manager.ps1 → [Z] |
| Worker 部署 | cd C:\Users\User\ahpal-pet\worker; npx wrangler deploy |
| D1 查表 | npx wrangler d1 execute ahpal-pet-db --remote --command="SELECT name FROM sqlite_master WHERE type='table';" |
| Pages 強制部署 | cd C:\Users\User\ahpal-pet; npx wrangler pages deploy . --project-name=ahpal-pet --branch=main --commit-dirty=true |
| 死命令檢查 | cd C:\Users\User\ahpal-static; .\scripts\preflight-check.ps1 |
| 項目 | 值 |
|---|---|
| 版號 | v11.10 FINAL |
| 更新日期 | 2026-10-20 深夜 |
| 維護者 | 🦞 龍蝦總工程師 |
| 產生方式 | Python 腳本（本檔案由 deploy_handover_v1110.py 自動產出） |
| 檔案路徑 | docs\ 與 strategy\ 各一份 |
| 項目 | v11.9 | v11.10 |
|---|---|---|
| 專案數 | 6 | 7（加 ahpal-pet） |
| Repo 數 | 6 | 7 |
| 寵物遊戲 | v2.2 | v2.3（4 表 + 4 API） |
| 血淚教訓 | 6 條 | 12 條 |
| 交接正門 | HTML | ai-handover-scan.ps1 產出的 11 txt |