學員最常問的 9 個問題

新酷音本體（包含 Windows / macOS / Linux 三平台的前端）與上游 chewing 引擎函式庫 libchewing，均以 GPLv2+ 開源授權釋出。對一般使用者而言，這代表你可以免費下載、安裝、使用、修改、重新散布新酷音，無需支付任何授權費或訂閱費。新酷音內部無任何付費功能、無廣告、無追蹤腳本，這是我們對 GPL 精神的堅持。

「GPLv2+」中的「+」代表「v2 或更新版本任選」——意即你或上游開發者可自由選擇採用 GPLv2 或 GPLv3 中的任一版本來散布。GPL 的核心限制僅在於：當你把修改後的版本散布給第三方（不限公司內外），必須連同原始碼以相同的 GPL 條款釋出，且不得附加額外限制。這就是 Copyleft 的「以源碼換自由」精神：你的改作可以商業使用，但你的改作也必須保持開源。

具體到日常使用情境，「個人使用者安裝在公司筆電上」「公司內 50 台電腦裝新酷音」「自製詞庫在公司 wiki 分享給同事」這些都不會觸發 GPL 開源義務——這些都屬於「內部使用」範圍。只有在你把新酷音修改版（例如加了企業專屬詞庫與浮水印）對外散布、販售、或放置於公開 GitHub 倉庫時，才需要同時釋出源碼。

新酷音目前支援 Windows 7 以上（含 Windows 10、11、Server 系列）、macOS 10.13 High Sierra 以上（含 Apple Silicon 原生）、Linux（含 Ubuntu、Debian、Fedora、Arch，桌面環境以 GNOME / KDE / XFCE 為主，需搭配 IBus 或 Fcitx5）、ChromeOS（透過 Linux 子系統）、純命令列環境（tmux / Vim / Emacs）。行動裝置方面，Android 平台有第三方 App（例如酷音輸入法的移植版）可呼叫 libchewing；iOS 因沙盒限制無原生輸入法外掛，需透過第三方鍵盤 App 整合。

對一般使用者來說，桌面平台覆蓋率已涵蓋 95% 以上情境。如果你使用特殊環境（例如 Chromebook、企業管理的精簡 Windows、企業內部的 Linux 嵌入式系統），請寫信到 [email protected]，我們會依你的具體情況評估可行性，並轉介給上游貢獻者協助。

值得一提的是，新酷音各平台的底層都呼叫同一份 libchewing 函式庫，因此你在不同裝置上看到的「候選字排序」「詞庫學習」「自動選字偏好」會是一致的，這也是新酷音被譽為「跨平台一致性最高的中文開源輸入法」的原因。

可以。新酷音的 GPLv2+ 授權明文允許商業使用，公司內部不論規模——5 人、50 人、500 人——都可自由安裝新酷音作為員工日常工作工具，無需支付授權費。這對過去使用商用輸入法（每年每裝置數百到數千元授權費）的企業 IT 部門來說，是直接可見的成本節省。

「商用」在新酷音的情境下有三個層次。第一層：作為員工日常打字工具（無需修改），這是完全自由的——裝多少台都沒問題。第二層：在公司內部 fork 一個客製版本（例如加上企業專屬詞庫、強制浮水印、整合企業 IM），這也是完全自由的——只要這個版本只在公司內部使用，不對外散布，就不觸發 GPL 開源義務。第三層：把客製版本散布給公司外部（含合作廠商、客戶、開源於公開 GitHub），此時必須連同源碼釋出，且衍生版本也須採 GPL。

實務上，大多數企業只會碰到第一、二層情境，這兩層都不需要付費或開源。如果你的企業需要更精細的授權諮詢（例如混合商用閉源元件），建議諮詢熟悉 GPL 的法律顧問，但根據本站 18 年觀察，極少數企業會真的走到第三層的灰色地帶。

