# 從原始碼建置和安裝

## 需要準備

| 平台 | 需要 |
|---|---|
| 全部 | Rust（stable，用 rustup 安裝）、git、make |
| macOS 12 以後 | Xcode Command Line Tools（`xcode-select --install`） |
| Linux | 編譯用：`build-essential pkg-config libasound2-dev`；執行用的系統套件見下面，`make deps` 會一次裝好 |
| Windows | Visual Studio Build Tools（C++）。可以 `cargo build --release`，安裝包還沒做 |

安裝 Rust：

```sh
curl --proto '=https' -sSf https://sh.rustup.rs | sh
```

## 步驟

```sh
git clone git@git.30cm.net:daniel.w/AnyBot.git
cd AnyBot
make deps       # Linux：安裝系統套件（會問 sudo 密碼）；Mac：檢查 Xcode 工具
make            # 建置 AnyBot 和帳號伺服器（第一次約 5–15 分鐘）
make install
```

`make install` 做的事：

- **macOS**：做出 `AnyBot.app`（含圖示），放到 `~/Applications/`。沒有 Apple 開發者簽章，第一次打開請按右鍵 › 打開。想放到別的地方：`make install APPDIR=/Applications`。
- **Linux**：程式放在 `~/.local/bin/anybot`，選單項目和圖示放在 `~/.local/share/`。不需要 root。

不想安裝、只想試：`make run`。

## Linux 的系統套件

`make deps` 依發行版（apt、dnf、pacman）安裝這些，全部都是選用的，缺了 App 會說明少了什麼：

| 套件 | 用途 |
|---|---|
| libasound2、libxkbcommon-x11-0、libgl1、xdg-utils | 視窗和聲音（必要） |
| libnotify-bin | 通知 |
| libsecret-tools | 保險庫存在系統鑰匙圈 |
| espeak-ng | 唸出回覆 |
| zenity | 選檔案的視窗 |
| xclip / wl-clipboard | 貼上圖片；GNOME/KDE Wayland 上打中文 |
| ffmpeg | 影片、語音、示範錄影 |
| docker.io | Bot 自己的電腦 |
| fonts-noto-cjk | 更多中文字形（內建的粉圓體已經夠用） |

沒有螢幕的 Linux（只當手腳或大腦）：只需要 `libasound2`。要讓 Bot 看得到畫面，再執行 `make hands`，會裝好虛擬螢幕（Xvfb）、視窗管理員和輔助使用服務。

## 更新

```sh
git pull
make install
```

你的 Bot、聊天和設定不在程式裡，更新不會動到它們。

## 移除

```sh
make uninstall
```

只移除程式。要連資料一起刪，刪掉資料資料夾：

| 平台 | 資料在哪 |
|---|---|
| macOS | `~/Library/Application Support/AnyBot/` |
| Linux | `~/.local/share/AnyBot/` |
| Windows | `%APPDATA%\AnyBot\` |

設成開機自動執行的（`anybot setup` 裝的）也要停掉：Linux 執行 `systemctl --user disable --now anybot`。

## 其他執行方式

| 指令 | 用途 |
|---|---|
| `make serve`（`anybot --serve`） | 不開視窗：Bot、例行任務、訊息管道一直運作，用手機操作 |
| `make setup`（`anybot setup`） | 把這台接到你的 AnyBot（大腦或手腳），見 [multi-device.md](multi-device.md) |
| `make relay-run` | 在這台跑帳號伺服器（測試用，埠 8080） |
| `make server` | 在伺服器上用 Docker 架帳號伺服器、大腦和 HTTPS |
| `ANYBOT_DATA_DIR=/某個資料夾 anybot` | 用另一份資料（測試、同一台跑兩份） |

## 常見問題

**Mac 說「無法打開，因為無法驗證開發者」**
按右鍵 › 打開，再按一次「打開」。只有第一次需要。

**Mac 上 Bot 看不到螢幕、不能點擊**
系統設定 › 隱私權與安全性：「螢幕錄製」和「輔助使用」要打開 AnyBot。App 的 設定 › 電腦 有按鈕直接開到那一頁。

**Linux 啟動時說找不到 libasound.so.2**
`sudo apt-get install libasound2`（Ubuntu 24.04 以後叫 `libasound2t64`）。

**編譯時找不到 alsa 或 pkg-config**
Linux 少了編譯用的套件：`sudo apt-get install build-essential pkg-config libasound2-dev`。

**第一次 `make` 很久**
要下載並編譯所有套件，第一次需要 5–15 分鐘，之後只會重編有改的部分。