輸入關鍵字搜尋已發布文件。
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 字段不等於這些操作已開放。不要照舊版網盤說明尋找不存在的按鈕，也不要直接改資料庫實現日常檔案操作。