AI 與新進工程師 · 系統完整交接文件
📌 vFinal · 2026-09-05

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

身份定位:

❤️ 革命情感與歷史背景

與團隊走過漫長的「48 小時黑暗期」,經歷過 JSONDecodeError 炸裂、Gemini 3.6 Flash 壯烈犧牲、Pollinations AI 配圖系統上線、SYSTEM 帳戶排程穩定運行,以及從雙 Repo 封存回歸單一主體儲存庫 (`ahpal-website`) 的重要歷程[cite: 1, 2]。

2. 📊 系統狀態總覽

2,190+
總文章數
9
分類
12+ GB
SQL 備份
100%
AI 自動化產線

📋 9 大分類

📜 歷史腦洞 (510)
💻 3C 科技教學 (93)
🎮 遊戲攻略 (25)
🏠 生活小常識 (472)
📊 軟體評測 (79)
🌟 人生哲理 (77)
🤖 AI 趨勢 (64)
🎵 音樂創作 (11)
🌳 動植物生態 (793)

3. 🏗️ 單一 Repository 主體架構

AHPAL 系統架構已升級並封存為單一唯一主體:

Repository權限 / 路徑內容與權責
praystone/ahpal-website Public
C:\Users\User\ahpal-static
包含 Python AI Agent、PowerShell 腳本、HTML 網頁資產、文章資料庫、Sitemap 與部署引擎[cite: 1, 2]
📌 核心原則: 所有產線生成、腳本維護與 Cloudflare Pages 部署完全集中於單一主體 `ahpal-website`,極簡化營運流程[cite: 1, 2]。

4. 🔴 10 條董事長死命令

#死命令檢查方式
1文章變更後強制檢查.\scripts\preflight-check.ps1
2文章檔名強制使用英文自動強制轉換
3CSS 靜態資產保護main.css 禁止自動覆蓋
4文章清單集中管理master-articles.json
5文章新增唯一入口pending-articles.json
6首頁完整性create_default_index()
7禁止擅自精簡或改寫既有功能修復前備份、修復後對比
8嚴禁稱呼董事長為「神」禁用一切造神式稱呼
9新增分類須遵循標準化 SOP10 步驟標準流程
10永遠使用 SYSTEM 帳戶排程LogonType: ServiceAccount

5. ⭐ 三大核心原則

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

6. 📂 重要檔案與路徑

用途路徑
專案主目錄 (ahpal-website)C:\Users\User\ahpal-static[cite: 1, 2]
Python 原始碼C:\Users\User\ahpal-static\src\[cite: 1, 2]
PowerShell 腳本C:\Users\User\ahpal-static\scripts\[cite: 1, 2]
文章清單C:\Users\User\ahpal-static\data\master-articles.json[cite: 1, 2]
日誌目錄C:\Users\User\ahpal-AI-archive\system-tools\system-reports\
環境變數 (.env)C:\Users\User\ahpal-static\.env (絕不進 Git)[cite: 1, 2]
桌面同步資料夾C:\Users\User\Desktop\AHPAL-Sync

7. ⚡ 快速指令參考

用途指令
環境初始化與進入目錄cd C:\Users\User\ahpal-static[cite: 1, 2]
解除腳本權限限制Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force
完整部署 / 主控台.\scripts\ahpal-master.ps1[cite: 1, 2]
Git 額度與健康檢查.\scripts\check-git-quota.ps1
死命令預檢.\scripts\preflight-check.ps1
全面系統診斷報告.\scripts\check-all.ps1 -Report
黃金備份機制.\scripts\backup-system.ps1 -Golden
桌面資料夾同步cd ~\Desktop\AHPAL-Sync; .\sync.ps1

8. 🤝 互動節點與默契

9. 📋 新進工程師 CheckList

  • ☐ 確認 GitHub 主儲存庫:praystone/ahpal-website[cite: 1, 2]
  • ☐ 確認 C:\Users\User\ahpal-static\.env 已建立並填入 DEEPSEEK_API_KEY 與 GITHUB_TOKEN(絕不上傳 Git)[cite: 1, 2]
  • ☐ 確認 Cloudflare Pages 專案綁定與自動觸發部署設定
  • ☐ 測試執行 Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force 並調用 .\scripts\ahpal-master.ps1[cite: 1, 2]
  • ☐ 熟悉 JSON 驅動新增文章流程
  • ☐ 了解 Pollinations AI 配圖機制
  • ☐ 了解 SYSTEM 帳戶排程設定
  • ☐ 已閱讀 10 條董事長死命令與 48 小時黑暗期教訓

10. 📌 數據遷移 Prompt

--- 🦞 龍蝦總工程師 · 數據遷移 Prompt 「永遠先備份,永遠不依賴幻想的判斷。」 ## 🦞 系統人格 你是 🦞 龍蝦總工程師,AHPAL.COM 的技術最高負責人。務實、精準、不廢話。 ## 📊 系統狀態 - 專案:雅寶社區 · 頂客論壇 (AHPAL.COM) - 唯一主體路徑:`C:\Users\User\ahpal-static` (GitHub: praystone/ahpal-website) - 核心技術:DeepSeek Flash + Pollinations AI + SYSTEM 排程 + Cloudflare Pages ## 🔴 核心原則 1. 不依賴 main.py → 直接呼叫 article_generator.generate_article() 2. 使用 SYSTEM 帳戶排程 3. 先掃描目錄 ---