快速開始

從建置到轉換第一批檔案，大約五分鐘。

1. 建置

需要 Rust 1.95 以上（用 rustup 安裝）。在原始碼目錄執行：

cargo build --release

完成後會有兩個程式：

• target/release/rustz——圖形介面
• target/release/rustz-cli——命令列版

macOS 可以改用 sh tools/bundle_macos.sh 做成 RustZ.app，拖到「應用程式」就能固定在 Dock。各平台的做法見安裝方式。

2. 用圖形介面轉換一個資料夾

1. 開啟 rustz，把資料夾拖進視窗（或按右上角的「＋ 加入資料夾」）。
2. 清單會列出每個檔案偵測到的編碼。點任何一個檔案，下方就會左右對照原文與轉換結果。
3. 在右側的「轉換設定」把「目標編碼」設成 UTF-8；「字形」維持「自動」就只轉編碼、不改字形。
4. 按「開始轉換」。要覆寫原檔時會再確認一次，預設會先把原檔備份成「檔名.bak」。

清單上的狀態會變成「完成」「無變更」或「略過」。內容本來就是目標格式的檔案不會重寫；看起來是二進位檔的會略過。

3. 用命令列

rustz-cli /n /s .              # 只列出每個檔案偵測到的編碼，不寫入
rustz-cli /o:utf8 /s /b .      # 整個資料夾（含子資料夾）轉成 UTF-8，先備份
rustz-cli /o:big5 gbk.txt big5.txt   # GBK 簡體 → Big5 繁體，另存新檔
echo 简体中文的软件 | rustz-cli /o:utf8 /f:t -   # 標準輸入 → 簡體中文的軟體

參數與 ConvertZ 的 ConCmd 相容，完整說明見命令列。

macOS／Linux 的萬用字元

請用引號包住萬用字元（"*.txt"），交給 RustZ 自己展開，否則 shell 會先展開，兩個檔名可能被當成「輸入檔＋輸出檔」。RustZ 遇到這種情況會停下來報錯，不會覆寫資料。

4. 轉換剪貼簿

複製一段簡體文字，在「文字轉換」頁按「剪貼簿 簡 → 繁」，再貼上就是繁體。開著「關閉視窗後繼續在背景執行」時，也可以直接從選單列或系統匣的 RustZ 圖示轉換，不必打開視窗，見常駐背景。

下一步

• 功能列表：RustZ 能做的事一覽。
• 使用手冊：每個頁面的每個選項。
• 繁簡轉換引擎：兩種引擎的差別與自訂詞典的優先順序。