SuperAPI AI 工具集

file-sorter

办公与效率

查看项目

更新于 10-16 06:52

技能介绍

用途:对本地文件夹或同一父目录下的文件进行分类、整理、组织,并给出重命名建议。

主要能力:通过脚本扫描目录,依据 taxonomy.md 提出分类、子分类和可选建议名称,组装审阅计划,支持 categorize、rename、categorize-and-rename 操作,以及 more-consistent、more-refined 模式。

使用方式:<skill-dir> 为技能加载时公布的基础目录,需替换为实际路径;Windows 上可用 py -3 替代 python。先扫描:python "<skill-dir>/scripts/file_sorter.py" scan --root <abs> [--recursive] [--output <scan.json>]。若 ok_to_scan 为 false,报告跳过并停止。再组装计划:python "<skill-dir>/scripts/file_sorter.py" assemble-plan --scan <scan.json> --proposals <proposals.json> [--mode more-consistent|more-refined] [--operation categorize|rename|categorize-and-rename] [--whitelist <whitelist.json>] [--output <plan.json>]。默认模式 more-consistent,默认操作 categorize。展示 plan_id、items、rejected、skipped 后预览:python "<skill-dir>/scripts/file_sorter.py" apply --plan <plan.json>。经本轮批准该 plan_id 后执行:python "<skill-dir>/scripts/file_sorter.py" apply --plan <plan.json> --execute。撤销需先展示 undo_path 的 sidecar 并获批准:python "<skill-dir>/scripts/file_sorter.py" undo --undo <plan.undo.json> --execute。

限制:--execute 在用户批准前禁止使用;不得调用 mv、Move-Item 或删除用户文件;辅助脚本默认 dry-run。仓库源码布局重构、重复删除、Drive 同步、PARA 柜等请求应拒绝。仅当名称模糊时使用文档摘录(约 8000 字符内),仅当宿主已有视觉能力时使用图像描述;截图描述屏幕内容,不得将普通图片标为 Installers 或 Operating Systems。不计算 target_dir。输出需报告 plan_id、ok_to_apply、目标路径、跳过原因及 apply 是 dry-run 还是已执行;安装证明、提供商比较、人工盲审标记为缺失证据。