檔案傳輸

概述

在桌面執行 Spck CLI 時，它充當桌面檔案系統與手機本地專案之間的同步樞紐。兩側在 Spck Editor 檔案管理員中並排顯示——手機的本地專案在左側，桌面檔案作為已連線的遠端伺服器——您可以使用標準的複製貼上命令在任意方向複製檔案或整個資料夾。

無需 AirDrop、藍牙、USB 傳輸線或第三方雲端儲存。傳輸透過 WebSocket 連線進行端對端加密，當兩台裝置在相同網路時，資料僅在本地 Wi-Fi 內流動。

運作原理

CLI 將桌面目錄作為遠端伺服器專案公開在 Spck Editor 的檔案管理員中。儲存在手機上的本地專案存放在應用程式的本地儲存空間中。Spck Editor 將兩者視為同等的專案位置，因此在單一專案內有效的所有檔案操作（包括複製貼上）也可以在它們之間進行。

手機（本地儲存空間）              桌面（透過 CLI）
────────────────────────          ─────────────────────
my-project/               ↔      ~/projects/my-project/
  ├── index.html                    ├── index.html
  ├── style.css                     ├── style.css
  └── assets/                       └── assets/
      └── logo.png                      └── logo.png

目錄以遞迴方式傳輸——內部所有檔案都會被複製，子目錄在目的地自動建立。

從桌面到行動裝置

當您想將檔案從電腦帶到手機時使用此方式——例如離線工作、與只有行動應用程式的同事共享專案，或在裝置上儲存工作快照。

在桌面啟動 CLI，指向您要傳輸的資料夾：
```
spck --root ~/projects
```
用相機應用程式掃描 QR 碼並在 Spck Editor 中開啟連結，連線手機。
在 Spck Editor 的專案面板中，桌面資料夾顯示為遠端伺服器專案。
在遠端專案中長按您想要的檔案或資料夾，然後點選複製。
導覽至手機上的本地專案（或透過新增專案建立新專案）。
長按目的地資料夾，然後點選貼上。

檔案從桌面下載並儲存到手機的本地儲存空間。

從行動裝置到桌面

當您想將手機上的工作傳回桌面時使用此方式——例如外出編輯後，或整合在裝置上建立的專案。

在桌面啟動 CLI，指向您希望檔案儲存的資料夾：
```
spck --root ~/Desktop/from-phone
```
掃描 QR 碼連線手機。
在 Spck Editor 中，開啟手機上包含要傳送檔案的本地專案。
長按您想要的檔案或資料夾，然後點選複製。
在專案面板中導覽至遠端桌面專案。
長按目的地資料夾，然後點選貼上。

檔案從手機本地儲存空間讀取，並透過 CLI 寫入桌面。

傳輸整個專案

您可以透過一次貼上操作複製整個專案資料夾。在檔案樹中長按專案根目錄並選擇複製，然後導覽至目的地並貼上。整個目錄樹（包括所有子目錄中的所有檔案）都會被傳輸。

適用於以下情境：

在進行重大變更前將行動專案備份到桌面
從現有桌面程式碼庫初始化手機上的新專案
將多個裝置上的工作合併到一處

提示

檔案大小限制

預設最大檔案大小為每個檔案 10 MB。若要傳輸圖片、壓縮檔或編譯後的二進位檔案等較大檔案，請在 CLI 設定中增加限制：

{
  "filesystem": {
    "maxFileSize": "200MB"
  }
}

詳情請參見 CLI 設定。

傳輸速度

速度完全取決於您的本地 Wi-Fi 或網路連線。對於大型目錄，傳輸逐檔案進行，因此整體吞吐量與檔案數量成比例。在一般家庭 Wi-Fi 網路上，以文字為主的小型專案（數百個檔案）可在幾秒內完成。

安全性

所有傳輸均透過 WSS（WebSocket Secure）加密，每個請求都使用每次工作階段的密鑰簽署。中繼伺服器在裝置間轉發訊息，但不會接收未加密的內容。詳情請參見 CLI 安全性。

同時執行多個傳輸

CLI 公開單一根目錄。若要同時從多個位置傳輸，請在不同終端機中執行獨立的 CLI 執行個體：

# 終端機 1：公開 ~/projects
spck --root ~/projects

# 終端機 2：公開 ~/Documents
spck --root ~/Documents

每個執行個體產生自己的 QR 碼和連線，兩個遠端伺服器同時出現在 Spck Editor 的專案面板中。