Description

智能文件夹颜色标注与命名规范技能。通过 emoji 色块对文件/文件夹进行颜色分类，配合序号补零排序规则，实现直观的视觉化文件管理。适用于个人知识库、项目分类、资源归档等场景。

README (SKILL.md)

\r \r

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

Name: color-filer
Author: cyrilcao

\r

概述\r

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

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

适用场景\r

\r

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

⚠️ 安全警告\r

\r

重要安全注意事项\r

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

强制 Dry-Run 模式\r
- 所有脚本默认为预演模式（dry_run=True）\r
- 仅在明确确认后才执行实际操作\r
- 预演模式会显示所有将要执行的操作，不会修改任何文件\r \r
目标目录验证\r
- 脚本会检查目标路径，拒绝处理系统关键目录\r
- 禁止路径：C:\Windows\*, C:\Program Files\*, C:\ProgramData\*, /root/, /bin/, /usr/\r
- 建议仅处理用户数据目录（如 F:\笔记, F:\projects）\r \r
备份要求\r
- 执行批量重命名前，强烈建议备份整个目录\r
- 脚本提供自动备份功能（默认启用）\r \r
用户确认\r
- 执行实际操作前，脚本会显示完整操作预览\r
- 需要用户输入 y 确认后才执行\r \r
小规模测试\r
- 先在子目录测试命名规则，确认无误后再全局执行\r
- 检查输出日志中的重命名映射，确保符合预期\r \r ---\r \r

工作流程\r

\r

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

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

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

\r

