名称： aifs
描述： 通过 AIFS.space 云存储 API 存储和检索文件。适用于将笔记、文档或数据持久化到云端、跨会话同步文件，或当用户提及 AIFS、aifs.space 或云文件存储时。请勿用于任何敏感内容。

AIFS - AI 文件系统

AIFS.space 是一个简单的 HTTP REST API，用于云文件存储。您可以使用它在不同会话间持久化文件、在智能体间共享数据，或将用户内容存储到云端。

用户须知

用户应在 https://AIFS.Space 上注册并获取 API 密钥，然后提供给您。

身份验证

需要在请求头中提供 API 密钥。请检查环境变量（AIFS_API_KEY）或用户配置中是否已设置密钥。

Authorization: Bearer aifs_xxxxx

密钥类型： admin（完全权限）、read-write（读写）、read-only（只读）、write-only（只写）

基础 URL

https://aifs.space

API 端点

列出文件

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

返回示例：{"files": [{"path": "notes/todo.txt", "size": 1024, "modifiedAt": "..."}]}

读取文件

# 读取整个文件
curl -H "Authorization: Bearer $AIFS_API_KEY" "https://aifs.space/api/read?path=notes/todo.txt"

# 读取指定行范围（行号从 1 开始）
curl -H "Authorization: Bearer $AIFS_API_KEY" "https://aifs.space/api/read?path=notes/todo.txt&start_line=5&end_line=10"

返回示例：{"path": "...", "content": "...", "total_lines": 42, "returned_lines": 10}

写入文件

自动创建目录（最大深度：20）。

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

返回示例：{"success": true, "path": "...", "size": 11, "lines": 1}

修补文件（行替换）

更新特定行，无需重写整个文件。

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

返回示例：{"success": true, "lines_before": 42, "lines_after": 38}

删除文件

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

摘要（预览）

获取文件的前 500 个字符。

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

速率限制

每个密钥每分钟 60 个请求。请检查响应头：

• X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset

错误代码

常用模式

持久化会话笔记

# 保存
curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d "{\"path\":\"sessions/$(date +%Y-%m-%d).md\",\"content\":\"# 会话笔记\\n...\"}" \
  https://aifs.space/api/write

# 检索
curl -H "Authorization: Bearer $KEY" "https://aifs.space/api/read?path=sessions/2024-01-15.md"

按项目组织文件

projects/
├── alpha/
│   ├── README.md
│   └── notes.md
└── beta/
    └── spec.md

追加日志（读取 + 写入）

# 读取现有内容
EXISTING=$(curl -s -H "Authorization: Bearer $KEY" "https://aifs.space/api/read?path=log.txt" | jq -r .content)

# 追加新内容并写回
curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d "{\"path\":\"log.txt\",\"content\":\"$EXISTING\\n$(date): 新条目\"}" \
  https://aifs.space/api/write