0. 🆕 v9.0 重大更新摘要

本版新增（相對 v8.0）：

✅ 小說站模板 v1.0 完成（深色系 + 閱讀器 + 回訪機制）
✅ 小說站上線（novels.ahpal.com 四層頁面回 200）
✅ 小說站 Git 清理（移除 _backup-phase* 和 public-test/ 追蹤）
✅ 小說站地雷處理（兩顆 novels.bak-* 搬到 _trash，省 1.31 GB）
✅ JSON 對帳機制（ai-handover-scan.ps1 v10.0 新增）
✅ 主站專案分析（發現 424 篇 JSON 落差）
✅ 今日教訓（先診斷、再備份、後動手）

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

身份定位：

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

🖥️ 雙機架構

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

📌 架構說明：

聯想為主要開發與部署機台。戴爾為外出攜帶機。兩台透過 Git 同步，路徑必須完全一致，Hugo 版本必須一致（v0.166.0 extended）。

⚠️ 戴爾 Latitude 5320 特殊注意：

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

💔 2026-08 多收費事件

DeepSeek 因系統障眼法問題，儲值成了 100 USD。隔天竟然還漲價三倍！技術團隊決定「不爽跑」，導致 08-21 ~ 08-29 產線停滯 9 天。

教訓：永遠先備份，永遠不依賴幻想的判斷。

🚨 2026-09-13 .env 資安事件

發現 https://ahpal-pages.pages.dev/.env 回傳 200，代表 .env 被公開在 Cloudflare Pages 上。

後續處理：

✅ .env 移到 C:\Users\User\ahpal-env\.env
✅ Cloudflare WAF 規則「Block .env access」
✅ 停用 pages.dev 預覽部署
✅ 撤銷所有 API Key（5 個服務）

🆕 2026-10-04 小說站 v1.0 完成

✅ 深色系模板（#0D1117 + 金字 + 青字）
✅ 閱讀器（字級、行距、主題切換）
✅ 回訪機制（localStorage 記進度）
✅ 三層頁面（首頁 / 目錄 / 章節）
✅ 上線（novels.ahpal.com 四層頁面回 200）

2. 📊 系統狀態總覽（v9.0）

📰 主站（ahpal-static）— 雙口徑

7,715

目錄實掃

7,291

JSON 登記

424

落差

12

分類

🔴 重要：

「目錄實掃」不等於「JSON 登記」。master-articles.json 只登記 7,291 筆，但目錄實際有 7,715 篇。落差 424 篇，需逐一分類處理。

對帳明細見 04b-JSON對帳明細.txt。

📂 12 大分類明細（2026-10-04 最新）

分類	目錄	目錄實掃	JSON 登記	落差
📜 歷史腦洞	`history`	590	586	+4
💻 3C 科技教學	`tech`	431	346	+85
🎮 遊戲攻略	`game`	380	280	+100
🏠 生活小常識	`life`	795	736	+59
📊 軟體評測	`review`	483	392	+91
🌟 人生哲理	`philosophy`	435	423	+12
🤖 AI 趨勢	`trend`	477	416	+61
🎵 影音創作	`music`	655	650	+5
🌳 動植物生態	`nature`	782	782	0
🚗 汽機車DIY	`car`	614	614	0
🧳 旅遊攻略	`travel`	734	732	+2
🍜 美食探索	`food`	1,339	1,331	+8
總計		7,715	7,291	+424

📚 小說站（ahpal-novels）v1.0

20

部小說

3,320

.md 檔

3,325

Hugo 總頁數

13

模板檔

📌 v8.0 的「4,721 頁」是舊數字：

包含 content/novels.bak-* 備份殘留。清理後正確頁數是 3,325 頁。

🌐 網域與 DNS

