InstPyConvert

InstPyConvert 是一個 Windows 桌面工具，用來把目前輸入框中的文字快速在繁體與簡體之間互相轉換。

它透過全域熱鍵觸發，會自動模擬全選、複製、轉換、貼上，適合用在記事本、瀏覽器、Office、聊天軟體等可接受一般鍵盤操作的輸入區域。

下載與使用

如果你只是想使用本程式，請到 GitHub Releases 下載：

InstPyConvert-v1.0.1-windows.zip

下載後解壓縮，執行：

InstPyConvert.exe

請不要把 GitHub 自動產生的 Source code (zip) 當成一般使用版。Source code 是給開發者閱讀、修改或自行執行原始碼使用。

功能特色

• 支援繁轉簡與簡轉繁雙向轉換
• 使用全域熱鍵，不需要切換視窗操作
• 內建 OpenCC 轉換
• 支援自訂校正詞表，可覆蓋 OpenCC 預設結果
• 提供圖形化設定視窗
• 支援繁體中文與簡體中文介面
• 最小化後常駐系統匣

系統需求

一般使用者：

• Windows 10 或 Windows 11
• 建議使用系統管理員權限執行

開發者執行原始碼：

• Windows 10 或 Windows 11
• Python 3.10 以上
• 建議使用系統管理員權限執行

預設熱鍵

• Ctrl+Down：簡轉繁
• Ctrl+Up：繁轉簡
• Ctrl+Shift+Q：退出程式

你也可以在設定視窗中自行修改。

設定視窗

系統匣右鍵選單可開啟設定視窗，內容包括：

• 介面語言
• 熱鍵設定
• 簡轉繁校正詞表
• 繁轉簡校正詞表
• 關於頁面

設定檔

程式會在執行目錄使用 config.json。這是本機設定檔，不會提交到 GitHub。

如果 config.json 不存在，程式會自動建立。專案提供 config.example.json 作為設定格式參考。

範例

{
  "ui_language": "zh_TW",
  "settings_window": {
    "width": 920,
    "height": 720,
    "x": null,
    "y": null
  },
  "hotkeys": {
    "s2t": "ctrl+down",
    "t2s": "ctrl+up",
    "exit": "ctrl+shift+q"
  },
  "corrections": {
    "s2t": {
      "着": "著"
    },
    "t2s": {}
  },
  "delays": {
    "after_select_all": 0.1,
    "after_copy": 0.05,
    "before_paste": 0.1
  }
}

欄位說明

• ui_language：介面語言，可用 zh_TW 或 zh_CN
• settings_window：設定視窗大小與位置
• hotkeys.s2t：簡轉繁熱鍵
• hotkeys.t2s：繁轉簡熱鍵
• hotkeys.exit：退出程式熱鍵
• corrections.s2t：簡轉繁校正詞表
• corrections.t2s：繁轉簡校正詞表
• delays：模擬鍵盤操作時的延遲設定

開發者使用

安裝相依套件：

pip install -r requirements.txt

啟動原始碼版本：

python main.py

啟動後程式會常駐在系統匣，並註冊熱鍵。

打包 Windows 版本

安裝 PyInstaller：

pip install pyinstaller

執行打包：

pyinstaller InstPyConvert.spec

打包完成後，使用者版會產生在：

dist/InstPyConvert/

要發布給一般使用者時，請將 dist/InstPyConvert/ 壓縮成類似下列名稱，並上傳到 GitHub Releases：

InstPyConvert-v1.0.1-windows.zip

請不要把 build/ 或 dist/ 直接提交到原始碼 repository。

使用方式

1. 把游標放到可編輯的文字輸入區。
2. 按下對應熱鍵。
3. 程式會自動全選、複製、轉換後再貼回原處。

注意事項

• 某些程式若不支援一般 Ctrl+A / Ctrl+C / Ctrl+V 流程，可能無法正常轉換。
• 熱鍵註冊依賴 Windows 全域鍵盤掛鉤，若權限不足，可能導致熱鍵失效。
• 轉換流程會短暫使用剪貼簿。
• 若個別軟體反應較慢，可調高 config.json 內的 delays。

常見問題

為什麼熱鍵沒有反應？

• 先確認程式是否仍在系統匣執行
• 嘗試以系統管理員身分啟動
• 檢查熱鍵是否和其他軟體衝突

為什麼某些詞轉換結果不符合預期？

可以到設定視窗的校正詞表中新增自訂規則，覆蓋預設轉換結果。

為什麼某些應用程式無法轉換？

如果該應用程式不接受標準複製貼上操作，程式就可能無法正確完成整個流程。

專案結構

main.py                  主程式入口
settings_ui.py           設定視窗
settings_tabs.py         設定分頁內容
settings_store.py        設定檔讀寫
settings_form_service.py 表單同步與驗證
settings_theme.py        視窗樣式與主題
converter.py             OpenCC 轉換邏輯
keyboard_simulator.py    模擬鍵盤操作
clipboard_manager.py     剪貼簿操作
startup_splash.py        啟動畫面
icon_builder.py          系統匣與視窗 icon 產生
about_content_core.py    About 內容整理
i18n_core.py             介面文字
InstPyConvert.spec       PyInstaller 打包設定
config.example.json      設定檔範例

授權與使用限制

本專案採用 PolyForm Noncommercial License 1.0.0。

你可以免費下載、使用、研究、修改與分享本工具，但僅限非商業用途。 未經作者書面許可，不得將本工具或其修改版本用於商業銷售、收費服務、商業產品整合或其他營利用途。

本工具為致敬「馴碼快手」操作理念而製作的公益工具，與原專案或原作者無隸屬、授權或官方關係。