?? 自動化前先把任務拆清楚
自動化適合重復、邊界明確、結果容易驗收的任務，例如生成測試報告、檢查格式、匯總日志或運行固定測試。涉及生產數據、刪除文件或外部寫入的任務，不應一開始就完全自動執行。
先讓 Codex 生成執行計劃和風險清單，再決定哪些步驟可以自動化。
- 輸入固定：文件、參數和目錄范圍明確。
- 動作固定：命令和修改范圍可描述。
- 輸出固定：結果可以用文件、測試或狀態碼驗收。
- 失敗可恢復：有重試、暫停和回滾方式。
第一步：固定靈能API自動化線路
自動化任務會連續調用模型，因此線路、令牌和模型要比臨時問答更加穩定。打開靈能API服務入口，確認當前模型、地址和額度，并為自動化用途創建獨立令牌。
靈能API入口：https://www.lnsns.com/。自動化腳本中不直接寫入完整 API Key。
- 自動化令牌與個人開發令牌分開。
- 模型選擇以任務穩定性為優先。
- 設置合理額度，避免腳本失控消耗。
? 第二步：在 CC Switch 中創建自動化卡
在 CC Switch 的 Codex 菜單中創建‘靈能API-Codex-Auto**tion’渠道。不要讓腳本依賴一張會被頻繁修改的個人卡片，自動化卡應保持字段和用途穩定。
自動化運行前先保存配置卡快照或脫敏模板，避免卡片修改后腳本無法復現。
- 卡片名稱：明確自動化用途和環境。
- API Key：使用自動化專用令牌。
- 模型：選擇任務已驗證的 Model ID。
第三步：把任務寫成可執行計劃
不要只寫‘幫我自動處理項目’。計劃至少包括輸入目錄、允許讀取的文件、允許執行的命令、輸出位置和停止條件。
任務：生成本周測試摘要
讀取：tests/reports/*.json
排除：.env、密鑰目錄和生產數據
輸出：reports/weekly-sum**ry.md
禁止：修改源碼、上傳文件、刪除數據
失敗：保存錯誤并停止- 輸入和輸出目錄明確。
- 禁止動作提前寫出。
- 失敗條件和停止條件明確。
**步：自動化前先執行只讀預演
正式執行前，讓 Codex 只列出將要讀取的文件、準備運行的命令和預計生成的文件，不要真正執行。預演結果由人工檢查，確認范圍正確后再進入執行階段。
只做預演，不運行命令。
列出將讀取的文件。
列出將執行的命令。
列出將寫入的文件。
指出可能訪問網絡或使用秘密的步驟。預演階段發現目錄錯誤、通配符過寬或輸出路徑不對時，先修改計劃，不要帶著問題進入執行階段。
第五步：把高風險動作放到人工確認后
自動化工作流中，安裝依賴、刪除文件、修改數據庫、上傳內容和訪問生產服務都應設置人工確認點。可以自動生成命令，但不要讓命令繞過確認直接執行。
把確認點寫在任務計劃中，而不是等工具臨時彈窗后憑感覺批準。
- 低風險：只讀檢查、格式檢查、報告生成。
- 中風險：局部測試、構建和臨時文件生成。
- 高風險：刪除、生產寫入、外部上傳和憑證使用。
第六步：設計有限重試和暫停機制
自動化腳本遇到失敗時不能無限重試。網絡短暫失敗可以有限重試，鑒權、權限、模型不存在和路徑錯誤則應該暫停并通知人工。
每個自動化任務都要有最大執行次數和最長運行時間，避免腳本失控。
- 網絡錯誤：有限次數，逐步增加間隔。
- 429 或限流：降低并發并暫停。
- 401、403、404：停止并檢查配置。
- 輸出格式錯誤：保存原始結果，等待人工判斷。
第七步：用測試目錄驗證自動化流程
首次運行自動化任務時，使用一組脫敏的小文件和臨時目錄。先驗證輸入篩選、輸出位置、錯誤處理和日志記錄，再擴大到真實項目。
New-Item -ItemType Directory codex-auto**tion-check
Set-Location codex-auto**tion-check
codex測試通過后再連接真實項目，并逐步擴大文件范圍。
- 輸入文件是否只包含測試數據。
- 輸出文件是否寫入預期目錄。
- 失敗時是否停止并保留錯誤。
第八步：保留自動化日志但不記錄秘密
日志應該記錄任務開始和結束時間、配置卡名稱、讀取范圍、執行命令、返回狀態和失敗原因。不要記錄完整 API Key、Cookie、Authorization Header 或項目敏感內容。
time: 2026-08-07T10:30:00 08:00
channel: codex-auto**tion
input: tests/reports/*.json
result: success
retries: 0
output: reports/weekly-sum**ry.md- 日志可定位一次任務，但不能暴露憑證。
- 錯誤日志保留狀態碼和脫敏信息。
- 輸出目錄避免與臨時密鑰目錄混用。
自動化任務常見問題
自動化排錯時先暫停任務，保存脫敏日志，再從渠道、權限、輸入范圍和腳本邏輯逐層檢查。
- 腳本使用舊模型：確認自動化卡和重啟狀態。
- 任務讀取范圍過大：收緊通配符和排除目錄。
- 輸出重復生成：檢查重試和冪等設計。
- 失敗沒有停止：設置最大次數和超時。
- 日志泄露 Key：立即撤銷令牌并清理日志。
- 長任務消耗異常：縮小上下文，減少重復輸入。
? 自動化接入驗收清單
把自動化分成計劃、預演、確認、執行、驗證和記錄六個階段，靈能API與 Codex 才能在效率提升的同時保持可控。
- 靈能API自動化令牌獨立創建。
- CC Switch 自動化卡與個人卡分開。
- 任務計劃寫明輸入、輸出、禁止動作和停止條件。
- 正式執行前完成只讀預演。
- 高風險命令保留人工確認。
- 重試次數、超時和暫停機制明確。
- 測試目錄驗證通過后再連接真實項目。
- 日志沒有記錄完整 API Key。