filesystem

📁 文件系统管理

面向 AI Agent 的高级文件系统操作。提供全面的文件和目录操作，并支持智能筛选、搜索和批处理功能。

功能

📋 智能文件列表

• 高级筛选 - 按文件类型、模式、大小和日期筛选
• 递归遍历 - 支持深度控制的目录扫描
• 丰富的格式 - 支持表格、树形和 JSON 输出格式
• 排序选项 - 按名称、大小、日期或类型排序

🔍 强大的搜索

• 模式匹配 - 支持 Glob 模式和正则表达式
• 内容搜索 - 在文件中进行全文搜索
• 多条件搜索 - 组合文件名和内容搜索
• 上下文显示 - 显示匹配行及其上下文

🔄 批处理操作

• 安全复制 - 基于模式复制文件并进行验证
• 试运行模式 - 执行前预览操作
• 进度跟踪 - 实时显示操作进度
• 错误处理 - 优雅地从失败中恢复

🌳 目录分析

• 树形可视化 - 显示 ASCII 树形结构
• 统计信息 - 文件数量、大小分布和类型分析
• 空间分析 - 找出大文件和大目录
• 性能指标 - 操作耗时和优化情况

快速开始

# 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> - 按名称、大小或日期排序
• --format <type> - 输出格式：table|json|list

filesystem search

按名称模式或内容搜索文件。

选项：

• --pattern <pattern> - 搜索模式（Glob 或正则表达式）
• --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 个文件

安装

# 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 自定义行为：

{
  "defaultPath": "./",
  "maxDepth": 10,
  "defaultFilters": ["*"],
  "excludePatterns": ["node_modules", ".git", ".DS_Store"],
  "outputFormat": "table",
  "dateFormat": "YYYY-MM-DD HH:mm:ss",
  "sizeFormat": "human",
  "colorOutput": true
}

示例

开发工作流

# 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

系统管理

# 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，获取技能更新和发布信息
• 🛠️ 全新的文件系统功能和增强项
• 📋 文件管理自动化的最佳实践
• 💡 提升工作流效率的技巧和窍门

关注 @LexpertAI，抢先了解新技能和改进内容：

• 技能公告和新版本发布
• 性能优化和功能更新
• 集成示例和工作流自动化
• 关于效率工具的社区讨论

许可证

MIT 许可证 - 可免费用于个人和商业用途。

---

请记住：出色的文件系统管理始于合适的工具。此技能提供全面的操作功能，同时确保安全性和性能。