Menu
视频目录清理。扫描并清理非视频文件夹（func1）和无用文件（func2）。当用户提到"清理"、"clean"、"删除无用文件"、"整理目录"时触发。
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/japan-media-skill-hub/video-cleaner --skill video-cleanerThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
Based on SOC occupation classification
| name | video-cleaner |
| description | 视频目录清理。扫描并清理非视频文件夹（func1）和无用文件（func2）。当用户提到"清理"、"clean"、"删除无用文件"、"整理目录"时触发。 |
负责清理视频目录中的无用内容。
扫描指定目录，将不含任何有效视频文件的文件夹移至 .delete 目录。
有效视频定义：
video.extensions 列表中video.min_size_mb在视频文件夹内，将与视频无关的文件移至 .delete 目录。
保留规则：
image.valid_keywords（如 poster, cover）→ 保留. 之前）与某个视频文件的前缀相同 → 保留.zh、.ja）而删除支持三种模式，由用户指令决定：
生成 JSON 计划文件，不执行。
调用方式：
# func1：清理非视频文件夹
.venv/bin/python .opencode/skills/video-cleaner/scripts/plan_clean_folders.py \
--root "/path/to/videos" \
--extensions ".mp4,.mkv,.avi,.wmv,.mov,.flv,.rmvb,.rm,.3gp,.m4v,.m2ts,.ts,.mpg" \
--min-size 300 \
--delete-dir ".delete" \
--output "plans/"
# func2：清理无用文件
.venv/bin/python .opencode/skills/video-cleaner/scripts/plan_clean_files.py \
--root "/path/to/videos" \
--video-extensions ".mp4,.mkv,.avi,.wmv,.mov,.flv,.rmvb,.rm,.3gp,.m4v,.m2ts,.ts,.mpg" \
--image-extensions ".jpg,.jpeg,.png,.gif,.bmp,.webp,.tiff" \
--valid-keywords "poster,movie,folder,cover,fanart,banner,clearart,thumb,landscape,logo,clearlogo,disc,discart,backdrop,keyart" \
--nfo-match-length 5 \
--temp-tail-globs "*.115chrome_*,*.115chrome_*.cfg" \
--subtitle-extensions ".srt,.ass,.ssa,.vtt,.sub" \
--delete-dir ".delete" \
--output "plans/"
输出：
plans/clean_folders_20260220_150000.json读取已有 JSON 计划文件，执行操作。
调用方式：
.venv/bin/python .opencode/skills/video-cleaner/scripts/execute_plan.py \
--plan "plans/clean_folders_20260220_150000.json"
先计划，agent 向用户展示摘要，用户确认后执行。JSON 保留作为事后核查记录。
Agent 从 config.toml 读取配置，理解后作为命令行参数传入：
| 参数 | 配置来源 |
|---|---|
--extensions / --video-extensions | [video] extensions |
--min-size | [video] min_size_mb |
--image-extensions | [image] extensions |
--valid-keywords | [image] valid_keywords |
--nfo-match-length | [nfo] match_length |
--subtitle-extensions | [subtitle] extensions |
--temp-tail-globs | [cleanup] temp_tail_globs |
--delete-dir | [cleanup] delete_dir_name |
--root 参数：
memory/paths.md 中读取 last_clean_path[
{
"func": "clean_folders",
"action": "MOVE",
"source": "/path/to/videos/non-video-folder",
"destination": "/path/to/videos/.delete/non-video-folder",
"size_mb": 12.5,
"created_at": "2026-02-20T15:00:00"
},
{
"func": "clean_files",
"action": "MOVE",
"source": "/path/to/videos/some-movie/useless.txt",
"destination": "/path/to/videos/.delete/some-movie/useless.txt",
"size_mb": 0.01,
"created_at": "2026-02-20T15:00:05"
}
]
脚本运行日志输出到 logs/ 目录。
文件命名：{func}_{timestamp}.log
plan_clean_folders.pyplan_clean_files.pyexecute_plan.pyexecute_plan.py（执行前强制步骤）在调用执行脚本前，先清理 plans/ 中超过 10 天的旧计划文件：
plans/ 下普通文件（不递归目录）mtime > 10 天 才删除rm，统一使用 Python（pathlib / os）删除删除数量 + 剩余数量，再继续执行 execute_plan.pypathlib。