mirror of
https://github.com/jxxghp/MoviePilot.git
synced 2026-06-21 23:44:31 +08:00
feat: add organize files skill
This commit is contained in:
jxxghp
@@ -575,7 +575,7 @@ class ConfigModel(BaseModel):
|
||||
# LLM Base URL 预设标识，用于区分同一 Base URL 下的不同模型目录
|
||||
LLM_BASE_URL_PRESET: Optional[str] = None
|
||||
# LLM最大上下文Token数量（K）
|
||||
LLM_MAX_CONTEXT_TOKENS: int = 64
|
||||
LLM_MAX_CONTEXT_TOKENS: int = 128
|
||||
# LLM OpenAI兼容接口请求User-Agent
|
||||
LLM_USER_AGENT: Optional[str] = None
|
||||
# LLM温度参数
|
||||
|
||||
147
skills/organize-files/SKILL.md
Normal file
147
skills/organize-files/SKILL.md
Normal file
@@ -0,0 +1,147 @@
|
||||
---
|
||||
name: organize-files
|
||||
version: 1
|
||||
description: >-
|
||||
Use this skill when the user asks the MoviePilot agent to identify and organize downloaded/local media files that automatic transfer cannot handle. Typical triggers include: manually organize a file or folder, organize unrecognized downloads, fix files stuck in a download directory, identify a messy episode pack, move/copy/link files into the library, or organize files by explicit TMDB/Douban ID. If the user gives failed transfer history IDs, prefer transfer-failed-retry instead.
|
||||
allowed-tools: list_directory query_directory_settings query_download_tasks query_transfer_history delete_transfer_history recognize_media search_media query_media_detail query_library_exists transfer_file ask_user_choice send_message
|
||||
---
|
||||
|
||||
# Organize Files (智能整理文件)
|
||||
|
||||
Use this skill to help the user identify media files that MoviePilot could not organize automatically, then call the normal transfer pipeline through `transfer_file`. Do not rename, move, or copy files manually; let MoviePilot's directory, transfer mode, rename template, overwrite, scrape, and notification settings handle the actual organization.
|
||||
|
||||
## MoviePilot Transfer Flow
|
||||
|
||||
MoviePilot's normal flow is:
|
||||
|
||||
1. `DownloadChain.download_single` adds a downloader task, records `DownloadHistory` and `DownloadFiles`, runs downloader-specific `download_added`, then sends `DownloadAdded`.
|
||||
2. `TransferChain.process` scans completed downloader tasks in monitored download directories. If a `DownloadHistory` exists for the hash, it reuses the recorded media IDs; otherwise it falls back to path recognition.
|
||||
3. Agent/manual organization calls `transfer_file`, which enters `TransferFileTool` -> `TransferChain.manual_transfer` -> `TransferChain.do_transfer`.
|
||||
4. `do_transfer` recursively collects eligible media/subtitle/audio files, ignores recycle/hidden paths and configured exclude words, resolves download history when possible, builds `MetaInfoPath`, then either uses explicit media info or calls `MediaChain.recognize_by_meta`.
|
||||
5. `TransferChain.__handle_transfer` chooses the target directory through `DirectoryHelper`, delegates file operations to the file manager module, and lets `TransHandler` build the final target path and name.
|
||||
6. The callback writes `TransferHistory` success/failure records, emits transfer events, sends notifications, and may trigger `transfer-failed-retry` for failed history records.
|
||||
|
||||
Important implication: an existing `TransferHistory` for the same source path can make a later transfer skip. Delete only stale or failed history records, and only after the user has confirmed the record is safe to remove.
|
||||
|
||||
## Workflow
|
||||
|
||||
### 1. Classify The Request
|
||||
|
||||
- If the user provides one or more failed transfer history IDs, stop and use `transfer-failed-retry`.
|
||||
- If the user provides a path, start from that path.
|
||||
- If the user describes a download task, use `query_download_tasks` to find its save path or hash, then continue with the path.
|
||||
- If the user only says "整理一下下载目录", use `query_directory_settings(directory_type="download")` first, then ask which directory or subdirectory to process if more than one candidate exists.
|
||||
|
||||
### 2. Inspect Candidate Files
|
||||
|
||||
Use `list_directory` for any directory the user provides. Prefer `sort_by="time"` for "recent" or "刚下载的" requests.
|
||||
|
||||
For directories with more than 20 items, ask the user to narrow the folder or choose the relevant child directory before running transfers. Avoid organizing a broad shared download root unless the user explicitly confirms the scope.
|
||||
|
||||
Treat these as transfer candidates:
|
||||
|
||||
- main media files and Blu-ray folders;
|
||||
- matching subtitle and external audio files in the same media folder;
|
||||
- episode packs where files share the same title/season pattern.
|
||||
|
||||
Skip obvious samples, trailers, screenshots, hidden folders, recycle folders, and files that are not media/subtitle/audio.
|
||||
|
||||
### 3. Identify The Media
|
||||
|
||||
For the best sample file, call:
|
||||
|
||||
```text
|
||||
recognize_media(path="<source file path>")
|
||||
```
|
||||
|
||||
If recognition fails or looks wrong:
|
||||
|
||||
1. Extract likely title, year, media type, season, and episode range from filenames.
|
||||
2. Call `search_media(title="...", year="...", media_type="movie|tv")`.
|
||||
3. If several results are plausible, use `ask_user_choice` when available, or ask the user directly to choose the correct title/TMDB ID.
|
||||
4. For TV season confusion, use `query_media_detail(tmdb_id=<id>, media_type="tv")` before deciding the season number.
|
||||
|
||||
Never invent a TMDB/Douban ID. When unsure, ask for confirmation.
|
||||
|
||||
### 4. Check Existing State
|
||||
|
||||
Before writing:
|
||||
|
||||
- Use `query_library_exists` when a precise `tmdb_id` and `media_type` are known and duplicate risk matters.
|
||||
- Use `query_transfer_history(title="<title or path keyword>", status="all")` if the file may already have a success or failure record.
|
||||
- If `transfer_file` later returns "已整理过", query transfer history, identify the matching source path, and ask before deleting the stale record.
|
||||
|
||||
Only call `delete_transfer_history(history_id=<id>)` for the exact stale/failed record that blocks the requested source path. Do not delete unrelated successful history.
|
||||
|
||||
### 5. Transfer Through MoviePilot
|
||||
|
||||
Use `transfer_file` with explicit identity whenever possible:
|
||||
|
||||
```text
|
||||
transfer_file(
|
||||
file_path="<source path>",
|
||||
storage="local",
|
||||
media_type="movie|tv",
|
||||
tmdbid=<tmdb_id>,
|
||||
season=<season_number_if_tv>
|
||||
)
|
||||
```
|
||||
|
||||
Rules:
|
||||
|
||||
- For directories, pass a trailing slash in `file_path` so the tool treats it as a directory.
|
||||
- Prefer leaving `target_path`, `target_storage`, and `transfer_type` empty so configured directory rules apply.
|
||||
- Set `target_path` or `transfer_type` only when the user explicitly asks or the default directory configuration cannot handle the file.
|
||||
- For a single movie or a single TV season folder, transfer the folder once with the shared identity.
|
||||
- For mixed folders, split by media and transfer each file/subfolder separately.
|
||||
- For episode packs, identify the media once, then reuse `tmdbid`, `media_type="tv"`, and the confirmed `season` for each item.
|
||||
|
||||
### 6. Report Clearly
|
||||
|
||||
After each transfer batch, report:
|
||||
|
||||
- source path(s) processed;
|
||||
- recognized media title, type, TMDB/Douban ID, season/episode range when relevant;
|
||||
- success/failure count;
|
||||
- any failed message exactly enough for the user to act, such as missing media library directory, unsupported storage, existing history, or no media recognized.
|
||||
|
||||
If the result creates failed history records, tell the user they can retry with the history ID or let the agent continue with `transfer-failed-retry`.
|
||||
|
||||
## Common Cases
|
||||
|
||||
### User Gives A Single File
|
||||
|
||||
1. `recognize_media(path=...)`
|
||||
2. If needed, `search_media(...)` and confirm the result.
|
||||
3. `transfer_file(file_path=..., media_type=..., tmdbid=..., season=...)`
|
||||
|
||||
### User Gives A Season Folder
|
||||
|
||||
1. `list_directory(path=...)`
|
||||
2. Pick a representative episode and run `recognize_media(path=...)`.
|
||||
3. Confirm `tmdbid`, `media_type="tv"`, and season.
|
||||
4. `transfer_file(file_path="<folder>/", media_type="tv", tmdbid=<id>, season=<season>)`
|
||||
|
||||
### User Gives A Messy Mixed Folder
|
||||
|
||||
1. `list_directory(path=...)`
|
||||
2. Group candidates by likely title/year/season.
|
||||
3. Confirm groups before writing if there is more than one media.
|
||||
4. Transfer each group separately; do not run one directory transfer over unrelated media.
|
||||
|
||||
### Transfer Says The File Was Already Organized
|
||||
|
||||
1. `query_transfer_history(title="<title or source path keyword>", status="all")`
|
||||
2. Find the exact record with matching `src`.
|
||||
3. Ask the user to confirm deletion if the record is stale or failed.
|
||||
4. `delete_transfer_history(history_id=<id>)`
|
||||
5. Retry `transfer_file(...)`.
|
||||
|
||||
## Guardrails
|
||||
|
||||
- Do not use shell commands, raw database edits, or manual filesystem moves for organization.
|
||||
- Do not delete transfer history without an exact matching source path and user confirmation.
|
||||
- Do not use broad download roots as transfer targets unless the user explicitly confirms the scope.
|
||||
- Do not process unrelated media in one directory transfer.
|
||||
- Do not override target directories or transfer modes unless necessary.
|
||||
- Prefer asking one focused question over guessing media identity, season mapping, or destructive cleanup.
|
||||
Reference in New Issue
Block a user