用途:让 AI 代理整理杂乱目录。给定目标路径后,代理扫描全部文件,按可配置规则分类,并移动到结构化目录树中。默认按文件类型分组(如 .pdf 进入 documents/,.png 进入 images/),也可按修改日期(2025/01/)、路径前缀或文件名标签推断的项目、或文件名中的优先级标签分组。用户可提供 YAML 或 JSON 自定义规则覆盖或扩展。
主要能力:通过内容哈希(SHA-256)检测重复文件,保留较新副本,将旧副本移入 _duplicates/ 并汇总供确认;可按 kebab-case、snake_case 或日期前缀统一命名,清洗特殊字符并保留扩展名;支持试运行预览,默认首次调用不实际移动;生成完整移动计划后执行,并写入 _organization-log.json 以便撤销;可将超过阈值(默认 12 个月)未访问或修改的文件移入 _archive/ 并按需压缩。
使用方式:指定目录与整理策略,缺省按文件类型。示例指令包括“Organize my ~/Downloads folder by file type.”“Sort the files in /data/raw-exports by modification date, using YYYY/MM subfolders.”“Organize ~/Projects/acme-app using this config file: .file-org-rules.yaml”。自定义规则文件包含 strategy、naming、date_prefix、archive_after_days、type_map 和 ignore 等字段;ignore 默认跳过 node_modules、.git、pycache 等。
限制与注意事项:先用试运行查看完整计划再确认;在 Git 仓库内应使用 git mv 保留历史,有未提交更改时提示;目标路径冲突时追加数字后缀而非覆盖;扫描不跟随符号链接;无扩展名文件默认归入 other/,有 shebang 时按解释器推断;超过 10000 个文件建议分批处理并显示进度;权限错误会记录并跳过;网络或外部驱动器可能较慢且中断导致不一致,建议先操作本地副本。资料未提供具体平台、收费或价格信息。