模態(tài)大模型在代碼能力上進步驚人，但在基礎(chǔ)視覺任務(wù)上卻頻繁失誤。UniPat AI 構(gòu)建了一個極簡的視覺智能體框架——SWE-Vision，讓模型可以編寫并執(zhí)行 Python 代碼來處理和驗證自己的視覺判斷。在五個主流視覺基準測試中，SWE-Vision 均達到了當前最優(yōu)水平。

01｜模型看得見，卻沒法精確處理

多模態(tài)大模型的代碼能力在過去一年取得了驚人進展——獨立搭建項目、排查 bug、完成復雜重構(gòu)，表現(xiàn)已可比肩資深工程師。然而在"理解視覺世界"這件事上，它們的表現(xiàn)遠沒有代碼能力那樣可靠。UniPat AI 此前發(fā)布的多模態(tài)基準 BabyVision 就揭示了這一現(xiàn)象：模型常常給出大段看似合理的推理，卻在最基礎(chǔ)的計量、計數(shù)和空間關(guān)系判斷上出錯。

UniPat AI此前發(fā)布的多模態(tài)理解benchmark BabyVision已被多個近期發(fā)布的重磅模型產(chǎn)品納入評測體系，并在其技術(shù)報告中被引用，體現(xiàn)了社區(qū)對這一問題的廣泛關(guān)注。

當我們仔細審視BabyVision中模型出錯的案例時，可以發(fā)現(xiàn)一個關(guān)鍵點：問題往往是"模型看見了，卻無法精確處理"：

• 閱讀柱狀圖時，模型能感知到"大約 75%"，但無法精確計算比值；
• 在復雜場景中計數(shù)時，模型可能識別了每一個物體，但在逐一清點時出錯；
• 描述空間位置時，模型能給出定性判斷，但難以穩(wěn)定進行距離計算和幾何推理。

面對這些錯誤，人類通常會怎么做？掏出工具：畫輔助線、作出標記、用尺測量、用筆計算。

這個觀察引發(fā)了一個關(guān)鍵猜想：既然模型已經(jīng)極其擅長編程，能否讓它用代碼——這個它最熟悉的工具——來彌補視覺處理中的精度短板？

SWE-Vision 正是對這一猜想的系統(tǒng)性驗證。

其結(jié)果令人矚目：在五個不同的視覺基準測試中——涵蓋基礎(chǔ)感知、圖表推理、數(shù)學問題解決、空間理解和復雜的多步驟視覺挑戰(zhàn)——SWE-Vision 始終改進了前沿 LLM，如 GPT-5.2-xhigh 和 Seed-2.0-Pro，并取得了最先進的結(jié)果：在 BabyVision 上達到 64.4，在 MathVision 上達到 94.0，在 Zero-Bench-Sub 上達到 50.1，在 OmniSpatial 上達到 69.0，在 CharXiv-RQ 上達到 82.5。

02｜SWE-Vision 是什么：一個“極簡視覺智能體”

SWE-Vision 并不需要再造一堆專用視覺工具，而是把要做的事壓縮到極簡：

2.1 工具層：只保留兩個工具

config.py 里定義的工具只有兩個：execute_code 和 finish。

• execute_code：讓模型在一個可持續(xù)保留狀態(tài)的 Jupyter 環(huán)境里執(zhí)行 Python
• finish：當模型確信答案正確時輸出最終答案

這里最關(guān)鍵的不是“能執(zhí)行代碼”，而是工具接口本身非常小、非常通用。SWE-Vision 沒有給模型塞一堆專用視覺 API，而是只暴露一個模型本來就很熟悉的動作：寫 Python。

2.2 控制層：一個標準的 agentic loop

agent.py 里的 VLMToolCallAgent 實現(xiàn)了完整的循環(huán)：先把用戶問題和圖片組織成消息；然后調(diào)用支持 tool use 的聊天接口；如果模型發(fā)起 execute_code，就把代碼送到 notebook 內(nèi)核執(zhí)行；再把執(zhí)行結(jié)果作為 tool message 回流給模型；模型據(jù)此決定繼續(xù)調(diào)用工具還是 finish。repo 里默認 tool_choice="auto"，并支持 reasoning 模式；在開啟時會把推理 effort 設(shè)為高檔，并允許最多 100 輪迭代。

