介绍
# 📁 Filesystem Management
面向 AI 智能体的高级文件系统操作。具备智能过滤、搜索和批处理功能的全面文件和目录操作。
## 功能特性
### 📋 **智能文件列表** - **高级过滤** - 按文件类型、模式、大小和日期过滤 - **递归遍历** - 带深度控制的深度目录扫描 - **丰富格式** - 表格、树形和 JSON 输出格式 - **排序选项** - 按名称、大小、日期或类型排序
### 🔍 **强大搜索** - **模式匹配** - 支持 Glob 模式和正则表达式 - **内容搜索** - 文件内全文搜索 - **多标准** - 结合文件名和内容搜索 - **上下文显示** - 显示匹配行及其上下文
### 🔄 **批量操作** - **安全复制** - 基于模式的文件复制及验证 - **试运行模式** - 执行前预览操作 - **进度跟踪** - 实时操作进度 - **错误处理** - 优雅的故障恢复
### 🌳 **目录分析** - **树形可视化** - ASCII 树结构显示 - **统计信息** - 文件计数、大小分布、类型分析 - **空间分析** - 识别大文件和目录 - **性能指标** - 操作计时和优化
## 快速开始
```bash # List files with filtering filesystem list --path ./src --recursive --filter "*.js"
# Search for content filesystem search --pattern "TODO" --path ./src --content
# Batch copy with safety filesystem copy --pattern "*.log" --to ./backup/ --dry-run
# Show directory tree filesystem tree --path ./ --depth 3
# Analyze directory structure filesystem analyze --path ./logs --stats ```
## 命令参考
### `filesystem list`
带有过滤选项的高级文件和目录列表。
**选项：** - `--path, -p <dir>` - 目标目录（默认：当前目录） - `--recursive, -r` - 包含子目录 - `--filter, -f <pattern>` - 按模式过滤文件 - `--details, -d` - 显示详细信息 - `--sort, -s <field>` - 按 name|size|date 排序 - `--format <type>` - 输出格式：table|json|list
### `filesystem search`
按名称模式或内容搜索文件。
**选项：** - `--pattern <pattern>` - 搜索模式（glob 或 regex） - `--path, -p <dir>` - 搜索目录 - `--content, -c` - 搜索文件内容 - `--context <lines>` - 显示上下文行数 - `--include <pattern>` - 包含文件模式 - `--exclude <pattern>` - 排除文件模式
### `filesystem copy`
带有模式匹配和安全检查的批量文件复制。
**选项：** - `--pattern <glob>` - 源文件模式 - `--to <dir>` - 目标目录 - `--dry-run` - 预览但不执行 - `--overwrite` - 允许覆盖文件 - `--preserve` - 保留时间戳和权限
### `filesystem tree`
以树形结构显示目录结构。
**选项：** - `--path, -p <dir>` - 根目录 - `--depth, -d <num>` - 最大深度 - `--dirs-only` - 仅显示目录 - `--size` - 包含文件大小 - `--no-color` - 禁用彩色输出
### `filesystem analyze`
分析目录结构并生成统计信息。
**选项：** - `--path, -p <dir>` - 目标目录 - `--stats` - 显示详细统计 - `--types` - 分析文件类型 - `--sizes` - 显示大小分布 - `--largest <num>` - 显示 N 个最大的文件
## 安装
```bash # Clone or install the skill cd ~/.clawdbot/skills git clone <filesystem-skill-repo>
# Or install via ClawdHub clawdhub install filesystem
# Make executable chmod +x filesystem/filesystem ```
## 配置
通过 `config.json` 自定义行为：
```json { "defaultPath": "./", "maxDepth": 10, "defaultFilters": ["*"], "excludePatterns": ["node_modules", ".git", ".DS_Store"], "outputFormat": "table", "dateFormat": "YYYY-MM-DD HH:mm:ss", "sizeFormat": "human", "colorOutput": true } ```
## 示例
### 开发工作流 ```bash # Find all JavaScript files in src filesystem list --path ./src --recursive --filter "*.js" --details
# Search for TODO comments filesystem search --pattern "TODO|FIXME" --path ./src --content --context 2
# Copy all logs to backup filesystem copy --pattern "*.log" --to ./backup/logs/ --preserve
# Analyze project structure filesystem tree --path ./ --depth 2 --size ```
### 系统管理 ```bash # Find large files filesystem analyze --path /var/log --sizes --largest 10
# List recent files filesystem list --path /tmp --sort date --details
# Clean old temp files filesystem list --path /tmp --filter "*.tmp" --older-than 7d ```
## 安全特性
- **路径验证** - 防止目录遍历攻击 - **权限检查** - 操作前验证读/写访问权限 - **试运行模式** - 预览破坏性操作 - **备份提示** - 覆盖前建议备份 - **错误恢复** - 优雅地处理权限错误
## 集成
与其他 Clawdbot 工具无缝协作： - **Security Skill** - 验证所有文件系统操作 - **Git Operations** - 遵循 .gitignore 模式 - **Backup Tools** - 集成到备份工作流 - **Log Analysis** - 非常适合日志文件管理
## 更新与社区
**了解最新的 Clawdbot 技能和文件系统工具：**
- 🐦 **在 X 上关注 [@LexpertAI](https://x.com/LexpertAI)** 以获取技能更新和发布信息 - 🛠️ **新的文件系统功能** 和增强 - 📋 文件管理自动化的**最佳实践** - 💡 提高工作流效率的**技巧和窍门**
关注 @LexpertAI 以提前获取新技能和改进： - **技能公告** 和新版本 - **性能优化** 和功能更新 - **集成示例** 和工作流自动化 - 关于生产力工具的**社区讨论**
## 许可证
MIT 许可证 - 个人和商业使用免费。
---
**请记住**：优秀的文件系统管理始于正确的工具。此技能在确保安全性和性能的同时提供了全面的操作。