? 先確認(rèn)線路是否支持多模態(tài)

并不是每個(gè)模型或每條 API 線路都能處理圖片和文檔。開始任務(wù)前，先查看當(dāng)前模型說明，確認(rèn)是否支持圖像輸入、文件解析或相關(guān)格式。不要因?yàn)槠胀ㄎ淖终?qǐng)求成功，就默認(rèn)圖片請(qǐng)求也一定可用。

能力不確定時(shí)，先用一張無敏感內(nèi)容的小圖片做測(cè)試。

• 模型能力：確認(rèn)當(dāng)前 Model ID 支持的輸入類型。
• 客戶端能力：確認(rèn) Codex 當(dāng)前版本能讀取該文件。
• 接口協(xié)議：確認(rèn)請(qǐng)求和響應(yīng)格式兼容。
• 權(quán)限額度：確認(rèn)圖片或長(zhǎng)文檔任務(wù)可用。

第一步：在靈能API中選擇合適模型

打開靈能API服務(wù)入口，查看當(dāng)前模型列表和能力說明。圖片分析、文檔理解和代碼**對(duì)模型要求不同，優(yōu)先選擇當(dāng)前線路明確支持對(duì)應(yīng)輸入的模型。

靈能API入口：https://www.lnsns.com/。不要把包含賬號(hào)、密鑰或客戶數(shù)據(jù)的截圖直接上傳測(cè)試。

• 復(fù)制精確 Model ID。
• 確認(rèn)輸入價(jià)格和長(zhǎng)上下文限制。
• 使用多模態(tài)專用測(cè)試令牌或項(xiàng)目令牌。

第二步：為圖片和文檔任務(wù)設(shè)置獨(dú)立渠道

建議為多模態(tài)任務(wù)單獨(dú)建立一張 CC Switch 卡片，名稱寫清模型和用途，例如‘靈能API-Codex-I**ge-Review’。這樣可以和普通代碼修改卡區(qū)分，也方便統(tǒng)計(jì)這類任務(wù)的消耗。

先保存卡片，再獲取模型列表。模型列表成功不代表圖片能力已經(jīng)驗(yàn)證，還需要繼續(xù)做最小圖像測(cè)試。

• API Key：使用權(quán)限明確的專用令牌。
• *ase **L：從當(dāng)前接口說明復(fù)制。
• Model ID：選擇支持當(dāng)前輸入類型的模型。

第三步：圖片分析前先做隱**理

截圖中可能包含郵箱、電話號(hào)碼、令牌、客戶名稱、內(nèi)部域名和項(xiàng)目路徑。上傳前先裁剪無關(guān)區(qū)域并遮蓋敏感信息。圖片分析的目標(biāo)是解決問題，不是把整個(gè)桌面環(huán)境完整發(fā)送出去。

如果無法確認(rèn)圖片是否包含敏感信息，先不要上傳，改用脫敏后的局部截圖。

• 隱藏 API Key、Cookie 和登錄二維碼。
• 隱藏客戶姓名、手機(jī)號(hào)和內(nèi)部地址。
• 只保留與問題相關(guān)的錯(cuò)誤提示或界面區(qū)域。
• 避免上傳包含生產(chǎn)環(huán)境信息的整張桌面截圖。

**步：讓 Codex 先描述再判斷

圖片任務(wù)中，建議把‘看到了什么’和‘應(yīng)該怎么做’分成兩步。先讓 Codex 客觀描述界面、錯(cuò)誤碼和可見字段，再讓它給出可能原因。這樣可以減少模型把猜測(cè)當(dāng)成事實(shí)。

先只描述截圖中可見的錯(cuò)誤碼、字段和值類型。
不要猜測(cè)隱藏信息。
第二步再列出三個(gè)可能原因。
最后給出驗(yàn)證順序，不要直接修改配置。

• 先事實(shí)，后推斷。
• 要求引用截圖中可見的證據(jù)。
• 不把圖片中的模糊文字當(dāng)作精確配置。

第五步：長(zhǎng)文檔分析要控制范圍

上傳整份長(zhǎng)文檔并不一定能得到更好的答案。先明確你要解決的問題，再只提供相關(guān)章節(jié)、表格或錯(cuò)誤段落。對(duì)于代碼文檔，最好同時(shí)說明倉(cāng)庫(kù)結(jié)構(gòu)、目標(biāo)模塊和輸出格式。

長(zhǎng)文檔分批分析時(shí)，為每批內(nèi)容保留標(biāo)題和頁(yè)碼，后續(xù)匯總會(huì)更容易校對(duì)。

