macOS 繁體注音智慧混輸實驗版

花椰輸入法

以 McBopomofo 小麥注音 3.1（2496）為基底，加入中英混合輸入、個人詞庫快捷新增、iCloud 詞庫同步與個人安裝包，讓技術文件、Email、會議紀錄可以少按幾次切換鍵。

下載 DMG 查看 GitHub

版本: v1.2.0
分支: upgrade/mcbopomofo-3.1
安裝包: 2026-09-06

今天Meeting改到下午

ㄐㄧㄣㄊㄧㄢ Meeting ㄍㄞˇ ㄉㄠˋ ㄒㄧㄚˋ ㄨˇ

今天 Meeting 改到下午

不用一直切換 中文輸入過程可直接保留英文片段。

詞庫可擴充 熱鍵加入游標前的中文詞或英文字。

多機同步 詞庫放 iCloud 雲碟或私有 git repo，自動同步。

Dictionary Notes

詞庫說明

使用者詞庫

`data.txt`

放你自己手動新增的詞、片語與專有名詞，格式是 phrase reading。它會影響候選詞，也會參與英文 prefix 判斷。

英文白名單

`smart-mixed-ascii-words.txt`

放產品名、縮寫與常用英文 run，一行一個 ASCII 詞，不需要讀音。它主要用來讓智慧混輸更穩地認出英文片段。

同步方式

指向同步資料夾

輸入法直接讀寫你指定的詞庫資料夾，同步交給那個資料夾背後的服務，輸入法本身不對外連線。同一個 Apple 帳號用 iCloud 雲碟；不同帳號用私有 git repo，還多了版本歷史。

本機重載

重新載入使用者詞彙

輸入法會用 FSEvents 監看詞庫資料夾，iCloud 同步進來的變動通常會自動生效。若你剛手動改了 data.txt 或白名單想立刻套用，按這個選項即可。

白話流程

加完就好，不用按同步

在任何一台 Mac 新增詞彙，檔案就直接寫進 iCloud 雲碟，其他 Mac 由 iCloud 自動收到。沒有「同步」這個步驟要按。唯一要注意的是不要兩台同時離線編輯，否則 iCloud 會產生衝突副本。

排查結論

更新後若沒看到功能選單

如果切到花椰輸入法後只有勾選，卻沒有出現「關於花椰輸入法」等項目，通常不是你打字方式有問題，而是該 App 還握著舊的輸入法連線。最有效的處理是完整關閉那個 App 再重開。

Feature Map

目前可用功能

已完成

注音 / 英文混合模式

輸入中文時可直接插入英文片段，例如「今天Meeting改到下午」。支援大寫起始英文、常用小寫詞、全大寫縮寫與尾端數字。

部分完成

不按 Shift 的小寫英文

像 call、meeting、chrome、testing 這類合理英文 run 會延遲判斷並回溯成英文。

已完成

快捷加入個人詞庫

游標在詞尾時，用 Control + Shift + 數字 將前 N 個字元加入使用者詞庫；同位置重複可刪除。

已完成

私人詞庫多機同步

私人白名單與詞庫不進公開 GitHub。詞庫資料夾指向 iCloud 雲碟或私有 git repo，只有你的裝置讀得到，輸入法本身不對外連線，也沒有任何公開端點。

已完成

候選字順序可自訂

候選視窗開著時用 Option + ↑ / ↓ 把常用的字往上搬，順序記在 candidate-order.txt，跟著多機同步。只調整顯示順序，不影響整句斷詞。

沿用基底

候選字與標點輸入

保留 McBopomofo 原本的候選字、注音引擎、使用者詞庫、服務選單與標點相關能力。

規劃中

自動完成與框選查詢

下一階段目標包含下一詞預測、快捷文字本，以及框選文字後查翻譯、查單字與發音。

How To Use

使用方法與熱鍵

下面是目前版本最重要的操作。熱鍵以 macOS 實際偵測到的 modifier flags 為準，尚未嚴格限定左側 Control / Shift。

ControlShift5

加入游標前 5 個字元

游標在 Cloud 的 d 後方時按下，會將 Cloud 加入使用者詞庫。

ControlShift2

加入游標前 2 個中文字

游標在「字尾」後方時按下，會將「字尾」加入使用者詞庫。

同位置同熱鍵

刪除剛加入的詞

同一位置再次按相同熱鍵，會從使用者詞庫刪除該詞，並顯示提示視窗。

