桌面應用

Multica Desktop 提供 macOS、Windows 和 Linux 版本。它和 Web 版使用相同的帳號與工作區資料，但會在本機自動管理守護程式，併為不同工作區保留各自的標籤頁。

Desktop 與 WebCopy Anchor Link

臨時檢視或在公共電腦上使用時，Web 更方便。

兩者可以同時登入。只要連線的是同一個 Multica 服務，看到的資料就是共享的。

安裝Copy Anchor Link

桌面標籤頁Copy Anchor Link

Desktop 會為每個工作區單獨儲存標籤頁。例如，你在工作區 A 開啟了三個任務，切到工作區 B 後會看到 B 自己的標籤頁；切回 A 時，之前的三個標籤頁仍然保留。

同一資源只會在當前工作區開啟一次。標籤頁可以重新排序、固定、關閉，也會保留各自的前進、後退和捲動位置。固定的標籤頁排在最左邊，沒有關閉按鈕，要先取消固定才能關；在它裡面開啟別的頁面時會新開一個標籤頁，它自己停在原頁面。點選或貼上本部署的應用連結會直接在標籤頁中開啟，不會跳轉到瀏覽器。

退出登入會清除本機儲存的所有標籤頁，避免下一位登入者看到上一個帳號留下的頁面。

內建守護程式Copy Anchor Link

登入後，Desktop 會為當前 Multica 服務建立一個專用 CLI profile，並用它啟動守護程式。這個 profile 位於：

~/.multica/profiles/desktop-<host>/

它不會讀取或覆蓋你在終端中使用的預設 profile。如果你同時手動啟動了另一個守護程式，Multica 會把它們顯示為不同的執行時。

可以在 Desktop 的設定中檢視執行狀態和日誌。工具沒有被檢測到時，先確認它能在普通終端中執行並且已經登入，再重啟 Desktop 的守護程式。

更新 DesktopCopy Anchor Link

自動更新預設開啟。應用在後臺檢查並下載新版本，下載完成後可以立即重啟安裝，也可以等下次退出時安裝。在 設定 → 更新 中可以關閉自動檢查，或手動檢查新版本。

更新按作業系統和處理器架構分發：

• Windows arm64 和 macOS x64（Intel）使用各自獨立的更新源；
• 其餘架構使用預設更新源；
• 應用會自動匹配更新源，無需手動選擇；
• Linux 上自動更新只對 .AppImage 生效，.deb 和 .rpm 透過下載新安裝包覆蓋安裝；
• 自動更新失敗時，同樣從下載頁獲取對應安裝包覆蓋安裝。

連線自託管例項Copy Anchor Link

Desktop 預設連線 Multica Cloud。連線自託管例項時，在使用者目錄的 .multica 下建立 desktop.json，內容如下：

{
  "schemaVersion": 1,
  "apiUrl": "https://api.example.com"
}

以上是預設位置。使用者目錄被遷移或重定向過的話，用實際路徑。

apiUrl 是 backend 的公開地址，必須填寫，且必須使用 http 或 https。另外兩個地址可以省略，Desktop 會自動推導：

• wsUrl：把 apiUrl 的協議換成 ws 或 wss，並在路徑後追加 /ws；
• appUrl：網域以 api. 開頭且至少三段時去掉 api. 字首（api.example.com → example.com），否則保持與 apiUrl 相同。

通常只寫 apiUrl 即可。推導不符合預期時再顯式覆蓋，常見情況有三類：

• Web 與 API 不同域；
• WebSocket 單獨部署；
• 網域不滿足剝字首的約定（api.local 這類兩段網域不會去掉字首）。

{
  "schemaVersion": 1,
  "apiUrl": "https://api.example.com",
  "appUrl": "https://app.example.com",
  "wsUrl": "wss://ws.example.com/socket"
}

儲存後重啟 Desktop，配置只在啟動時讀取一次。兩種失敗的表現不同：

• 檔案沒找到（目錄不對，或檔名不是 desktop.json）：Desktop 使用預設的 Cloud 配置，不報錯。所以如果 Desktop 仍然顯示 Cloud 地址且沒有任何配置錯誤，說明檔案不在 Desktop 查詢的位置。
• 檔案找到但無效（JSON、版本或 URL 有問題）：Desktop 顯示配置錯誤，不會自動回退到 Cloud。

刪除該檔案並重啟即可恢復預設的 Cloud 配置。

Windows：檢查檔名和編碼Copy Anchor Link

Windows 上兩種常見的寫檔案方式會生成 Desktop 讀不了的檔案：

• 記事本會補 .txt 字尾。存成 desktop.json 可能實際得到 desktop.json.txt，Desktop 會當作沒找到。在資源管理器裡開啟副檔名顯示，或在儲存對話方塊裡選所有檔案。想確認真實檔名，在 PowerShell 裡執行 Get-ChildItem "$env:USERPROFILE\.multica" -Filter "desktop.json*"，Name 一列必須正好是 desktop.json。
• PowerShell 重定向會寫成 UTF-16 或帶 BOM。> desktop.json 和 Out-File 可能生成無法解析的編碼，表現為配置錯誤。

上面 Windows 頁籤裡的 PowerShell 命令可以同時避開這兩個坑。

Windows Defender 把 Multica 報成病毒Copy Anchor Link

Windows 安全中心報出 Trojan:Script/Wacatac.B!ml 之類的威脅，並隔離 Desktop 安裝目錄裡的某個檔案。被隔離的通常是內建的 CLI，而不是應用主程式：

C:\Users\<你>\AppData\Local\Programs\@multicadesktop\resources\app.asar.unpacked\resources\bin\multica.exe

這是誤報。!ml 字尾表示結論來自 Defender 的機器學習啟發式判斷，不是病毒特徵庫匹配。Multica 的 Windows 構建目前還沒有做 Authenticode 程式碼簽名，一個剛釋出、沒有簽名、又會拉起後臺程式並建立網路連線的二進位制，很容易被這類啟發式判為可疑。所有 Windows 產物都由 GitHub Actions 從本倉庫的公開原始碼構建。

你可以自己校驗：每個 GitHub release 都發布了覆蓋全部 CLI 壓縮包的 checksums.txt。

Get-FileHash .\multica-cli-<version>-windows-amd64.zip -Algorithm SHA256

把輸出的雜湊和最新 release 裡 checksums.txt 對應那一行比對。

按下面三步處理：

接下來Copy Anchor Link

• 快速上手 — 首次連線流程。
• 守護程式與執行時 — 內建守護程式的機制。
• 故障排查 — 連線問題排查。