用途：在 Domo 自定义应用中访问 FileSets 文件存储系统，完成文件上传、下载、目录树浏览、按名称搜索，以及对文件内容进行 AI 语义查询。该 API 处于 BETA 阶段，可能变更，建议用 try/catch 包裹调用并向用户暴露明确错误。
主要能力：列出文件（POST /files/search，支持 fieldSort、filters、dateFilters 及 directoryPath、immediateChildren、limit 参数，用 pageContext.next 分页）；获取文件元数据（按 fileId 或按 path）；下载文件（返回二进制，可用 .blob() 或 .text()）；上传文件（FormData 含 file 与 createFileRequest 两部分，不要手动设置 Content-Type）；删除文件（按 ID 或 path）；搜索与创建 fileset 容器；AI 查询（需 fileset 开启 aiEnabled: true，POST /query，传 query、directoryPath、topK，返回带 score 的 matches）。
使用方式：无需 manifest.json，在服务文件中定义 FILESET_ID 常量即可。可用 fetch('/api/files/v1/...')（支持 JSON 与二进制）或 domo.get('/domo/files/v1/...')（仅 JSON）。二进制操作必须用 fetch。fileset ID 可从 Domo UI 获取，或用 fileset-cli 技能（filesets search --name "..."）查找。
适用场景：Domo 自定义应用内的文件浏览、上传下载、导出 CSV 等 Blob 上传，以及基于文件内容的自然语言问答。
限制：API 为 BETA，可能变更；AI 查询需 fileset 启用 aiEnabled；domo.js 代理不支持二进制；上传时不可设置 Content-Type；资料未提供鉴权、配额、价格等信息。