項目	值
網域	`ahpal.com`
註冊商	✅ Cloudflare, Inc.
到期日	2029-04-07
DNS 代管	`clayton.ns.cloudflare.com` / `princess.ns.cloudflare.com`
DNSSEC	✅ 已啟用
SSL/TLS	✅ Full (Strict)
HSTS	✅ 1 年 + preload
主站	`ahpal.com` / `www.ahpal.com` → Cloudflare Pages
小說站	`novels.ahpal.com` → Cloudflare Workers

3. 🏗️ 四大 Repository 與部署架構

📦 四大 Repository

Repository	權限 / 路徑	內容與權責
praystone/ahpal-website	Public `C:\Users\User\ahpal-static`	主站：Python AI Agent、PowerShell 腳本、HTML、文章資料庫
praystone/AHPAL-SystemTools	Public `C:\Users\User\ahpal-AI-archive\system-tools`	系統工具（雙機同步）
praystone/AHPAL-Sync	Public `C:\Users\User\Desktop\AHPAL-Sync`	企劃專案倉庫（含企劃專案/、訴訟資料/、軟體設備/）
praystone/ahpal-novels	Public `C:\Projects\ahpal_backup\...\mysql\hugo_site`	小說站：Hugo 專案、20 部小說、3,320 章節

🚨 部署架構（唯一正門）

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

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

絕對禁止： npx wrangler pages deploy .

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. ⭐ 三大核心原則與防錯守則

永遠不依賴 main.py 的判斷邏輯 — 直接呼叫 article_generator.generate_article()
永遠使用 SYSTEM 帳戶排程 — LogonType: ServiceAccount
永遠先掃描目錄與檔案備份 — 確認缺失數量後再執行生成

🆕 防錯守則（v9.0 完整版）

JSONDecodeError 炸裂： 立即回滾 master-articles.json
API Key 失效或超額： 檢查 .env
排程未自動觸發： 檢查 Task 是否為 SYSTEM 權限
CSS 白底白字： 檢查 style/main.css
Emoji 顯示異常： 在腳本開頭加入 UTF-8 編碼設定
空清單綁定錯誤： [array]$Articles = @()
批次腳本找不到萬用模板： $TemplatePath = "$PSScriptRoot\..\lib\auto-batch-template.ps1"
Git Pull 衝突： 使用 .\git-manager.ps1 選 [P]
UTF-8 無 BOM： .json 用 System.Text.UTF8Encoding $false
PowerShell 5.1 相容性： #Requires -Version 5.1
🚨 .env 部署防護： 不要用 wrangler pages deploy
🚨 Cloudflare WAF： 確認「Block .env access」已啟用
Hugo 模板分離： layouts/index.html 與 layouts/_default/list.html 必須不同
.gitignore 補強： 加入 novels.bak-*/、旗袍/、backups/
小說無標題 fallback： convert_to_hugo.py 已加 3000 字切章
章節數守門： 章節數 < 10 → 強制 fallback
診斷順序： 先看原始檔 → 再看 pattern → 再改邏輯
雙機同步前： 先 git status 確認乾淨
雙機路徑： 兩台路徑必須完全相同
Hugo 版本： 兩台必須同版本（v0.166.0 extended）
SMB 轉移後： 關閉共享，避免安全風險
.git 複製： 用 Robocopy，不用 git clone .
Python 套件安裝： 用絕對路徑 & "python.exe" -m pip install
批次生成前： 確認 API Key 檢查通過
Responses API 失敗： 自動降級至 Chat API
配圖 HTTP 500： Pollinations AI 重試 3 次
網域轉移後： 確認 Cloudflare Registrar 狀態為 Active，並開啟 DNSSEC
SSL/TLS 設定： 使用 Full (Strict)，並開啟 HSTS + Always Use HTTPS
Redirect Rule： 裸域 301 到 www，排除 novels 子網域
watch-pipeline.ps1： 健康狀態只依「失敗數」判斷，避免誤判
圖片進 Git： 網站圖片必須進 Git，否則 Cloudflare Pages 部署後會破圖
backups/ 排除： .gitignore 加入 backups/
Wrapper 必須完整： 不能只給 $Articles 清單，必須包含呼叫模板的邏輯
Wrapper 必須有 Read-Host： 右鍵執行才不會秒關
先診斷再給腳本： 不確定模板長什麼樣，先問清楚
分類要確認： life 和 philosophy 不要搞混
模板路徑： $PSScriptRoot\..\lib\auto-batch-template.ps1
🆕 .gitignore 補強（小說站）： 加入 _backup-phase*/、public-test/
🆕 Hugo 模板放對位置： assets/ 需透過 resources.Get，static/ 才自動複製
🆕 閱讀器 localStorage： 設定和進度分開存（ahpal_reader_settings / ahpal_reader_progress）
🆕 小說站地雷： novels.bak-* 要排除，否則 Hugo 頁數會多算

