名称： filesystem
描述： Clawdbot 高级文件系统操作 - 提供文件列表、搜索、批量处理和目录分析功能
主页： https://github.com/gtrusler/clawdbot-filesystem
元数据： {"clawdbot":{"emoji":"📁","requires":{"bins":["node"]}}}

📁 文件系统管理

为 AI 智能体提供高级文件系统操作。具备智能过滤、搜索和批量处理能力的综合性文件与目录管理工具。

功能特性

📋 智能文件列表

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

🔍 强大搜索功能

• 模式匹配 - 支持通配符模式和正则表达式
• 内容搜索 - 文件内全文检索
• 多条件组合 - 支持文件名与内容搜索结合
• 上下文显示 - 显示匹配行及其上下文

🔄 批量操作

• 安全复制 - 基于模式的文件复制，带验证功能
• 模拟运行模式 - 执行前预览操作结果
• 进度跟踪 - 实时显示操作进度
• 错误处理 - 优雅的失败恢复机制

🌳 目录分析

• 树状可视化 - ASCII 树形结构展示
• 统计分析 - 文件计数、大小分布、类型分析
• 空间分析 - 识别大文件和目录
• 性能指标 - 操作计时与优化建议

快速开始

# 带过滤的文件列表
filesystem list --path ./src --recursive --filter "*.js"

# 内容搜索
filesystem search --pattern "TODO" --path ./src --content

# 安全批量复制
filesystem copy --pattern "*.log" --to ./backup/ --dry-run

# 显示目录树
filesystem tree --path ./ --depth 3

# 分析目录结构
filesystem analyze --path ./logs --stats

命令参考

filesystem list

带过滤选项的高级文件和目录列表功能。

选项：
- --path, -p <目录> - 目标目录（默认：当前目录）
- --recursive, -r - 包含子目录
- --filter, -f <模式> - 按模式过滤文件
- --details, -d - 显示详细信息
- --sort, -s <字段> - 按名称|大小|日期排序
- --format <类型> - 输出格式：table|json|list

filesystem search

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

选项：
- --pattern <模式> - 搜索模式（通配符或正则表达式）
- --path, -p <目录> - 搜索目录
- --content, -c - 搜索文件内容
- --context <行数> - 显示上下文行数
- --include <模式> - 包含文件模式
- --exclude <模式> - 排除文件模式

filesystem copy

带模式匹配和安全检查的批量文件复制。

选项：
- --pattern <通配符> - 源文件模式
- --to <目录> - 目标目录
- --dry-run - 预览执行结果
- --overwrite - 允许文件覆盖
- --preserve - 保留时间戳和权限

filesystem tree

以树形结构显示目录。

选项：
- --path, -p <目录> - 根目录
- --depth, -d <数字> - 最大深度
- --dirs-only - 仅显示目录
- --size - 包含文件大小
- --no-color - 禁用彩色输出

filesystem analyze

分析目录结构并生成统计信息。

选项：
- --path, -p <目录> - 目标目录
- --stats - 显示详细统计信息
- --types - 分析文件类型
- --sizes - 显示大小分布
- --largest <数量> - 显示前 N 个最大文件

安装指南

# 克隆或安装技能
cd ~/.clawdbot/skills
git clone <filesystem-skill-repo>

# 或通过 ClawdHub 安装
clawdhub install filesystem

# 设为可执行
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
}

使用示例

开发工作流

# 查找 src 目录下所有 JavaScript 文件
filesystem list --path ./src --recursive --filter "*.js" --details

# 搜索 TODO 注释
filesystem search --pattern "TODO|FIXME" --path ./src --content --context 2

# 复制所有日志到备份目录
filesystem copy --pattern "*.log" --to ./backup/logs/ --preserve

# 分析项目结构
filesystem tree --path ./ --depth 2 --size

系统管理

# 查找大文件
filesystem analyze --path /var/log --sizes --largest 10

# 列出最近文件
filesystem list --path /tmp --sort date --details

# 清理旧临时文件
filesystem list --path /tmp --filter "*.tmp" --older-than 7d

安全特性

• 路径验证 - 防止目录遍历攻击
• 权限检查 - 操作前验证读写权限
• 模拟运行模式 - 预览破坏性操作
• 备份提示 - 覆盖前建议备份
• 错误恢复 - 优雅处理权限错误

集成能力

与其他 Clawdbot 工具无缝协作：
- 安全技能 - 验证所有文件系统操作
- Git 操作 - 遵循 .gitignore 模式
- 备份工具 - 与备份工作流集成
- 日志分析 - 完美支持日志文件管理

更新与社区

获取最新 Clawdbot 技能和文件系统工具信息：

• 🐦 关注 @LexpertAI 获取技能更新和发布信息
• 🛠️ 新文件系统功能 和增强特性
• 📋 文件管理自动化最佳实践
• 💡 生产力工作流技巧与窍门

通过关注 @LexpertAI 获取新技能和改进的早期访问：
- 技能公告 和新版本发布
- 性能优化 和功能更新
- 集成示例 和工作流自动化
- 生产力工具社区讨论

许可证

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

重要提示：优秀的文件系统管理始于合适的工具。本技能在保持安全性和性能的同时，提供全面的操作功能。