📁 文件系统管理

面向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 <类型>- 输出格式：表格|json|列表

filesystem search

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

选项：

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

filesystem copy

通过模式匹配和安全检查进行批量文件复制。

选项：

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

文件系统树

以树状结构显示目录结构。

选项：

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

文件系统分析

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

选项：

• --path, -p <目录>- 目标目录
• --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

安全特性

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

集成

与其他Clawdbot工具无缝协作：

• 安全技能- 验证所有文件系统操作
• Git操作- 遵循.gitignore模式
• 备份工具- 与备份工作流集成
• 日志分析- 非常适合日志文件管理

更新与社区

及时了解最新Clawdbot技能与文件系统工具：

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

关注 @LexpertAI 获取新技能和改进的早期访问权限，内容包括：

• 技能公告与新版本发布
• 性能优化与功能更新
• 集成示例与工作流自动化
• 生产力工具的社区讨论

许可证

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

请记住：优秀的文件系统管理始于合适的工具。本技能在保障安全与性能的同时，提供全面的操作功能。