6. 📂 重要檔案與路徑

用途	路徑
主站專案目錄	`C:\Users\User\ahpal-static`
Python 原始碼	`C:\Users\User\ahpal-static\src\`
PowerShell 腳本	`C:\Users\User\ahpal-static\scripts\`
萬用批次模板	`C:\Users\User\ahpal-static\scripts\lib\auto-batch-template.ps1`
批次腳本	`C:\Users\User\ahpal-static\scripts\auto-batch\`
全站文章 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`
小說站乾淨備份	`C:\Projects\ahpal_novels_clean_backup_20261004-003749`
小說站地雷（_trash）	`C:\Projects\_trash-novels-bak-*`（暫存，一週後可刪）
小說站轉換腳本	`C:\Projects\ahpal_backup\...\mysql\convert_to_hugo.py`
小說站批量腳本	`C:\Projects\ahpal_backup\...\mysql\batch_convert.py`
小說站 MySQL 備份	`C:\Projects\ahpal_backup\...\mysql\dk101dz.sql`（9.9 GB）
系統工具	`C:\Users\User\ahpal-AI-archive\system-tools\`
批次日誌	`C:\Users\User\ahpal-AI-archive\system-tools\system-reports\01-批次生成日誌\`
產線報告	`C:\Users\User\ahpal-AI-archive\system-tools\system-reports\03-產線報告\`
專案分析報告	`C:\Users\User\ahpal-AI-archive\system-tools\system-reports\06-專案分析\`
網域註冊商後台	`https://dash.cloudflare.com/` → Domain Registration

7. 📚 小說站 v1.0 完整說明

🎯 專案定位

項目	值
專案路徑	`C:\Projects\ahpal_backup\backup-7.10.2025_06-35-38_flwsybvf675b\mysql\hugo_site`
GitHub Repo	`praystone/ahpal-novels`
部署平台	Cloudflare Workers（Static Assets）
自訂網域	`novels.ahpal.com`
Hugo 版本	`0.166.0 extended`（兩台一致）
小說部數	20 部
.md 檔數	3,320
Hugo 總頁數	3,325（正確）
模板檔數	13 個
Google Search Console	✅ 已驗證
Sitemap	✅ 已提交

🎨 設計原則

面向	設計
底色	`#0D1117`（深色系，護眼）
卡片	`#161B22`
邊框	`#2D303A`
主文字	`#E6EDF3`
副文字	`#8B949E`
金色（標題）	`#D4AF37`
青色（連結）	`#58A6FF`
閱讀主題	暗（預設）/ 暖 / 白
字級	14 / 16 / 18 / 20 / 22px（5 段）
行距	1.6 / 1.9 / 2.2（3 段）
響應式	768 / 480 斷點

📁 模板結構（13 個檔）