2.3 執(zhí)行層：Docker 里的持久化 Jupyter kernel

kernel.py 不是簡單 exec() 一段代碼，而是正經(jīng)啟動一個 Docker 容器，再在容器里拉起 ipykernel。宿主側(cè)通過
jupyter_client.BlockingKernelClient連接這個內(nèi)核，并從 IOPub / shell 通道收集執(zhí)行結(jié)果。內(nèi)核是持久化的，變量、導入、圖像對象和中間結(jié)果都能跨多次 execute_code 保留；同時代碼運行在隔離的 Docker 環(huán)境里，宿主與容器通過掛載目錄交換文件。kernel.py 還會在啟動后做 health check，并把 matplotlib 后端配置成 inline，以便抓取圖像輸出。

簡單來說，SWE-Vision 不強迫模型每題都寫代碼，但給它一個隨時可用并且熟悉的“視覺工具庫”。

03｜一次請求在系統(tǒng)里到底怎么流動：從看圖推理到帶圖循環(huán)驗證

SWE-Vision 像一個會看圖的數(shù)據(jù)科學家，其完整工作流如下：

1. 用戶給問題 + 圖片
2. 模型先思考：這題能不能直接答？需不需要計算/驗證？
3. 需要就調(diào)用 execute_code：在 Notebook 里用 PIL / NumPy / matplotlib 等做分析
4. 代碼輸出（數(shù)值/報錯/可視化圖）回流給模型
5. 模型繼續(xù)迭代，直到調(diào)用finish 給最終答案

它有幾個關(guān)鍵設(shè)計：

• 有狀態(tài)的執(zhí)行環(huán)境：變量、導入、圖片加載都能跨多次調(diào)用保留
• Docker 沙箱：確保可控安全環(huán)境 + 復現(xiàn)性；
• Image-in / Image-out：意味著模型不僅能讀取輸入圖像，還能將自己生成的可視化結(jié)果回傳給自身進行驗證——這是實現(xiàn)自我糾錯的關(guān)鍵；
• OpenAI function calling 標準接口：保證了與主流模型的開箱即用兼容性。

這套設(shè)計的價值在于：允許模型像一個真正的科學家一樣，先做實驗再下結(jié)論。

04｜為什么 stateful notebook 比一次性 code executor 更關(guān)鍵

很多人第一次看 SWE-Vision 會覺得，它不過是在 VLM 外面加了個 Python 工具。真正的差別其實在于stateful。在SWE-Vision 中內(nèi)核狀態(tài)會在多次調(diào)用間保留；這意味著模型可以像人類分析師那樣分步工作：第一輪先讀圖、檢查尺寸；第二輪裁剪局部、看邊緣；第三輪統(tǒng)計顏色或測距離；第四輪畫輔助線做確認；最后再生成答案。

如果代碼執(zhí)行是無狀態(tài)的，這種多步分析會非常笨重：每一步都要重新導入庫、重載圖片、重建變量，模型也更難維護中間假設(shè)。SWE-Vision 通過持久化 kernel，把“多輪工具調(diào)用”變成了“同一個 notebook 會話里的連續(xù)實驗”。從工程實現(xiàn)上看，這也是它為什么能處理圖表測量、空間關(guān)系和復雜多步視覺任務(wù)，而不只是做一次性的 OCR 或檢測。

05｜SWE-Vision 的關(guān)鍵在于“能驗證自己的視覺判斷”

在 SWE-Vision「觀察科學圖表、總結(jié)規(guī)律」的案例中，我們看到了一種截然不同的行為模式。如下圖所示，這是科研場景中常見的圖表分析任務(wù)：我們要求模型判斷，在 Quarters = 15 時，哪一張子圖中紅色虛線與黑色實線之間的差距最大。

SWE-Vision 智能體給出了一套極其嚴謹且可解釋的解法。首先，它排除了不存在紅色虛線的子圖（d）；隨后，對每一張候選子圖在 Quarters = 15 處精確繪制輔助線，定位紅線與黑線的交點；接著，通過可執(zhí)行代碼精確計算兩條曲線在該位置的數(shù)值差距；最終基于計算結(jié)果給出正確答案。

