输入关键词搜索已发布文档。
mywebdrive
文件与版本
文件列表、分页、当前版本、下载票据和未提供的文件管理操作。
在个人中心找文件
打开实例的 /account。“我的文件”每批请求 20 条；“加载更多”使用服务端返回的 nextCursor，点“刷新”会重载第一批。请求失败的错误提示与“暂无文件”是不同状态，不应把服务不可用解释成文件已清空。
文件条目包含名称、更新时间，以及当前版本的大小、版本号和 MIME 类型。currentVersion: null 表示还没有可用版本，此时“版本”和“下载”按钮不可用。等待上传完成并刷新，而不是根据文件名存在就认为内容已经保存。
查看版本
点击文件旁的“版本”，弹窗列出版本号、大小和创建时间。File 是逻辑文件；File Version 是不可变内容版本；Storage Object 是存储层对象。这三个标识不能混用。
版本 API 支持游标分页，每批默认 20 条、最大 100 条。当前弹窗只请求前 100 条，没有继续翻页的控件；这不是超过 100 个版本会消失。API 的 nextCursor 才决定是否还有更多。替换上传可增加版本，但当前弹窗没有“恢复旧版”或“下载指定历史版本”按钮。
下载当前版本
点击“下载”后，客户端先用登录身份申请私有 Download Ticket，再用返回的 downloadGrant 请求 Storage 对象。票据有效期为 60 秒且只能消费一次，必须在点击下载时申请；不能把对象地址当作永久公开下载链接。
浏览器将完整响应读取成 Blob 后保存，所以大文件可能占用较多浏览器内存。源码没有保证断点续传、多线程下载或任意 Range 请求。票据过期、已用或下载中断时，重新发起下载获取新票据；不要自动无限重试同一票据。
文件列表 API 的边界
GET /api/v1/files 默认每批 50 条，最大 100 条；省略 parentId 不加父目录过滤，parentId=null 筛选根目录。cursor 是绑定用户、接口和筛选上下文的签名值，应原样传递；换筛选条件时从第一批开始，不能拼接或在不同账户间共享。
当前公共文件路由提供查询，不提供通用创建文件夹、重命名、移动、删除或回收站恢复接口。数据模型存在 folder 或 deletedAt 字段不等于这些操作已开放。不要照旧版网盘说明寻找不存在的按钮，也不要直接改数据库实现日常文件操作。