hugo_site/
├── hugo.toml                       ← 設定檔（含 params、menu）
├── layouts/
│   ├── index.html                  ← 首頁（閱讀進度 + 20 部卡片）
│   ├── _default/
│   │   ├── baseof.html            ← 骨架
│   │   └── single.html            ← 章節頁（fallback）
│   ├── novels/
│   │   ├── list.html              ← 目錄頁（總目錄 + 單部目錄）
│   │   └── single.html            ← 章節頁（保留給 type: novel）
│   └── partials/
│       ├── head.html              ← 
│       ├── header.html            ← 頂部導覽
│       ├── footer.html            ← 頁尾
│       ├── chapter-nav.html       ← 章節導覽（上/下/目錄）
│       ├── reader-toolbar.html    ← 閱讀工具列
│       └── novel-card.html        ← 書本卡片
├── assets/
│   ├── css/
│   │   └── main.css              ← 深色系 + 閱讀器 + 首頁樣式
│   └── js/
│       ├── reader.js             ← 閱讀器邏輯
│       └── progress.js           ← 首頁閱讀進度
└── content/
    └── novels/
        ├── ao-jian-ling-yun/     ← 20 部小說
        ├── bai-lian-cheng-xian/
        └── ...
        

🛠️ 閱讀器功能

功能	說明
字級調整	5 段（14 / 16 / 18 / 20 / 22px）
行距調整	3 段（1.6 / 1.9 / 2.2）
主題切換	暗 / 暖 / 白（循環）
章節導覽	上一章 / 目錄 / 下一章
鍵盤快捷	← → 翻章、ESC 回目錄
進度條	頂部細條
進度記憶	localStorage（`ahpal_reader_progress`）
設定記憶	localStorage（`ahpal_reader_settings`）

🆕 Git 清理紀錄

2026-10-04：移除 _backup-phase* 和 public-test/ 追蹤

✅ .gitignore 加入 _backup-phase*/、public-test/
✅ 移除 24 個 _backup-phase* 檔案追蹤
✅ 移除 3,329 個 public-test/ 檔案追蹤
✅ Commit + Push 完成

🆕 地雷處理紀錄

2026-10-04：搬移兩顆 novels.bak-* 地雷

地雷 1：hugo_site/novels.bak-20260915-021044/（926.8 MB / 26,708 檔）
地雷 2：content/novels.bak-20260915-124527/（384.29 MB / 1,395 檔）
處理方式：搬到 C:\Projects\_trash-novels-bak-*
省下空間：1.31 GB
清理後 hugo_site/ 從 2.47 GB → 1.21 GB

8. 📊 JSON 對帳機制（v10.0）

ai-handover-scan.ps1 v10.0 新增：

✅ .env 雙路徑尋找（ahpal-env\.env 優先，ahpal-static\.env 次之）
✅ JSON 對帳區塊（目錄實掃 vs JSON 登記）
✅ 對帳明細（04b-JSON對帳明細.txt）
✅ 報告標示雙口徑（目錄實掃 + JSON 登記 + 落差）

424 篇落差拆解

類型	數量	性質	處理方式
A 類：中文檔名未登記	~60	違反死命令第 2 條	重新命名 + 登記
B 類：測試/佔位/未分類	~80	不該進正式清單	確認刪除或搬移
C 類：JSON 舊名 vs 目錄新名	62	命名規則改了但 JSON 沒更新	更新 JSON 檔名
D 類：其他零散未登記	~222	混合	逐一分類
合計	424	—	—

🔴 C 類最安全，先處理：

JSON 舊名（2026-habit-loop.html）vs 目錄新名（2026-habit-loop-science.html），只需更新 JSON 的 filename 欄位，風險最低。

9. 🔴 主站待處理問題

#	項目	狀態	備註
1	主站 `.git` 361 MB	待辦	可能有大檔歷史
2	主站 `.env` 位置	待確認	可能是 symlink 指向 `ahpal-env`
3	主站 `backups/` 114 MB	待辦	`.gitignore` 有排除，但目錄還在磁碟上
4	主站 90+ 未提交 `philosophy/` 文章	待辦	需確認要 commit 還是刪除
5	主站 424 篇 JSON 落差	待辦	分 A/B/C/D 四類處理
6	主站 `game/index.html`	待確認	放在 `game/` 目錄，語意怪
7	主站 `images/` 7,363 檔 / 326 MB	已知	圖片進 Git，讓 `.git` 變大

