長任務最容易失敗的不是模型，而是上下文失控

大型項目任務通常包含多個階段：理解目錄、定位入口、分析依賴、設計方案、修改代碼、運行測試和總結結果。如果一次性把所有階段塞進一個請求，輸入上下文會迅速膨脹，輸出也可能偏離目標。更穩妥的方式是讓 Codex 每完成一個階段就留下明確檢查點。

中轉線路的作用是提供穩定的模型調用入口，但任務拆分和項目邊界仍然需要由使用者控制。

• 階段一：只讀項目結構和關鍵入口。
• 階段二：確認問題范圍和修改邊界。
• 階段三：提出方案，不立即寫入。
• 階段四：分批修改并運行局部測試。
• 階段五：匯總變更、測試結果和剩余風險。

第一步：為長任務挑選合適的模型線路

進入靈能API公開頁面或控制臺，查看當前模型列表、上下文能力、輸入輸出價格和 Model ID。長任務不要只看單價，還要看模型能否穩定處理較長上下文，以及輸出是否容易重復和跑題。

官網入口：https://www.lnsns.com/。模型與價格可能更新，實際配置以當天頁面為準。

• 短任務：速度和基礎穩定性優先。
• 長上下文：關注上下文容量和讀取完整度。
• 代碼修改：關注計劃執行能力和輸出準確度。

第二步：長任務使用單獨令牌和配置卡

長任務可能持續較久、產生更多輸入輸出，因此建議為它創建獨立令牌和配置卡。這樣可以區分日常短問答與項目級消耗，也便于長任務異常時單獨暫停。

不要在長任務運行中臨時替換主線路字段。需要測試新模型時，復制卡片建立實驗線路，保留當前任務的穩定配置。

• 令牌名稱：Codex-LongTask-Project。
• 備注：項目分析、分步修改、局部測試。
• 安全規則：完整令牌只保存在本地私密位置。

? 第三步：在 CC Switch 建立長任務卡片

打開 CC Switch 的 Codex 配置區域，新增或復制一張渠道卡片。名稱建議同時包含服務、任務類型和模型角色，例如“靈能API-Codex-長任務分析”。名稱清晰后，切換線路時不容易誤選短任務配置。

創建后逐項確認協議、*ase **L、Model ID 和 API Key。復制卡片只減少錄入工作，不代表模型和令牌已經適合長任務。

• 配置名稱：靈能API-Codex-長任務分析。
• *ase **L：填寫到當前服務要求的版本路徑。
• Model ID：從當天模型列表復制。

?? **步：填寫參數并控制輸入邊界

長任務配置仍然遵循地址、模型、密鑰的順序。*ase **L 通常填寫到 /v1，不要把完整接口路徑繼續拼進去。Model ID 要與當前列表一致，API Key 使用長任務專用令牌。

服務名稱：靈能API-Codex-長任務分析
*ase **L：https://www.lnsns.com/v1
Model ID：以當前模型列表為準
API Key：長任務專用令牌

長任務不等于把所有文件都發給模型。先確定入口目錄、目標文件和排除目錄。日志、構建產物、依賴目錄和重復生成文件通常不需要進入上下文。減少無關輸入，既能提高準確度，也能降低消耗和超時概率。

第五步：先讓 Codex 建立項目地圖

啟動長任務前，先讓 Codex 只讀項目結構。任務可以限制為：列出指定目錄、說明入口文件、指出主要依賴和潛在風險，不修改任何文件。這樣可以先確認模型看到的項目范圍是否正確。

cd D:\work\your-project
git status
codex

如果項目很大，可以先只讀取 src、配置文件和測試入口。等項目地圖建立后，再讓 Codex 根據地圖定位某個功能。不要一開始就要求它同時理解前端、后端、部署和數據庫。

• 確認當前目錄正確。
• 確認版本控制工作區狀態。
• 確認讀取范圍沒有包含敏感文件。

第六步：用檢查點拆分修改任務

每個階段都應該有一個可以檢查的結果。比如完成分析后，讓 Codex 輸出問題范圍和待修改文件；完成計劃后，讓它列出風險和測試方式；完成修改后，讓它說明具體變更和測試結果。

檢查點 1：問題范圍和目標文件
檢查點 2：修改方案和風險
檢查點 3：已修改文件和差異摘要
檢查點 4：測試命令和結果
檢查點 5：剩余問題和回退方式

如果某一步結果不符合預期，立即回到上一個檢查點，不要讓錯誤繼續積累到后面的修改階段。長任務的穩定性，很大程度上來自這些人為設置的暫停點。

? 第七步：用輕量測試確認長任務線路

保存并啟用長任務卡片后，關閉舊 Codex 和 PowerShell，再打開新終端。先在空目錄完成一個只讀任務，再進入項目。界面上的測試成功不能替代新進程驗證。

mkdir codex-long-task-check
cd codex-long-task-check
codex

短任務成功后，再在項目中讀取少量文件。如果短任務穩定而項目任務超時，先減少上下文和輸出長度；如果短任務也失敗，回到地址、令牌和網絡檢查。

?? 長任務超時與上下文過大的處理方式

如果短請求也出現 401、403、404 或連接失敗，應先處理配置和服務問題；如果只有長任務失敗，優先調整任務規模和上下文。

• 一次只讀取指定目錄，不掃描整個倉庫。
• 把長日志先壓縮成錯誤摘要，再定位代碼。
• 讓模型先輸出計劃，不直接生成大量代碼。
• 把大型改動拆成多個小提交或小步驟。
• 減少歷史對話和重復粘貼的上下文。

長任務常見錯誤定位

記錄錯誤碼、卡片名稱、任務階段和時間，不記錄完整 API Key。排錯時一次只改變一個變量。

• 401：檢查長任務卡片使用的專用令牌。
• 403：檢查額度、分組和模型權限。
• 404：檢查 *ase **L 是否重復 /v1。
• model not found：重新復制當前 Model ID。
• 長任務超時：縮小讀取范圍和輸出長度。
• 切換不生效：關閉舊進程后重新啟動。

長期維護：給長任務保留恢復路徑

長任務運行時間較長，更需要主線路和恢復線路。主線路用于日常項目，實驗線路用于新模型，恢復線路保留已知可用參數。出現異常時，先保存當前項目狀態，再切回恢復線路做小任務驗證。

需要查看當前模型、令牌和服務信息時，通過可點擊的靈能API官網入口進入：https://www.lnsns.com/。實際頁面信息優先于舊截圖。

• 長任務使用獨立配置卡和令牌。
• 每個階段都有可檢查的輸出。
• 修改前確認 Git 或其他版本控制狀態。
• 完整 Key 不進入截圖、倉庫和日志。

最終清單：長任務開始前檢查八項

按檢查點推進，長任務就能從一次不可控的連續對話，變成一組可以觀察、暫停和回退的開發步驟。

• 當前工作目錄是目標項目。
• 配置卡名稱明確，長任務線路已啟用。
• *ase **L 和 Model ID 來自當前服務信息。
• 長任務令牌與日常線路分開。
• 已排除依賴目錄、構建產物和敏感文件。
• 任務已經拆分并設置檢查點。
• 空目錄和短任務測試通過。
• 項目有版本控制和恢復方式。