檔案工具
這是什麼
Hermes 對專案檔案系統執行讀取、寫入、局部修補與搜尋的四類工具能力。
白話解釋
想像一台只有四種功能的圖書館推車：從書架取書、放入一本新書、只修正特定頁面的錯字而不必重抄整本書，以及依關鍵字搜尋館藏。檔案工具就是 Hermes 操作檔案系統的這台推車，只負責讀取、寫入、修補與搜尋。
為什麼重要
讀取、寫入、修補、搜尋這四種檔案操作，支撐了大量工作流程：內容再利用、商業 CRM 接收，以及任何需要持久保存產出物的技能，都會使用同一套工具。檔案存取一旦設定錯誤，後果通常較大，因此它也自然搭配專案隔離與核准邊界，限制讀寫實際可以落在哪裡。這套工具集共有 4 個宣告，與終端機及 Home Assistant 工具集相同。
運作方式
read_file 會回傳檔案內容，預設上限約 100,000 個字元，並可透過 file_read_max_chars 調整，避免內容塞滿上下文視窗；write_file 可建立或覆寫路徑；search_files 以 ripgrep 執行正規表示式內容搜尋，或以 glob 尋找檔案；patch 則使用 9 種模糊比對策略進行局部尋找與取代，讓少量空白或縮排差異不致造成比對失敗（tools/file_tools.py）。修補模式也接受多檔案的 V4A 風格批次修補，並在編輯後自動執行語法檢查。跨設定檔的軟性防護會阻擋寫入其他 Hermes 設定檔所屬的技能、外掛程式、排程任務或記憶，除非呼叫端明確停用這項防護。
具體範例
代理收到任務，要在整個專案修正設定檔中的拼字錯誤。它先以 search_files 搭配正規表示式找出所有包含錯字的檔案，再逐一呼叫 patch 傳入舊字串與新字串；不同檔案的縮排差異由模糊比對吸收。每次 patch 都回傳統一差異，因此 Hermes 能精確說明變更，不必重寫整份檔案。
如何連結
「檔案工具」屬於「工具」系列。最直接相關的概念包括：「瀏覽器工具」、「終端機工具」、「代理執行環境」、「個人作業系統」。
來源證據
vendor/hermes-agent/toolsets.py#<file>—toolsets.py的結構性來源對應；此檔位於工具、工具集與 MCP 架構中的工具登錄與工具集核心結構。