功能概覽
Mavis 提供完整的 SFTP/FTP 檔案管理功能，方便使用者安全、高效地操作遠端檔案。以下文件概略介紹主要功能、注意事項與特殊情境。
- 安全與可靠：透過 SFTP/FTP 協定傳輸檔案，支援加密，保護資料安全
- 多平台支援：Windows、macOS、Linux 等作業系統，以及主流 SFTP/FTP 伺服器
- 直觀操作：提供傳輸進度條、狀態提示與日誌，方便使用者追蹤檔案操作
- 靈活管理：支援單檔、多檔、資料夾操作，並自動處理檔案名稱重複、衝突或特殊情境
基本功能與操作概念
2.1 上傳與下載
- 單檔上傳：可直接選擇檔案上傳
- 多檔上傳：支援同時上傳多個檔案
- 資料夾上傳：資料夾內所有檔案會攤平成列表進行上傳
- 檔名重複處理：
- 單檔重複：跳出確認 modal，選擇覆蓋或取消
- 多檔重複：可選擇覆蓋、跳過或停止，並可套用到剩餘檔案
- 系統會自動對重複檔案補上編號，例如 filename(1).txt
- 下載：
- 單檔下載：每個檔案獨立下載
- 壓縮下載：勾選多個檔案或資料夾時，系統自動生成 ZIP 檔下載
- 壓縮檔命名範例：SFTP_download_userA_20250821_1030.zip
- 重複下載會自動新增序號：SFTP_download_userA_20250821_1030 (1).zip
- 注意事項：
- 壓縮下載僅支援常見格式：zip、dmg、gz、tgz、rar、7z
- 特殊檔案（如 Postman.app.zip）在 macOS 可能無法自動解壓或放到指定資料夾
2.2 建立資料夾
- 可在當前瀏覽的遠端目錄建立單層資料夾
- 命名規範遵循 Validation 標準
- 成功提示：Folder created.
- 失敗處理：
- 無權限：Create directory failed: {server_name}
- 重複名稱： 建立失敗
2.3 重新命名
- 支援單一檔案或資料夾
- 命名不得與同一層級其他項目重名，不得含特殊字元
- 成功提示：Rename success.
- 失敗處理：
- 無權限：Permission denied.
- 檔案名稱衝突：Name already exists.
- 檔案不存在 / 無法存取：Rename failed: {file_name}
- 連線問題：Rename failed: {server_name}
2.4 移動
- 可將同一資料夾內的檔案或子資料夾移動至其他位置
- 限制：
- 只能在同一來源資料夾選取項目
- 目的地資料夾需在使用者權限範圍內
- 不支援跨 Tab 或 Session 拖曳
- 操作流程：
- 單選或多選檔案/資料夾 → 點擊移動 → 選擇目的地資料夾
- 衝突處理：
- 目標資料夾已有同名檔案 → 會覆蓋
- 目標資料夾已有同名資料夾 → 移動失敗
- 目標資料夾已有同名檔案 → 會覆蓋
- 狀態提示： Waiting / Processing / Completed / Fail
2.5 刪除
- 可刪除當前資料夾內的檔案或子資料夾
- 支援單筆或多筆刪除
- 遞迴刪除資料夾：包含所有子資料夾及檔案
- Pop-up Modal：
- 單筆刪除或非遞迴：無
- 多筆或遞迴刪除：會顯示確認提示
- 成功操作：無 toast
- 失敗操作：
- 無權限：Permission denied
- 檔案不存在 / 名稱衝突：Delete failed: {file_name}
- 連線問題：Delete failed: {server_name}
常見問題 (FAQ)
Q1：資料夾為什麼「下載」按鈕無法使用？
A1：資料夾需使用「壓縮並下載」；單檔可直接下載。
Q2：上傳或下載時進度條失敗怎麼辦？
A2：可點擊 Retry 重新嘗試。可能原因：網路中斷、權限不足、檔案被鎖定。
Q3：下載檔案名稱會自動改嗎？
A3：重複下載會自動新增序號，壓縮檔名稱包含伺服器帳號與下載時間。
Q4：哪些檔案或資料夾無法上傳或下載？
A4：特殊壓縮格式或 macOS 特殊檔案可能無法自動解壓或放到指定資料夾。
Q5：一次能上傳或移動多少檔案？
A5：前端一次只會傳 4 個檔案，採 async 上傳；遇重複檔案會先處理後續再繼續。
Q6：移動資料夾時會覆蓋嗎？
A6：檔案重名會覆蓋，資料夾重名會失敗，系統會跳出確認提示。
Q7：刪除資料夾時可以取消嗎？
A7：遞迴刪除或多選刪除一旦確認不可復原，單筆刪除或非遞迴可直接操作。
Q8：操作失敗時有日誌嗎？
A8：系統支援 Session Log 與 Access Log，可追蹤操作紀錄與錯誤訊息。
Q9：上傳時遇到檔案重複怎麼辦？
A9：單檔重複會跳出確認 Modal，選擇覆蓋或取消。多檔重複可選擇覆蓋、跳過或停止，並可套用到剩餘檔案。
Q10：壓縮下載支援哪些格式？
A10：zip、dmg、gz、tgz、rar、7z，冷門或特殊格式需額外開發。
Q11：移動檔案時可跨資料夾選取嗎？
A11：不支援跨不同來源資料夾、多 Tab 或 Session 的拖曳操作。
Q12：建立資料夾時遇到重複名稱怎麼辦？
A12：建立失敗，部分平台會在 log 中記錄錯誤訊息。
Q13：刪除資料夾是否包含子資料夾和檔案？
A13：遞迴刪除會同時刪除所選資料夾內的所有子資料夾及檔案。