• 問題先行：說明你需要提取、比較還是總結(jié)。
• 范圍明確：指定頁(yè)碼、章節(jié)或文件。
• 輸出格式：要求表格、清單或修復(fù)計(jì)劃。
• 敏感處理：刪去無關(guān)賬號(hào)和內(nèi)部信息。

第六步：圖片與代碼結(jié)合分析

遇到前端布局、終端報(bào)錯(cuò)或配置界面問題時(shí)，圖片只能展示現(xiàn)象，代碼和日志才能提供原因。讓 Codex 把圖片中的現(xiàn)象與指定文件關(guān)聯(lián)起來，不要只憑截圖直接修改項(xiàng)目。

請(qǐng)先描述截圖中可見的問題。
再讀取 config 文件和相關(guān)日志。
比較截圖字段與文件字段。
列出差異和驗(yàn)證方法。
不要直接修改文件。

• 截圖用于確認(rèn)現(xiàn)象。
• 配置文件用于確認(rèn)實(shí)際值。
• 日志用于確認(rèn)發(fā)生順序。

第七步：用小圖片完成能力驗(yàn)證

第一次驗(yàn)證多模態(tài)線路時(shí)，準(zhǔn)備一張無敏感信息、內(nèi)容清晰、尺寸適中的圖片。要求 Codex 只返回可見文字和布局要點(diǎn)，不執(zhí)行文件修改，也不加入長(zhǎng)項(xiàng)目上下文。

New-Item -ItemType Directory codex-vision-check
Set-Location codex-vision-check
codex

小測(cè)試通過后，再把圖片分析與項(xiàng)目代碼、日志或文檔結(jié)合。

• 測(cè)試一：識(shí)別圖片中可見的標(biāo)題。
• 測(cè)試二：列出三個(gè)可見界面元素。
• 測(cè)試三：指出無法確認(rèn)的信息。

? 第八步：進(jìn)入真實(shí)項(xiàng)目時(shí)分階段處理

真實(shí)項(xiàng)目中的圖片任務(wù)可以拆成四步：確認(rèn)圖片現(xiàn)象、讀取相關(guān)代碼、提出修改計(jì)劃、執(zhí)行局部修復(fù)。不要讓 Codex 僅憑一張截圖直接重構(gòu)整個(gè)頁(yè)面。

修改前檢查 Git 狀態(tài)，修改后同時(shí)查看 diff 和頁(yè)面截圖，避免視覺修復(fù)引入代碼回歸。

• 階段一：描述截圖問題和可見證據(jù)。
• 階段二：讀取相關(guān)組件、樣式和錯(cuò)誤日志。
• 階段三：提出最小修改計(jì)劃。
• 階段四：修改指定文件并截圖驗(yàn)證。

多模態(tài)任務(wù)常見問題

多模態(tài)排錯(cuò)先確認(rèn)能力和格式，再檢查權(quán)限、上下文和任務(wù)提示，不要只重復(fù)上傳同一張圖片。

• 圖片無法讀?。捍_認(rèn)模型、接口和客戶端支持。
• 識(shí)別文字不準(zhǔn)：裁剪清晰區(qū)域并提供文字上下文。
• 響應(yīng)超時(shí)：縮小圖片、減少上下文和并發(fā)。
• 圖片能看但項(xiàng)目修改失敗：檢查工作目錄和權(quán)限。
• 結(jié)果過于肯定：要求區(qū)分可見事實(shí)和推測(cè)。
• 費(fèi)用增加：檢查圖片尺寸、重復(fù)上傳和長(zhǎng)歷史上下文。

? 多模態(tài)接入驗(yàn)收清單

靈能API接入 Codex 后，多模態(tài)能力的效果取決于模型支持、輸入質(zhì)量、上下文范圍和驗(yàn)證流程。先小范圍確認(rèn)，再逐步用于真實(shí)項(xiàng)目。

• 當(dāng)前模型明確支持所需輸入類型。
• CC Switch 已建立多模態(tài)任務(wù)專用卡。
• 測(cè)試圖片已完成脫敏。
• 首次測(cè)試使用空目錄和小圖片。
• 提示詞要求區(qū)分事實(shí)與推測(cè)。
• 長(zhǎng)文檔按章節(jié)或問題拆分。
• 真實(shí)項(xiàng)目采用圖片、代碼、日志聯(lián)合驗(yàn)證。
• 截圖和日志中沒有完整 API Key。