AIFS - AI文件系统

AIFS.space是一个用于云文件存储的简单HTTP REST API。可用于跨会话持久化文件、在代理间共享数据，或在云端存储用户内容。

人类用户

人类用户需在https://AIFS.Space注册并获取API密钥以供您使用。

身份验证

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

Authorization: Bearer aifs_xxxxx

密钥类型： 管理员密钥（全权限）、读写密钥、只读密钥、只写密钥

基础URL

https://aifs.space

端点

列出文件

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

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

读取文件

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

# Line range (1-indexed)
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

错误代码

常见模式

持久化会话笔记

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

# Retrieve
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

追加到日志（读取 + 写入）

# Read existing
EXISTING=$(curl -s -H "Authorization: Bearer $KEY" "https://aifs.space/api/read?path=log.txt" | jq -r .content)

# Append and write back
curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d "{\"path\":\"log.txt\",\"content\":\"$EXISTING\\n$(date): New entry\"}" \
  https://aifs.space/api/write