⚠️ 由貞已將以下錯誤模式寫入 SOUL.md，每次對話都會自動參照。
遇到這些錯誤時，由貞會直接走對方向，不再嘗試錯誤方向。
🔴 模式一：Token 授權失敗（最常見）
觸發關鍵詞：
code 9106、Authentication failed、
CF_API_TOKEN + Invalid token、
Cloudflare API 任何 auth 失敗相關錯誤
嘗試重建 Token、換其他部署方式、詢問主公密碼
立即執行「env-setup」（一句指令完成）
$env:CLOUDFLARE_API_TOKEN = [Environment]::GetEnvironmentVariable("CF_API_TOKEN", "User")
$env:CLOUDFLARE_ACCOUNT_ID = "2f2795bc4a98928375b23c36140ba33b"
不是 Token 本身有問題，是 WorkBuddy 重裝後 session 環境變量未正確載入。
🔴 模式二：軟體重裝後首次對話
觸發情境：
WorkBuddy 版本更新後首次啟動、軟體重裝後首次對話、
主公提到「重裝」「更新」「換機」
直接執行部署、嘗試各種 Cloudflare/wrangler 指令、重新建立 API Token
由貞主動提示「偵測到軟體重裝，請先執行 env-setup」，然後直接執行
重裝後環境變量（User scope）斷層，須重新配置後才能使用。
🟡 模式三：反覆失敗超過 2 次
觸發條件：
同一個操作連續失敗 2 次以上、嘗試了 3+ 種不同方法但都失敗
繼續嘗試第 4、5 種方式、假設這次會不一樣
立即停下來，回顧根本原因，檢查：環境變量？路徑？權限？配置？
🔵 模式四：API 返回 400 但 Token/ID 皆正確
觸發關鍵詞：
400 Bad Request、遠端伺服器傳回錯誤：(400)、
API 返回 400 但 Token 有設定
重建 Token、懷疑 Token 已過期、反覆更換 Token
先測試
/accounts endpoint 驗證 Token 有效性，再檢查 URL 格式# Step 1: 先驗證 Token + Account ID 是否正確
GET https://api.cloudflare.com/client/v4/accounts
# 如果成功返回帳號列表，代表 Token 和 Account ID 都正確
# Step 2: 常見原因 - URL 多了不支援的參數
# 錯誤：?per_page=50（CF Pages API 不支援此參數）
GET https://api.cloudflare.com/client/v4/accounts/{id}/pages/projects?per_page=50 ← 400
GET https://api.cloudflare.com/client/v4/accounts/{id}/pages/projects ← 200
Token 本身有效，根本原因是 API URL 格式不正確（如多了不支援的查詢參數）。
📋 env-setup 技能說明（#30）
技能位置：
C:\Users\Administrator\.workbuddy\skills\env-setup\SKILL.md
觸發詞：
「執行 env-setup」、「環境配置」、「env-setup」
功能：
讀取 CF_API_TOKEN → 設置 session 環境變量 → 驗證 wrangler 狀態
Account ID：
2f2795bc4a98928375b23c36140ba33b（固定）
Token 來源：
[Environment]::GetEnvironmentVariable("CF_API_TOKEN", "User")
💡 由貞的自我保護機制
由貞已將錯誤模式寫入 SOUL.md
每次對話開始時，由貞會自動參照這些模式。遇到觸發關鍵詞，由貞會：
1. 第一時間識別錯誤類型
2. 跳過錯誤方向，直接走對的路
3. 主動告知主公正在做什麼
📁 相關檔案
SOUL.md：
C:\Users\Administrator\.workbuddy\SOUL.md
env-setup：
C:\Users\Administrator\.workbuddy\skills\env-setup\SKILL.md
Skills List：
https://wholistics.pages.dev/skills-list.html
實體備忘：
C:\Users\Administrator\WorkBuddy\工作備忘\重要備忘-錯誤模式與env-setup.txt
← 返回首頁