首頁>編程相關>其他源碼
下載

Pot (派了個萌的翻譯器)

?一個跨平台的劃詞翻譯軟體(QQ 頻道)


中文| English | 한글

目錄

  • 使用說明
  • 特色功能
  • 支援介面
  • 插件系統
  • 安裝指南
  • 外部調用
  • Wayland 支持
  • 國際化
  • 貢獻者
  • 感謝

使用說明

劃詞翻譯輸入翻譯外部調用
滑鼠選取需要翻譯的文本，按下設定的劃詞翻譯快捷鍵即可按下輸入翻譯快捷鍵呼出翻譯窗口，輸入待翻譯文字後按下回車翻譯透過被其他軟體調用實現更方便高效的功能, 詳見外部調用
剪力板監聽模式截圖OCR截圖翻譯
在任意翻譯面板上點擊左上角圖示啟動剪切板監聽默認，複製文字即可完成翻譯按下截圖OCR 快捷鍵後框選需要識別區域即可完成識別按下截圖翻譯快捷鍵後框選需要識別區域即可完成翻譯

特色功能

  • 多介面並行翻譯(支援介面)
  • 多介面文字辨識(支援介面)
  • 多介面語音合成(支援介面)
  • 導出到生詞本(支援介面)
  • 外部呼叫(詳情)
  • 支援插件系統(插件系統)
  • 支援所有PC 平台(Windows, macOS, Linux)
  • 支援Wayland (在KDE、Gnome 以及Hyprland 上測試)
  • 多語言支援

支援介面

翻譯

  • OpenAI
  • 智譜AI
  • Gemini Pro
  • Ollama (離線)
  • 阿里翻譯
  • 百度翻譯
  • 彩雲小譯
  • 騰訊翻譯君
  • 騰訊互動翻譯
  • 火山翻譯
  • 小牛翻譯
  • Google
  • Bing
  • Bing 字典
  • DeepL
  • 有道翻譯
  • 劍橋字典
  • Yandex
  • Lingva (外掛程式)
  • Tatoeba (插件)
  • ECDICT (插件)

更多介面支援請參閱插件系統

文字識別

  • 系統OCR (離線)
    • Windows.Media.OCR on Windows
    • Apple Vision Framework on MacOS
    • Tesseract OCR on Linux
  • Tesseract.js (離線)
  • 百度
  • 騰訊
  • 火山
  • 迅飛
  • 騰訊圖片翻譯
  • 百度圖片翻譯
  • Simple LaTeX
  • OCRSpace (插件)
  • Rapid (離線插件)
  • Paddle (離線插件)

更多介面支援請參閱插件系統

語音合成

  • Lingva

更多介面支援請參閱插件系統

生詞本

  • Anki
  • 歐路詞典
  • 有道(插件)
  • 扇貝(插件)

更多介面支援請參閱插件系統

插件系統

軟體內建介面數量有限，但是您可以透過插件系統來擴充軟體的功能。

插件安裝

你可以在Plugin List 找到你需要的插件，然後前往插件倉庫下載插件。

pot 插件的副檔名為.potext , 下載得到.potext檔案之後，在偏好設定-服務設定-新增外部插件-安裝外部插件選擇對應的.potext即可安裝成功，新增至服務清單即可像內建服務一樣正常使用了。

故障排除

  • 找不到指定的模組(Windows)

    出現類似這樣的報錯是因為系統缺少C++函式庫，到這裡安裝即可解決問題。

  • 不是有效的Win32 應用程式(Windows)

    出現類似這樣的報錯表示你沒有下載對應系統或架構的插件，前往插件倉庫下載正確的插件即可解決問題。

插件開發

在Plugin List 中的模板章節提供了各種插件的開發模板，具體的開發文件請查看對應的模板倉庫。

安裝指南

Windows

透過Winget 安裝

winget install Pylogmon.pot

手動安裝

  1. 在Release 頁面下載最新exe安裝包。

    • 64 位元機器下載pot_{version}_x64-setup.exe
    • 32 位元機器下載pot_{version}_x86-setup.exe
    • arm64 機器下載pot_{version}_arm64-setup.exe

  2. 雙擊安裝包進行安裝。

故障排除

  • 啟動後沒有介面，點擊托盤圖示沒有反應

    檢查是否卸載/停用了WebView2，如果卸載/停用了WebView2，請手動安裝WebView2 或將其還原。

    如果是企業版系統不方便安裝或無法安裝WebView2，請嘗試在Release 下載內建WebView2 的版本pot_{version}_{arch}_fix_webview2_runtime-setup.exe

    若問題仍然存在請嘗試使用Windows7 相容模式啟動。

