? 截圖分析前，先確認客戶端和模型能力
截圖分析能否順利完成，取決于客戶端版本、當前模型和服務端是否支持圖片輸入。不要因為配置卡能進行文本對話，就默認所有模型都能識別圖片。開始前先查看當前模型說明，并用一張低敏感度測試圖驗證。
- 確認當前模型是否支持圖片或視覺輸入。
- 確認 Codex 當前入口支持附件或圖片傳遞。
- 測試圖不包含賬號、令牌和隱私信息。
- 圖片分析后仍需用代碼和測試結果復核。
第一步：從靈能API頁面選擇合適模型
進入靈能API頁面或控制臺，查看當前模型列表、Model ID、圖片輸入說明和相關價格。圖片任務可能同時產生圖片理解、文字上下文和代碼輸出消耗，因此不要只看普通文本價格。
官網入口：https://www.lnsns.com/。實際模型能力和價格以當天頁面為準。
- 界面截圖：關注視覺輸入和布局理解。
- 終端截圖：關注錯誤文字和命令上下文。
- 代碼截圖：圖片只輔助定位，最終仍需讀取源文件。
第二步：圖片任務使用獨立配置卡
圖片分析任務可能與普通代碼任務使用不同模型和用量。建議為它建立獨立令牌和配置卡，名稱寫清圖片分析用途，避免日常主線路被臨時模型覆蓋。
- 卡片名稱：靈能API-Codex-圖片分析。
- 令牌用途：界面、終端和錯誤截圖。
- 安全要求：圖片中不出現 Key、郵箱和隱私數據。
? 第三步：在 CC Switch 創建圖片分析渠道
打開 CC Switch 的 Codex 配置區域，新建“靈能API-Codex-圖片分析”卡片。先填寫協議、*ase **L、Model ID 和 API Key，再確認當前模型確實支持目標輸入方式。
*ase **L 通常填寫到 /v1，Model ID 從當前列表復制。復制主卡片后不要默認圖片能力會自動增加，仍要重新查看模型說明并測試。
?? **步：配置后先做低敏感度圖片測試
服務名稱：靈能API-Codex-圖片分析
*ase **L：https://www.lnsns.com/v1
Model ID：以當前視覺模型列表為準
API Key：圖片任務專用令牌測試圖片可以是一張不含敏感信息的界面截圖或示例圖。先讓 Codex 描述圖片中可見內容，不要求它修改代碼。若圖片無法識別，先判斷是客戶端附件能力、模型能力還是線路配置問題。
第五步：圖片和代碼要分兩輪分析
截圖適合幫助模型看到視覺現象，源代碼適合確認真正原因。建議先讓 Codex 描述截圖中看到的錯誤，再指定相關文件進行代碼閱讀，最后把兩次結果合并。不要只憑截圖直接修改項目。
第一輪：只描述截圖中可見的布局、錯誤和異常位置。
第二輪：讀取指定源文件，解釋截圖現象可能對應的代碼。
第三輪：給出修改方案，不要直接寫入。- 截圖描述：確認現象是否真實存在。
- 代碼閱讀：確認入口、樣式、數據或接口原因。
- 方案確認：判斷修改范圍和測試方式。
? 第六步：讓 Codex 按截圖位置提出修改
如果截圖顯示按鈕錯位、文字溢出、接口錯誤或頁面空白，可以要求 Codex 按‘現象—可能原因—對應文件—驗證方法’的格式回答。這樣可以避免它只根據圖片猜測。
進入真實項目后，先讀取一個相關組件或接口文件，再讓 Codex提出方案。修改前檢查 Git 狀態，修改后重新截圖并讓它做對比，最后運行項目已有測試或構建命令。
截圖分析的結果如何驗收
圖片能說明‘看起來哪里不對’，測試和代碼才能說明‘是否真正修好’。兩者缺一不可。
- 模型能準確描述截圖中的主要現象。
- 提出的文件范圍與項目結構匹配。
- 修改前給出原因和風險，而不是直接覆蓋。
- 修改后重新截圖，確認視覺問題是否改善。
- 同時運行代碼檢查、構建或局部測試。
圖片任務常見問題
排錯記錄只保留卡片名稱、錯誤碼、模型和時間，不保留包含賬號、密鑰或用戶數據的原圖。
- 圖片無法識別：檢查模型能力、客戶端附件功能和圖片格式。
- 401：檢查圖片分析卡片使用的專用令牌。
- 403：檢查模型權限和賬戶額度。
- 404：檢查 *ase **L 是否重復 /v1。
- model not found：重新復制當前 Model ID。
- 分析結果跑偏：減少無關上下文，明確圖片和代碼的對應關系。
圖片與項目安全邊界
需要查看當前模型、令牌和服務信息時，通過可點擊的靈能API官網入口進入：https://www.lnsns.com/。
- 上傳前裁剪賬號、郵箱、令牌和用戶數據。
- 只提供解決問題所需的局部截圖。
- 圖片分析卡與正式開**分開。
- 修改前檢查項目版本控制狀態。
- 完整 API Key 不出現在圖片、日志和倉庫。
圖片分析驗收清單
按照這套流程，截圖會成為定位問題的輔助證據，而不是替代代碼和測試的唯一依據。
- 當前模型確實支持目標圖片輸入方式。
- 圖片線路使用獨立配置卡和令牌。
- 測試圖片不包含敏感信息。
- 先描述截圖，再讀取代碼，再提出修改方案。
- 修改后重新截圖并運行測試。
- 遇到異常時可以切回已知可用線路。