使用说明

发行方是 Auto-Coder.Chat。这个服务的客户端编号是 agent-file，范围是 openid email，登录使用授权码和 PKCE。

目录和磁盘

虚拟路径里看到的是原始文件名。磁盘上的对象是 {用户}/{项目}/{文件 UUID}，不会把原始文件名当作磁盘路径。

凭据范围

• files:read 可以列出和下载。
• files:read-write 还可以创建、上传、移动和删除。

命令行

agent-file auth login --server https://files.sparse-agent.com
agent-file auth status
agent-file projects create --name 示例
agent-file projects list
agent-file dirs create --project 项目编号 --path 笔记
agent-file upload --project 项目编号 --path 笔记/你好.txt --file ./你好.txt
agent-file list --project 项目编号 --path 笔记
agent-file download --project 项目编号 --path 笔记/你好.txt --out ./你好.txt
agent-file move --project 项目编号 --from 笔记/你好.txt --to 笔记/已改名.txt
agent-file delete --kind file --project 项目编号 --path 笔记/已改名.txt --confirm 笔记/已改名.txt
agent-file mcp

删除目录时把 --kind 换成 dir。目录里还有内容时会拒绝删除。

MCP

HTTP 入口是 /mcp。标准输入输出由 agent-file mcp 转发到这个入口。工具有 health、projects_create、projects_list、dirs_create、list、upload、download、move、delete_file、delete_dir。