疑難排解
本指南涵蓋您在使用 Neotask 時可能遇到的常見問題及其解決方法。
授權與啟用
「授權金鑰無效」
- 驗證金鑰格式:
SC-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX - 檢查是否有額外的空格或缺少字元
- 確保您有可用的網際網路連接
- 嘗試小心地重新輸入金鑰
「授權已撤銷」
- 您的授權已由伺服器撤銷
- 在 neotask.ai 查看您的帳單狀態
- 如果您認為這是錯誤,請聯絡支援
「授權已過期」
- 您的訂閱已到期
- 透過帳單入口網站更新您的計劃
- 過期時應用程式進入唯讀模式
「離線寬限期已過期」
- 您已離線超過 72 小時
- 連接至網際網路以進行自動重新驗證
- 連接後應用程式將恢復正常運作
「版本已封鎖」
- 您的應用程式版本因安全原因已被封鎖
- 立即更新至最新版本
- 自動更新應該會提示您;如果沒有,請從網站下載
閘道問題
「閘道啟動失敗」
- 檢查連接埠 18789 是否可用(未被其他應用程式使用)
- 嘗試重新啟動應用程式
- 從儀表板檢查閘道健康狀態
- 如果在 macOS 上,請確保應用程式在系統偏好設定 → 隱私與安全性中具有必要的權限
「三次失敗鎖定」
- 連續 3 次閘道失敗後,操作被封鎖
- 重新啟動應用程式以重置鎖定計數器
- 如果問題持續,請查看日誌以找出根本錯誤
「閘道已斷開連接」
- 本地執行期失去連接
- 在閘道面板中點擊「重新連接」
- 如果持續斷開,請重新啟動應用程式
- 檢查是否有防火牆封鎖 localhost 連接
語音問題
「未偵測到音訊輸入」
- 授予麥克風權限:
- macOS:系統偏好設定 → 隱私與安全性 → 麥克風 → 為 Neotask 啟用
- Windows:設定 → 隱私 → 麥克風 → 允許應用程式存取
- 確認您的麥克風未靜音
- 在系統設定中確認已選擇正確的輸入裝置
「喚醒詞未觸發」
- 確保在設定中啟用了語音啟動
- 確認喚醒模式設定為「Porcupine」(而非「Shortcut」或「Off」)
- 清楚地說出喚醒短語:「Hey Neotask」
- 嘗試改用鍵盤快捷鍵(Cmd+Shift+Space / Ctrl+Shift+Space)
- 檢查是否有其他應用程式正在使用麥克風
「TTS 音訊斷斷續續或延遲」
- 檢查您的網際網路連接(TTS 需要 ElevenLabs API)
- ElevenLabs 可能遇到速率限制
- 嘗試從設定中選擇其他聲音
- 減少背景網路活動
「語音快捷鍵無效」
- 其他應用程式可能已佔用相同的快捷鍵
- 在設定 → 啟動 → 鍵盤快捷鍵中更改快捷鍵
- 在 macOS 上,在系統偏好設定 → 鍵盤 → 快捷鍵中檢查衝突
連接與網路
「無法連接到伺服器」
- 驗證您的網際網路連接
- 在瀏覽器中檢查 neotask.ai 是否可以存取
- 如果在企業防火牆後面,確保 HTTPS 流量被允許
- 嘗試暫時停用 VPN
「API 請求失敗」
- 檢查您的網際網路連接
- 驗證您的授權是否有效
- 如果使用 BYOK,請確認您的 API Key 有效並有配額
- 嘗試重新整理儀表板
代理程式與工作階段
「無法建立代理程式:已達到限制」
- 代理程式數量不受方案限制;建立自訂代理程式需要付費方案
- 如果您在 Free 方案上看到此訊息,請升級至付費方案以建立自訂代理程式
- 刪除未使用的代理程式以保持工作區整潔
「代理程式沒有回應」
- 檢查閘道健康狀態(必須正在執行)
- 驗證代理程式的模型是否可存取(API Key 有效、提供商可用)
- 檢查每日預算, , 如果超過,代理程式將暫停至 UTC 午夜
- 嘗試重置工作階段
「工作階段訊息無法載入」
- 重新整理頁面/應用程式
- 檢查閘道連接狀態
- 如果工作階段很長,嘗試建立新的工作階段
帳單與付款
「付款失敗」
- 驗證您的卡片詳細資訊是否正確
- 向您的銀行詢問是否有任何國際交易限制
- 嘗試其他付款方式
- 如果問題持續,請聯絡支援
「使用配額已超過」
- 您的代理程式 Token 消耗已超過訂閱中包含的配額
- 額外使用量按使用率計費。在儀表板的使用量頁面查看詳細資訊。
- 切換至 BYOK 模式(使用您自己的 API Key)以直接向您的提供商路由 Token 費用
- 設定每日預算限制以防止意外超額
「付款後計劃未更新」
- Stripe Webhook 可能有輕微延遲(通常不到 1 分鐘)
- 重新整理儀表板
- 如果 5 分鐘後仍未更新,請帶著您的付款確認聯絡支援
效能
「應用程式啟動緩慢」
- 啟動時會進行授權驗證和閘道啟動, , 這是正常的
- 確保您的系統符合最低要求
- 關閉不必要的背景應用程式
「CPU 使用率高」
- 如果使用始終監聽的喚醒詞(Porcupine),它使用極少的 CPU,但可以停用
- 不使用時暫停語音工作階段
- 在活動監視器/工作管理員中檢查是否有卡住的閘道程序
「記憶體使用率高」
- 長聊天工作階段會累積記憶體
- 定期建立新工作階段
- 重新啟動應用程式以清除累積的狀態
獲取幫助
- 文件:您在這裡, , 瀏覽知識庫
- 支援:在 neotask.ai/support 造訪支援頁面
- 聯絡:使用網站上的聯絡表單
- 狀態:在 neotask.ai 查看服務狀態