安裝方式

目前沒有預先編譯的安裝檔，請從原始碼建置。建置一次大約幾分鐘，之後就是一般的應用程式。

需求

Rust 1.95 以上：圖形介面使用的 eframe 0.36 需要這個版本；只建置命令列版的話 1.85 即可。用 rustup 安裝。
macOS 11 以上、Windows 10 以上，或有 X11／Wayland 桌面的 Linux。
圖形介面以 GPU 繪製（Metal、Direct3D、Vulkan 或 OpenGL），一般電腦都符合。

從原始碼建置

cargo build --release
cargo test --workspace     # 可選：跑一次測試

輸出在 target/release/：rustz（圖形介面）與 rustz-cli（命令列版）。詞庫與對照表都已編進程式裡，不需要額外的資料檔。

macOS：做成 App，固定在 Dock

sh tools/bundle_macos.sh

會產生 target/RustZ.app（含圖示，命令列版也放在裡面）。拖到「應用程式」資料夾後開啟，在 Dock 上的圖示按右鍵 →「選項」→「保留在 Dock」。

命令列版可以這樣放進 PATH：

ln -s /Applications/RustZ.app/Contents/MacOS/rustz-cli /usr/local/bin/rustz-cli

簽章

腳本只做本機用的臨時簽章（ad-hoc），在自己這台 Mac 上執行沒有問題。要把 App 分享給其他 Mac，需要用 Apple Developer ID 簽章並送公證，這部分不在腳本裡。

Windows

cargo build --release

target\release\rustz.exe 是圖形介面，Release 版不會開出主控台視窗；rustz-cli.exe 是命令列版，放到 PATH 裡的資料夾即可在任何地方使用。開啟 rustz.exe 後，在工作列的圖示按右鍵 →「釘選到工作列」。

Linux

建置不需要額外的開發套件。執行時用的是桌面環境本來就有的東西：X11 或 Wayland、檔案對話框用的 XDG Desktop Portal，系統匣圖示則透過 D-Bus 的 StatusNotifierItem。

安裝到自己的家目錄並加入應用程式選單：

install -Dm755 target/release/rustz     ~/.local/bin/rustz
install -Dm755 target/release/rustz-cli ~/.local/bin/rustz-cli
install -Dm644 packaging/linux/rustz.desktop ~/.local/share/applications/rustz.desktop

python3 tools/make_icon.py /tmp/rustz-icons 256
install -Dm644 /tmp/rustz-icons/rustz-256.png ~/.local/share/icons/hicolor/256x256/apps/rustz.png

不需要系統匣功能時，可以不編進去：

cargo build --release --no-default-features -p rustz-gui

解除安裝

刪除程式（或 RustZ.app）即可。設定與自訂詞典放在下面的資料夾，不要了也可以一起刪除：

平台	位置
macOS	`~/Library/Application Support/RustZ/`
Windows	`%APPDATA%\RustZ\`
Linux	`~/.config/rustz/`（或 `$XDG_CONFIG_HOME/rustz/`）

安裝方式 ​

需求 ​

從原始碼建置 ​

macOS：做成 App，固定在 Dock ​

Windows ​

Linux ​

解除安裝 ​