MacOS

透過Brew 安裝

  1. 加入我們的tap: 
brew tap pot-app/homebrew-tap
  1. 安裝pot: 
brew install --cask pot
  1. 更新pot 
brew upgrade --cask pot

手動安裝

  1. 從Release 頁面下載最新的dmg安裝套件。 （如果您使用的是M1 晶片，請下載名為pot_{version}_aarch64.dmg的安裝包，否則請下載名為pot_{version}_x64.dmg的安裝包）
  2. 雙擊下載的檔案後將pot 拖入Applications 資料夾即可完成安裝。

故障排除

  • 由於開發者無法驗證，「pot」無法開啟。

    點擊取消按鈕，然後去設定-> 隱私與安全性頁面，點擊仍要打開按鈕，然後在彈出窗口裡點擊打開按鈕即可，以後打開pot 就再也不會有任何彈窗告警了

    如果在隱私與安全性中找不到以上選項，或啟動時提示檔案損壞。開啟Terminal.app，並輸入以下指令，然後重新啟動pot 即可： 

    sudo xattr -d com.apple.quarantine /Applications/pot.app

  • 如果每次開啟時都遇到輔助功能權限提示，或無法進行劃詞翻譯，請前往設定-> 隱私與安全性-> 輔助功能，移除“pot”，並重新新增“pot”。

Linux

Debian/Ubuntu

  1. 從Release 頁面下載最新的對應架構的deb安裝套件。

  2. 使用apt-get進行安裝

    sudo apt-get install ./pot_{version}_amd64.deb

Arch/Manjaro

Warning

在最新版本的Webkit2Gtk (2.42.0) 中，由於Nvidia 專有驅動未完全實現DMABUF，將導致無法啟動和崩潰的情況發生。
請降級或在/etc/environment （或其他設定環境變數的地方）中加入WEBKIT_DISABLE_DMABUF_RENDERER=1環境變數關閉DMABUF 的使用。

  1. 在AUR 上查看

使用AUR helper安裝： 

yay -S pot-translation # 或 pot-translation-bin

# paru -S pot-translation # 或 pot-translation-bin
  1. 如果你使用archlinuxcn來源，可以直接使用pacman 安裝
sudo pacman -S pot-translation

Flatpak

Warning

Flatpak 版本缺少托盤圖示。

外部調用

Pot 提供了完整的HTTP 接口，以便可以被其他軟體調用。您可以透過向127.0.0.1:port發送HTTP 請求來呼叫pot，其中的port是pot 監聽的連接埠號，預設為60828 ,可以在軟體設定中進行更改。

API 文件:

翻译指定文本(body为需要翻译的文本), GET "/config" => 打开设置, POST "/translate" => 翻译指定文本(同"/"), GET "/selection_translate" => 划词翻译, GET "/input_translate" => 输入翻译, GET "/ocr_recognize" => 截图OCR, GET "/ocr_translate" => 截图翻译, GET "/ocr_recognize?screenshot=false" => 截图OCR(不使用软件内截图), GET "/ocr_translate?screenshot=false" => 截图翻译(不使用软件内截图), GET "/ocr_recognize?screenshot=true" => 截图OCR, GET "/ocr_translate?screenshot=true" => 截图翻译,">
POST " / " = > 翻译指定文本(body为需要翻译的文本),
GET " /config " = > 打开设置,
POST " /translate " = > 翻译指定文本(同" / " ),
GET " /selection_translate " = > 划词翻译,
GET " /input_translate " = > 输入翻译,
GET " /ocr_recognize " = > 截图OCR,
GET " /ocr_translate " = > 截图翻译,
GET " /ocr_recognize?screenshot=false " = > 截图OCR(不使用软件内截图),
GET " /ocr_translate?screenshot=false " = > 截图翻译(不使用软件内截图),
GET " /ocr_recognize?screenshot=true " = > 截图OCR,
GET " /ocr_translate?screenshot=true " = > 截图翻译,

範例：

  • 調用劃詞翻譯：

    如果想要呼叫pot 劃詞翻譯，只需向127.0.0.1:port發送請求即可。

    例如透過curl 發送請求： 

    curl " 127.0.0.1:60828/selection_translate "

不使用軟體內截圖

這項功能可以讓您在不使用軟體內截圖的情況下呼叫截圖OCR/截圖翻譯功能，這樣您就可以使用您喜歡的截圖工具來截圖了，也可以解決在某些平台下pot 自帶的截圖無法使用的問題。

