refactor: Update tool imports and descriptions in factory.py; remove obsolete query tools and enhance ListDirectoryTool description

app/agent/tools/impl/list_directory.py

@@ -24,7 +24,7 @@ class ListDirectoryInput(BaseModel):
 
 class ListDirectoryTool(MoviePilotTool):
     name: str = "list_directory"
-    description: str = "List contents of a file system directory. Shows files and subdirectories with their names, types, sizes, and modification times. Returns up to 20 items and the total count if there are more items."
+    description: str = "List actual files and folders in a file system directory (NOT configuration). Shows files and subdirectories with their names, types, sizes, and modification times. Returns up to 20 items and the total count if there are more items. Use 'query_directories' to query directory configuration settings."
     args_schema: Type[BaseModel] = ListDirectoryInput
 
     def get_tool_message(self, **kwargs) -> Optional[str]:

app/agent/tools/impl/query_directory_settings.py

@@ -10,7 +10,7 @@ from app.helper.directory import DirectoryHelper
 from app.log import logger
 
 
-class QueryDirectoriesInput(BaseModel):
+class QueryDirectorySettingsInput(BaseModel):
     """查询系统目录设置工具的输入参数模型"""
     explanation: str = Field(..., description="Clear explanation of why this tool is being used in the current context")
     directory_type: Optional[str] = Field("all",
@@ -21,10 +21,10 @@ class QueryDirectoriesInput(BaseModel):
                                description="Filter directories by name (partial match, optional)")
 
 
-class QueryDirectoriesTool(MoviePilotTool):
-    name: str = "query_directories"
-    description: str = "Query system directory configuration and list all configured directories. Shows download directories, media library directories, storage settings, transfer modes, and other directory-related configurations."
-    args_schema: Type[BaseModel] = QueryDirectoriesInput
+class QueryDirectorySettingsTool(MoviePilotTool):
+    name: str = "query_directory_settings"
+    description: str = "Query system directory configuration settings (NOT file listings). Returns configured directory paths, storage types, transfer modes, and other directory-related settings. Use 'list_directory' to list actual files and folders in a directory."
+    args_schema: Type[BaseModel] = QueryDirectorySettingsInput
 
     def get_tool_message(self, **kwargs) -> Optional[str]:
         """根据查询参数生成友好的提示消息"""

app/agent/tools/impl/query_download_tasks.py

@@ -11,7 +11,7 @@ from app.db.downloadhistory_oper import DownloadHistoryOper
 from app.log import logger
 
 
