它是「索引」,不是「全文」。細節全部在交接包的 .txt 裡,HTML 不重寫細節,避免兩邊不同步。
交接包在哪:C:\Users\User\ahpal-AI-archive\ai交接-<最新時間戳>\ 裡面有 18 個 .txt,按下面順序讀。
| 順序 | 檔案 | 去這裡查什麼 |
|---|---|---|
| 1 | 00-總覽-入口.txt | 先讀這個,全站總覽,知道有幾個專案、幾個 repo |
| 2 | 11-工作SOP-拋射與驗證.txt / 13-工作SOP-索引.txt | 動手前必查:你的任務對應哪個 SOP、抄哪支範本 |
| 3 | 12-工具鏈地圖.txt / 15-腳本清單-全站.txt | 工具在哪、腳本在哪,不要自己造輪子,先看現成的 |
| 4 | 09-雙機同步地圖.txt / 11-雙機同步-操作手冊.txt | 雙機同步怎麼跑,A 電腦 / B 電腦怎麼對 |
| 5 | 07-主站交接精華.txt / 14-主站-人格口號死命令.txt | 主站人格、口號、死命令,不能改的在這裡 |
| 6 | 01-主站-掃描.txt | 主站 ahpal-static:檔案數、12 分類、關鍵檔案 |
| 7 | 02-系統工具-掃描.txt | 系統工具:D1、git-manager 在哪 |
| 8 | 03-企劃-掃描.txt | 企劃 AHPAL-Sync:企劃檔在哪 |
| 9 | 04-小說站-掃描.txt | 小說站 ahpal-novels |
| 10 | 05-紀念館A-掃描.txt | 紀念館 A ahpal-memories (UCHome) |
| 11 | 06-紀念館B-BBS2-掃描.txt | 紀念館 B ahpal-memories-bbs2 |
| 12 | 07-寵物遊戲-事實.txt | 寵物遊戲 ahpal-pet:事實,不要猜 |
| 13 | 08-開心農場-事實.txt | 開心農場 ahpal-farm:事實,不要猜 |
| 14 | 09-工具箱-掃描.txt | 工具箱 ahpal-tools |
| 15 | 10-百科全書-掃描.txt | 百科 ahpal-wiki |
| 16 | 12-外部儲存-對照表.txt | 外部儲存、D1、R2 對照 |
| 17 | 17-全站部署地圖.txt | 全站部署:誰部署到哪、Pages / Worker / D1 |
| 18 | 20-專案索引-10備忘錄.txt | 10 個專案備忘錄,projects\ 裡面 |
| 腳本 | 路徑 | 用途 |
|---|---|---|
| dump-d1-schema.ps1 | ahpal-AI-archive\system-tools\dump-d1-schema.ps1 | 撈 D1 完整結構,交接先撈這個 |
| git-manager.ps1 | ahpal-AI-archive\system-tools\git-manager.ps1 | 8 個 repo 管理,同步用這支 |
| deploy_handover.py | ahpal-ai-archive-git\handover\SOP\deploy_handover.py | 產這張交接手冊 HTML,正式版是 deploy_handover_official.py |
| 任務 | 必讀 SOP | 抄哪支範本 |
|---|---|---|
| 改掃描器(加專案) | 10.8 + 10.32 | split-output2.py |
| 改掃描器(加 SOP 章節) | 10.8 + 10.17補 | modify-handover-*.py |
| 加 SOP 章節(sop-*.txt) | 10.3.1 | add-readme.py |
| 改 PowerShell 腳本(長內容) | 10.8 + 10.15 | PowerShell 陣列 + 絕對路徑 |
| 新增文章 / 批次生成 | 21 + 22 + 23 | auto-batch-* |
| 部署 / Cloudflare Pages | 31 | GitHub Actions |
| 改 sitemap | 34 | update_sitemap() |
| 改 canonical | 33 + 35 | 三刀 SOP |
| tools ↔ wiki 切割 | 33 | 六刀 SOP |
| 一條龍(拋射) | 49.3 | 一條龍模板 |
變數命名鐵律:PowerShell 變數大小寫不敏感,迴圈變數會覆蓋函數參數。解法:函數參數用一個名字,迴圈變數用另一個名字,永遠不撞名。詳細去 13-工作SOP-索引.txt 查。
工具:C:\Users\User\ahpal-announcements-worker\公告管理-announcements-D1.ps1,資料庫 ahpal-announcements-db,表 announcements
流程:先 List,再 Get,再 Update,不要直接 Update。ID 是 GUID,用 List 抄。
換文案:不要換行,用 5 個半形空格分隔;連結用完整 https://,AI 靈感卡一定要是 https://tools.ahpal.com/ai-inspiration-card/
換圖標:圖標就是 emoji 放最前面,例如 🛠 📖 ✨,不要用圖片圖標,換完手機看一次。
wrangler:底層 npx wrangler d1 execute ahpal-announcements-db --remote --command=SQL --json,--remote 不能拿掉,SQL 單引號變兩個。
速查表:C:\Users\User\ahpal-announcements-worker\WRONGLER語法.txt
1. 備份 AHPAL-Handover-FINAL- 舊版(只備一次,不備 .bak)→ 2. 寫 docs/ 新版 → 3. copy 到 strategy/ → 4. git add docs strategy → 5. commit → 6. push → 7. 等 40 秒,帶 User-Agent 驗證線上是不是 200。