核心用法
filesystem 是 Clawdbot 生态的专用文件系统管理技能，基于 Node.js 实现，提供六大核心功能模块：
1. 智能文件列表 (list)：支持递归遍历、多格式输出（table/json/list）、按名称/大小/日期排序，以及 glob 模式过滤
2. 强力搜索 (search)：文件名 glob/regex 匹配 + 文件内容全文检索，支持上下文行显示与包含/排除规则
3. 批量操作 (copy)：模式匹配批量复制，内置 dry-run 预览模式、进度追踪、权限与时间戳保留选项
4. 目录树可视化 (tree)：ASCII 树形结构输出，可控深度、可选文件大小显示
5. 目录分析 (analyze)：文件类型分布、大小统计、空间占用分析，支持识别最大文件
典型工作流示例：
filesystem search --pattern "TODO|FIXME" --path ./src --content --context 2 filesystem copy --pattern "*.log" --to ./backup/ --dry-run --preserve filesystem analyze --path /var/log --sizes --largest 10
显著优点
- 安全优先设计：路径遍历防护、权限预检查、dry-run 模式、覆盖前备份提示
- Clawdbot 原生集成：与 Security Skill、Git 操作、备份工具无缝协作，自动尊重 .gitignore
- 灵活配置：JSON 配置文件支持默认路径、排除模式、输出格式等个性化设置
- 开发运维双场景：既支持代码库 TODO 扫描，也支持系统日志分析与清理
潜在缺点与局限性
- 依赖 Node.js 运行时：非纯 Shell 实现，目标环境需预装 Node
- 生态绑定：专为 Clawdbot 设计，脱离该框架后功能受限
- 无内置删除命令：仅提供 copy/list/search 等安全操作，主动规避 rm 类高风险指令（需配合其他工具完成清理）
- 社区规模待观察：GitHub 仓库 Stars/Forks 数据未披露，长期维护持续性需跟踪 @LexpertAI 官方动态
适合人群
- Clawdbot 用户需要增强型文件管理能力
- 前端/Node.js 开发者进行项目结构分析与批量迁移
- 运维人员处理日志归档、大文件排查等常规任务
- 追求"预览再执行"安全工作流的谨慎型用户
常规风险
- 路径注入：虽内置遍历防护，但复杂符号链接场景仍需人工确认
- 批量操作误伤：dry-run 虽可预览，实际执行时模式匹配范围过大可能导致预期外复制
- 权限提升依赖：分析系统目录（如 /var/log）时需确保执行用户具备相应读取权限
- 上游供应链：通过 git clone 或 ClawdHub 安装，需验证来源仓库完整性