快速開始與部署說明。

優先使用 macOS 啟動器；如果希望直接檢查和控制執行環境，也可以使用手動 Bash/Python 路徑。

快速開始

  1. 下載 macOS 版。
  2. 打開 Team Chat Launcher。
  3. 啟動本地 Hub。
  4. 建立或加入團隊。
  5. 新增聯絡人。
  6. 開始在區域網內聊天。

安裝說明

解壓 macOS 下載檔案，可按需把 App 移入 Applications，然後從 Finder 打開。如果 macOS 要求確認打開來自網路的 App，請在 Finder 中打開並按照系統提示操作。

手動部署

進階使用者可以直接使用 Bash/Python 路徑。這些命令讓執行方式保持可見，適合自訂部署。

python3 -m venv .venv
. .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -r requirements.txt
python3 -m src.network.hub --host 0.0.0.0 --port 8080
python3 -m src.app.main --profile alice --transport network --hub 127.0.0.1:8080

故障排查

App 打不開

確認 zip 已完整解壓，然後從 Finder 打開 App，並按需完成 macOS 確認提示。

瀏覽器 404

從專案根目錄使用官網預覽腳本，確保靜態伺服器指向 website 目錄。

Hub 無法啟動

檢查 Python 依賴、選擇的專案根目錄，以及 Hub 連接埠是否已被占用。

無法發現區域網設備

確認設備在同一網路內，並允許 Hub TCP 連接埠和 UDP 發現連接埠通過防火牆。

檔案傳送失敗

確認臨時檔案服務正在執行，並且客戶端可以訪問 Hub 主機。

權限 / 防火牆問題

允許 App 和 Python 執行環境通過本機防火牆提示，然後重新嘗試連接 Hub。