veil：AI 代理的 MCP Shell 創新，回傳結構化效果以提升可靠性與安全性

veil 是一個 MCP shell，能將終端機命令的效果轉為結構化資料，而非原始文字，提高了 Agent 與命令互動的穩定性與安全性，並具有檔名追蹤、可恢復性等特性，是 Agent 工具開發的實戰進展。

大多數 AI 代理的 Shell 工具僅將標準輸出/錯誤直接傳輸給模型，導致解析脆弱、重複讀取狀態以及缺乏撤銷機制等問題。 veil 提出了一種創新方法，將指令執行結果視為結構化數據（structured effects），而非原始的終端文字。 • 它能從 git porcelain 或系統呼叫追蹤獲取檔案變更，提供精確的效果差異（effect-diff）。 • 指令細節（sh_detail）可儲存於磁碟並可定址，即使伺服器重啟也能搜尋歷史輸出，無須重複執行。 • 指令規劃（sh_plan）在執行前靜態分類指令的影響範圍（如唯讀、修改或破壞性），提升安全性。 • 利用 APFS CoW 實現檢查點/恢復功能，並可選擇性啟用核心沙盒，確保操作的可復現性。這個專案採用 MIT 授權，透過標準 I/O 運作，兼容多種 MCP 客戶端（如 Claude Code、Cursor、Zed）。

作者誠摯地希望社群能對這種「效果差異」方法與單純追蹤所有操作的模式進行比較，並提供回饋。