🍙 UCL_LIU (肥米輸入法)

利用 Python + PyHook 開發的仿蝦米輸入法，旨在提供穩定、輕量且高度自定的輸入體驗。

---

測試在 Windows 11 下正常運作

📺 觀看介紹影片

使用 TSF 出字模式時，請記得將 Windows 輸入法切換為「UCLLIU TSF Bridge」

---

🚀 快速開始 (Download)

Important

提醒： 如果遇到無法正常出字的視窗，請嘗試將肥米輸入法關閉，點擊右鍵選擇 「以系統管理員身分執行」。

檔案名稱	下載連結	說明
uclliu.exe	立即下載	v1.68 Beta 主程式 (建議使用)
uclliu.zip	立即下載	v1.68 Beta 壓縮版
穩定版 (v1.66)	exe / zip	穩定版備份
同音字庫	pinyi.txt	放在 exe 旁即可啟用同音字查詢
打字音效	wavs.zip	解壓後將 0~9.wav 與 exe 放一起

註：因版權問題，不提供字根檔 (liu-uni.tab, liu.cin, liu.json)，請自行準備。

---

✨ 核心特色

🌉 TSF Bridge 出字模式 (實驗性)

為了解決現代應用程式 (如 Chrome, Edge, VS Code, Line) 在傳統模擬輸入模式下上字不穩定或光標跳動的問題：

1. 在選單開啟「TSF 出字模式」。
2. 將 Windows 右下角輸入法切換為 「UCLLIU TSF Bridge」。
3. 享受如原生輸入法般的穩定上字體驗。 （初次使用需管理員權限進行註冊，出字失敗會自動 Fallback 回原本流程）

🎮 遊戲模式 (,,,lock)

針對遊戲環境（如 CS:GO），當需要按住 Shift 消音走路時，避免觸發輸入法切換。

📝 強大的字根支援

支援多種來源的字碼表：

• 官方 7.0.4 / 7.0.5 / 嘸蝦米 J (liu-uni.tab)
• PIME / RIME 字根表 (liu.json, liur_trad.dict.yaml)
• fcitx / 泰瑞版小小輸入法表格 (boshiamy.txt)
• 支援韓語字根與 CJK 特殊符號

---

🛠️ 使用與安裝

1. 基本安裝：
   • 下載 uclliu.exe。
   • 將 liu-uni.tab 或 liu.cin 或 liu.json 任一檔案與 uclliu.exe 置於同一目錄。
   • 執行 uclliu.exe。首次執行會自動進行轉檔（約 30~60 秒）。
2. 同音/注音查詢：
   • 下載 pinyi.txt 並置於同目錄。
   • 使用「'ucl」查詢同音字。
   • 使用「';zo6」進入注音查詢模式。
3. 熱鍵說明：
   • ,,,unlock：回到正常模式
   • ,,,lock：進入遊戲模式
   • ,,,c / ,,,t：切換簡體/繁體
   • ,,,s / ,,,l : UI 縮窄/拉寬
   • ,,,+ / ,,,- : UI 放大/縮小
   • ,,,x / ,,,z : 反白文字進行「字根轉文字」或「文字轉字根」

---

⚙️ 環境設定與 FAQ

建議的語言設定 (Windows 10/11)

強烈建議安裝「ENG (United States)」語系，並將其上移至第一順位，這樣打字時就不會被微軟新注音干擾。

點擊展開圖解說明

在 Win11 中甚至可以直接移除微軟注音，只留 ENG 與肥米，體驗最清爽。

UCLLIU.ini 設定說明

參數	說明
short_mode	是否為短版模式 (0/1)
zoom	UI 縮放大小 (如 0.90)
send_kind_1_paste	設定特定程式 (如 putty.exe) 強制使用「複製貼上」出字
tsf_bridge_enable	是否啟用 TSF Bridge (0/1)
play_sound_enable	打字音效開關

---

👨‍💻 開發者資訊

技術棧 (Tech Stack)

• Python 2.7 (32-bit): 核心邏輯
• PyGTK: UI 介面
• PyHook / PyWin32: 按鍵攔截與視窗控制
• TSF Bridge (C++): 支援 Windows Text Services Framework

自行編譯 (Build)

1. 安裝 Python 2.7.13 (x86) 並設定環境變數。
2. 安裝 p27/ 目錄下的所有依賴組件。
3. 執行 pip install psutil configparser pyaudio pyinstaller==3.4。
4. 執行 build.bat 產出 dist/uclliu.exe。
5. TSF Bridge 編譯：執行 build_tsf.bat (需 VS 2022 C++ 環境)。

🤖 GitHub Actions 自動化編譯與發布

本專案已整合 GitHub Actions。當您推送 Tag（如 v1.68）或手動觸發工作流時，GitHub CI 平台會自動：

1. 使用 windows-2022 執行器。
2. 靜態安裝 p27/ 目錄下的 Python 2.7 與 PyGTK MSI 安裝套件。
3. 解壓並配置 pywin32 與 pyHook 至 site-packages。
4. 安裝本地的 .whl 與 PyInstaller 3.4。
5. 編譯 TSF Bridge (x64/x86) DLL 並呼叫 build.bat 打包為 uclliu.exe。
6. 自動打包成 ZIP 並建立 GitHub Release 上傳發布。

詳細配置請參閱 .github/workflows/build-and-release.yml。

---

📜 更新記錄與計畫

最近更新 (v1.68)

• Release build 修正：修正 GitHub Actions 產出的 exe 缺 PyGTK/pywin32 runtime 而無法啟動。
• SHA256 依賴檢查：CI 使用 p27/SHA256SUMS.txt 先驗證 vendored Python 2.7 依賴。
• PyGTK / pywin32 安裝驗證：CI 會驗證 gtk/gobject/pango/win32api/pythoncom/pyHook 可匯入。
• 打包內容檢查：發布前確認 exe 內含必要 PyInstaller entry，避免壞包被上傳。

查看完整歷史更新記錄

(2025-12-23) v1.66 版：
1. 205、chrome 瀏覽 term.ptt.cc 有時標題會變成 ws.ptt.cc，導致出字失敗

(2025-10-30) v1.65 版：
1. 198、自定詞庫字體顯示支援「🅅 U+1F145」、「☒ U+2612」
2. 199、自定詞庫視窗左上角，顯示「肥」Icon
... (此處省略數百行，詳見下方原始歷史區)

---

📝 原始詳細說明備存 (包含所有寶貴資料)

點擊展開詳細技術說明、FAQ 與 ToDo List

目前支援的字碼表來源：

1. 官方 7.0.4 / 7.0.5 / 嘸蝦米 J (liu-uni.tab)
2. PIME liu.json
3. fcitx 嘸蝦米表格
4. 泰瑞版小小輸入法
5. RIME 字根表 ...等

開發工具與依賴：

• Python 27 (32BIT)
• pyhook, pygtk, pywin32
• psutil, pyaudio
• (Third party) php.py, portalocker.py, SendKeysCtypes.py
• (Third party) liu_unitab2cin.py, cintojson.py

完整歷史更新記錄：

詳細的版本演進記錄請參閱 CHANGELOG.md。

ToDo List：

• (Done) 送出字元方法優化
• (Done) 遊戲模式
• (Done) 同音字查詢
• (137) 相關字詞推薦功能
• (174) 表情、符號快選選單

---

💖 致謝

感謝 Benson9954029 與所有回報問題的網友 (klt, Chuanhuan, ym, Allen, robert820, hrcspkla 等)。

作者： 羽山秋人 (3wa.tw) / Benson9954029 信箱： uclliu.3wa@gmail.com 版權： 完全免費的 MIT-License