macOS 嘸蝦米輸入法 — 純 Swift、零依賴、離線聯想。
📖 使用手冊
- macOS 14.0+（Apple Silicon）
- Xcode Command Line Tools
- 嘸蝦米 CIN 字表（
liu.cin，使用者自行取得）
git clone https://github.com/FakeRocket543/yabomish.git && cd yabomish && ./yabomish.sh選擇 1) 完整安裝、2) 精簡安裝 或 3) 極簡安裝。
| 模式 | 說明 | 大小 |
|---|---|---|
| 完整安裝 | 含聯想語料（28 專業詞典 + bigram/trigram + 詞庫） | ~98MB |
| 精簡安裝 | 無專業詞典，仍有成語、用語、兩岸用詞聯想 | ~18MB |
| 極簡安裝 | 無聯想、無詞庫，僅打字＋查碼＋繁簡轉換＋字頻排序 | ~2MB |
安裝過程會：
- 編譯輸入法（YabomishIM.app）和設定程式（YabomishPrefs.app）
- 安裝到
/Library/Input Methods/和/Applications/
安裝完成後：
- 系統設定 → 鍵盤 → 輸入方式 → 加入「Yabomish」
- 首次切換會引導匯入
liu.cin - 匯入完成後顯示「空白鍵送字 ｜ Shift 切英文 ｜ ,,H 說明」提示
設定程式 → 匯入字表⋯ → 選擇 liu.cin（裝置端編譯為 .bin，不上傳、不外流）
| 操作 | 按鍵 |
|---|---|
| 送字 | 空白鍵 |
| 選字 | 1–9 |
| 補碼 | v/r/s/f（第 2–5 候選） |
| 萬用碼 | *（Shift+8） |
| 頓號 | vv + 空白鍵 |
| 中英切換 | 快按 Shift（composing 中會先清除字根） |
| 暫時英文 | 按住 Shift |
| 全型空格 | Shift+Space |
| 命令模式 | ,, + 命令碼 + Space |
| 注音查碼 | ,,ZH |
| 拼音查碼 | ,,PYS / ,,PYT |
| 同音字 | ,,TO |
| 送出原始碼 | Enter |
完整使用說明見 docs/usage.md。
- 硬體 keyCode 對應 — Dvorak、Colemak、AZERTY 等非 QWERTY 鍵盤正常運作
- CIN 字表裝置端編譯 —
.cin匯入後在裝置上編譯為.bin二進位格式（mmap zero-copy 載入） - 安全輸入偵測 — 密碼欄位自動停用
- 模糊匹配 — 鄰鍵容錯，打錯一碼也能找到候選字
- 游標跟隨模式 — 毛玻璃垂直列表，跟隨輸入游標（可切換橫向排列）
- 固定位置模式 — 水平列，可拖曳、右鍵調整對齊/透明度
- 多螢幕支援 — 自動偵測所在螢幕，GPU 終端無效座標時 fallback 固定模式
- 全螢幕 App 相容 — tmux/Ghostty 中正常顯示
- VoiceOver 無障礙 — 候選字窗支援螢幕朗讀
- 高對比模式 — 候選字加粗＋文字陰影（設定程式開啟）
輸入 ,, + 命令碼 + 空白鍵觸發：
| 命令 | 模式 |
|---|---|
,,T |
繁中（預設） |
,,S |
簡中 |
,,SP |
速打（僅最短碼） |
,,SL |
慢打（僅最長碼） |
,,TS |
繁→簡轉換 |
,,ST |
簡→繁轉換 |
,,J |
日文假名 |
,,ZH |
注音查碼 |
,,PYS |
拼音查碼（簡體） |
,,PYT |
拼音查碼（繁體） |
,,TO |
同音字查詢模式 |
,,RS |
重置字頻統計 |
,,RL |
重載字表＋擴充表 |
,,PIN |
固定同碼字排序 |
,,UNPINx |
解除碼 x 的固定排序 |
,,C |
顯示當前模式 |
,,SG |
聯想開關 |
,,Xxx |
語境切換（預設：df/tw/ch/tc） |
,,XS |
儲存當前語境 |
,,XI |
顯示當前語境 |
,,XRS |
重置語境（= ,,XDF） |
,,H |
命令說明 |
,,V |
貼上純文字（去格式） |
,,VT |
貼上簡→繁 |
,,VS |
貼上繁→簡 |
三層架構，送字後自動建議下一個字／詞：
- 詞級語料 — 可切換萌典（教育部辭典）、維基百科斷詞、新聞斷詞
- 詞庫 — 12 一般詞庫（NER 詞組、萌典詞組、成語、晶晶體、中國流行語、歇後語、台灣俗諺、客語辭典、台灣地名、學科術語、韓語漢字詞、日本熟語）＋ 28 個專業詞典（資訊、商業、醫學、法律⋯⋯，資料來源為樂詞網 NAER＋維基百科）
- 字級聯想 — bigram / trigram 預測下一字
- 三層順序可拖拉調整（詞級優先 / 詞庫優先 / 字級優先）
- 詞庫可逐一啟用／停用，拖拉調整優先順序
- 晶晶體（台式中英夾雜）為獨立聯想池
- Emoji 聯想（依前一字自動建議）
- 虛詞結尾自動停止聯想
- Unigram — 字頻學習（SQLite，每 500 次自動 decay）
- Bigram — 自適應 stupid backoff（bigram 命中用機率，未命中 fallback unigram × α，α 根據 session 內命中率自動調整）
- Trigram — 複合鍵
prev2|prev1存入 bigram 表 - 固定排序 —
,,PIN指定同碼字的固定順序，不受 decay 影響 - 用詞習慣 — 臺灣用詞 / 中式用詞切換（NAER 兩岸對照表），對側用詞降權
- 萬用碼
*（Shift+8）— prefix 預過濾加速 - 補碼
v/r/s/f— 選第 2–5 候選字 - 滿碼自動送字 — 可選，碼打滿且唯一候選時自動送出
';/直送 — 空閒時不攔截，方便寫程式和 slash command- 標點配對 — 打「自動補」（可選，macOS 預設關）
- 同音字自動退出 — 可選，預設關閉。同音字查詢選字後自動退出同音字模式，關閉時則須再次輸入
,,TO離開（設定程式「輸入」頁開啟）
~/Library/Application Support/Yabomish/tables/*.txt— tab-separated編碼<Tab>內容- 修改後打
,,RL+ Space 即時重載 - 支援 iCloud 同步資料夾共用
~/Library/Application Support/Yabomish/commands.json 可定義 ,, 開頭的自訂指令：
{
"sf": { "type": "open", "app": "Safari" },
"gh": { "type": "open", "app": "Ghostty" },
"ss": { "type": "shell", "run": "screencapture -x ~/Desktop/shot-$(date +%s).png" }
}open— 開啟/切換到指定 appshell— 執行任意 shell 命令（5 秒超時）,,RL重載字表時一併重載自訂指令- 內建指令優先於自訂指令
獨立 GUI 設定 App，五個分頁：
- 輸入 — 選字窗模式（含 demo 預覽）、聯想輸入、自動送字、拆碼提示、注音反查、同音字自動退出、模糊匹配、標點配對、固定同碼字排序
- 聯想與詞庫 — 語境切換器、用詞習慣、三層順序拖拉、詞級語料來源切換、一般詞庫與專業詞典啟用／排序
- 快捷碼 — 空碼綁定自訂文字／指令，新增與匯入時自動驗證碼長度（2–4 碼）及字表衝突
- 外觀 — 字體大小（滑桿+即時預覽）、透明度、高對比模式、蝦頭方向、Debug 模式
- 關於 — 使用方法、快捷鍵速查、語料來源與授權、版本號（亦可在 menu「關於 Yabomish 設定」查看）
| 輸入 | 聯想與詞庫 |
|---|---|
 |
 |
| 一般詞庫 + 專業詞典 | 專業詞典展開（28 本） |
|---|---|
 |
 |
| 快捷碼 | 外觀 | 關於 |
|---|---|---|
 |
 |
 |
首次開啟有三頁引導（匯入字表 → 加入輸入方式 → 常用快捷鍵）。
cd yabomish && ./yabomish.sh選擇 5) 移除 Yabomish。
~/Library/Application Support/Yabomish/：
| 檔案 | 說明 |
|---|---|
liu.cin |
嘸蝦米字表（使用者匯入） |
liu.bin |
編譯後的二進位字表 |
freq.db |
字頻學習資料（SQLite WAL） |
tables/ |
擴充表資料夾 |
tables/user_shortcuts.txt |
使用者自訂快捷碼 |
commands.json |
自訂 ,, 指令設定檔 |
user_phrases.txt |
使用者自訂詞組 |
debug.log |
Debug 日誌（開啟時） |
| 資料 | 來源 | 授權 |
|---|---|---|
| 注音對照表 | 威注音 VanguardLexicon | MIT |
| 繁簡對照表 | OpenCC | Apache 2.0 |
| 成語 | 教育部成語典 | 政府開放資料 |
| 台灣俗諺 | 教育部台灣閩南語常用詞辭典 | 政府開放資料 |
| 客語辭典 | 教育部臺灣客語辭典（六腔） | 政府開放資料 |
| 台灣地名 | 教育部本土語言標注臺灣地名 | CC-BY 3.0 TW |
| 台語學科 | 教育部臺灣台語學科術語 | CC-BY 3.0 TW |
| 兩岸用詞對照 | 國家教育研究院 樂詞網 | 政府開放資料 |
| 專業詞典 ×28 | 國家教育研究院 樂詞網 | 政府開放資料 |
| 歇後語 | chinese-xinhua | MIT |
| 韓語漢字詞 | Kengdic | MPL 2.0 / LGPL 2.0+ |
| 維基語料 | 中文維基百科 zhwiki dump | CC-BY-SA 3.0 |
| 新聞詞頻 | 國家教育研究院 新聞語料庫 | 政府開放資料 |
| 萌典字頻 | 萌典 | CC0 |
| Emoji | Unicode CLDR | Unicode License |
明碼語料及各自的授權、格式、build 指令詳見 yabomish_data/README.md。
展開看程式碼架構
YabomishIM/Sources/
├── AppDelegate.swift # IMKServer 啟動
├── YabomishInputController.swift # 按鍵處理、IMK 整合、session 管理
├── CINTable.swift # CIN 字表載入（mmap .bin + text fallback）
├── CandidatePanel.swift # 選字窗（游標/固定雙模式、VoiceOver）
├── FreqTracker.swift # 字頻學習（unigram + bigram + trigram + pinned、SQLite）
├── ZhuyinLookup.swift # 注音反查 + 同音字 + 拼音查碼
├── PhraseLookup.swift # NER 詞組 + 社群上下文（SQLite）
├── DataDownloader.swift # 語料下載（GitHub Release）
├── Prefs.swift # UserDefaults 偏好設定
├── DomainOrderManager.swift # 詞庫排序管理
├── DebugLog.swift # Debug 日誌
└── Shared/ # macOS / iOS 共用引擎
├── InputEngine.swift # 輸入引擎（狀態機、命令分派）
├── SuggestionEngine.swift # 三層聯想建議
├── CandidateRanker.swift # 候選字排序（字頻 + bigram + 用詞習慣）
├── WikiCorpus.swift # 語料查詢（trigram、NER、詞庫、emoji）
├── BigramSuggest.swift # 字級 bigram 建議（mmap .bin）
├── DomainMerger.swift # 詞庫合併
├── CINCompiler.swift # .cin → .bin 裝置端編譯
├── UserPhrases.swift # 使用者自訂詞組
├── IMEPreferences.swift # 偏好設定協定（可注入測試替身）
├── MemoryBudget.swift # 記憶體預算管理（iOS 60MB 限制）
└── Constants.swift # 路徑常數（App Group / Application Support）
YabomishPrefs/Sources/ # 獨立設定程式（SwiftUI）
├── main.swift
├── ContentView.swift # TabView（輸入/聯想與詞庫/快捷碼/外觀/關於）
├── PrefsStore.swift # @Observable UserDefaults 包裝
├── InputTab.swift # 用詞習慣、選字窗、輸入功能開關
├── SuggestionTab.swift # 聯想層順序、詞級語料、詞庫管理
├── ShortcutTab.swift # 空碼快捷碼綁定、匯入匯出
├── AppearanceTab.swift # 字型、透明度、高對比、蝦頭方向、Debug
├── HelpTab.swift # 使用方法＋快捷鍵速查＋語料授權
├── WelcomeView.swift # 首次使用引導
├── Typo.swift # 設計 token（字型、色彩、SectionDivider）
├── PinnedOrderSection.swift # 固定同碼字排序 UI
├── DomainCardView.swift # 詞庫卡片元件
└── DomainData.swift # 詞庫定義（6 一般 + 28 專業）
tools/ # 知識挖掘 Pipeline
├── wiki_ngram_pipeline.py # 維基 → ckip 斷詞 → n-gram 統計
├── wiki_ner_pipeline.py # 維基 → ckip NER → 實體抽取
├── wiki_kg_pipeline.py # NER × 條目標題 → 知識圖譜
├── wiki_word_bigram.py # 維基 → 詞級 bigram
├── wiki_category_extract.py # 維基分類抽取
├── build_ime_db.py # 組裝 → yabomish_ime.db
├── build_wbmm.py # 詞頻 → WBMM 二進位格式
├── build_zhuyin_tables.py # 萌典 + 字頻 → 注音候選排序
├── build_bigram_boost.py # bigram 加權表
├── build_jingjing.py # 晶晶體詞典
├── build_region_sets.py # NAER 兩岸對照 → region_tw/cn.txt
├── emoji_cin_patch.py # Emoji 擴充表
├── gen_pinyin_data.py # 拼音對照表
├── ime_prototype.py # 排序引擎原型測試
└── poc_char_embedding.py # 字向量 PoC
點開看開發日誌（有點長）
macOS 版暫時告一段落後，因為想用 iOS 版的 Yabomish，在處理的過程中發現 iOS 一定要有聯想輸入才方便，不用一直按，於是就開始試著做做看聯想式的輸入。
一開始用萌典，但覺得萌典不是那麼貼合生活使用。於是花了四天的晚上，把中文維基百科的 dump 給拆了——從詞條開始拆解，全文也拆解成 826 個知識領域、海量的實體、bigram、trigram。
裝上去之後發現麻煩不小，維基百科的冷門詞佔比過高，會造成 Yabomish 一直在觸發長詞。多次篩選後還是覺得不夠理想，過多的知識主宰了輸入法，就算做了類似 LLM 的知識領域加權排序，依舊令人厭煩。
本來想自行爬蟲爬取，但又覺得這不是辦法。剛好看到國家教育研究院有做各大報紙的詞頻統計，這總算解決了新詞與排序的需求。
那麼一不做二不休，樂詞網也來吧。樂詞網原本是做英文專有名詞對譯中文的，會有一詞多義的情況，因此我把樂詞網的詞目重新分割，變成單純的詞典。排除一大堆刻意編成的長句後，可用性大幅提高。
最後加入的材料是晶晶體。晶晶體很煩啊——一定是某個中文動詞 + 英文 + 中文，這是一種三明治式的嵌合短句，本質上晶晶體並非詞或成語。考慮台灣大量的晶晶體使用者，收集完材料後發現，大多數都是使用「拿」「用」「再」等常見的晶晶體術式發動動詞。要做成晶晶體聯想，一定要有一字觸發——打個「再」，就能接出「再幫我 Double Confirm。」
我本來想說，這樣就差不多了吧。
想不到三天後，我的學生在交出作業的當下，一路在走廊上大喊：牛逼！牛逼！太牛逼了，我的土話情話對話機器人接起來了。
眼前的情境促使我開始思考，我還能做些什麼。於是開始爬取中國流行用語，結合 GitHub 上收來的不明語料，還有維基中式網路流行語頁面清理後混合編輯。也把教育部語文研究成果網中的客語、台語歇後語，以及 GitHub 上原始語料授權不明的新華詞典歇後語也端進來了。
整體而言，這個版本的 Yabomish 是一份結合三層語境的重排序檢索器：
- 第一層：詞級語料 — 決定你的中文輸出風格。接近簡中式用法，還是台灣繁中用法；只用萌典常見詞、新聞用詞、或是維基百科海量專有名詞。
- 第二層：詞庫 — 決定你要接上哪些文體或句典。成語、歇後語、晶晶體、中國流行語、台語客語熟語、日本熟語、韓語漢字詞。
- 第三層：專業領域 — 28 個樂詞網專業詞典。資訊、醫學、法律、電機、機械、化學、物理⋯⋯
三層順序可拖拉調整，詞庫可逐一啟停。你的文化傾向與需求，由自己來排序。
當然，你可以完全不用這些東西——安裝時選擇精簡版，跟上一版幾乎完全一樣，想打什麼就打什麼，不會跳出聯想詞，完全不會被語料攻擊。
實際操作面的主要改動：
- Emoji 融入嘸蝦米碼 — 放棄五碼字輸出，打個「笑」就會有 🤣
- 放棄 ;' 等功能鍵 — agent 時代，更多人需要輸入指令、操作資料庫，沒有理由還要一直切換，多按一鍵 Shift 都不值得
- 查碼改用 ,, 命令 — 注音查碼
,,ZH、同音字查碼,,TO、拼音查碼,,PYS/,,PYT - 四碼短語擴充 — 嘸蝦米碼中沒有字佔位的四碼，可以拿來當指令或短語輸出。像我就拿來做常用的 AI prompt 指令、
sudo apt update && sudo apt upgrade、email 地址、常用 CLI 指令。輸入法與 prompt 系統混在一起用，連 alias 都不用寫，還可以帶著走 - 固定同碼字排序 — 全自動組字會把高頻字排前面，造成「手」「乎」互搶。最後只能新增
,,PIN功能，手動鎖死排列，避免傷害蝦米族的肌肉記憶
以上，希望大家會喜歡這次的更新。野心很大，token 不夠，時間更少。若有任何 bug，請發 issue 或直接提 PR。
咦，那 Yabomish iOS 呢？——做了，但還沒準備好。敬請期待。
MIT
本專案與行易有限公司無任何關係。「嘸蝦米」為行易有限公司之商標；其輸入法字表（liu.cin 及衍生之拆碼資料）為行易公司之智慧財產，本專案不含、不散布、亦不代為提供任何字表內容——使用者需自行合法取得字表並於裝置端匯入。專案內建之候選字排序、聯想語料皆來自公開授權資料來源（見上表），與行易字表無關。