📁 文件系统管理

适用于 AI 代理的高级文件系统操作。提供全面的文件与目录操作功能，具备智能过滤、搜索及批量处理能力。

特性

📋 智能文件列表

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

🔍 强大搜索功能

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

🔄 批量操作

• 安全复制 - 基于模式的文件复制，并带有验证机制
• 预览模式（Dry Run） - 执行前预览操作结果
• 进度追踪 - 实时显示操作进度
• 错误处理 - 出现异常时可优雅恢复

🌳 目录分析

• 树形可视化 - 以 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 <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 个最大文件

安装

# 克隆或安装该技能
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

安全特性

• 路径校验 - 防止目录遍历攻击
• 权限检查 - 操作前验证读写权限
• 预览模式（Dry Run） - 预览破坏性操作
• 备份提示 - 覆盖文件前建议备份
• 错误恢复 - 对权限错误等异常情况提供容错处理

集成能力

可无缝集成其他 Clawdbot 工具：

• 安全技能 - 所有文件系统操作均受安全校验
• Git 操作 - 尊重 .gitignore 规则
• 备份工具 - 支持与备份流程集成
• 日志分析 - 适用于日志文件管理

更新与社区

关注最新 Clawdbot 技能与文件系统工具动态：

• 🐦 关注 [@LexpertAI](https://x.com/LexpertAI) 获取技能更新与发布信息
• 🛠️ 新文件系统功能 与改进
• 📋 文件管理自动化最佳实践
• 💡 提升效率的小技巧与使用建议

关注 @LexpertAI 可提前获取新技能与优化：

• 技能发布通知 与版本更新
• 性能优化 与功能增强
• 集成示例 与工作流自动化方案
• 社区讨论 关于生产力工具的经验分享

许可证

MIT 许可证 - 个人与商业用途均可免费使用。

注意：优秀的文件系统管理始于合适的工具。此技能提供全面的操作功能，同时确保安全与性能。