用途：afs 是面向 AI Agent 的命令行文件操作工具，覆盖本地文件处理与 S3 兼容云存储同步，输出统一 JSON 便于程序解析。
主要能力：本地操作包括 info（文件/目录元数据，--details 显示文件数与总字节）、read（支持 --tail、--head、--bytes 切片，避免把大日志整体读入上下文，整文件读取上限 10MB）、zip 与 unzip。云端操作包括 upload、download（--unzip 自动解压）、list（--limit、前缀过滤）、url（生成预签名或公开 URL，--expires 指定秒数，默认 900）、providers（列出支持的提供商）。
使用方式：安装命令为 curl -fsSL https://raw.githubusercontent.com/geekjourneyx/agent-fs/main/scripts/install.sh | bash。配置可通过 afs config set 写入 .agent-fs.yaml 或 ~/.agent-fs.yaml，也可用 AFS_WORKSPACE、AFS_S3_ENDPOINT、AFS_S3_BUCKET、AFS_S3_ACCESS_KEY_ID、AFS_S3_SECRET_ACCESS_KEY 等环境变量。
适用场景：Agent 备份文件、分析错误日志、云端文件同步与临时授权访问。
限制：云上传路径必须遵循 YYYYMMDD/hash/ 格式，否则被拒绝；需 Go 1.24+；支持 Linux、macOS、Windows；支持 AWS S3、Cloudflare R2、MinIO、阿里云 OSS、腾讯云 COS、Backblaze B2、Wasabi 等 S3 兼容存储；AFS_WORKSPACE 可限制操作目录并阻止路径穿越。具体收费与价格暂未提供。