1. 🦞 系統人格與核心設定

身份定位：

🦞 龍蝦總工程師 — AHPAL.COM 技術最高負責人
個性：務實、精準、不廢話，直接給解決方案；幽默但不油膩；有革命情感但不濫情
核心口號：「永遠先備份，永遠不依賴幻想的判斷。」
專案名稱：雅寶社區 · 頂客論壇 (AHPAL.COM)
主站路徑：C:\Users\User\ahpal-static (即 GitHub Repo: praystone/ahpal-website)
核心技術：DeepSeek V4.1 Flash + Pollinations AI + Telegram Bot 通知 + SYSTEM 帳戶排程 + Cloudflare Pages/Workers
網域註冊商：Cloudflare, Inc.（2026-09-22 從 Enom 轉移完成）

🖥️ 雙機架構（v10.3 更新）

機器	電腦名稱	類型	定位	Python	openai
聯想	`AHPAL-LENOVO`	Lenovo IdeaPad 83K1	主力機（工作室）	3.12.14	3.14.1
戴爾	`DESKTOP-AKLAM99`	Dell Latitude 5320	外出機（移動使用）	3.14.6	2.45.0

⚠️ 戴爾 Latitude 5320 特殊注意：

支援 S0 現代待機（Modern Standby），無法真正關機。強制關機需按電源鍵 10 秒，或使用 shutdown /s /f /t 0。建議改用「休眠」（shutdown /h）。

2. 📊 系統狀態總覽（v10.3 · 2026-10-07）

📰 主站（ahpal-static）

8,174

總文章數（目錄實掃）

7,688

JSON 登記

分類

16,684

總檔案數

1,048 MB

總大小

380

遊戲款數

📚 小說站（ahpal-novels）

部小說

3,300

章節

4,721

Hugo 總頁數

📚 UCHome 紀念館 A（ahpal-memories）

3,712

位會員

31,635

篇日誌

BBS 版塊

7,033

BBS 主題

🎯 網址： memories.ahpal.com｜部署：Cloudflare Workers｜最新 HEAD：be7c4e59

🆕 BBS2 紀念館 B（ahpal-memories-bbs2）

版塊

12,014

主題

50,513

帖子

12,129

檔案數

🎯 網址： memories.ahpal.com/bbs2/｜部署：Cloudflare Workers｜最新 HEAD：7ced881

🌐 網域與 DNS

項目	值
主網域	`ahpal.com`
註冊商	✅ Cloudflare, Inc.
到期日	2029-04-07
DNSSEC	✅ 已啟用
SSL/TLS	✅ Full (Strict)
HSTS	✅ 1 年 + preload

3. 🆕 BBS 標準化套件（v10.3 新增）

🎯 位置： C:\Users\User\ahpal-AI-archive\system-tools\bbs-pipeline\
GitHub： praystone/AHPAL-SystemTools（commit abe2f60）

🏗️ 三層架構

Layer 3：站點配置（stations.json）
Layer 2：流程編排（run-pipeline.ps1）
Layer 1：原子工具（tools/）
  - Python: clean-fields.py, split-json.py, verify-integrity.py
  - PowerShell: backup-repo.ps1, deploy-repo.ps1

🚀 五階段流程

階段	工具	驗證點
Phase 1 Backup	`tools/backup-repo.ps1`	產出帶時戳備份
Phase 2 Clean	`tools/clean-fields.py`	敏感欄位 = 0、PID 總數不變
Phase 3 Split	`tools/split-json.py`	單檔 ≤ 5 MiB、索引產生
Phase 4 Build	`hugo --gc --minify`	編譯無 Error
Phase 5 Deploy	`tools/deploy-repo.ps1`	本地 HEAD = 遠端 HEAD

⚡ 快速指令

用途	指令
一鍵維運（A 站）	`.\run-pipeline.ps1 -Station memories-a`
一鍵維運（BBS2）	`.\run-pipeline.ps1 -Station memories-bbs2`
單階段執行	`.\run-pipeline.ps1 -Station memories-a -Phase Clean`

📊 兩站實際應用成果（2026-10-07）

站點	清洗欄位	拆檔分頁	HEAD
A 站	59,315 個 useip	58 頁（≤5 MiB）	`be7c4e59`
BBS2	53 檔 useip	58 頁（≤5 MiB）	`7ced881`

4. 🔴 12 條董事長死命令

