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

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

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

# Hermes交互界面輸入
幫我查詢(xún)文件 /home/user/test.txt 的內(nèi)容

start_line: Optional[int] = Field(
    default=1,
    description="開(kāi)始讀取的行數(shù)，默認(rèn)從第1行開(kāi)始"
)
end_line: Optional[int] = Field(
    default=None,
    description="結(jié)束讀取的行數(shù)，默認(rèn)讀取到文件末尾"
)

hermes logs  # 查看Hermes運(yùn)行日志，定位錯(cuò)誤