Color-Filer: 智能文件夹整理与命名规范（增强版）

概述

Color-Filer 提供智能文件夹整理和命名规范化能力，基于表情符号分类体系和序号补零排序规则，支持文件批量重命名、目录结构优化、类型分类归档等任务。

🚀 v2.0 新增功能：

• ✅ 完整的 Dry-Run 预演模式
• ✅ 路径安全验证（拒绝系统目录）
• ✅ 自动备份功能（已修复）
• ✅ 用户确认机制
• ✅ 配置文件支持（--config 参数）
• ✅ 自动确认支持（--yes 参数）
• ✅ 目录重命名支持
• ✅ 文件归档支持
• ✅ 创建目录支持

适用场景

• 批量重命名：对多个文件/文件夹按统一规则重命名
• 目录优化：重组文件夹结构，提升可检索性
• 类型分类：按技术类型、用途、优先级分组
• 序号标准化：确保文件按字典序正确排序（01, 02... 10, 11）
• 工作区整理：完整的目录结构整理（重命名、归档、创建）

⚠️ 安全警告

重要安全注意事项

本技能包含批量文件操作脚本，必须遵循以下安全规范：

1. 强制 Dry-Run 模式

   • 所有脚本默认为预演模式（dry_run=True）
   • 仅在明确确认后才执行实际操作
   • 预演模式会显示所有将要执行的操作，不会修改任何文件

2. 目标目录验证

   • 脚本会检查目标路径，拒绝处理系统关键目录
   • 禁止路径：C:\Windows\*, C:\Program Files\*, C:\ProgramData\*, /root/, /bin/, /usr/
   • 建议仅处理用户数据目录（如 F:\笔记, F:\projects）

3. 备份要求

   • 执行批量重命名前，强烈建议备份整个目录
   • 脚本提供自动备份功能（默认启用）

4. 用户确认

   • 执行实际操作前，脚本会显示完整操作预览
   • 需要用户输入 y 确认后才执行

5. 小规模测试

   • 先在子目录测试命名规则，确认无误后再全局执行
   • 检查输出日志中的重命名映射，确保符合预期

工作流程

方案 1：完整工作区整理（推荐）

使用 scripts/organize_workspace.py 执行完整的工作区整理：

步骤 1：预览整理（Dry-Run 模式）

python scripts/organize_workspace.py "F:\笔记" --dry-run

输出内容：

• 📊 目录统计（文件总数、目录总数）
• ⚠️ 未使用表情符号的文件数量
• 📋 操作预览（将执行的所有操作）
• 💡 安全检查结果

步骤 2：确认并执行

python scripts/organize_workspace.py "F:\笔记" --rename

执行流程：

1. ✅ 安全检查（拒绝危险路径）
2. 💾 创建备份（默认启用）
3. 📋 显示操作预览
4. ⚠️ 用户确认（输入 y 确认）
5. 🚀 执行整理操作

操作类型：

• 📁 重命名目录（如需要）
• 📁 创建缺失目录（如需要）
• 📄 移动根目录散文件（如需要）
• 📄 递归重命名文件（添加表情符号前缀）

方案 2：仅文件重命名

使用 scripts/rename_files.py 仅重命名文件：

步骤 1：预览重命名

python scripts/rename_files.py "F:\笔记" --dry-run

步骤 2：执行重命名

python scripts/rename_files.py "F:\笔记" --rename

方案 3：仅分析目录

使用 scripts/analyze_folder.py 分析目录结构（只读操作）：

python scripts/analyze_folder.py "F:\笔记"

输出内容：

• 📊 统计摘要
• 📋 文件类型分布（Top 10）
• 📂 根目录列表
• ⚠️ 问题检测
• 💡 整理建议
• 🎯 命名规范速查表

命名规范

表情符号分类对照表

文件类型图标

序号补零规则

• ≤ 99 个文件：2 位（01, 02 ... 10, 11）
• ≤ 999 个文件：3 位（001, 002 ... 010, 011）
• 超过 999：4 位（0001, 0002 ...