Smart File Manager

📁 智能文件归档,告别混乱目录

自动化文件整理系统,规范输入/输出文件的存储、命名与分类,支持图片、视频、PDF等多种格式,通过shell脚本实现目录初始化、验证与修复,避免文件散落与命名混乱。

收藏
6.5k
安装
2.4k
版本
1.1.0
CLS 安全性认证2026-08-10
点击查看完整报告 >

使用说明

核心用法

File Manager Skill 是一套面向AI工作流的文件归档规范,核心功能包括:

1. 目录结构管理:预设 /workspace/user_input_files//workspace/my_outputs/ 两大根目录,按 images/videos/pdfs/excels/others/ 五类细分存储
2. 标准化命名:强制采用 {input|output}-{描述}-{YYYYMMDD}.{扩展名} 格式,解决历史文件编号混乱问题

3. 脚本化操作:提供 init.sh(初始化)、verify.sh(验证)、move.sh(移动)、fix-nested.sh(修复嵌套)四个可执行脚本

4. 强制验证机制:任何存档操作后必须运行验证脚本,确认通过后才能交付

显著优点

  • 流程闭环:输入接收→分类存储→生成输出→归档验证→最终交付,每个环节均有明确操作指令
  • 可追溯性强:日期+描述的双标识命名,支持快速定位历史文件
  • 错误自修复:内置嵌套目录、根目录散落等常见问题的自动化修复脚本
  • 多格式兼容:覆盖图片、视频、办公文档等主流文件类型

潜在缺点与局限性

  • 环境依赖:基于bash脚本,Windows环境需额外配置(Git Bash/WSL)
  • 手动干预move.sh 需要人工输入描述和日期参数,无法完全自动化
  • 无版本控制:同一文件多次生成会覆盖或产生重复,未集成Git式版本管理
  • 扩展性受限:新增文件类型需修改脚本源码,非配置化扩展

适合人群

  • 高频处理用户上传文件的AI助手/Agent开发者
  • 需要规范化多模态输出(图文、视频混排)的内容生产团队
  • 追求文件可追溯、可审计的自动化工作流搭建者

常规风险

  • 路径硬编码风险/workspace/ 为固定根目录,迁移项目时需批量替换
  • 脚本权限问题:未提及执行权限设置(chmod +x),新手可能遭遇Permission denied
  • 日期格式约束:强制YYYYMMDD,跨时区协作时可能产生理解偏差
  • 无文件完整性校验:缺少MD5/SHA校验机制,无法检测传输损坏

来源可信度

开源MIT协议,无外部依赖,代码透明可控。

安全解读

核心用法

File Manager Skill 是一款专为Agent设计的本地文件管理工具,核心功能围绕"接收-处理-交付"全链路展开。当用户上传图片、视频、PDF等文件时,Skill自动按类型归入user_input_files/下的images/videos/pdfs/excels/others子目录;当Agent生成输出文件时,则归档至my_outputs/对应分类。文件命名遵循{input/output}-{描述}-{YYYYMMDD}.{扩展名}规范,确保可追溯性。

Skill提供4个Bash脚本:

  • init.sh:一键初始化双层目录结构
  • move.sh:按类型/描述/日期三参数智能移动并重命名文件
  • verify.sh:递归校验目录结构完整性
  • fix-nested.sh:自动修复my_outputs/output嵌套异常

使用流程强制要求"操作→验证→交付"三步闭环,验证失败需修复后方可继续。

显著优点

极致轻量:纯Bash实现,零第三方依赖,156行代码完成全部功能,启动瞬间完成。

安全透明:经CLS六维检测全绿通过——无动态代码执行、无敏感信息硬编码、无网络通信、无环境变量越权访问,100%本地沙箱运行。

合规友好:通过GDPR数据最小化与CCPA透明度认证,不采集用户数据,满足企业级隐私合规要求。

即开即用:MIT协议开源,无API密钥配置,解压即用,适合快速集成至各类Agent工作流。

潜在缺点

功能边界清晰但有限:仅处理本地/workspace目录,不支持云存储同步、远程文件拉取或版本控制集成,重度依赖用户需额外工具链补充。

脚本鲁棒性待增强move.sh缺少路径合法性校验,fix-nested.shrm -rf无二次确认,虽风险可控,但极端误操作场景下可能导致非空目录误删。

无图形界面:纯命令行交互,非技术用户需要理解Bash参数格式(如bash scripts/move.sh /path/to/file.pdf pdf invoice 20250325)。

适合人群

  • Agent开发者:需快速为AI助手集成文件I/O管理能力
  • 自动化工作流搭建者:构建图片批处理、文档生成等Pipeline
  • 隐私敏感型企业用户:要求数据不出本地、零外泄风险的场景
  • 开源爱好者/个人开发者:寻求轻量、可审计、可二次定制的文件管理方案

使用风险

性能风险极低:本地磁盘I/O操作,无网络延迟,但大量小文件批量移动时建议分批次执行避免IO阻塞。

依赖风险:纯Bash依赖Linux/macOS环境,Windows用户需WSL或Git Bash支持。

运维风险rm -rf操作虽经限定目录,仍建议在关键业务场景前手动备份或fork后增加--dry-run模拟模式。

维护风险:T3来源(个人开发者),无商业SLA保障,长期维护活跃度需社区观察。

Smart File Manager 内容

scripts文件夹
手动下载zip · 4.3 kB
fix-nested.shtext/x-shellscript
请选择文件