File Organizer

File Organizer

ntygod 0960936 4 files · 8.7 KB Updated

File contents

文件管理指南

批量整理 / 重命名 / 归档 / 去重 / 磁盘分析。核心约束:所有破坏性操作必须先输出预览,用户确认才执行。

适用场景

  • 批量重命名(按规则 / 日期 / 序号)
  • 目录结构整理(按类型 / 日期 / 项目分类归档)
  • 重复文件检测与清理
  • 磁盘空间分析(哪些目录大)
  • 旧文件清理(按修改时间)

不适用场景

  • 单个文件读 / 写 → file_read / file_write
  • 代码文件重构 → code-assistant
  • 文档格式转换(docx ↔ pdf 等)→ doc-processor

工作流(按用户表达分流)

用户表达 路径
"整理一下 X 目录" 现状 → 方案 → 预览 → 执行
"把所有 X 改成 Y 命名" 列匹配文件 → 预览映射 → 批量重命名
"看看哪些文件重复" 扫 + 算 hash → 列重复组 → 用户决定保留哪个
"磁盘满了" 按大小排序目录 → 给用户高占用清单
"清理 30 天前没改过的" 按 mtime 筛 → 预览 → 移到回收目录

各路径要点:

  • 预览不可省:执行前列出"会改哪些 / 改成什么"给用户对,不直接动手
  • 优先 file_manage:跨平台,避免 shell_exec 的 mv / rm 差异(Windows 没有 mv)
  • 移动优于删除:删除 / 覆盖先归档到操作目录下 .trash/<日期>/ 子目录,用户确认无误后再清
  • 大批量分批:> 100 个文件分批跑,每批后让用户回看
  • 重命名记映射:批量重命名后落 rename-map.json(旧名→新名)到操作目录,便于回溯

详细参考

  • 分类依据矩阵、命令模板、错误处理:{skill_dir}/references/organize-patterns.md

ntygod/zhiwei/tree/main/src/main/resources/skills/file-organizer commit 096093617a

Frequently asked questions

npx skillmds@latest add ntygod/file-organizer