Option↑ / ↓

調整候選字順序

候選視窗開著時，把反白的候選字上移或下移一位。只能在同一個讀音內調整，碰到不同讀音的鄰居會發出提示音。

Shift-<>

輸入雙向箭頭

按住 Shift 依序按 - < > 會得到 ↔。只按前兩鍵是 ←，- > 是 →。

輸入法選單

重新載入使用者詞彙

立刻重讀 data.txt 與 smart-mixed-ascii-words.txt。多機同步交給 iCloud 雲碟，不需要在選單裡按任何同步動作。

Install

下載與安裝

目前提供個人測試用 DMG。它可以安裝在從未安裝過此輸入法的 Mac，也可以覆蓋舊版；安裝腳本會停止舊 process、替換 app bundle 並重新啟用輸入來源。

下載 Broccoli SmartInput v1.2.0 DMG 下載 PKG

打開 DMG，執行 Broccoli-SmartInput-v1.2.0-personal.pkg。
需要 macOS 13 Ventura 或更新版本。
若 macOS 顯示「Apple 無法驗證」，對 pkg 按右鍵選「打開」。
安裝後到「系統設定 > 鍵盤 > 輸入方式」確認花椰輸入法已加入。
若行為仍像舊版，登出再登入或重開機一次。
如果打開 DMG 後執行 PKG 碰到困難，請直接使用下方終端機指令，複製貼上即可完成安裝。

Advanced

終端機指令

完整安裝指令（推薦）

用終端機下載可以完全避開 Gatekeeper 的「無法驗證」：curl 取得的檔案不會被加上隔離屬性，瀏覽器下載的才會。

curl -L -o /tmp/broccoli.pkg https://github.com/CloudHua183/Broccoli-SmartInput/releases/download/v1.2.0/Broccoli-SmartInput-v1.2.0-personal.pkg
sudo installer -pkg /tmp/broccoli.pkg -target /
open ~/Library/Input\ Methods/McBopomofo.app

已經用瀏覽器下載好 PKG 的話，先複製到 /tmp 再移除隔離屬性——DMG 是唯讀磁碟區，直接對裡面的檔案下 xattr 一定會失敗：

cp ~/Downloads/Broccoli-SmartInput-v1.2.0-personal.pkg /tmp/broccoli.pkg
xattr -dr com.apple.quarantine /tmp/broccoli.pkg
sudo installer -pkg /tmp/broccoli.pkg -target /

設定多機詞庫同步

詞庫位置可以指向任何會自動同步的資料夾。同一個 Apple 帳號的多台 Mac 用 iCloud 雲碟最省事：

./script/migrate_to_icloud_dictionary.sh

若各台使用不同 Apple 帳號，改用私有 git repo。它同時提供版本歷史，詞庫被誤改時可以回溯：

./script/setup_dict_sync.sh git@github.com:YOUR_NAME/YOUR_DICT_REPO.git

Source

來源與開源基底

花椰輸入法是 McBopomofo 小麥注音的改造實驗版，保留原本注音引擎與 macOS Input Method Kit 架構，再加入智慧混輸與 iCloud 私人詞庫同步。

McBopomofo 原始專案 McBopomofo 官方網站 Broccoli SmartInput Repo

Release Notes

v1.2.0 更新

新功能

候選字順序可自訂

候選視窗開著時用 Option + ↑ / ↓ 把常用的字往上搬。順序記在 candidate-order.txt，跟著多機同步。只改顯示順序，不影響整句斷詞。

新功能

雙向箭頭 ↔

按住 Shift 依序按 - < > 得到 ↔，反向 - > < 也可以。原有的 ← 與 → 不變。

已改善

安裝指令修正

原本的終端機指令對唯讀的 DMG 磁碟區下 xattr，那不可能成功。改為直接用 curl 下載，從源頭避開 Gatekeeper 的「無法驗證」。

已改善

多機同步支援不同 Apple 帳號

除了 iCloud 雲碟，現在也可以把詞庫放進私有 git repo。跨 Apple 帳號可用，而且多了版本歷史。

Roadmap

下一步

候選列中加入「作為英文 / 作為注音」切換。
完整小寫英文 scanner 與 correction memory。
使用者詞庫管理 UI、匯入匯出與衝突提示。
自動完成、快捷文字本與框選查詢 companion app。
Apple Developer 簽章與 notarization。