v1.0.2

v1.0.2

✨ 新功能

設定視窗顯示版本號

• 開啟「設定 → 一般」，最底部新增「關於」區塊
• 顯示目前版本，例如 1.0.2 (build 3)
• 版本號直接從 app bundle 讀取，永遠準確

🛠 改進

DMG 檔名帶版本號

• 發布的安裝檔現在命名為 TypelessMLX-1.0.2.dmg，方便辨識版本
• build-app.sh 自動從 Info.plist 讀取版本號，每次 build 都對應正確版本

---

累積修復（自 v1.0.0）

版本	修復
v1.0.1	外接麥克風 format mismatch crash
v1.0.1	無麥克風時顯示友善錯誤訊息
v1.0.1	build-app.sh 簽章穩定性（TCC 授權不消失）
v1.0.2	設定視窗顯示版本號
v1.0.2	DMG 檔名帶版本號

v1.0.1

v1.0.1

🐛 修復項目

修復外接麥克風造成的 crash（PR #3）

• 舊版在安裝錄音 tap 前就依據硬體格式建立 WAV 檔，某些外接麥克風實際回傳的格式不同，導致 AVFAudio format mismatch crash
• 改為在收到第一個音訊 buffer 後才開啟 WAV 檔，使用 tap 實際回傳的格式，徹底消除 crash

無麥克風時顯示友善錯誤訊息（PR #4）

• 舊版在無可用麥克風時會進入 CoreAudio 底層錯誤流程，顯示難以理解的系統錯誤
• 現在在錄音前先用 CoreAudio API 檢查是否有可用的輸入裝置
• 無麥克風時立即顯示「找不到可用的音訊輸入裝置，請連接或選擇麥克風」

修正 README 日誌路徑（PR #1）

• 日誌路徑錯誤標示為 ~/.Library/...，修正為正確的 ~/Library/Logs/TypelessMLX/

改善 build-app.sh 簽章穩定性（PR #5）

• 舊版每次 build 使用 ad-hoc 臨時簽章，macOS TCC 每次 rebuild 後都視為新 app，Accessibility / Input Monitoring 授權會消失
• 改為自動偵測 Keychain 中的 Apple Development 憑證進行簽署
• 開發者可設 ALLOW_ADHOC_SIGNING=1 進行臨時測試

TypelessMLX v1.0.0

TypelessMLX — macOS 語音聽寫 App

按住快捷鍵說話，文字自動打入任何輸入框。使用 MLX Whisper 在 Apple Silicon 上完全離線運算，無任何雲端連線。

主要功能

語音聽寫
按住右 Option 鍵開始錄音，放開即停止，辨識結果自動貼入游標所在的輸入框。支援切換模式（按一下開始，再按一下停止）。

多模型支援

• macOS 內建語音辨識 — 免下載、零設定，開啟即用（預設）
• Breeze-ASR-25 — 台灣中文優化，由聯發科研究院開發，繁體中文效果最佳（~1.8GB，首次選用時自動下載）
• Qwen3-ASR-0.6B — 中文高精度（~1GB，首次選用時自動下載）
• Whisper Large v3 / Medium / Small — 多語言支援

文字後處理

• 自動標點符號補全
• Apple Intelligence 文字修正（需 macOS 26+）
• 語助詞過濾（自動移除「呃」「嗯」等猶豫音）
• 自訂詞典（注入專有名詞提升辨識精度）
• Initial Prompt 引導辨識風格

其他

• 完全離線，所有推理在本機完成
• 系統選單列常駐，輕量不佔 Dock
• 支援多輸入裝置選擇
• 聽寫歷史記錄（最多 200 筆）
• 開機自動啟動

系統需求

• macOS 13.0 Ventura 以上（建議 macOS 26+ 以使用 AI 文字修正）
• Apple Silicon（M1 或以上）

安裝方式

1. 下載 TypelessMLX.dmg，拖入 /Applications
2. 首次啟動後點「開始安裝」，自動建立 Python 環境（約 1–2 分鐘）
3. 授權麥克風及輔助使用權限
4. 按右 Option 開始聽寫

預設使用 macOS 內建語音辨識，無需下載任何模型即可立即使用。