快捷碼與擴充表

Yabomish 提供兩套自訂機制——快捷碼與擴充表，讓你把常用的文字片段、指令、簽名檔綁定到短碼上，打幾個字母就能送出整段內容。

7.1 快捷碼系統

什麼是快捷碼？

嘸蝦米字表中，並非所有 2～4 碼的組合都有對應的字。這些「空碼」可以拿來綁定你自訂的文字，稱為快捷碼。

打碼 → 空白鍵送出，就像打一般的字一樣，只是送出的是你預先設定的整段內容。

適用情境

提示：內容中可使用 \n 表示換行，送出時會自動轉為實際的換行字元。

管理方式

快捷碼在設定程式（YabomishPrefs.app）的「快捷碼」分頁中管理：

1. 新增：輸入 2～4 碼的編碼與對應內容，按下「加入」。系統會自動檢查該碼是否已被字表佔用，若衝突會提示你換一個碼。
2. 搜尋與刪除：列表上方有搜尋欄，可快速找到並刪除不需要的快捷碼。
3. 匯入匯出：支援 tab-separated 的 .txt 檔案，方便備份或與他人分享。

匯入匯出的檔案格式為每行一筆，編碼與內容之間以 Tab 分隔：

agpt	請用繁體中文回答，並附上參考來源
asig	—\n王大明\n大明科技 技術長\nming@example.com
alog	print("DEBUG: \(#function) line \(#line)")

設定程式底部會顯示目前 4 碼空碼的剩餘數量，讓你知道還有多少碼可以使用。

7.2 擴充表系統

快捷碼的底層其實就是擴充表的一部分。Yabomish 的擴充表系統讓你用純文字檔擴充輸入法的內容。

檔案位置

~/Library/YabomishIM/tables/*.txt

此資料夾下的所有 .txt 檔案都會被載入。安裝時預設包含 Emoji 聯想表。

檔案格式

每個擴充表都是 tab-separated 的純文字檔，一行一筆：

編碼<Tab>內容

例如：

agpt	請用繁體中文回答，並附上參考來源
asig	—\n王大明\n大明科技 技術長
xhrt	❤️
xstr	⭐

快捷碼與擴充表的關係

透過設定程式管理的快捷碼，實際上儲存在：

~/Library/YabomishIM/tables/user_shortcuts.txt

你也可以直接用文字編輯器修改這個檔案，效果完全相同。

即時重載

修改擴充表檔案後，不需要重新啟動輸入法。只要在輸入狀態下打：

,,RL + 空白鍵

即可即時重載所有擴充表，修改立刻生效。

7.3 iCloud 同步

如果你有多台 Mac，可以透過 iCloud 同步快捷碼和學習資料，讓每台電腦都保持一致的輸入體驗。

設定方式

在設定程式中，可以指定一個同步資料夾（例如 iCloud Drive 中的某個目錄）。

同步內容

設定完成後，所有同步資料夾內的變更會透過 iCloud Drive 自動在多台 Mac 之間同步。在任何一台電腦上新增的快捷碼或累積的字頻學習，都會反映到其他電腦上。

注意：字表檔案（liu.cin / liu.bin）不在同步範圍內，每台電腦需各自匯入。

實用技巧

• 命名慣例：建議快捷碼以特定前綴開頭（如 a），避免與日常打字衝突。
• 多行內容：善用 \n 換行，可以把整段簽名檔或模板塞進一個快捷碼。
• 團隊共享：把擴充表匯出後分享給同事，大家就能用同一套快捷碼。
• 分類管理：你可以在 tables/ 下建立多個 .txt 檔案，依用途分類（如 work.txt、emoji.txt），方便管理。