用途:为 AI 智能体提供完整的文件与目录操作能力,覆盖列举、搜索、批量处理与目录分析,适合开发工作流与系统管理场景。
主要能力: 列举(list):按类型、模式、大小、日期过滤,支持递归遍历、深度控制,输出 table、tree 或 JSON,可按名称、大小、日期、类型排序。 搜索(search):支持 glob 与正则模式匹配、文件内容全文搜索、文件名与内容多条件组合,并可显示匹配行的上下文。 批量复制(copy):基于模式的复制,带校验、dry-run 预览、进度跟踪与错误恢复。 目录树(tree):ASCII 树形可视化,可限制深度、仅显示目录、显示文件大小、关闭彩色输出。 分析(analyze):统计文件数量、大小分布、类型分析,识别大文件与目录,输出操作耗时等指标。
使用方式:通过命令行调用,如 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。安装可克隆到 ~/.clawdbot/skills 后执行 chmod +x filesystem/filesystem,或用 clawdhub install filesystem。行为可通过 config.json 配置默认路径、最大深度、默认过滤、排除模式(如 node_modules、.git)、输出格式、日期与大小格式、彩色输出等。
安全与集成:具备路径校验(防目录遍历)、权限检查、dry-run 预览、覆盖前备份提示与错误恢复;可与安全技能、Git 操作(遵循 .gitignore)、备份工具和日志分析流程配合。
限制:具体安装仓库地址、运行环境依赖与各命令完整参数细节以官方资料为准;资料未提供实际性能数据与平台兼容性说明。