這種“先結(jié)構(gòu)化分析、再程序化測量、最后數(shù)值驗證”的思維與行動閉環(huán)，與傳統(tǒng)視覺語言模型依賴直覺式“瞪眼觀察”直接給出答案的方式形成鮮明對比。它不僅顯著提升了結(jié)果的可靠性與可解釋性，也展示出更高的能力上限與更強的泛化潛力。

06｜為什么極簡設(shè)計反而更強

SWE-Vision 的一個重要結(jié)論是：對視覺任務(wù)而言，加入通用代碼工具，是提升前沿多模態(tài)模型視覺能力的一個有效 test-time scaling 方向。

它之所以有效，恰恰在于其極簡：

• 工具數(shù)量少，決策邊界清晰；
• 工具語義與模型已有能力高度一致；
• 支持多輪迭代和狀態(tài)積累；
• 中間結(jié)果可被再次觀察，而不是一次性返回文本；
• 不綁定某個特定 benchmark 的專用手工策略。

這與很多“為了某類視覺任務(wù)單獨發(fā)明一套工具接口”的方法不同。這些方法往往在某些窄任務(wù)上能提升，但泛化性不足；而 SWE-Vision 的目標，是提供一個盡可能通用的視覺增強框架，讓模型自己決定何時調(diào)用代碼、如何組織分析步驟。

07｜五大基準全線提升：更加通用的“視覺能力增強器”

SWE-Vision 在五個覆蓋面很廣的視覺基準上進行了評測（基礎(chǔ)感知、圖表、數(shù)學、空間、綜合多步推理），核心發(fā)現(xiàn)高度一致：引入代碼執(zhí)行能力，能系統(tǒng)性地抬升前沿模型的視覺表現(xiàn)上限。

在對比實驗中（同一模型 vs SWE-Vision），SWE-Vision 對兩個前沿的視覺語言模型（GPT-5.2，Seed-2.0）都帶來顯著提升：

“反直覺”的一點是：提升幅度最大的，往往不是最復雜的高階推理任務(wù)，而是最基礎(chǔ)的感知和精確處理能力——例如 BabyVision 中的計數(shù)、顏色識別和空間關(guān)系判斷。這類任務(wù)人類靠直覺加簡單工具就能穩(wěn)定完成，而模型僅憑"語言化視覺"則極易忽略細節(jié)、數(shù)錯個數(shù)、缺乏驗證手段。

SWE-Vision 的結(jié)果也給我們揭示了另一種可能：對于視覺來說，測試時擴展（test-time scaling，TTS）不一定只能靠“多想幾段文字”，也可以靠“多寫幾行代碼”來看得更精細。

08｜未來的發(fā)展方向：讓“代碼增強視覺”變成視覺智能體的原生能力

與用于訓練多模態(tài) LLMs 的傳統(tǒng)數(shù)據(jù)（基本上是問題，圖片，答案三元組）不同，訓練視覺智能體模型需要多模態(tài)交錯的智能體軌跡。它還需要一個交互式環(huán)境來支持強化學習、工具使用和評估，使模型不僅能學習回答問題，還能學習感知、行動和反思，要徹底釋放“工具增強視覺”的潛力，模型需要更多深度交織的視覺-編程 SFT/RL 數(shù)據(jù)與環(huán)境，來學會感知、行動和反思。

具體而言，下一步的關(guān)鍵方向包括：

• 判斷時機：學會識別何時視覺推理需要代碼輔助，何時可以直接回答
• 中間驗證：在多步推理過程中主動檢驗中間結(jié)果的正確性
• 失敗恢復：在代碼方案無效時及時跳出，切換到替代策略
• 原生融合：讓"觀察"與"計算"不再是兩個獨立步驟，而是深度融合，一體兩面

SWE-Vision 的開源代碼已在 GitHub 發(fā)布。編程輔助的精確視覺理解是一個值得社區(qū)共同探索的方向——五百行代碼的極簡框架，也許是這段旅程一個不錯的起點。