python scripts/organize_workspace.py "F:\笔记" --dry-run\r
```\r
\r
**输出内容**：\r
- 📊 目录统计（文件总数、目录总数）\r
- ⚠️ 未使用表情符号的文件数量\r
- 📋 操作预览（将执行的所有操作）\r
- 💡 安全检查结果\r
\r
#### 步骤 2：确认并执行\r
\r
```bash\r
python scripts/organize_workspace.py "F:\笔记" --rename\r
```\r
\r
**执行流程**：\r
1. ✅ 安全检查（拒绝危险路径）\r
2. 💾 创建备份（默认启用）\r
3. 📋 显示操作预览\r
4. ⚠️ 用户确认（输入 y 确认）\r
5. 🚀 执行整理操作\r
\r
**操作类型**：\r
- 📁 重命名目录（如需要）\r
- 📁 创建缺失目录（如需要）\r
- 📄 移动根目录散文件（如需要）\r
- 📄 递归重命名文件（添加表情符号前缀）\r
\r
---\r
\r
### 方案 2：仅文件重命名\r
\r
使用 `scripts/rename_files.py` 仅重命名文件：\r
\r
#### 步骤 1：预览重命名\r
\r
```bash\r
python scripts/rename_files.py "F:\笔记" --dry-run\r
```\r
\r
#### 步骤 2：执行重命名\r
\r
```bash\r
python scripts/rename_files.py "F:\笔记" --rename\r
```\r
\r
---\r
\r
### 方案 3：仅分析目录\r
\r
使用 `scripts/analyze_folder.py` 分析目录结构（只读操作）：\r
\r
```bash\r
python scripts/analyze_folder.py "F:\笔记"\r
```\r
\r
**输出内容**：\r
- 📊 统计摘要\r
- 📋 文件类型分布（Top 10）\r
- 📂 根目录列表\r
- ⚠️ 问题检测\r
- 💡 整理建议\r
- 🎯 命名规范速查表\r
\r
---\r
\r
## 命名规范\r
\r
### 表情符号分类对照表\r
\r
| 色系 | 表情 | 含义 | 适用场景 |\r
|------|------|------|----------|\r
| 🔴 红色 | 🔴🚨🔥❤️🧯 | 核心/警告/紧急 | 主入口、高危操作、高频脚本 |\r
| 🟠 橙色 | 🟠⚙️🛠️🧰🪛 | 工具/配置/实用 | 通用工具、环境配置、批量处理 |\r
| 🟡 黄色 | 🟡✏️📝💡📒 | 学习/记录/入门 | 教学示例、草稿、学习笔记 |\r
| 🟢 绿色 | 🟢✅🟩🌱🧩 | 稳定/完成/可用 | 已验证版本、正式上线、模块组件 |\r
| 🔵 蓝色 | 🔵💻📚🔍🧠 | 开发/技术/调试 | 编程脚本、技术文档、算法研究 |\r
| 🟣 紫色 | 🟣✨🧪🚀🧬 | 高级/实验/创新 | 内部测试、优化技巧、创新探索 |\r
| ⚫⚪ 黑白 | ⚫⚪📦🗄️🧾 | 历史/归档/通用 | 旧版归档、通用模板、存档文件 |\r
\r
### 文件类型图标\r
\r
| 扩展名 | 图标 | 类型 |\r
|--------|------|------|\r
| .md | 📝 | Markdown 文档 |\r
| .xlsx/.csv | 📊 | 电子表格 |\r
| .pdf | 📄 | PDF 文档 |\r
| .sh/.bat/.py | 🖥️ | 脚本文件 |\r
| .conf/.ini | ⚙️ | 配置文件 |\r
| .gz/.zip/.rpm | 📦 | 压缩包 |\r
| .png/.jpg | 🖼️ | 图片文件 |\r
| .pem/.key | 🔐 | 证书文件 |\r
\r
### 序号补零规则\r
\r
- **≤ 99 个文件**：2 位（01, 02 ... 10, 11）\r
- **≤ 999 个文件**：3 位（001, 002 ... 010, 011）\r
- **超过 999**：4 位（0001, 0002 ... 1000）\r
\r
**命名格式**：`[表情][序号]_标题.扩展名`\r
\r
示例：\r
- `🚨_01_数据删除脚本.bat`\r
- `💻_02_系统监控工具.py`\r
- `📚_03_学习笔记.md`\r
\r
---\r
\r
## 资源文件\r
\r
### scripts/ - 可执行脚本\r
\r
| 脚本 | 用途 | 安全特性 |\r
|------|------|----------|\r
| `organize_workspace.py` | 完整工作区整理（v2.0 新增，v2.1 修复备份） | ✅ Dry-Run、✅ 路径验证、✅ 备份（v2.1）、✅ 用户确认、✅ 配置支持、✅ 自动确认 |\r
| `analyze_folder.py` | 分析目录结构 | ✅ 只读操作 |\r
| `rename_files.py` | 批量文件重命名 | ✅ Dry-Run、✅ 路径验证、✅ 备份 |\r
| `test_security_functions.py` | 安全验证测试 | ✅ 测试工具 |\r
\r
### references/ - 参考文档\r
\r
| 文件 | 说明 |\r
|--------|--------|\r
| `naming_rules.md` | 完整命名规则说明 |\r
| `api_reference.md` | 脚本 API 参考 |\r
\r
### assets/ - 模板文件\r
\r
| 文件 | 用途 |\r
|--------|------|\r
| `index_template.md` | 目录索引 Markdown 模板 |\r
| `example_asset.txt` | 示例文件 |\r
\r
---\r
\r
## 使用示例\r
\r
### 示例 1：完整整理工作区（推荐）\r
\r
```bash\r
# 预览整理（Dry-Run 模式）\r
python scripts/organize_workspace.py "F:\笔记" --dry-run\r
\r
# 执行实际整理（自动备份）\r
python scripts/organize_workspace.py "F:\笔记" --rename\r
\r
# 执行实际整理（不备份）\r
python scripts/organize_workspace.py "F:\笔记" --rename --no-backup\r
```\r
\r
### 示例 2：仅重命名文件\r
\r
```bash\r
# 预览重命名\r
python scripts/rename_files.py "F:\笔记" --dry-run\r
\r
# 执行实际重命名\r
python scripts/rename_files.py "F:\笔记" --rename\r
```\r
\r
### 示例 3：分析目录\r
\r
```bash\r
# 分析目录结构（只读）\r
python scripts/analyze_folder.py "F:\笔记"\r
```\r
\r
### 示例 4：测试安全验证\r
\r
```bash\r
# 测试路径安全验证功能\r
python scripts/test_security_functions.py\r
```\r
\r
---\r
\r
## 最佳实践\r
\r
1. **始终备份**：执行批量重命名前，先备份整个目录\r
2. **Dry-Run 测试**：始终先运行 dry_run 模式，检查输出\r
3. **小规模测试**：先在子目录测试命名规则\r
4. **处理冲突**：当目标文件名已存在时，自动追加序号\r
5. **保持语义**：命名应保留原文件核心关键词\r
6. **索引同步**：重命名后同步更新索引文件\r
\r
---\r
\r
## 故障排除\r
\r
### 常见问题\r
\r
**Q: 脚本拒绝执行操作？**\r
A: 检查是否触发了安全保护机制（如目标路径是系统目录）\r
\r
**Q: Dry-Run 输出不符合预期？**\r
A: 检查 `EXT_ICONS` 和 `FILE_CATEGORY_RULES` 配置，确认表情符号映射\r
\r
**Q: 中文字符显示乱码？**\r
A: 脚本已内置 `sys.stdout.reconfigure(encoding='utf-8')`，确保使用 Python 3+\r
\r
**Q: 如何自定义目录重命名和文件归档规则？**\r
A: 创建配置文件（如 `docmd_config.py`），使用 `--config` 参数加载，或直接编辑 `organize_workspace.py` 中的变量\r
\r
---\r
\r
## 安全特性验证\r
\r
### 路径安全测试\r
\r
```bash\r
python scripts/test_security_functions.py\r
```\r
\r
**预期输出**：\r
```\r
❌ C:\Windows                   | 禁止处理系统目录\r
❌ C:\Program Files             | 禁止处理系统目录\r
✅ F:\笔记                      | 路径安全\r
✅ C:\Users\cyrilcao\Documents  | 路径安全\r
```\r
\r
---\r
\r
## 版本历史\r
\r
### v2.1 (2026-03-21)\r
\r
**Bug 修复**：\r
- ✅ 修复备份功能未调用的问题\r
- ✅ 添加 no_backup 属性检查\r
- ✅ 在主函数中实现备份逻辑\r
\r
**改进**：\r
- 添加 `--config` 参数支持配置文件\r
- 添加 `--yes` 参数支持自动确认\r
- 增强备份状态显示\r
\r
### v2.0 (2026-03-20)\r
\r
**新增功能**：\r
- ✅ 完整的 Dry-Run 预演模式\r
- ✅ 路径安全验证（拒绝系统目录）\r
- ✅ 自动备份功能（v2.1 修复）\r
- ✅ 用户确认机制\r
- ✅ 目录重命名支持\r
- ✅ 文件归档支持\r
- ✅ 创建目录支持\r
\r
**新增脚本**：\r
- `scripts/organize_workspace.py` - 完整工作区整理脚本\r
- `scripts/test_security_functions.py` - 安全验证测试脚本\r
\r
**改进**：\r
- 统一命名规范为 `color-filer`\r
- 补充缺失的参考文档\r
- 增强安全性\r
\r
### v1.0\r
\r
**初始版本**：\r
- 文件重命名功能\r
- 目录分析功能\r
- 基本命名规则\r
\r
---\r
\r
*Color-Filer v2.0 - 基于表情符号分类体系与序号补零规则的智能文件夹整理工具*\r

Usage Guidance

这个技能总体上是自洽且用途明确的，但请在安装/运行前注意： - 先在一个小的测试子目录运行所有脚本的 dry-run（例如：python scripts/rename_files.py <test_dir> --dry-run 或 python scripts/organize_workspace.py <test_dir> --dry-run），确认输出与预期一致。 - 使用 scripts/test_security_functions.py 验证路径安全规则行为。技能包含拒绝系统目录的检查，但务必自己确认目标路径被正确识别。 - 检查并（如需）编辑 docmd_config.py 中的 DIR_MAPPINGS / FILE_MAPPINGS：这些映射是硬编码的，会在目标目录下执行重命名/移动，错误的映射可能把重要文件移动或重命名。若不需要这些映射，先在运行时不传或移除它们。 - 注意备份位置与磁盘使用：脚本默认会创建备份（shutil.copytree），备份会复制整个目录到同一父目录下，可能占用大量磁盘空间；如打算跳过备份请谨慎并确保你能承受潜在风险。 - 避免使用自动确认/跳过备份参数（--yes / --no-backup / dry_run=False）直到完全验证脚本行为。 - 虽然我未发现网络/外发代码或隐藏/混淆逻辑，仍建议在受信任的环境中审阅脚本完整源代码（特别是被省略/截断的部分），确认没有 os.system、subprocess 调用到外部命令或 socket/requests 导致网络连接。如果你希望，我可以： - 帮你检查被截断脚本剩余部分（organize_workspace.py 与 rename_files.py 的末尾），确认没有遗漏的网络或危险操作； - 帮你生成一个安全的测试夹结构并演示 dry-run 输出样例。

Capability Analysis

Type: OpenClaw Skill Name: color-filer Version: 2.0.1 The 'color-filer' skill is a utility for organizing and renaming files using emojis and standardized numbering. The bundle includes comprehensive safety features such as path validation to prevent modification of system directories (DANGEROUS_PATHS in organize_workspace.py and rename_files.py), mandatory dry-run modes for previewing changes, user confirmation prompts, and automatic directory backups. While organize_workspace.py uses exec() to load local configuration files, which is a potential vulnerability if an attacker can place files in the scripts directory, there is no evidence of malicious intent, data exfiltration, or unauthorized remote access. The skill's behavior is well-documented and aligns strictly with its stated purpose of file management.

Capability Assessment

✓ Purpose & Capability

技能名与描述（文件/文件夹按 emoji 分类并重命名/重组）与包含的脚本（organize_workspace.py、rename_files.py、analyze_folder.py 等）一致。没有请求云或第三方凭据，也没有不相关的二进制或配置要求。docmd_config.py 中包含具体的重命名/归档映射，这是为实际整理场景合理的本地配置。

✓ Instruction Scope

SKILL.md 指示运行随附的 Python 脚本来做读取、重命名、移动与备份等文件系统操作；脚本实现包含路径安全检查（拒绝系统目录）、默认 dry-run、备份、以及用户确认。未发现脚本会读取与任务无关的系统配置或访问外部网络/远程端点。注意：文档与脚本提到存在可绕过交互的参数（--yes / --no-backup / dry_run=False），这些会在用户允许的情况下执行有破坏性的文件改动，需小心使用。

✓ Install Mechanism

没有安装规格（instruction-only + 随包脚本文件），不会从网络下载或在安装时写入不明二进制。代码以纯 Python 脚本形式提供，风险较低。

✓ Credentials

不要求任何环境变量或凭据，脚本仅操作本地文件系统。唯一的配置是可选的本地配置文件（docmd_config.py）与命名映射，属于功能所需，未请求外部密钥/敏感令牌。

✓ Persistence & Privilege

元数据中没有设置 always:true，技能不会被强制常驻。脚本不会修改其他技能的配置或系统范围设置。唯一的持久性行为是脚本会在父目录创建备份目录（shutil.copytree），这是其工作流程的一部分且在说明中有明确提示。

Version History

v2.0.1

- Added three new scripts: `docmd_config.py`, `organize_workspace.py`, and `test_security_functions.py` - Introduced workspace organization and security validation capabilities - Enhanced safety with path validation and test utilities - Expanded support for configuration and testing of secure file operations

v1.0.0

Initial release of color-filer – a visual file and folder management skill based on emoji color blocks and zero-padded numbering. - Provides an emoji-based classification and naming convention for files and folders. - Implements zero-padded serial numbers for correct sorting. - Supports batch file renaming, directory structure optimization, and category-based archiving. - Includes a detailed emoji-color mapping table for common classification scenarios. - Offers workflow guidelines, script usage instructions, and best practices. - Suitable for personal knowledge bases, project folders, and resource archiving.

Metadata

Slug color-filer

Version 2.0.1

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 2

Frequently Asked Questions

What is color-filer?

智能文件夹颜色标注与命名规范技能。通过 emoji 色块对文件/文件夹进行颜色分类，配合序号补零排序规则，实现直观的视觉化文件管理。适用于个人知识库、项目分类、资源归档等场景。 It is an AI Agent Skill for Claude Code / OpenClaw, with 178 downloads so far.

How do I install color-filer?

Run "/install color-filer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is color-filer free?

Yes, color-filer is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does color-filer support?

color-filer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created color-filer?

It is built and maintained by cyrilcao (@cyrilcao); the current version is v2.0.1.

More Skills

color-filer