📁 Filesystem Management

📁 Filesystem Management 是什么

为 Agent 提供比简单读写更完整的文件系统工具，包括过滤列表、内容搜索、批量复制、目录树和空间分析。

适用场景

适合开发仓库巡检、日志归档、大文件查找、目录结构理解和批量备份。

核心能力与工作机制

清单支持表格、树、JSON 输出，复制时可保留时间和权限，提供 overwrite 开关、权限检查、备份提示与错误恢复。

执行流程

先解析并限制目标目录，用 list/tree/analyze 了解范围；搜索或预览匹配集合，批量操作前确认目标和覆盖策略，完成后核对统计。

输入与输出

需要明确源目录、过滤条件、搜索模式、目标目录和覆盖/保留选项。输出文件列表、匹配、目录树、统计或复制后的文件集合。

依赖、账号与权限

依赖 Node.js 和技能 CLI，需要相应目录读写权限。

副作用、限制与风险

通配符、错误根目录和 overwrite 可能覆盖大量文件；内容搜索会读取敏感文件。列表和分析只读，copy 会创建或覆盖文件；清理示例不应在未确认时执行。

不适用边界

不能绕过系统权限，也不应对宽泛根目录执行未审查的批量写操作。

失败处理与验收

权限或路径错误时缩小范围并重新检查，部分复制失败要列明成功与失败文件，不重复覆盖已完成项。比较源目标数量、大小、哈希或抽样内容，并确认没有越出解析后的目标目录。

适合谁使用

适合开发者、运维和需要安全批处理文件的 Agent 用户。

来源、版本与许可

本条目依据 SkillHub 热门榜、发布者详情和版本 1.0.2 的完整 SKILL.md 整理，核验日期为 2026 年 9 月 21 日。完整 SKILL.md 未声明许可证，公开可下载不代表可以任意复制、修改或再分发。 SkillHub 当前两套安全扫描状态为 benign、benign；该状态只是平台信号，不能替代对脚本、凭据、网络请求、数据外送与后续版本的人工审查。

常见问题

1. 📁 Filesystem Management 主要解决什么问题？

为 Agent 提供比简单读写更完整的文件系统工具，包括过滤列表、内容搜索、批量复制、目录树和空间分析。适合开发仓库巡检、日志归档、大文件查找、目录结构理解和批量备份。是否采用它，应以实际任务边界和可核验材料为准，不要因为榜单热度而跳过来源审查。

2. 开始前需要准备什么？

需要明确源目录、过滤条件、搜索模式、目标目录和覆盖/保留选项。准备阶段不要代替用户猜测关键事实；缺少会改变路线、费用或权限的输入时，应先补齐再执行。

3. 它怎样完成任务并交付结果？

先解析并限制目标目录，用 list/tree/analyze 了解范围；搜索或预览匹配集合，批量操作前确认目标和覆盖策略，完成后核对统计。每个阶段都要保留输入、决策、输出和检查点，不能把计划、预览或排队状态描述成最终交付。

4. 需要哪些工具、账号或权限？

依赖 Node.js 和技能 CLI，需要相应目录读写权限。凭据应放在安全环境中，并按最小权限授权；账号、网络或本地依赖不满足时应明确停止条件。

5. 它会产生哪些外部操作或副作用？

列表和分析只读，copy 会创建或覆盖文件；清理示例不应在未确认时执行。涉及外部写入、上传、发送、付费或持久配置时，应在实际动作前说明影响范围并取得相应确认。

6. 哪些情况不适合使用？

不能绕过系统权限，也不应对宽泛根目录执行未审查的批量写操作。超出来源明确能力、专业资质或授权范围时，应切换到更合适的工具或交给专业人员处理。

7. 失败或结果异常时怎样恢复？

权限或路径错误时缩小范围并重新检查，部分复制失败要列明成功与失败文件，不重复覆盖已完成项。恢复时优先查询已有任务、日志或备份，避免无上限重试、重复扣费、重复发送或覆盖唯一原件。

8. 如何验收结果并控制风险？

比较源目标数量、大小、哈希或抽样内容，并确认没有越出解析后的目标目录。验收应基于真实文件、页面、任务终态或权威来源，并把未能实际检查的部分明确标记出来。