10. 🆕 2026-10-04 今日教訓

✅ 正確的做法：

先診斷，再動手
先備份，再改動
一次一個階段，不要一次改全部
數字對不上，先查清楚
結構正常 ≠ 內容正確
目錄實掃 ≠ JSON 登記
Hugo assets/ 需透過 resources.Get，static/ 才自動複製
Git .gitignore 要即時更新，避免垃圾進 Git

❌ 今天的錯誤：

三個階段跑完，_backup-phase* 和 public-test/ 意外進了 Git
Hugo assets/ 沒有 resources.Get，字級功能一度無法運作
小說站頁數 4,721 是舊數字（含備份殘留）

11. 📋 新進工程師 CheckList（v9.0 FINAL）

☐ 確認 GitHub 主儲存庫：praystone/ahpal-website
☐ 確認小說站儲存庫：praystone/ahpal-novels
☐ 確認 C:\Users\User\ahpal-env\.env 已建立（絕不上傳 Git）
☐ 確認 Cloudflare Pages / Workers 綁定與自動部署
☐ 測試執行 .\scripts\ahpal-master.ps1
☐ 了解 Pollinations AI 配圖機制
☐ 了解 SYSTEM 帳戶排程設定
☐ 已閱讀 12 條死命令與 48 小時黑暗期教訓
☐ 確認 style/main.css 手動維護
☐ 確認三個設定檔模型名稱一致
☐ 了解 Git 管理工具 v3.5
☐ 了解「萬用批次模板 + Thin Wrapper」架構
☐ 設定 Telegram Bot 通知
☐ 了解 SEO 四大件無 noindex
☐ 確認所有 .ps1 為 #Requires -Version 5.1 + UTF-8 有 BOM
☐ 確認 .env 已移出專案目錄
☐ 確認 Cloudflare WAF 規則已啟用
☐ 確認 pages.dev 預覽部署已停用
☐ 了解小說站 Hugo 架構與 novels.ahpal.com 部署流程
☐ 確認 layouts/index.html 與 layouts/_default/list.html 內容不同
☐ 確認 .gitignore 已加入 novels.bak-*/、旗袍/、backups/
☐ 了解 AHPAL-BUG-001（已修復）與 AHPAL-BUG-003（已修復）
☐ 了解 fallback（每 3000 字切章）與守門（< 10 章）機制
☐ 確認聯想為主力機，戴爾為外出機
☐ 確認兩台機器 Hugo 版本一致（v0.166.0 extended）
☐ 確認兩台機器專案路徑完全相同
☐ 測試 ssh -T [email protected] 回 Hi praystone!
☐ 確認 novels.ahpal.com 線上回 200
☐ 確認 Python 套件已安裝：requests / openai / google-genai / python-dotenv
☐ 確認批次日誌路徑：C:\Users\User\ahpal-AI-archive\system-tools\system-reports\01-批次生成日誌\
☐ 了解 Responses API 與 Chat API 的 fallback 機制
☐ 確認 ai-handover-scan.ps1 v10.0 已就位
☐ 確認 ahpal.com 註冊商為 Cloudflare（whois ahpal.com）
☐ 確認 ahpal.com 到期日為 2029-04-07
☐ 確認 DNSSEC 已啟用（Cloudflare → ahpal.com → Settings）
☐ 了解戴爾 Latitude 5320 的 S0 現代待機限制（無法真關機）
☐ 了解 AHPAL-Sync 已重組為企劃專案倉庫
☐ 確認 SSL/TLS 為 Full (Strict)
☐ 確認 HSTS 已啟用（1 年 + preload）
☐ 確認 Always Use HTTPS 已啟用
☐ 確認 Automatic HTTPS Rewrites 已啟用
☐ 確認 Redirect Rule 已建立（裸域 → www）
☐ 確認 watch-pipeline.ps1 v3.1 已就位
☐ 確認 auto-batch-template.ps1 v3.4 已就位
☐ 確認 ahpal-master.ps1 v11.0 已就位
☐ 確認網站圖片已進 Git（6,348 張）
☐ 確認美食探索 1,339 篇
☐ 確認生活小常識 795 篇（目錄實掃）/ 736 篇（JSON 登記）
☐ 確認人生哲理 435 篇（目錄實掃）/ 423 篇（JSON 登記）
☐ 確認總文章數 7,715 篇（目錄實掃）/ 7,291 篇（JSON 登記）
☐ 🆕 確認小說站模板 v1.0 已上線（novels.ahpal.com 回 200）
☐ 🆕 確認小說站四層頁面正常（首頁 / 目錄 / 單部 / 章節）
☐ 🆕 確認小說站閱讀器功能（字級、行距、主題、進度記憶）
☐ 🆕 確認小說站 .gitignore 含 _backup-phase*/、public-test/
☐ 🆕 確認小說站地雷已搬到 C:\Projects\_trash-novels-bak-*
☐ 🆕 確認小說站 .git 從 549 MB → 724 MB（清理追蹤後不再增長）
☐ 🆕 確認 ai-handover-scan.ps1 已升級 v10.0（雙路徑 .env + JSON 對帳）
☐ 🆕 確認 04b-JSON對帳明細.txt 已就位
☐ 🆕 確認主站 424 篇 JSON 落差已分類（A/B/C/D）
☐ 🆕 確認 Wrapper 必須完整（含呼叫模板邏輯）
☐ 🆕 確認 Wrapper 必須有 Read-Host 擋住視窗
☐ 🆕 確認先診斷再給腳本（不確定模板長什麼樣，先問清楚）
☐ 🆕 確認分類不要搞混（life vs philosophy）
☐ 🆕 確認 Hugo assets/ vs static/ 的差異