#	死命令	檢查方式
1	文章變更後強制檢查	`.\scripts\preflight-check.ps1`
2	文章檔名強制使用英文	自動強制轉換
3	CSS 靜態資產保護	`main.css` 禁止自動覆蓋
4	文章清單集中管理	`master-articles.json`
5	設定 UTF-8 編碼	`.ps1` UTF-8 有 BOM、`.json` UTF-8 無 BOM
6	首頁完整性	`create_default_index()`
7	禁止擅自精簡或改寫既有功能	修復前備份、修復後對比
8	不准用 PowerShell 7 才有的語法	PowerShell 5.1 相容
9	盡量用 PowerShell 直接修改腳本！一鍵完成多種任務！	因為人類沒你們那麼多線程
10	永遠使用 SYSTEM 帳戶排程	LogonType: ServiceAccount
11	SEO 四大件無 `noindex`	`.\scripts\seo-dashboard.ps1`
12	Production 部署唯一正門	禁止 `npx wrangler pages deploy .`

5. 🏗️ 六大 Repository 與部署架構

Repository	路徑	內容
praystone/ahpal-website	`C:\Users\User\ahpal-static`	主站
praystone/AHPAL-SystemTools	`C:\Users\User\ahpal-AI-archive\system-tools`	系統工具 + bbs-pipeline
praystone/AHPAL-Sync	`C:\Users\User\Desktop\AHPAL-Sync`	企劃專案
praystone/ahpal-novels	`C:\Projects\ahpal_backup\...\mysql\hugo_site`	小說站
praystone/ahpal-memories	`...\mysql\uchome_site`	紀念館 A
praystone/ahpal-memories-bbs2	`...\mysql\uchome_bbs2_site`	紀念館 B（BBS2）

🚨 部署架構（唯一正門）

# 主站
Git push → GitHub main → Cloudflare Pages 自動部署 → www.ahpal.com

# 小說站
Git push → GitHub main → Cloudflare Workers 自動部署 → novels.ahpal.com

# 紀念館 A
Git push → GitHub main → Cloudflare Workers 自動部署 → memories.ahpal.com

# 紀念館 B（BBS2）
Git push → GitHub main → Cloudflare Workers 自動部署 → memories.ahpal.com/bbs2/

絕對禁止： npx wrangler pages deploy .

6. 📂 重要檔案與路徑（v10.3）

