Files

核心功能

Files 是一款面向高级用户的文件重组工具，专注于安全、可逆的批量文件操作。核心能力包括：智能重复文件检测（三阶段哈希比对）、磁盘空间分析（按目录聚合）、批量重命名与移动，以及智能整理提案（按日期/类型自动分类）。

显著优点

• 安全性优先：严格的权限边界（禁止操作系统目录）、路径规范化防御路径遍历攻击、绝不自动跟随符号链接
• 防误删设计：强制使用系统回收站，支持30天内完整撤销，含元数据侧车记录原始路径
• 性能优化：哈希缓存、分阶段去重（大小→4KB采样→全哈希）、10万+文件操作需显式确认
• 跨平台适配：macOS .app 包识别、Windows 长路径支持、Linux XDG 标准

局限性与注意事项

• 非通用文件管理器：不支持打开/创建文件、解压归档、基础浏览——这些需用系统原生工具
• 网络驱动器风险：会检测并警告可靠性问题，建议先本地复制
• 大操作负载：超过10万文件需手动确认， manifest 超10MB 需分页查看
• 撤销记录30天过期，过期前会警告用户

适合人群

• 需要清理大量下载/照片/项目文件夹的重度用户
• 开发者（自动识别 node_modules、__pycache__ 等安全删除目标）
• 注重操作可逆性的谨慎型用户

常规风险

• 符号链接误用：虽然自动跳过，但用户显式"跟随链接"时需逐条确认外部目标
• 磁盘空间检查：操作前预留1%余量，满盘时优雅失败并报告部分完成状态
• 路径攻击：通过规范化+白名单双重验证阻断 .. 与系统目录访问

核心功能

Files 是一款专注于文件重组与优化的文档型 Skill，而非基础文件浏览器。其核心能力覆盖三大场景：智能去重（三阶段哈希检测，支持万级文件规模）、批量整理（按日期/类型自动组织，附带可视化提案）、空间分析（识别安全清理目标如 node_modules）。所有操作均配备完整的撤销系统（JSON 元数据记录，30 天有效期）和原生回收站支持，彻底杜绝误删风险。

安全架构亮点

该 Skill 采用非协商式路径安全策略：强制规范化所有路径（解析 ..、~、符号链接），拒绝任何系统目录访问（/etc、C:\Windows 等），并明令禁止自动跟随符号链接——这是经典的权限提升攻击向量。操作模式分为Fast Path（≤9 文件即时执行）与 Safe Path（≥10 文件生成清单待确认），在效率与保护间取得平衡。哈希缓存采用 SQLite 持久化，mtime 失效机制确保数据一致性。

平台适配与限制

跨平台支持 macOS（尊重 .app 捆绑包）、Linux（XDG 规范）、Windows（长路径前缀 \\?\）。对网络驱动器自动检测延迟并建议本地复制，对 10 万+ 文件操作强制人工确认。所有失败场景均提供原子化回滚或断点续传选项，磁盘空间检查预留 1% 缓冲。

局限与注意事项

作为纯文档型 Skill，其实际行为完全依赖 Agent 的解释执行——文档虽明确定义了安全边界，但 Agent 是否严格遵守无法保证。来源为社区平台个人开发者（T3 级），未经验证的 GitHub 仓库背书。此外，该 Skill 明确声明不替代基础文件操作（打开、创建、复制、解压需使用系统原生工具），功能边界需用户自行把握。

适合人群

• 需要定期整理大量下载/照片/项目文件的重度电脑用户
• 开发环境维护者（快速清理构建缓存、依赖目录）
• 对误删风险极度敏感、要求操作可逆的数据管理者
• 熟悉命令行但不愿记忆复杂 rsync/find 参数的效率追求者