filesystem

📁 安全高效的智能文件管理专家

Clawdbot生态的文件系统管理规范,提供完善的文件操作安全配置与最佳实践指南,当前为纯文档实现需配合实际脚本使用。

收藏
9.4k
安装
2.1k
版本
v1.0.0
CLS 安全性认证2026-05-03
点击查看完整报告 >

使用说明

该技能作为Clawdbot平台的文件系统管理解决方案,旨在为AI代理提供全面的文件操作能力。尽管当前版本为纯文档配置型资产,但其详细定义了文件列表、智能搜索、批量复制、目录树可视化和存储分析等核心功能接口,并配备了完善的安全策略配置模板。

核心用法涵盖五大功能模块:通过filesystem list实现带过滤和排序的高级文件列表;利用filesystem search进行文件名模式匹配和内容全文检索;借助filesystem copy执行带dry-run模式的批量文件复制;通过filesystem tree生成ASCII树形目录结构;以及使用filesystem analyze进行存储空间统计和文件类型分析。所有操作均支持递归遍历、深度控制和多种输出格式。

显著优点体现在其安全设计理念上。配置文件中预设了严格的安全边界:防止系统路径访问、明确列出受保护目录(如/etc、/usr/bin)、限制操作类型为只读/复制/分析、设置递归深度上限(10层)、单文件大小限制(50MB)和文件数量上限(10000个),以及30秒超时保护。权限申请遵循最小化原则,仅请求文件系统读写权限,明确声明无网络和系统权限。此外,干运行模式(Dry Run)和路径验证机制的设计,体现了对安全操作的重视。

潜在缺点和局限性十分明显:根据安全审计,该技能目前为"纯文档型"实现,package.json中声明的入口文件并不存在,缺乏实际可执行的脚本代码,因此无法直接执行任何文件操作。用户需要自行实现核心逻辑或等待后续版本补充实际代码。此外,来源为T3级个人开发者账号(gtrusler),相比组织级或社区广泛认可的项目,可信度和长期维护能力存在一定不确定性。

适合的目标群体主要包括:需要将文件系统操作集成到Clawdbot工作流的开发者、寻求安全文件管理配置参考的系统管理员、以及计划构建文件自动化处理流程的DevOps工程师。对于注重安全策略模板和最佳实践的技术团队,该技能提供了有价值的配置参考。

使用该技能存在的常规风险包括:由于缺少实际可执行代码,直接部署无法实现声明的功能,可能导致自动化流程失败;若用户基于当前文档自行实现代码,需确保安全策略得到正确实施,避免引入路径遍历或权限提升漏洞;作为个人维护的项目,未来更新和安全维护的持续性需要关注。建议在实际生产环境中使用时,先补充完整的代码实现并进行充分测试。

安全解读

核心用法

filesystem 是专为 Clawdbot 设计的文件系统管理 Skill,提供四大核心能力:

1. Smart File Listing - 支持递归遍历、多条件过滤(类型/大小/日期)、多格式输出(表格/树形/JSON)及灵活排序
2. Powerful Search - 结合 Glob/正则文件名匹配与全文内容搜索,支持上下文显示与排除模式

3. Batch Operations - 带 Dry-Run 预览的批量复制、进度追踪、错误恢复及权限保留

4. Directory Analysis - ASCII 树形可视化、文件统计分布、大文件识别与性能指标分析

显著优点

  • 零依赖架构:纯 Markdown/JSON 配置类 Skill,无第三方依赖,无可执行代码,攻击面极小
  • 完善的安全配置preventSystemPaths=true 保护系统目录,requireConfirmation=true 强制确认,操作范围限定明确
  • 防御性设计:内置路径验证防遍历攻击、权限预检查、Dry-Run 模式与备份提示
  • 丰富的输出格式:开发友好的表格/JSON 输出,系统管理的尺寸分布与性能指标
  • 生态集成:自动适配 .gitignore 模式,与 Security Skill、备份工具链协同工作

潜在局限

  • T3 来源级别:由个人开发者 gtrusler 维护,非顶级开源基金会背书,需关注上游更新动态
  • Node.js 依赖:运行环境要求已安装 Node,对纯容器/边缘环境可能有限制
  • 功能边界:定位为文件管理而非编辑处理,不支持文件内容修改、压缩解压或远程同步
  • 交互深度:虽有确认机制,但批量操作在大规模文件场景下仍需人工审慎评估

适合人群

  • 开发者:项目结构梳理、代码库搜索、构建产物管理
  • 系统管理员:日志分析、磁盘空间审计、临时文件清理
  • DevOps/自动化工程师:CI/CD 流水线中的文件操作、备份工作流集成
  • 数据分析师:本地数据集目录统计与文件元数据提取

常规风险

  • 声明了 filesystem: read-write 权限,虽配置完善,但用户仍需监控实际访问路径
  • 文档引用的外部 URL(GitHub/X/ClawdHub)为纯文档行为,无代码级调用,安装时无网络暴露

filesystem 内容

手动下载zip · 8.2 kB
config.jsonapplication/json
请选择文件