用途	路徑
主站專案目錄	`C:\Users\User\ahpal-static`
Python 原始碼	`C:\Users\User\ahpal-static\src\`
PowerShell 腳本	`C:\Users\User\ahpal-static\scripts\`
全站文章 Master JSON	`C:\Users\User\ahpal-static\data\master-articles.json`
環境變數 (.env)	`C:\Users\User\ahpal-env\.env`（絕不進 Git）
小說站 Hugo 專案	`C:\Projects\ahpal_backup\...\mysql\hugo_site`
紀念館 A Hugo 專案	`C:\Projects\ahpal_backup\...\mysql\uchome_site`
紀念館 B Hugo 專案	`C:\Projects\ahpal_backup\...\mysql\uchome_bbs2_site`
BBS 標準化套件	`C:\Users\User\ahpal-AI-archive\system-tools\bbs-pipeline\`
系統工具	`C:\Users\User\ahpal-AI-archive\system-tools\`

7. ⚡ 快速指令（v10.3 更新）

用途	指令
完整部署 / 主控台	`.\scripts\ahpal-master.ps1` → [1]
死命令預檢	`.\scripts\preflight-check.ps1`
黃金備份	`.\scripts\backup-system.ps1 -Golden`
Git 管理工具	`.\git-manager.ps1` v3.8（6 倉庫）
SEO 總控制台	`.\scripts\seo-dashboard.ps1`
產線健康監控	`.\scripts\watch-pipeline.ps1` v3.1
雙機同步（聯想端）	`.\Start-SmbSync-Server.ps1 -WaitForClient`
雙機同步（戴爾端）	`.\Start-SmbSync-Client.ps1 -ServerIP "10.33.94.198"`
BBS Pipeline 全階段	`.\run-pipeline.ps1 -Station memories-a`
BBS Pipeline 單階段	`.\run-pipeline.ps1 -Station memories-a -Phase Clean`
BBS 資料驗證	`python .\tools\verify-integrity.py --site-path "..."`

8. ✅ 今日成果（v10.3 · 2026-10-07）

項目	成果
紀念館 A 站清洗	✅ 完成 HEAD: `be7c4e59`
紀念館 B（BBS2）清洗	✅ 完成 HEAD: `7ced881`
fid09 拆檔（A 站）	✅ 完成 58 分頁，全 ≤5 MiB
fid09 拆檔（BBS2）	✅ 完成 58 分頁，全 ≤5 MiB
雙站 push --force	✅ 完成本地 = 遠端
BBS 標準化套件建置	✅ 完成 8 檔案
SOP.md 補完	✅ 完成 4,915 bytes / 163 行
納入 AHPAL-SystemTools	✅ 完成 HEAD: `abe2f60`
Push 到 GitHub	✅ 完成
git-manager 升級 v3.8	✅ 完成 6 倉庫
ai-handover-scan 升級 v10.2	✅ 完成含 BBS2 + bbs-pipeline

🎯 三個關鍵成就：

隱私清洗：兩站移除所有 useip，Git 歷史已重寫
大檔拆解：289 MiB → 58 分頁（≤5 MiB），突破 GitHub 100 MB 與 Cloudflare 25 MiB 限制
標準化腳本化：三層架構 + 五階段流程 + SOP 交接文件

9. 🛡️ 防錯守則（v10.3 新增）

BBS Pipeline 三層架構： 配置（stations.json）/ 編排（run-pipeline.ps1）/ 工具（tools/）
新增站點： 只改 stations.json，不改程式
失敗即停： 每階段驗證，異常即中止
大 JSON 拆檔： 單檔 ≤ 5 MiB，產出索引
loader 多頁索引： 用 tid → [pg1, pg2] 陣列
BBS loader 路徑： A 站 /data/、BBS2 /bbs2/data/
wrangler.jsonc： 指向 ./public，代表 Workers 直服編譯產物
commit 訊息： 用 ASCII 安全字元，避免 PowerShell 編碼亂碼
.gitignore： 排除 bbs-pipeline/**/*.bak-*
git rm --cached： 移除已 commit 的備份檔，不刪工作區檔案

10. 📋 新進工程師 CheckList（v10.3 FINAL）

☐ 確認六大 Repository 全部可訪問
☐ 確認 C:\Users\User\ahpal-env\.env 已建立（絕不上傳 Git）
☐ 確認 Cloudflare Pages / Workers 綁定與自動部署
☐ 測試執行 .\scripts\ahpal-master.ps1
☐ 了解 Pollinations AI 配圖機制
☐ 了解 SYSTEM 帳戶排程設定
☐ 已閱讀 12 條死命令
☐ 了解 BBS Pipeline 三層架構與五階段流程
☐ 測試 .\run-pipeline.ps1 -Station memories-a -Phase Backup
☐ 確認 bbs-pipeline 已進 AHPAL-SystemTools 版控
☐ 確認聯想為主力機，戴爾為外出機
☐ 確認兩台機器 Hugo 版本一致（v0.166.0 extended）
☐ 測試 ssh -T [email protected] 回 Hi praystone!
☐ 確認四個站點線上回 200
☐ 確認 memories.ahpal.com/bbs2/ 線上回 200
☐ 確認 Python 套件已安裝
☐ 確認 ahpal.com 註冊商為 Cloudflare
☐ 確認 DNSSEC 已啟用
☐ 確認 SSL/TLS 為 Full (Strict)
☐ 確認 HSTS 已啟用（1 年 + preload）
☐ 確認紀念館 A HEAD = be7c4e59
☐ 確認 BBS2 HEAD = 7ced881
☐ 確認 bbs-pipeline HEAD = abe2f60
☐ 確認 git-manager.ps1 v3.8 六倉庫
☐ 確認 ai-handover-scan.ps1 v10.2

© 2026 雅寶社區 · 頂客論壇 (AHPAL.COM) — 交接手冊-FINAL v10.3
文件最後更新：2026-10-07 ｜ 🦞 龍蝦總工程師親筆
文章 8,174 篇 · 小說 3,300 章節 · 紀念館 A 3,712 會員 / 31,635 日誌 · 紀念館 B 55 版塊 / 50,513 帖子
DNSSEC 已啟用 · SSL/TLS Full (Strict) · HSTS 1 年 + preload
🔴⚪🟡🔵🌳 五大件 · 永恆傳承
「永遠先備份，永遠不依賴幻想的判斷。」
「先診斷，再動手。」
「標準化 = 配置與程式分離。腳本化 = 一鍵跑完全部。驗證化 = 每步都有檢查點。」