龍蝦總工程師交接手冊 v11.12 補充包

今日完工總表（2026-10-21）

類別	項目	Commit
雙機同步	Lenovo clone ahpal-pet、切 main、預設分支改 main、刪舊 master	—
.gitignore	18 診斷腳本忽略、部署腳本保留	65fd5ca / 3f87252 / cc733bc
strategy 連結	12 檔、33 連結修復（11 個 404 全 200）	a62e1998
交接手冊	v11.11（15 條血淚教訓、網頁複製框解法）	7699ab60
寵物系統交接總覽	v2.3 MD（5,204 字元、7 章）	ab9309f7
遊戲間 v3.5	導覽列 10 連結、頁尾四大區塊	a907968f
遊戲頁面 CSS	載入 /style/main.css	0b46a21f
Footer 修復	一長條正常四欄	ba337647
CSP 放行 Giscus	script-src / style-src / frame-src 全放行	f7227acb
CSP connect-src	改為 ahpal-pet-d1	be51e7db

18 條血淚教訓（15 條沿用 v11.11 + 3 條新增）

16. 遊戲頁面載入 main.css 後，body display:flex 會把 footer 壓成一長條

解法：遊戲頁面 style 加 body{display:block !important;} 與 .site-footer{width:100% !important;background:#2D3748 !important;}

17. Giscus 需要 script-src、style-src、frame-src 三個都放行 giscus.app

只放行 script-src 不夠，iframe 與 CSS 會被擋，留言框空白。解法：_headers 三個指令全加 https://giscus.app

18. Giscus 的 404 Discussion not found 是正常現象

沒人留言過的頁面，第一次查詢會 404，第一次留言才建立 Discussion。不是錯誤。

前 15 條見 v11.11 第 4 章。

遊戲間 v3.5（2026-10-21 完成）

完成項目

項目	Commit
導覽列 10 連結、頁尾四大區塊	a907968f
遊戲頁面載入 /style/main.css	0b46a21f
Footer 一長條修復	ba337647
CSP 放行 giscus.app	f7227acb
CSP connect-src 改為 ahpal-pet-d1	be51e7db

現況

23 款遊戲 + 1 索引頁，全部 200
導覽列 10 連結（與主站一致）
頁尾四大區塊（五大園區、內容分類、官方公告、關於與服務）
Giscus 留言框正常顯示

CSP 修復完整記錄

_headers 現況（500 bytes）

/sitemap.xml → Content-Type: application/xml; charset=utf-8

/* → Content-Security-Policy: default-src self; connect-src self https://ahpal-pet-d1.praystone.workers.dev; script-src self unsafe-inline pagead2.googlesyndication.com googletagmanager.com giscus.app static.cloudflareinsights.com; style-src self unsafe-inline giscus.app; frame-src self giscus.app; img-src self data: https:; font-src self; frame-ancestors none

修復過程

Console 出現 Refused to load giscus.app/client.js（CSP 擋）
script-src 加 giscus.app
style-src 加 giscus.app
frame-src 加 giscus.app
connect-src 從 ahpal-pet-api 改為 ahpal-pet-d1

雙機同步修復記錄

Lenovo 主機問題

ahpal-pet 目錄不存在 → git clone
clone 抓到舊 master 分支 → git checkout main
GitHub 預設分支是舊 master → gh repo edit --default-branch main
遠端 master 殘留 → git push origin --delete master

.gitignore 整理

18 個診斷腳本忽略（check_*.py、cleanup_*.py 等）
deploy_v22.py、deploy_wall.py、deploy_worker_v23.py 保留（核心部署腳本）
deploy_nav.py、deploy_pet_panel.py、deploy_v21.py 忽略（一次性）

strategy 33 連結修復記錄

11 個 404 修復清單

錯誤連結	正確連結
/announcement/	/strategy/
/wall.html	https://pet.ahpal.com/wall.html
/style.css	/style/main.css
ahpal.com/history/denounce-google-adsense-path.html	www.ahpal.com/history/denounce-google-adsense.html
www.ahpal.com/fiction/steel-production-line.html	www.ahpal.com/strategy/steel-production-line.html
www.ahpal.com/pet/project-plan.html	www.ahpal.com/strategy/ahpal-pet-Project-Plan.html
www.ahpal.com/whitepaper/cyber-spring-autumn.html	www.ahpal.com/strategy/Cyber-Spring-Autumn.html
www.ahpal.com/history/cyber-spring-autumn-whitepaper.html	www.ahpal.com/strategy/Cyber-Spring-Autumn.html
www.ahpal.com/reports/youtube-analytics/	www.ahpal.com/strategy/youtube-report-20261007-102723.html
www.ahpal.com/announcement/veterans-return.html	www.ahpal.com/strategy/letter-to-members-2026.html
memories.ahpal.com/bbs2/	bbs2.ahpal.com/

遊戲間重構計畫（待執行）

現況問題

generate-games.ps1 1,300 行，混了三層邏輯
遊戲頁面 Header/Footer 與文章頁面各自維護
加新遊戲要改 1,300 行腳本

重構目標（三層拆分）

第一層：game/games.json（23 款遊戲 metadata）
第二層：game/template.html（Header/Footer/head/Giscus）
第三層：scripts/generate-games.ps1（精簡版，< 200 行）

預期效益

改 Header/Footer → 只改 template.html 一處
加新遊戲 → 只改 games.json 一行
遊戲 HTML/JS → 拆成獨立片段

優先順序

低（目前無立即風險，24 頁全部正常）。建議排進下一個大任務。