轉換成本比你想像的低。新酷音沿用教育部標準注音符號（37 鍵或大千 40 鍵任選），鍵盤配置與微軟注音幾乎相同——你過去怎麼按，新酷音就怎麼按。最大的差別只有兩點：第一，候選字排序邏輯不同，新酷音依繁體中文詞頻排序，因此繁體常用詞（臺灣、香港、軟體、聲音）會比微軟注音預設更常出現在第一頁；第二，預設快捷鍵不同，例如新酷音的中英切換預設是 CapsLock，可改回 Shift；選字鍵預設是數字鍵 1-9，可改為方向鍵或空白鍵變體。

本站第 4 章「中英切換與快捷鍵」會完整教如何把新酷音調整成你熟悉的微軟注音操作模式；大多數學員在 3-7 天內就能完全適應，最慢的案例是 14 天。期間最常見的卡關點是「同音字排序」——例如你的名字在新酷音候選字第 5 位、在微軟注音第 1 位，這時只要在詞庫管理（第 6 章）手動加入一次，新酷音會從此優先把你的名字排在最前面。

相對地，新酷音能帶給你的新能力是微軟注音做不到的：自訂詞庫匯出、可程式化加詞、跨平台一致體驗、可 fork 客製化、以及未來若微軟終止某個 API 你也能繼續用下去。這些都是 GPL 開源的核心紅利。

可以。新酷音的個人詞庫主要由兩部分組成：使用者字典（userphrase.tbl，純文字格式）與學習資料庫（ chewing.sqlite3，SQLite 格式）。前者可直接以任何雲端同步工具（Dropbox、Syncthing、Google Drive、OneDrive、自架 Git）同步；後者會在每次啟動時合併學習資料，不會因為多裝置同步而遺失。

