# 1. 激活Hermes虛擬環(huán)境（手動安裝用戶）
source ~/.hermes/venv/bin/activate
# 2. 確認hermes命令可用
hermes version
# 3. 安裝必要依賴（若未安裝）
pip install pydantic  # 工具參數校驗（Hermes內置依賴，一般已安裝）

# 創(chuàng)建自定義工具目錄（若不存在）
mkdir -p ~/.hermes/skills/my_custom_tools
cd ~/.hermes/skills/my_custom_tools

from hermes.tools.base import BaseTool
from pydantic import Field
from typing import Optional
# 自定義工具類，必須繼承BaseTool
class FileQueryTool(BaseTool):
    # 1. 工具基礎信息（必填）
    name: str = "file_query"  # 工具唯一標識（調用時用這個名字）
    description: str = "用于查詢本地文件的內容，需要傳入文件的絕對路徑；如果文件不存在，會返回錯誤提示"  # LLM用來判斷是否調用該工具
    return_direct: bool = False  # 是否直接返回結果（無需LLM二次處理）
    # 2. 工具參數（必填，用pydantic校驗）
    file_path: str = Field(
        description="本地文件的絕對路徑，例如：/home/user/test.txt、C:/Users/test.txt（WSL2中用Linux路徑）"
    )
    encoding: Optional[str] = Field(
        default="utf-8",
        description="文件編碼格式，默認utf-8，若出現亂碼可嘗試gbk"
    )
    # 3. 核心執(zhí)行方法（必填，實現工具邏輯）
    async def execute(self) -> str:
        """執(zhí)行工具，查詢文件內容并返回"""
        try:
            # 讀取文件內容
            with open(self.file_path, "r", encoding=self.encoding) as f:
                content = f.read()
            # 處理長文本（避免超過LLM上下文限制）
            if len(content) > 1000:
                return f"文件內容（前1000字符）：\n{content[:1000]}\n\n提示：文件內容過長，已截取前1000字符，如需完整內容請指定截取范圍。"
            else:
                return f"文件內容：\n{content}"
        except FileNotFoundError:
            return f"錯誤：未找到文件，請檢查路徑是否正確（路徑：{self.file_path}）"
        except Exception as e:
            return f"讀取文件失?。簕str(e)}"
# 注冊工具（Hermes啟動時會自動掃描并加載）
def register_tools(tool_manager):
    tool_manager.register_tool(FileQueryTool())

# 1. 重啟Hermes（加載新工具）
hermes stop  # 若已啟動，先停止
hermes       # 重新啟動
# 2. 在Hermes交互界面，查看所有工具
/hermes tools list

# Hermes交互界面輸入
幫我查詢文件 /home/user/test.txt 的內容

start_line: Optional[int] = Field(
    default=1,
    description="開始讀取的行數，默認從第1行開始"
)
end_line: Optional[int] = Field(
    default=None,
    description="結束讀取的行數，默認讀取到文件末尾"
)

hermes logs  # 查看Hermes運行日志，定位錯誤