調用流程

  1. 使用其他截圖工具截圖
  2. 將截圖儲存於$CACHE/com.pot-app.desktop/pot_screenshot_cut.png
  3. 向127.0.0.1:port/ocr_recognize?screenshot=false發送請求即可呼叫成功

$CACHE為系統快取目錄，例如在Windows 上為C:Users{用户名}AppDataLocalcom.pot-app.desktoppot_screenshot_cut.png

範例

在Linux 下呼叫Flameshot 進行截圖OCR: 

rm ~ /.cache/com.pot-app.desktop/pot_screenshot_cut.png && flameshot gui -s -p ~ /.cache/com.pot-app.desktop/pot_screenshot_cut.png && curl " 127.0.0.1:60828/ocr_recognize?screenshot=false "

現有用法(快速劃詞翻譯)

SnipDo (Windows)

  1. 從Microsoft Store 下載安裝SnipDo。
  2. 從Release 下載pot 的SnipDo 擴充(pot.pbar)
  3. 雙擊下載的擴充檔完成安裝。
  4. 選取文字，可以看到彈出的SnipDo 工具條，點擊翻譯按鈕即可翻譯。

PopClip (MacOS)

  1. 從App Store 下載安裝PopClip
  2. 從Release 下載pot 的PopClip 擴充(pot.popclipextz)
  3. 雙擊下載的擴充檔完成安裝。
  4. 在PopClip 的擴充功能中啟用pot 擴展，選中文字即可點擊翻譯。

Starry (Linux)

Starry 目前仍處於開發階段，因此您只能手動編譯它。

Github: ccslykx/Starry

Wayland 支持

由於各大發行版對於Wayland 的支持程度不同，所以pot 本身無法做到特別完美的支持，這裡可以提供一些常見問題的解決方案，通過合理的設置之後，pot 也可以在Wayland 下完美運行。

快捷鍵無法使用

由於Tauri 的快速鍵方案並沒有支援Wayland，所以pot 應用程式內的快速鍵設定在Wayland 下無法使用。 您可以設定係統快速用curl 發送請求來觸發pot，詳見外部調用

截圖無法使用

在一些純Wayland 桌面環境/視窗管理器(如Hyprland)上，pot 內建的截圖無法使用，這時可以透過使用其他截圖工具代替，詳見不使用軟體內截圖

以下給出在Hyprland 下的設定範例(透過grim 和slurp 實作截圖)： 

 bind = ALT, X, exec, grim -g "$(slurp)" ~/.cache/com.pot-app.desktop/pot_screenshot_cut.png && curl "127.0.0.1:60828/ocr_recognize?screenshot=false"
bind = ALT, C, exec, grim -g "$(slurp)" ~/.cache/com.pot-app.desktop/pot_screenshot_cut.png && curl "127.0.0.1:60828/ocr_translate?screenshot=false"

其他桌面環境/視窗管理器也是類似的操作

劃詞翻譯視窗跟隨滑鼠位置

由於目前pot 在Wayland 下還無法取得正確的滑鼠座標，所以內部的實作無法運作。 對於某些桌面環境/視窗管理器，可以透過設定視窗規則來實現視窗跟隨滑鼠位置，這裡以Hyprland 為例： 

 windowrulev2 = float, class:(pot), title:(Translator|OCR|PopClip|Screenshot Translate) # Translation window floating
windowrulev2 = move cursor 0 0, class:(pot), title:(Translator|PopClip|Screenshot Translate) # Translation window follows the mouse position.

國際化(Weblate)

貢獻者

手動編譯

環境要求

Node.js >= 18.0.0

pnpm >= 8.5.0

Rust >= 1.80.0

開始編譯

  1. Clone 倉庫

    git clone https://github.com/pot-app/pot-desktop.git

  2. 安裝依賴

     cd pot-desktop
pnpm install

  3. 安裝依賴(僅Linux 需要) 

    sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.0-dev libayatana-appindicator3-dev librsvg2-dev patchelf libxdo-dev libxcb1 libxrandr2 libdbus-1-3

  4. 開發偵錯

    pnpm tauri dev # Run the app in development mode

  5. 打包建構

    pnpm tauri build # Build into installation package

感謝

  • Bob 靈感來源
  • bob-plugin-openai-translator OpenAI 介面參考
  • @uiYzzi 實作思路
  • @Lichenkass 維護Deepin 應用程式商店中的pot
  • Tauri 好用的GUI 框架
展開
附加信息
相關應用
爲您推薦
相關資訊 全部
網友評論