本站第 8 章進階「跨平台詞庫同步」會教三種主流方案：第一種是 Dropbox——把 `~/.config/chewing/`（Linux）、`%APPDATA%\Chewing\`（Windows）、`~/Library/Application Support/Chewing/`（macOS）整個資料夾符號連結到 Dropbox 對應路徑；第二種是 Syncthing——適合不想把個資放到第三方雲端的技術使用者；第三種是自架 Git——把 userphrase.tbl commit 到私有 GitHub repo，每天 cron 自動 pull 一次。三種方案我們都附完整排錯指南，包含 iCloud 路徑衝突、OneDrive 大檔同步卡住、Syncthing 多裝置檔案衝突時的具體處理步驟。

常見的同步陷阱是「學習資料庫在不同裝置上累積不同偏好」——例如在公司筆電常用 Word、在家桌機常用瀏覽器，兩處的詞頻排序會略有差異。這個現象是正常的，新酷音不會覆寫你的個人化資料；如果你希望「重置到某裝置的狀態」，只需把該裝置的 userphrase.tbl 複製過去、刪除其他裝置的版本即可。

新酷音預設詞庫已涵蓋《常用國字標準字體表》的 4,808 字與《次常用國字標準字體表》的 7,051 字，總計 11,859 字。這對日常使用已涵蓋 95% 以上的需求；但臺語用字（例如「𪜶」「𨑨迌」）、古典漢字（例如《康熙字典》收錄的字）、人名僻字（例如「煊」「燊」）可能落在預設詞庫之外。

遇到罕見字時，有三條處理路徑：第一，手動加詞——在新酷音選字模式下按 `Ctrl+Enter`（或 macOS 的 `Cmd+Enter`），即可把目前音節加入個人詞庫；第二，匯入社群整理的擴充詞庫——本站論壇與上游 chewing 倉庫 wiki 都有志工整理的「臺語漢字」「古籍用字」「姓氏僻字」詞庫包，可直接匯入；第三，回報給上游——若你發現的字在 unicode 中存在、但新酷音詞庫未收錄，請到 github.com/chewing/chewing/issues 開新 issue，附上字型檔、讀音、用法例句；上游核心維護者會在下個 release 補入。

罕見字處理最常見的誤區是「以為打不出來就是輸入法不支援」——其實很多時候只是預設詞庫沒收錄，並不代表底層引擎無法處理。新酷音底層使用 Unicode 14.0 全碼表，理論上任何 CJK Unified Ideographs 範圍內的字都能處理；差別只在於是否需要手動加詞或回報上游。

從 libchewing 0.5.x 系列升級到 0.6.0（包含 0.5.1、0.5.2、0.5.3 等版本），個人詞庫（userphrase.tbl）、學習資料庫（chewing.sqlite3）、快捷鍵設定、與候選窗外觀設定皆會自動保留。升級過程是無縫的，你只需下載新版安裝檔、執行安裝程式、依提示重新登入即可；不需要先匯出、再匯入。

從更舊版本（例如 0.3.x、0.4.x）升級時，建議遵循以下安全步驟：第一步，先用舊版新酷音的「匯出詞庫」功能把個人詞庫匯出成 .cin 檔，存到桌面或雲端硬碟作為備份；第二步，解除安裝舊版；第三步，安裝新版；第四步，用新版的「匯入詞庫」把 .cin 檔匯入。雖然多數情況下直接升級也能保留資料，但因為舊版的詞庫格式與新版有少數相容性差異（例如索引方式），先備份是最保險的做法。

另外，從其他輸入法（例如微軟注音、自然輸入法、谷歌注音）搬遷個人詞庫到新酷音時，雖然無法直接轉檔，但你可以用「批次加詞工具」一次匯入數千條詞——本站第 6 章與第 9 章會教具體做法，包含處理編碼差異（Big5 ↔ UTF-8）、篩選同音詞、與批次驗證。

可以。libchewing 提供完整的 C API（libchewing.h），可從 Python、Node.js、Java、Rust、Go 等語言透過 FFI（外部函式介面）呼叫。常見的整合場景有三類：第一類，內嵌輸入法——例如你的 App 需要一個自帶的中文輸入面板（不依賴作業系統輸入法框架），可直接 link libchewing，呼叫 `chewing_new()`、`chewing_handle_Default()`、`chewing_cand_String()` 等函式；第二類，命令列工具——例如批次處理文字檔時自動加上常用詞註解，可寫一支 CLI 呼叫 libchewing 自動加詞；第三類，自動化測試——例如驗證你的 App 在不同輸入法狀態下的 UI 表現，可用 libchewing 模擬鍵盤事件。

libchewing 是 GPLv2+ 授權，因此若你的 App 是閉源商用軟體、且會散布給第三方使用，link libchewing 會觸發 GPL 義務——你的 App 必須同樣以 GPL 釋出。常見的避險做法是「程序隔離」：把 libchewing 與你的 App 切分成兩個獨立程序、以 IPC 通訊，這樣只有 libchewing 程序需要 GPL，你的 App 仍可保持閉源。我們的進階章第 9 章會教完整的程序隔離設計與範例程式碼。

新酷音各前端本身也是 libchewing 整合的最佳範例——Windows 端、macOS 端、Linux 端的源碼都在 github.com/chewing 公開，建議開發者直接閱讀上游程式碼，比從零摸索 API 更有效率。

請到上游 github.com/chewing/chewing/issues 開新 issue，並附上：作業系統版本（Windows 11 23H2 / macOS 14.5 / Ubuntu 24.04 等）、libchewing 版本（可在「關於」對話框看到）、新酷音前端版本、重現步驟（含截圖或螢幕錄製更好）、預期行為、實際行為。上游核心維護者目前有 6 位活躍貢獻者，平均回覆時間 7-14 天；中文使用者回報會由本站志工協助翻譯成英文，並補上必要的環境細節。

緊急 bug（例如安裝後整個輸入法失效、特定 App 內無法打字、無法卸載）通常 1-3 天內就會有第一個回覆；非緊急 bug（例如罕見字排序不理想、特定快捷鍵不順手）可能需要排進下個 release 週期，每月一次。中度優先 bug（例如某個破音字候選順序錯誤）通常 2-4 週。

如果你不熟悉英文 issue 撰寫、或是公司環境不便使用 GitHub，可寫信到 [email protected]，主旨寫「[bug 回報] 簡述問題」，本站志工會在 3 個工作天內代為撰寫並提交到上游，並回信給你附上 issue 編號以便後續追蹤。我們不會代為修改程式碼，但會盡力協助你清楚描述問題。