SuperAPI AI 工具集

file-organizer

智能体与模型

查看项目

更新于 10-16 01:19

技能介绍

用途:整理或重构混乱目录(如 Downloads、Desktop、文档文件夹),把文件分类到合理文件夹并按内容重命名,适用于本地磁盘、网络挂载或远程文件系统。

主要能力:scan 子命令扫描目录并输出 JSON,含路径、相对路径、文件名、大小、修改时间、类型、MIME 与内容片段;默认由智能体自身 LLM 推理生成整理方案(文件夹层级、描述性文件名、按时间分组),也可选用外部更便宜的 LLM(deepseek、openrouter、ollama)生成。execute 按块执行移动,先建目标文件夹、跳过冲突(绝不覆盖)、逐文件记录错误。支持 --dry-run 预览。

使用方式:先运行 python3 scripts/organize.py scan --path <目录> 获取 JSON;再由智能体或 propose 生成 plan JSON(含 source_dir、moves、folders_to_create);然后必须以表格形式向用户展示方案并获得明确确认;确认后运行 python3 scripts/organize.py execute --plan /tmp/plan.json --chunk-size 10。网络挂载建议减小块大小。可用 --self-test 运行内置测试。

限制:只移动和重命名,绝不删除、不覆盖;执行前必须有用户确认。超大目录扫描输出庞大,可先用 --depth 1。二进制文件无内容片段,只能依据文件名、大小、修改时间推断。可选依赖 Pillow、mutagen、PyMuPDF 缺失时降级。其他平台或价格信息暂未提供。