Web App無需登入零後端100% 離線
詞庫生成器把 txt/CSV 格式的個人詞彙、姓名、地名、專業術語打包成新酷音相容的 .json 詞庫檔。上傳後所有處理都在你的瀏覽器內完成，檔案不會上傳到任何伺服器。我們從 2024 年起就堅持這個零後端原則，因為「詞彙」這種東西本質上是個人隱私。工具會自動做簡轉繁（OpenCC）、自動偵測分隔符、批次合併多檔，並用 libchewing 的 SDK 驗證每個詞的注音是否合理。輸出格式相容 chewing 5.0+ 的 userphrase 規範，下載後直接丟到 ~/.local/share/chewing/（Linux/macOS）或 %APPDATA%\chewing\（Windows）即可生效。
進階功能包含「重複詞過濾」（自動合併同字串但注音不同的條目）、「長詞優先排序」（4 字以上的詞排在前面，加快打長詞時的選字速度），以及「匯出整包 zip」一次把所有用戶詞打包成 timestamp 檔名的 zip，搭配我們的同步腳本就能無痛跨機搬遷。我們也支援命令列版本（Node.js 寫的 CLI），方便進階用戶在開機腳本裡自動跑。
使用步驟
- 把詞彙整理成 txt（每行一個詞）或 CSV（兩欄：詞、注音）
- 拖進網頁，或按「選擇檔案」
- 點「轉換」等 3~5 秒
- 下載 zip，解壓到 chewing 目錄
- 重啟輸入法（Linux 重新登入、macOS 從系統偏好切換、Windows 從工作列右鍵重啟）
系統需求
| 瀏覽器 | Chrome 110+、Firefox 115+、Safari 16.4+、Edge 110+ |
|---|
| 記憶體 | 10 萬詞約 80MB |
|---|
| 上限 | 單檔 50MB，總詞數 100 萬 |
|---|
| 相依 | 無（純前端 JS + WebAssembly OpenCC） |
|---|
HTML可搜尋可列印
新酷音官方把快捷鍵分散在 4 份 markdown 說明檔（輸入、切換、選字、進階）裡，新手常常找不到。速查表把所有 30+ 條預設快捷鍵整理成一張可搜尋的單頁，分組為「基本輸入 / 選字操作 / 詞庫管理 / 設定切換 / 進階」五大類，支援右上角即時搜尋（譬如打「shift」就只剩跟 Shift 有關的條目）。每條都有中英文兩種按鍵名、對應的 chewing 設定檔欄位名、以及「為什麼這樣設計」的小註解——譬如 CapsLock 切換中英之所以是預設，是因為 CapsLock 在鍵盤左上角、離 home row 最近、左右手都能壓。
另外我們內建「自訂熱鍵」說明段，告訴你怎麼在 ~/.config/chewing/chewing.ini 改 hotkey 設定、改完怎麼驗證生效。完成自訂後可以按「匯出設定」把我們自動產生的 chewing.ini 片段下載回去，避免一個個欄位手動改。詳見 shortcuts.html。
tar.gz12KB ~ 28KB相容 chewing 5.0+
3 套預設設定檔對應 3 種典型使用者：工程師（預設注音 41 鍵、選字緩衝開啟、Esc 直接送字不做詞庫預測）、文編（候選字 9 個一頁、Enter 選第一字、Space 翻頁、適合長文校稿時一直按 Enter）、學生（簡轉繁預設開啟、字頻學習開啟、容易記下課堂新詞）。每套設定檔都是一份完整的 chewing.ini 加 1~2 個自訂詞庫檔，tar.gz 打包。下載解壓到 ~/.config/chewing/ 覆蓋即可，建議先備份自己的舊 chewing.ini 以防萬一。
所有設定檔都附 README.md 解釋每個非預設值是為什麼、怎麼改回預設。我們也提供「diff 工具」網頁版本（首頁有入口），貼上你自己的 chewing.ini 跟我們的設定檔，會自動列出哪些欄位不同、影響是什麼，方便你增量採用而不是全盤覆蓋。
三套差異速覽
| 設定項 | 工程師 | 文編 | 學生 |
|---|
| 注音鍵盤 | 41 鍵 | 標準 | 標準 |
| 選字緩衝 | 開 | 關 | 開 |
| 簡轉繁 | 關 | 關 | 開 |
| 字頻學習 | 關 | 關 | 開 |
| 候選字數 | 9 | 9 | 9 |
| Enter 行為 | 送出首選 | 送出首選 | 送出首選 |
zip · 480KB含 PSDchewing 5.0+
5 套免費皮膚——琥珀（本站主色 #b45309）、墨綠（#0f5132）、霧灰（#6c757d）、夜青（#0a3d62）、米白（#f5f1e8）——涵蓋白天、夜晚、簡報三種使用情境。zip 內含 PNG 點陣圖（9 鍵 × 4 種狀態，總共 36 張）、對應的 chewing skin 設定檔（YAML 格式）、以及 Photoshop PSD 原始檔（圖層分好，方便改主色或換字型）。
所有皮膚的注音字型都使用 Noto Sans TC Regular，候選字使用思源宋體。字型本身採 SIL OFL 授權，附在 zip 內。如果你想要更換字型，PSD 圖層命名為 bopomofo 和 candidate，改完存檔、用 ImageMagick 一行指令就能批次輸出 PNG：convert skin.psd -resize 96x96 bopomofo-%d.png。完整教學見 github.com/xinkuyi-toolset/skin。
每季會發一版新配色。如果有想要的顏色（譬如「櫻花粉」「北歐藍」），到 issue tracker 許願，被按 5 個 👍 的配色我們就會排程。
bashSyncthingcron friendly
「在公司 Mac 學到 30 個新詞，回家打 Windows 怎麼沒有？」這個問題社群被問了 15 年。同步腳本基於 Syncthing（點對點、開源、無需中心伺服器）把 chewing/ 目錄在三台機器（Windows / macOS / Linux）之間雙向同步。我們包了 3 個 shell script：chewing-sync-init.sh（初次設定 Syncthing folder）、chewing-sync-watch.sh（每 5 分鐘檢查一次 diff）、chewing-sync-merge.sh（合併衝突的詞條，預設策略是「保留較長的詞、合併重複詞、衝突時印警告給使用者決定」）。
同步腳本最大的設計決定是「不做雲端」——詞彙屬於個人隱私，過任何第三方伺服器都令人不安。Syncthing 是 LAN / VPN 直連，詞彙資料從不離開你的機器群。Linux/macOS 用 launchd / cron；Windows 端用 Syncthing GUI 內建的排程器。同步衝突解決的設計原則我們在 MERGE.md 寫得很清楚，這裡不重複。
三平台路徑對應
Linux ~/.local/share/chewing/
macOS ~/Library/Application Support/chewing/
Windows %APPDATA%\chewing\
(本腳本會自動偵測平台並轉譯路徑)
Web App41 條 FAQlog 抓取指令
輸入法裝好之後「打不出字」「候選字不見」「快捷鍵失效」「皮膚變回預設」是新手最常見的 4 種症狀，每種都有 3~5 種可能原因。診斷助手是個問答式 Web App：你選症狀（多選）→ 選 OS → 選輸入法版本 → 它給出 3 步排查指令（譬如「打開終端機、執行 chewing-dump 把 log 貼到這裡」）並即時比對 FAQ 資料庫，給出可能原因清單與對應的 chewing.ini 欄位修改建議。
進階模式支援直接貼 log 文字——助手會用正則表達式匹配 chewing log 常見的錯誤模式（ERR_CANDIDATE_EMPTY、WARN_HOTKEY_CONFLICT、FAIL_OPEN_DICT 等 18 種），給出對應的 wiki 條目連結。資料庫 41 條條目每條都有「症狀 / 原因 / 解法 / 預防」四段，2024 年起累積的 600+ 提問覆蓋率約 87%，未覆蓋的會直接建議到 GitHub issue 開新條目，並預先填好裝置資訊。