12. 📌 數據遷移 Prompt（v9.0 FINAL）

---
🦞 龍蝦總工程師 · 數據遷移 Prompt (v9.0 FINAL)
生成日期：2026-10-04

「永遠先備份，永遠不依賴幻想的判斷。」

## 🦞 系統人格
你是 🦞 龍蝦總工程師，AHPAL.COM 的技術最高負責人。務實、精準、不廢話。

## 📊 系統狀態
- 主站：C:\Users\User\ahpal-static (praystone/ahpal-website)
- 系統工具：C:\Users\User\ahpal-AI-archive\system-tools
- 小說站：C:\Projects\ahpal_backup\...\mysql\hugo_site (praystone/ahpal-novels)
- 小說站乾淨備份：C:\Projects\ahpal_novels_clean_backup_20261004-003749
- 環境變數：C:\Users\User\ahpal-env\.env
- 核心技術：DeepSeek V4.1 Flash + Pollinations AI + Telegram Bot + SYSTEM 排程 + Cloudflare
- 主站總文章數（目錄實掃）：7,715 篇
- 主站 JSON 登記：7,291 筆
- 主站落差：424 篇
- 小說站：20 部、3,320 .md、3,325 頁、13 模板檔
- 網域：ahpal.com（Cloudflare Registrar，2029-04-07 到期）
- DNSSEC：已啟用
- SSL/TLS：Full (Strict)
- HSTS：1 年 + preload

## 🖥️ 雙機架構
- 聯想（AHPAL-LENOVO）：主力機，工作室，Python 3.12.14
- 戴爾（DESKTOP-AKLAM99）：外出機，移動使用，Python 3.14.6
- 兩台透過 Git 同步，路徑必須完全一致，Hugo 版本必須一致（v0.166.0 extended）

