文件整理工具

通过安全、可预测的批量操作管理文件组织。

核心工作流程

目录结构

创建标准项目布局：

project/
├── src/          - 源代码
├── docs/         - 文档
├── tests/        - 测试文件
├── assets/       - 图片、字体、媒体文件
├── scripts/      - 构建脚本、工具脚本
└── config/       - 配置文件

移动文件

• mv <source> <dest> - 单个文件移动
• find . -name "*.ext" -exec mv {} <dest>/ \; - 按扩展名批量移动
• 始终确认目标路径存在

批量重命名

常用模式：

• 顺序编号：file_{001..100}.txt
• 日期格式：YYYY-MM-DD_描述
• 按类型分组：按文件扩展名归类

安全操作步骤：

1. 先使用 echo 输出命令（预演）
2. 审查输出结果
3. 移除 echo 后执行

按类型整理文件

根据文件扩展名将文件分类至对应目录：

mkdir -p images docs code
find . -name "*.png" -o -name "*.jpg" | xargs -I {} mv {} images/
find . -name "*.md" -o -name "*.txt" | xargs -I {} mv {} docs/
find . -name "*.py" -o -name "*.js" | xargs -I {} mv {} code/

查找分散的文件

find . -type f -name "*.ext"    # 按扩展名查找
find . -type f -mtime -7        # 近7天内修改的文件
find . -type f -size +100M      # 大于100MB的文件

预演操作优先

始终预览批量操作：

echo "将移动以下文件："
find . -name "*.ext"
# 审查后执行

安全规则

1. 禁止删除，除非明确授权（如有可用，建议使用 trash 命令）
2. 先预演 - 所有批量操作必须先通过 echo 或预览确认
3. 检查目标路径 - 确保目标目录已存在
4. 重构前备份 - 重大移动操作前应进行快照备份
5. 遵守工作区边界 - 仅限操作 ~/openclaw 目录下的内容

何时查阅 references/patterns.md

在以下情况加载该文件：

• 需要复杂重命名模式
• 需要项目结构模板
• 需要高级 find 命令进行过滤
• 处理特殊场景（如符号链接、特殊字符文件名）