用途：通过 olares-cli files 命令管理 Olares 中已知路径的文件，包括寻址、读取、写入、移动、删除、分享与传输，以及压缩/解压归档、管理异步任务队列、挂载 SMB/NFS 服务器和管理 Seafile 仓库。按名称或内容查找文件属于 olares-search，全文索引目录配置属于 olares-settings。
主要能力：支持 ls、cat、download、upload、edit、mkdir、rm、rename、cp、mv、chown、compress、extract、archive、task、share、smb、nfs、repos 等动词。路径格式为 fileType/extend[/subPath]，fileType 可为 drive、cache、sync、external、awss3、dropbox、google、tencent、share、internal 等。
使用方式：用 olares-cli files <verb> --help 查看语法。例如上传本地文件到用户 Drive：olares-cli files upload ./report.pdf drive/Home/Documents/；列出目录：olares-cli files ls drive/Home/ -o json；读取单个文件字节：olares-cli files cat drive/Home/Documents/report.pdf；访问 drive/Home 之外的路径：olares-cli files ls sync/<repo_id>/。
限制与注意事项：目录创建遇冲突可能自动重命名而非报冲突；上传不会预建目标目录。直接对文件资源发起原始 GET 可能返回 HTTP 500，应改用 files cat 或 files download。external/<node>/ 是虚拟卷选择器，写入需 external/<node>/<volume>/...。drive/Home/ 第一层有 11 个系统保留名称，rename、rm 及作为源的 mv 会被拒绝，cp 与嵌套内容仍可编辑。cache/<node>/ 可存储但不能直接用于创建分享。compress 与 extract 为异步任务，Ctrl-C 只停止本地轮询；task cancel --all 影响该节点所有任务。归档、NFS 和 drive/Common 需要 Olares 1.12.6+。不要暴露令牌或密码，使用 stdin 输入密钥。遇到路径、节点/卷身份、覆盖意图或并发删除不明确时应停止并重新列出父目录询问用户。