## 🔴 核心原則
1. 不依賴 main.py → 直接呼叫 article_generator.generate_article()
2. 使用 SYSTEM 帳戶排程
3. 先掃描目錄並執行備份

## 🛠️ 防錯守則
- CSS 嚴禁自動生成
- 變更 master-articles.json 前先備份
- 雙機同步使用 git-manager.ps1 v3.5
- 通知系統使用 Telegram Bot
- SEO 四大件嚴禁 noindex
- .ps1 必須 #Requires -Version 5.1 + UTF-8 有 BOM
- .json 必須 UTF-8 無 BOM
- Hugo 模板分離
- .gitignore 加入 novels.bak-*/、旗袍/、backups/
- .gitignore（小說站）加入 _backup-phase*/、public-test/
- convert_to_hugo.py 有 fallback（3000 字切章）
- 章節數 < 10 → 強制 fallback
- 雙機路徑必須完全一致
- Hugo 版本必須一致（v0.166.0 extended）
- Hugo assets/ vs static/ 的差異（assets 需 resources.Get）
- Python 套件安裝要用絕對路徑
- 批次生成前確認 API Key 檢查通過
- 網站圖片必須進 Git（否則破圖）
- Wrapper 必須完整（含呼叫模板邏輯）
- Wrapper 必須有 Read-Host 擋住視窗
- 先診斷再給腳本
- 分類不要搞混（life vs philosophy）

## 🔐 .env 保護
- .env 路徑：C:\Users\User\ahpal-env\.env
- 不要用 wrangler pages deploy
- Cloudflare WAF 規則已設定

## 🎯 核心口號
「系統架構不會死，只是換個 AI 來維護。」
「我們是有革命情感的。」
「先診斷，再動手。」
---
        

13. ✅ 近期事件與修復記錄（v9.0 新增）

日期	事件	狀態
2026-10-03	人生哲理 +100 篇	✅ 完成
2026-10-03	git-manager.ps1 v3.5 修正	✅ 完成
2026-10-04	小說站模板 v1.0 完成（階段 1）	✅ 完成
2026-10-04	小說站模板 v1.0 完成（階段 2）	✅ 完成
2026-10-04	小說站模板 v1.0 完成（階段 3）	✅ 完成
2026-10-04	小說站上線（四層頁面 200）	✅ 完成
2026-10-04	小說站 Git 清理（移除 _backup-phase*、public-test/）	✅ 完成
2026-10-04	小說站地雷處理（搬移兩顆 novels.bak-*）	✅ 完成
2026-10-04	ai-handover-scan.ps1 v10.0（JSON 對帳）	✅ 完成

14. 🆕 技術債追蹤（v9.0）

#	項目	狀態	備註
1	主站 `.git` 361 MB	待辦	可能有大檔歷史
2	主站 `.env` 位置	待確認	可能是 symlink
3	主站 `backups/` 114 MB	待辦	可刪或搬到 _trash
4	主站 90+ 未提交 `philosophy/` 文章	待辦	需 commit
5	主站 424 篇 JSON 落差	待辦	分 A/B/C/D 四類
6	小說站 `_trash` 一週後可刪	待辦	2026-10-11 後可刪
7	小說站 `.git` 724 MB	待辦	可選 `git gc`
8	兩台 Python 版本不一致	待辦	聯想 3.12.14 / 戴爾 3.14.6
9	兩台 openai 版本不一致	待辦	聯想 3.14.1 / 戴爾 2.45.0
10	網域續約 7 年	待辦	推至 2036 年
11	`mo-ri-zhang-lang` 18 MB / 7 章	待追	守門未觸發
12	`jian-dao-du-shen` 58 章	待追	可能過度切章
13	主站 `game/index.html` 語意怪	待確認	放在 game/ 目錄
14	主站 `images/` 7,363 檔 / 326 MB	已知	讓 .git 變大
15	Wrapper 與模板的關係需文件化	待辦	2026-10-03 教訓