極速、安全、無縫的桌面翻譯助手

常駐系統列（System Tray / Status Bar），選取文字後按下全域快速鍵，瞬間調用 Gemini API、Ollama 本地 LLM 或 OpenAI 進行高品質翻譯，支援覆蓋原文字與游標懸浮視窗展示。

立即開始使用 GitHub 倉庫

Core Advantages

為什麼選擇 TranslateAgent？

⚡

極速 GPU 加速響應

基於 Rust 現代 GUI 框架 Iced 0.13 構建，常駐狀態記憶體僅佔用十數 MB。繪圖與動畫經 GPU 渲染，流暢且極速反應。

🔒

晶片級憑證安全防護

API 金鑰拒絕明文存放。macOS 完美整合系統 Keychain，Windows 採用 DPAPI 硬體級金鑰綁定加密，防止惡意軟體竊取金鑰。

🤖

多元 AI 模型深度整合

內建優化 OpenAI 相容介面。完美支援 Gemini API 及 Ollama 本地模型（如 Llama 3.2），一鍵動態拉取可用模型清單。

⚙️

設定自我修復與防呆

每次啟動自動驗證 settings.json 數值區間（限制 temperature 與 maxTokens 參數），損毀時自動備份並無感重置，防範系統當機。

🔄

覆蓋與懸浮雙重模式

支援覆蓋模式（翻譯後直接以譯文貼上替換原選取文字）與懸浮視窗模式（在游標定位處開啟極簡精美視窗顯示翻譯，並提供手動複製）。

💻

跨平台高度客製化

完美支援 macOS 系統選單與 Windows 托盤。Linux 用戶更可透過 CLI flags 參數，靈活與 Linux 系統快捷鍵或 Bash 腳本進行串接。

Interactive Features

功能介紹與底層工作流

跨平台功能細節比較

TranslateAgent 針對 macOS 與 Windows 提供深度原生整合，Linux 提供極簡 GUI 核心與命令列介面。

功能特徵	Windows	macOS	Linux
常駐系統托盤 / 選單列	✅	✅	❌
全域快速鍵監控與自動觸發	✅	✅	❌ (需自行綁定快速鍵)
自動複製 / 貼上覆蓋 (鍵盤模擬)	✅	✅	❌
金鑰晶片級安全存取	✅ (DPAPI)	✅ (Keychain)	⚠️ (明文 0o600 限制檔)
圖形化設定介面 (`--settings`)	✅	✅	✅
結果懸浮與載入中動畫 GUI	✅	✅	✅
開機/登入時自動啟動程式	✅ (Registry HKCU)	✅ (LaunchAgent)	❌

macOS 權限提示： 由於 macOS 安全性限制，自動複製與快速鍵模擬需要開啟「輔助功能」與「輸入監控」權限。軟體內建貼心的 Objective-C 半透明拖曳引導視窗，直接拖拽 App 圖示到隱私設定列表即可完成授權，免除手動尋找路徑。

底層核心翻譯流程

點擊右側項目展開，了解 TranslateAgent 在您按下快捷鍵時的極速數據流運算。

選取文字 & 按下快捷鍵

系統模擬複製鍵 Cmd+C / Ctrl+C

喚起 --loading 旋轉動畫視窗

安全加解密 API key 並異步發送請求

寫入剪貼簿 & 貼上覆蓋 (若啟用)

游標定位處彈出 --result 視窗

1. 全域熱鍵與事件攔截 ▼

程式使用 global-hotkey 套件向作業系統核心層級註冊熱鍵（預設 macOS: Cmd+Option+T, Windows: Ctrl+Alt+T）。當被觸發時，背景線程將第一時間切換鎖定狀態，防止重複按壓產生多次併發請求，隨後發送鍵盤事件。

2. 模擬複製與剪貼簿存取 ▼

為取得反白文字，程式模擬發送作業系統層級複製組合鍵。文字被放入系統剪貼簿後，利用 arboard 套件進行高速讀取，全程不干預使用者的原有複製紀錄（在覆蓋模式下亦會備份並在結束後還原使用者剪貼簿內容）。

