AIOS File Transfer

为AI agent提供S3兼容的文件传输能力

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:AIOS File Transfer。
它的用途是:为AI agent提供S3兼容的文件传输能力
完整的 Skill 内容见:https://321skill.com/skills/aios-file-transfer-x-5/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'请将 file_input://user_123/report.xlsx 下载到工作区,然后分析其中的销售数据。' 它会自动调用 AIOS File Transfer 将文件从 S3 存储下载到当前工作目录,然后进行后续分析。如果分析完成需要输出结果,可以说:'将生成的图表上传到 file_output://analysis 目录',Skill 会自动上传并返回可访问的 file_output URI。

介绍

AIOS File Transfer 解决的是 AI agent 在与外部系统交互时,无法便捷地访问和传输文件的问题。许多 agent 需要从指定的 URI(如 file_input://)下载输入文件到工作区,或者将处理完的本地文件上传到指定位置(如 file_output://),但缺乏标准化的文件传输机制。该 Skill 通过兼容 AWS S3 的 SDK,为 agent 提供了统一的文件读写接口,使文件传输变得像调用本地 API 一样简单。

使用方式非常直接:当 agent 收到 file_input:// 开头的 URI 时,Skill 会自动根据当前会话的 senderId 将对应文件下载到工作区目录;当 agent 需要输出文件时,只需将文件放入 senderId 对应的本地目录,Skill 便会自动上传并以 file_output:// 格式返回访问地址。整个过程无需手动配置路径或认证,完全由 Skill 在后台自动完成。

该 Skill 主要面向 AI 智能体开发者、后端工程师以及运维人员。如果你正在构建一个需要频繁与云存储交互的 AI agent(例如处理用户上传的文档、生成报告并分享、同步多 agent 间的数据等),AIOS File Transfer 能帮你省去重复编写文件传输逻辑的麻烦。它也适合需要将 agent 工作区与 S3 兼容存储(如 MinIO、阿里云 OSS、腾讯云 COS)对接的场景。

建议在使用前先确保目标 S3 存储的端点、鉴权信息已正确配置到环境变量或 agent 配置文件中。由于该 Skill 依赖网络 I/O,对于超大文件(如 1GB 以上)或高并发传输场景,建议先评估网络带宽和存储性能。另外,注意 senderId 的隔离机制,不同 agent 或会话的文件不会互相干扰,但需确保 senderId 的唯一性。

核心特点

与普通文件传输工具或 SDK 不同,AIOS File Transfer 专为 AI agent 的 `file_input://` / `file_output://` URI 协议设计,自动按 `senderId` 隔离工作区,agent 无需关心底层存储细节即可完成文件的上传与下载。

注意事项

不适合需要实时双向同步、多地复制或超大规模文件(如视频素材)传输的场景,且依赖 S3 兼容存储的可用性。

常见问题

如何配置 S3 的 Endpoint 和认证信息?

通常通过环境变量(如 AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_ENDPOINT_URL)或 agent 的配置文件中设置,具体请参考仓库 README 中的环境变量说明。

支持哪些云存储服务?

只要是兼容 AWS S3 协议的服务均可,如 AWS S3、MinIO、阿里云 OSS、腾讯云 COS、华为云 OBS 等。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/aios-file-transfer-x-5/raw/index.md 读取 AIOS File Transfer 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。