-class QueryDownloadsInput(BaseModel):
+class QueryDownloadTasksInput(BaseModel):
     """查询下载工具的输入参数模型"""
     explanation: str = Field(..., description="Clear explanation of why this tool is being used in the current context")
     downloader: Optional[str] = Field(None,
@@ -22,10 +22,10 @@ class QueryDownloadsInput(BaseModel):
     title: Optional[str] = Field(None, description="Query download tasks by title/name (optional, supports partial match, searches all tasks if provided)")
 
 
-class QueryDownloadsTool(MoviePilotTool):
-    name: str = "query_downloads"
+class QueryDownloadTasksTool(MoviePilotTool):
+    name: str = "query_download_tasks"
     description: str = "Query download status and list download tasks. Can query all active downloads, or search for specific tasks by hash or title. Shows download progress, completion status, and task details from configured downloaders."
-    args_schema: Type[BaseModel] = QueryDownloadsInput
+    args_schema: Type[BaseModel] = QueryDownloadTasksInput
 
     def get_tool_message(self, **kwargs) -> Optional[str]:
         """根据查询参数生成友好的提示消息"""

app/agent/tools/impl/query_library_exists.py

@@ -12,7 +12,7 @@ from app.log import logger
 from app.schemas.types import MediaType
 
 
-class QueryMediaLibraryInput(BaseModel):
+class QueryLibraryExistsInput(BaseModel):
     """查询媒体库工具的输入参数模型"""
     explanation: str = Field(..., description="Clear explanation of why this tool is being used in the current context")
     media_type: Optional[str] = Field("all",
@@ -23,10 +23,10 @@ class QueryMediaLibraryInput(BaseModel):
                                 description="Release year of the media (optional, helps narrow down search results)")
 
 
-class QueryMediaLibraryTool(MoviePilotTool):
-    name: str = "query_media_library"
+class QueryLibraryExistsTool(MoviePilotTool):
+    name: str = "query_library_exists"
     description: str = "Check if a specific media resource already exists in the media library (Plex, Emby, Jellyfin). Use this tool to verify whether a movie or TV series has been successfully processed and added to the media server before performing operations like downloading or subscribing."
-    args_schema: Type[BaseModel] = QueryMediaLibraryInput
+    args_schema: Type[BaseModel] = QueryLibraryExistsInput
 
     def get_tool_message(self, **kwargs) -> Optional[str]:
         """根据查询参数生成友好的提示消息"""

app/agent/tools/impl/query_library_latest.py

@@ -11,17 +11,17 @@ from app.helper.service import ServiceConfigHelper
 from app.log import logger
 
 
-class QueryMediaLatestInput(BaseModel):
+class QueryLibraryLatestInput(BaseModel):
     """查询媒体服务器最近入库影片工具的输入参数模型"""
     explanation: str = Field(..., description="Clear explanation of why this tool is being used in the current context")
     server: Optional[str] = Field(None, description="Media server name (optional, if not specified queries all enabled media servers)")
     count: Optional[int] = Field(20, description="Number of items to return (default: 20)")
 
 
-class QueryMediaLatestTool(MoviePilotTool):
-    name: str = "query_media_latest"
+class QueryLibraryLatestTool(MoviePilotTool):
+    name: str = "query_library_latest"
     description: str = "Query the latest media items added to the media server (Plex, Emby, Jellyfin). Returns recently added movies and TV series with their titles, images, links, and other metadata."
-    args_schema: Type[BaseModel] = QueryMediaLatestInput
+    args_schema: Type[BaseModel] = QueryLibraryLatestInput
 
     def get_tool_message(self, **kwargs) -> Optional[str]:
         """根据查询参数生成友好的提示消息"""

app/agent/tools/impl/recognize_media.py

@@ -22,7 +22,7 @@ class RecognizeMediaInput(BaseModel):
 
 class RecognizeMediaTool(MoviePilotTool):
     name: str = "recognize_media"
-    description: str = "Recognize media information from torrent titles or file paths. Supports two modes: 1) Recognize from torrent title and optional subtitle, 2) Recognize from file path. Returns detailed media information including title, year, type, TMDB ID, overview, and other metadata."
+    description: str = "Extract/identify media information from torrent titles or file paths (NOT database search). Supports two modes: 1) Extract from torrent title and optional subtitle, 2) Extract from file path. Returns detailed media information. Use 'search_media' to search TMDB database, or 'scrape_metadata' to generate metadata files for existing files."
     args_schema: Type[BaseModel] = RecognizeMediaInput
 
     def get_tool_message(self, **kwargs) -> Optional[str]:

app/agent/tools/impl/scrape_metadata.py

@@ -27,7 +27,7 @@ class ScrapeMetadataInput(BaseModel):
 
 class ScrapeMetadataTool(MoviePilotTool):
     name: str = "scrape_metadata"
-    description: str = "Scrape media metadata (NFO files, posters, backgrounds, etc.) for a file or directory. Automatically recognizes media information from the file path and generates metadata files. Supports both local and remote storage."
+    description: str = "Generate metadata files (NFO files, posters, backgrounds, etc.) for existing media files or directories. Automatically recognizes media information from the file path and creates metadata files. Supports both local and remote storage. Use 'search_media' to search TMDB database, or 'recognize_media' to extract info from torrent titles/file paths without generating files."
     args_schema: Type[BaseModel] = ScrapeMetadataInput
 
     def get_tool_message(self, **kwargs) -> Optional[str]:

app/agent/tools/impl/search_media.py

@@ -24,7 +24,7 @@ class SearchMediaInput(BaseModel):
 
 class SearchMediaTool(MoviePilotTool):
     name: str = "search_media"
-    description: str = "Search for media resources including movies, TV shows, anime, etc. Supports searching by title, year, type, and other criteria. Returns detailed media information from TMDB database."
+    description: str = "Search TMDB database for media resources (movies, TV shows, anime, etc.) by title, year, type, and other criteria. Returns detailed media information from TMDB. Use 'recognize_media' to extract info from torrent titles/file paths, or 'scrape_metadata' to generate metadata files."
     args_schema: Type[BaseModel] = SearchMediaInput
 
     def get_tool_message(self, **kwargs) -> Optional[str]: