用途：drive9 是面向 AI 智能体的类文件系统 API，用于让智能体持久化保存与检索文件，并通过语义搜索按含义而非文件名找回内容。
主要能力：文件写入后自动嵌入并建立全文索引；小文件（小于 50 KB）存于 db9 并即时嵌入，大文件经预签名 URL 存于 S3，单一路径命名空间同时覆盖两层。目录可放置 .abstract.md（约 100 tokens，L0 扫描）与 .overview.md（约 1k tokens，L1 扫描），便于智能体先低成本浏览再加载全文。支持写入、读取、列目录、stat、删除（含递归）、建目录、零拷贝复制、重命名、内容搜索（grep）、按属性查找（find）、批量 stat 与批量读取小文件、大文件分片上传、SSE 变更事件流。
使用方式：基础地址为 https://api.drive9.ai，所有文件系统操作走统一的 /v1/fs/{path} 端点，通过 HTTP 方法与查询串修饰符区分。认证使用 bearer token：Authorization: Bearer $DRIVE9_TOKEN，也兼容 X-API-Key。密钥可通过 drive9.ai 控制台或 drive9 create CLI 获取。写入文件时用 --data-binary 以保留字节。大文件建议使用 drive9 CLI 或 SDK，直接调用 HTTP 时走 V2 分片上传流程（/v2/uploads/initiate、presign、presign-batch、complete、abort）。
适用场景：为智能体提供持久化笔记与记忆、按语义检索历史资料、跨路径复用同一文件、批量读取小文件等。
限制：资料未提供收费、价格、平台支持范围与性能指标。若请求失败，可运行 zero doctor check-connector --env-name DRIVE9_TOKEN 或 zero doctor check-connector --url https://api.drive9.ai/v1/fs/ --method GET 排查连接。