3. 晶片級硬體金鑰保護機制 ▼

傳送請求前，程式動態自 Keychain（macOS）或利用 crypt32.dll 的 DPAPI（Windows）安全載入金鑰。解密操作在系統底層的記憶體區段完成，不留痕跡。未授權的外部軟體、非當前 Windows SID 使用者均無法強行解碼。

命令列參數（CLI Flags）與彈性整合

TranslateAgent 內部採用模組化設計。所有的 GUI 視窗（設定、載入中、翻譯結果）皆可透過獨立參數啟動，方便 Linux 或腳本玩家自訂串接。

參數	資料格式	預設值	用途說明	範例
--settings	無 (旗標)	N/A	直接開啟圖形化設定視窗。	`TranslateAgent --settings`
--permissions	無 (旗標)	N/A	開啟 macOS 權限引導及 TCC 診斷視窗。	`TranslateAgent --permissions`
--loading	無 (旗標)	N/A	於特定位置開啟「正在翻譯中」圓形懸浮動畫條。	`TranslateAgent --loading`
--loading-x	浮點數	螢幕中央	設定載入中視窗的 X 坐標。	`--loading-x 100`
--loading-y	浮點數	50.0	設定載入中視窗的 Y 坐標。	`--loading-y 200`
--result	字串	N/A	啟動翻譯結果視窗，展示傳入的文字內容。	`--result "哈囉"`
--result-x	浮點數	游標位置	設定結果視窗的 X 坐標。	`--result-x 450`
--result-y	浮點數	游標位置	設定結果視窗的 Y 坐標。	`--result-y 300`
--hide-copy	無 (旗標)	N/A	隱藏翻譯結果視窗底部的「複製」按鈕。	`--result "譯文" --hide-copy`

Getting Started

快速開始 & 打包安裝

您可以直接下載發佈的 DMG，或者在本機使用 Makefile 打包編譯安裝：

bash — macOS Compile & Bundle

# 1. 複製專案原始碼
git clone https://github.com/Jackwio/translate-agent-anywhere.git
cd translate-agent-anywhere

# 2. 打包成原生 macOS .app 檔案
make app

# 3. 打包成可發佈的 .dmg 安裝映像檔
make dmg

產出映像檔將存放於 dist/ 目錄，將 TranslateAgent.app 拖移至「應用程式」即可。

Windows 可執行獨立可攜式版本 TranslateAgent-portable.exe，或建立自解壓 NSIS 安裝包：

cmd / bash — Windows Compile & Installer

# 本地編譯可攜式 EXE 執行檔
make exe

# 建置自動安裝精靈 NSIS 套件 (需安裝 NSIS)
make win-installer

# 跨平台編譯 (在 macOS/Linux 上交叉編譯 Windows 執行檔，需 mingw-w64)
make setup
make exe

便攜版首次執行會引導自動安裝，並註冊開機啟動與「新增或移除程式」反安裝控制項。

Linux 用戶必須先安裝編譯 GUI 必備的 Vulkan/xkb 依賴套件，隨後進行 Debian 包或 AppImage 打包：

bash — Linux Pre-requisites & Build

# 1. 安裝系統編譯依賴 (Debian/Ubuntu 系統)
sudo apt-get install -y libxkbcommon-dev libwayland-dev libvulkan-dev libfontconfig1-dev pkg-config

# 2. 打包成 .deb 安裝包
make deb
sudo dpkg -i dist/*.deb

# 3. 亦可打包為 AppImage
make appimage

授權系統權限

首次執行 macOS 版本，程式會自動引導開啟系統的「輔助功能」與「輸入監控」權限，確保模擬複製貼上功能能正常運作。

設定翻譯供應商與金鑰

於常駐狀態列圖示點擊右鍵選擇「設定 settings」（或直接執行 --settings 參數），挑選 AI 服務商（如 Gemini）並登錄金鑰，點選拉取可用模型清單後存檔。

開始翻譯體驗

選取任何軟體或網頁中的一段文字，按下快速鍵（macOS: ⌥ ⌘ T，Windows: Ctrl + Alt + T），即可立刻看見翻譯結果！

TranslateAgent Loading...