檔案工具

這是什麼

Hermes 如何將檔案系統作業（讀取、寫入、編輯、搜尋、目錄列表）公開為代理可直接呼叫的工具。

白話解釋

想像一個可以為你閱讀、撰寫和管理檔案的圖書館員——你告訴他需要什麼，他就會去拿正確的書，抄錄你需要的部分，並將它放回原位。Hermes 的檔案工具讓 AI 代理能夠以結構化、安全的方式與你的檔案系統互動，就像一位能幹的圖書館員。

為什麼重要

檔案是我們大多數數位生活的基礎。如果 Hermes 無法讀取和寫入檔案，它的功能將嚴重受限——它無法編輯你的程式碼、讀取你的筆記、或將結果儲存到檔案中。檔案工具提供了這種基礎的能力，同時透過核准邊界和路徑限制來維持安全。

運作方式

檔案工具作為一組獨立的工具來實作，每個工具對應一個特定的檔案系統操作：read_file、write_file、edit_file、search_files、list_directory。每個工具接受檔案路徑和操作專用的參數。這些工具遵循核准邊界（某些操作可能需要你的核准），並遵守專案隔離規則（代理只能存取允許的目錄）。

具體範例

你要求：「在我的專案中搜尋所有包含「API_KEY」的檔案，並將它們的內容替換為「API_KEY=your-key-here」」——但僅限於 .env.example 檔案中。

1. Hermes 使用 search_files 在專案中搜尋「API_KEY」。
2. 它找到數個 .env 和 .env.example 檔案。
3. 它使用 edit_file 僅更新 .env.example 檔案。
4. 實際的 .env 檔案會被跳過——無論是因為核准邊界要求你的確認，還是因為明確的路徑排除規則。

如何連結

本筆記屬於工作區系列。最鄰近的概念包括：核准邊界、專案隔離、成品產出。

來源證據

• file_tools.py#read_file、file_tools.py#write_file、file_tools.py#edit_file、file_tools.py#search_files、file_tools.py#list_directory — 提供核心檔案系統操作的個別工具。

工作流程

• 尚無首次工作流程對應；此概念仍透過文章與來源證據存在於筆記庫圖譜中。

相關文章

• 目前暫無文章以此概念名稱或別名達到引用門檻（請參閱提及-挖掘政策）。

相關筆記

• 核准邊界
• 專案隔離
• 成品產出