AIFS云文件存储

技能简介

AIFS.space 提供简单的 HTTP REST API，用于在云端存储和读取文件。支持跨会话持久化数据、多代理共享文件，以及用户内容的云端托管。

能做什么

• 上传、下载、删除云端文件
• 按行范围读取或局部修改文件内容
• 自动创建目录结构（最大深度20层）
• 获取文件摘要预览（前500字符）
• 查看速率限制状态

使用说明

1. 获取 API 密钥

访问 https://AIFS.Space 注册账号并获取 API 密钥。密钥类型包括：admin（完全权限）、read-write（读写）、read-only（只读）、write-only（仅写）。

2. 配置认证

将密钥存入环境变量 AIFS_API_KEY 或通过用户配置提供。请求头格式：

Authorization: Bearer aifs_xxxxx

3. 基础调用示例

列出文件：

curl -H "Authorization: Bearer $AIFS_API_KEY" https://aifs.space/api/files

读取文件：

curl -H "Authorization: Bearer $AIFS_API_KEY" "https://aifs.space/api/read?path=notes/todo.txt"

写入文件（自动创建目录）：

curl -X POST -H "Authorization: Bearer $AIFS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"path":"notes/new.txt","content":"Hello world"}' \
  https://aifs.space/api/write

局部修改（替换指定行）：

curl -X PATCH -H "Authorization: Bearer $AIFS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"path":"notes/todo.txt","start_line":5,"end_line":10,"content":"replacement"}' \
  https://aifs.space/api/patch

删除文件：

curl -X DELETE -H "Authorization: Bearer $AIFS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"path":"notes/old.txt"}' \
  https://aifs.space/api/delete

4. 速率限制

每密钥每分钟60次请求，通过响应头查看剩余额度：X-RateLimit-Remaining。

输入与输出

见下方输入与输出表格。

项目	内容
输入	文件路径、文件内容、行号范围（可选）、API 密钥（Bearer Token）
输出	文件列表、文件内容、操作状态、元数据（大小/行数/修改时间）、错误代码
适用人群	需要云端持久化存储的开发者、多会话数据同步用户、轻量级文件管理需求者
不包含	大文件分片上传、版本历史、端到端加密、细粒度团队权限、离线缓存

 

风险提示

• 禁止存储敏感内容（密码、密钥、个人隐私数据）
• API 密钥泄露可能导致文件被未授权访问
• 目录深度超过20层时写入会失败
• 超出速率限制后请求将被拒绝
• 文件删除操作不可恢复

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/deploydon/aifs-space/SKILL.md
来源类型：GitHub 仓库