使用
安裝前先知道:有已知漏洞
pickfit 在安裝時會一併裝上的套件裡找到 20 個已知的高風險或嚴重漏洞(OSV.dev,2026年11月3日),安裝前請先考慮。
pypi:anyio 4.12.1AnyIO:TLSStream 的 IDNA 2003 主機名稱編碼可能導致 TLS 憑證偽造 (GHSA-82r6-8w77-94w6,嚴重,4.14.2 已修正)pypi:certifi 2026.1.4certifi 打包了中繼 CA 金鑰已遭入侵的 emSign 根 CA (GHSA-6q48-6c7w-9gw2,嚴重,2026.10.18 已修正)
再看 8 個
npm:@xmldom/xmldom 0.8.13— GHSA-27p8-2357-5qqv(高風險),0.8.15 已修正npm:@xmldom/xmldom 0.8.13— GHSA-4w3w-2rp5-g8jm(高風險),0.8.14 已修正npm:@xmldom/xmldom 0.8.13— GHSA-8344-3jmq-59r6(高風險),0.8.15 已修正npm:@xmldom/xmldom 0.8.13— GHSA-93r5-fhx6-vmg9(高風險),0.8.15 已修正npm:@xmldom/xmldom 0.8.13— GHSA-965w-775f-mr7g(高風險),0.8.15 已修正npm:@xmldom/xmldom 0.8.13— GHSA-c7q8-3ch8-vqpv(高風險),0.8.15 已修正npm:@xmldom/xmldom 0.8.13— GHSA-w2rr-34g9-rvrj(高風險),0.8.14 已修正npm:@xmldom/xmldom 0.8.13— GHSA-x4fp-j954-r2f4(高風險),0.8.15 已修正
另有 10 筆未列出。
Linux x86_64
需要先準備
- 執行環境:
Python 3.10+,Node.js 22.12+
這些步驟是在家目錄裡一個已經存在的 work 資料夾裡跑的。請先建立它,再從那裡執行:
mkdir -p "$HOME/work" && cd "$HOME/work"git clone HoldSpeak 並執行 uv venv + uv pip install -e .(方案 1);llama-cpp-python 從原始碼建置約 3 分鐘
cd "$HOME"/work && rm -rf HoldSpeak && git clone --depth 1 https://github.com/karolswdev/HoldSpeak.git && cd HoldSpeak && uv venv && . .venv/bin/activate && uv pip install -e .
README 與實測不符之處
- README 寫: uv pip install -e . (Linux: uv pip install -e '.[linux]')
實際可行: 一般安裝成功;但 doctor 回報 'Transcription backend: Install Linux backend with pip install holdspeak[linux]',因此 Linux 上要有可用的轉錄後端需安裝 [linux] extra。未測試加裝 extra 的情況。
在 pickfit 驗證過的原始指令(沙盒裡實際執行的)
僅供查核:裡面是沙盒的家目錄 /home/sbx。
cd /home/sbx/work && rm -rf HoldSpeak && git clone --depth 1 https://github.com/karolswdev/HoldSpeak.git && cd HoldSpeak && uv venv && . .venv/bin/activate && uv pip install -e .cd /home/sbx/work/HoldSpeak && . .venv/bin/activate && which holdspeak && holdspeak --helpcd /home/sbx/work/HoldSpeak && . .venv/bin/activate && holdspeak doctor確認能用
cd "$HOME"/work/HoldSpeak && . .venv/bin/activate && which holdspeak && holdspeak --help輸出應包含「Examples:」。
先試試這個
cd "$HOME"/work/HoldSpeak && . .venv/bin/activate && holdspeak doctor它能做什麼
以下依據 README;pickfit 沒有逐項檢查。
- 按住按鍵即可在任何應用程式中聽寫文字未測試
- 轉錄會議並確認決策未測試
- 針對會議與專案提問未測試
- 將結果傳送到 GitHub、Jira 或 Slack未測試
pickfit 測到哪一步
Linux x86_64
- 可以安裝
- 可以啟動
- 能回應請求
- 可離線使用
macOS:專案說支援,但 pickfit 還沒試過。
適合用來
- 以快速鍵聽寫,在任何應用程式中輸入文字
- 錄製或匯入會議以進行轉錄
- 針對會議與專案提出有依據的問題
- 將摘要傳送到 GitHub、Jira、Slack 或電子郵件
可替代 superwhisper、MacWhisper、VoiceInk、Wispr Flow 和 Aqua Voice。
pickfit 怎麼測的
每次測試都從乾淨的機器開始,照上面的步驟執行。 pickfit 怎麼驗證
Linux x86_64
服務能回應請求
- 從頭重跑
- 可離線使用
- 檢查於 2026年11月16日
- 版本 0.4.0
測試機器遇到的差異
- README: a C++ compiler (the local model runtime builds from source)
測試中: uv pip install 時從原始碼建置 llama-cpp-python 0.3.37(約 3 分鐘);沙盒內的 gcc/g++/cmake 已足夠。 - README: holdspeak (launches web runtime)
測試中: 無頭環境下執行時輸出 'Voice typing hotkey unavailable',doctor 將 Global hotkey 標為 FAIL;加上 --no-open 網頁伺服器仍可執行。含每次執行專屬權杖的 URL 會印在日誌中。 - README: run holdspeak doctor if something does not work
測試中: doctor 回報 FAIL 項目時以 1 結束;在此沙盒中是需要桌面環境的快捷鍵與麥克風。結束碼 1 是 doctor 的回報,不代表安裝失敗。 - README: Set up local AI downloads the speech model and a starter language model (in the browser UI)
測試中: 未完成:預設 Dictation 模型為 Qwen3.5-4B-Q4_K_M.gguf,對推論檢查來說太大;本機模型要透過 Settings > Engines 介面設定,也找不到無頭的生成指令。