跳到主要內容
What's up my neighbor.下載 macOS 版
開發者文件目錄第 1 / 6 篇

  1. 認識專案

    1. 專案定位與平台狀態
    2. 架構與資料流

  2. 動手開發

    1. 開發環境與本機建置
    2. 測試方式與驗證範圍

  3. 參與與發布

    1. 參與方式
    2. 版本、更新、授權與隱私

專案定位與平台狀態

What's up my neighbor 是什麼、刻意不做什麼、三個平台目前的實際進度，以及原始碼放在哪裡。

適用平台
macOSWindowsiPhone
對照版本
macOS 1.4.5（build 1012）
最後更新

內容來源：macOS repo README.md、Windows repo README.md 與 VALIDATION.md、iPhone 開發版 README.md（2026-10-19 核對）。網站展示經審閱的固定版本，最新內容以 repo 為準。

一句話

What's up my neighbor 是一個語音輸入工具：在任何輸入框按快捷鍵說話，再按一次結束，文字就回到原本的游標位置。陪伴使用者的是一隻叫 Yui 的小黑貓。

設計原則

這幾條是產品的底線，改動前會先在 Issue 討論：

  • 只做語音轉文字。文字處理是本機固定規則（簡繁、標點、空格、語助詞），不使用聊天模型，不摘要、不改寫。
  • 本機快捷鍵永遠不按 Enter。只有 iPhone 接力中，使用者在手機上明確按「貼到 Mac 並送出」，Mac 再驗證一次目標後才會送出。
  • 剪貼簿優先。文字一定先放進剪貼簿，驗證輸入目標後才自動貼上；驗證不過就停在剪貼簿，不貼到別處。
  • 資料去向說清楚。錄音直接從使用者的裝置傳到 Groq，不經過開發者的伺服器；沒有帳號系統、分析工具或廣告 SDK。
  • 使用者自備 Groq API Key。金鑰存在系統鑰匙圈，App 不代管、不轉售額度。

平台狀態

平台版本狀態證據與限制
macOS1.4.5（build 1012）已發布GitHub Release 提供安裝包、SHA-256 與 Sparkle 更新；免費簽章，未經 Apple 公證
Windows0.1.0-beta.1預發布測試版CI 通過離線核心與平台測試、受控桌面 UI 測試，以及安裝、升級、移除流程；真實 Windows 10／11 的麥克風、藍牙、輸入法與第三方 App 尚未實機驗收
iPhone0.6.0（7）開發中，未發布已完成個人簽章安裝與首次啟動；兩台實機配對、收音與貼上尚未驗收，不提供下載

狀態只在該平台自己的建置與實際操作驗收都通過後才升級。

功能範圍（macOS 1.4.5）

類別內容
錄音自訂全域快捷鍵（預設 ⌥↑）、16 kHz 單聲道 AAC、指定麥克風並排除 iPhone 連續互通麥克風、單段最長 5 分鐘、選用靜音自動停止
辨識Groq whisper-large-v3；語言設定（主要語言加最多兩個混用語言）；未允許語言時自動重試一次
文字處理純逐字（預設）、標準、簡潔三種模式；中文數字轉換（選用）；法律用語保護
輸出剪貼簿優先、輸入目標驗證、模擬 ⌘V；失敗時保留錄音供重新辨識
本機工具最近 10 筆剪貼簿歷史（⌃⌥V）、詞典管理與貼上後修正學習
小黑貓錄音浮窗（左眼取消、右眼完成）、招呼彩蛋、可選的桌面小黑貓（1.4.5 起可點擊回應、抓起與放下）、cat.config.json 自訂
更新Sparkle 每日檢查，由使用者決定是否安裝
選用iPhone 接力（Mac 端功能存在，每次啟動預設關閉；iPhone App 尚未發布）

不在首版範圍

  • 公開 API、SDK、外掛系統。
  • 多人會議逐字稿、說話者區分、摘要（本機研究中，列在 Roadmap 的 Explore）。
  • 離線辨識（探索候選）。
  • App Store 上架與 Apple 公證。

原始碼

Repo內容授權
whats-up-my-neighbor-ai-input-macosmacOS App（Swift、AppKit、AVFoundation）MIT
whats-up-my-neighbor-ai-input-windowsWindows 測試版（C#、.NET Framework 4.8）MIT

macOS 與 Windows 在 2026-10-18 拆成兩個獨立 repo，各自測試與發布。舊網址 groq-ai-voice-input-macos 會轉址到新的 macOS repo，已安裝的 App 仍透過它讀取更新清單，所以這個舊名稱不會被重新使用。

名稱

  • What's up my neighbor：產品名稱，也是 macOS App 顯示的名字。
  • Yui：小黑貓的名字。
  • YUI Neko：早期設計稿使用的名稱，現在不再對外使用。
  • AI語音輸入.app、Groq-AI-Voice-Input-macOS-*.zip、以及 App 的 Bundle ID：為了讓既有使用者能順利更新而保留的舊識別，改動屬於發布相容性工作，不會隨文件一起修改。

內容和 App 畫面對不上，或步驟走不下去？可以到 GitHub Issues 告訴我們是哪一篇、哪一步。