入門指南，以及常見問題解答。

macOS 工作區（macOS 13 或更新版本）：共用資料夾會自動掛載——開啟 Finder，查看 /Volumes/My Shared Files路徑下的內容。無需任何指令。

Linux 工作區：每個共用資料夾都有自己的掛載指令，會直接顯示在應用程式內該工作區的「共用檔案」分頁中，使用該資料夾專屬的標籤，形如：

mkdir -p /mnt/my_folder
sudo mount -t virtiofs <folder-tag-shown-in-app> /mnt/my_folder

請使用應用程式中顯示的確切標籤——每個資料夾的標籤都是唯一的，因此從別處複製的指令不會生效。

Linux 上的剪貼簿共用依賴於虛擬機器內執行的代理程式。請依序檢查以下幾點：

1. 在工作區的「資源」分頁中，確認 剪貼簿共用 已開啟。
2. 在虛擬機器內，確認 spice-vdagent 已安裝：

   sudo apt install spice-vdagent

3. 確認該代理程式確實正在執行：

   systemctl status spice-vdagentd

   如果處於未啟用狀態，用 sudo systemctl start spice-vdagentd啟動它；如果你使用的是圖形化桌面環境，請登出後重新登入，讓桌面工作階段辨識它。
4. 某些精簡版或無圖形介面的桌面環境不會自動啟動 spice-vdagent ——如果代理程式已安裝並執行，但仍然不生效，請檢查你桌面環境的自動啟動設定。

剪貼簿共用目前僅適用於 Linux 工作區。

Debian 使用與 Ubuntu 相同的 apt 與 update-binfmts 工具。在工作區的「資源」分頁中開啟 Rosetta，啟動該工作區，然後在虛擬機器內執行一次以下指令：

sudo mkdir -p /media/rosetta
sudo mount -t virtiofs rosetta /media/rosetta

sudo apt-get update
sudo apt-get install -y binfmt-support

sudo /usr/sbin/update-binfmts --install rosetta /media/rosetta/rosetta \
  --magic "\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x3e\x00" \
  --mask "\xff\xff\xff\xff\xff\xfe\xfe\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff" \
  --credentials yes --preserve yes --fix-binary yes

Fedora 沒有內建 Debian 的 update-binfmts 工具，但內建了 systemd-binfmt，它會從設定檔中讀取與前者完全相同的核心 binfmt_misc 註冊資訊。在工作區的「資源」分頁中開啟 Rosetta，啟動該工作區，然後在虛擬機器內執行一次以下指令：

sudo mkdir -p /media/rosetta
sudo mount -t virtiofs rosetta /media/rosetta

sudo mkdir -p /etc/binfmt.d
sudo tee /etc/binfmt.d/rosetta.conf > /dev/null <<'EOF'
:rosetta:M::\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x3e\x00:\xff\xff\xff\xff\xff\xfe\xfe\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff:/media/rosetta/rosetta:CF
EOF

sudo systemctl restart systemd-binfmt

rosetta.conf 檔案會在重新啟動後依然保留，因此每個工作區只需設定一次。

1. 在工作區之外，於你的 Mac 上安裝並執行 Ollama。
2. 為該工作區啟用 AI 橋接（在 AI 沙盒預設中預設為開啟，也可以自行在工作區的「整合」或「資源」設定中開啟）。
3. 啟動工作區，然後開啟其 AI 橋接分頁——其中會顯示本機端點位址，對於 Linux 虛擬機器，還會顯示轉發連線所需的確切指令。
4. 在工作區內，把你的工具指向這個位址，就像連接任何使用標準 chat-completions API 格式的本機伺服器一樣。

關閉的瞬間它會被自動刪除，包括其磁碟。之後無法復原——不要把用後即焚工作區用於任何你需要保留的東西。

停止該工作區，然後在已停止工作區顯示的橫幅中選擇 儲存為基礎映像檔 。之後再次儲存同一個工作區會建立一個新的獨立基礎映像檔，而不是覆蓋先前的映像檔——你可以在偏好設定 → 基礎映像檔中管理並刪除不再需要的基礎映像檔。

工作區磁碟與基礎映像檔存放在你 Mac 上的 ~/Library/Application Support/VeloWorkspaces 目錄下。從資料庫中刪除不再需要的工作區，並在偏好設定 → 基礎映像檔中刪除未使用的基礎映像檔，即可釋放空間。

此版本尚不支援。Velo Workspaces 目前支援 Linux 與 macOS 虛擬機器。

CPU、記憶體、儲存空間、共用資料夾等一些設定屬於虛擬機器設定的一部分，執行期間無法變更（Apple 的 Virtualization 框架不支援對這些項目進行熱插拔）。請先停止該工作區，完成變更後再重新啟動。

建立 macOS 虛擬機器需要以 Apple 晶片 Mac 作為主機。在 Intel Mac 上，Linux 虛擬機器仍然完全受支援。