故障排除

本指南涵盖您在使用 Neotask 时可能遇到的常见问题及解决方法。

许可证与激活

"Invalid license key"

• 验证密钥格式：SC-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX
• 检查是否有多余的空格或缺少的字符
• 确保有活跃的互联网连接
• 尝试仔细重新输入密钥

"License revoked"

• 您的许可证已被服务器撤销
• 在 neotask.ai 检查您的计费状态
• 如果您认为这是错误，请联系支持

"License expired"

• 您的订阅已失效
• 通过计费门户续订您的套餐
• 许可证过期后应用进入只读模式

"Offline grace period expired"

• 您已离线超过 72 小时
• 连接到互联网以自动重新验证
• 连接后应用将恢复正常运行

"Version blocked"

• 您的应用版本因安全原因被阻止
• 立即更新到最新版本
• 自动更新应提示您；如果没有，请从网站下载

网关问题

"Gateway failed to start"

1. 检查端口 18789 是否可用（未被其他应用使用）
2. 尝试重启应用
3. 从控制面板检查网关健康状态
4. 如果在 macOS 上，确保应用在系统偏好设置 > 隐私与安全性中有必要的权限

"3-strike lockout"

• 连续 3 次网关失败后，所有操作被阻止
• 重启应用以重置锁定计数器
• 如果持续存在，检查日志以查找底层错误

"Gateway disconnected"

• 本地运行时失去连接
• 在网关面板中点击"重新连接"
• 如果持续断开，请重启应用
• 检查是否有防火墙阻止 localhost 连接

语音问题

"No audio input detected"

• 授予麦克风权限：
  • macOS：系统偏好设置 > 隐私与安全性 > 麦克风 > 为 Neotask 启用
  • Windows：设置 > 隐私 > 麦克风 > 允许应用访问
• 检查麦克风是否静音
• 验证系统设置中选择了正确的输入设备

"Wake word not triggering"

1. 确保在设置中启用了语音激活
2. 检查唤醒模式是否设置为 "Porcupine"（不是 "Shortcut" 或 "Off"）
3. 清晰地说出唤醒短语："Hey Neotask"
4. 尝试使用键盘快捷键（Cmd+Shift+Space / Ctrl+Shift+Space）
5. 检查是否有其他应用在使用麦克风

"TTS audio choppy or delayed"

• 检查您的互联网连接（TTS 需要 ElevenLabs API）
• ElevenLabs 可能正在经历速率限制
• 尝试在设置中更换不同的声音
• 减少后台网络活动

"Voice shortcut not working"

• 其他应用可能已占用了相同的快捷键
• 在设置 > 激活 > 键盘快捷键中更改快捷键
• 在 macOS 上，检查系统偏好设置 > 键盘 > 快捷键中是否有冲突

连接与网络

"Cannot connect to server"

• 验证您的互联网连接
• 检查 neotask.ai 是否可在浏览器中访问
• 如果在企业防火墙后面，确保允许 HTTPS 流量
• 尝试暂时禁用 VPN

"API request failed"

• 检查您的互联网连接
• 验证您的许可证是否有效
• 如果使用 BYOK，检查您的 API 密钥是否有效且有余额
• 尝试刷新控制面板

代理与会话

"Cannot create agent: limit reached"

• 代理数量不按套餐设上限；创建自定义代理需要付费套餐
• 如果您在 Free 套餐上看到此提示，请升级到付费套餐以创建自定义代理
• 删除未使用的代理以保持工作区整洁

"Agent not responding"

• 检查网关健康状态（必须运行中）
• 验证代理的模型是否可访问（API 密钥有效、提供商可用）
• 检查每日预算 -- 如果超出，代理会在 UTC 午夜前暂停
• 尝试重置会话

"Session messages not loading"

• 刷新页面/应用
• 检查网关连接状态
• 如果会话很长，尝试创建新会话

计费与支付

"Payment failed"

• 验证您的卡信息是否正确
• 与银行确认是否阻止了国际交易
• 尝试不同的支付方式
• 如果问题持续，联系支持

"Usage allocation exceeded"

• 您的代理的 token 消耗已超过订阅中包含的分配
• 额外使用量按使用费率计费。查看控制面板中的使用页面了解详情。
• 切换到 BYOK 模式（使用您自己的 API 密钥）将 token 成本直接路由到您的提供商
• 设置每日预算限额以防止意外超额

"Plan not updated after payment"

• Stripe webhooks 可能有轻微延迟（通常不超过 1 分钟）
• 刷新控制面板
• 如果 5 分钟后仍未更新，请联系支持并提供您的付款确认

性能

"App slow on startup"

• 许可证验证和网关启动在启动时进行 -- 这是正常的
• 确保您的系统满足最低要求
• 关闭不必要的后台应用

"High CPU usage"

• 如果使用始终开启的唤醒词（Porcupine），它使用的 CPU 很少但可以禁用
• 不使用时暂停语音会话
• 在活动监视器/任务管理器中检查是否有卡住的网关进程

"High memory usage"

• 长时间的聊天会话会累积内存
• 定期创建新会话
• 重启应用以清除累积的状态

获取帮助

• 文档：您正在这里 -- 浏览知识库
• 支持：访问 neotask.ai/support 的支持页面
• 联系：使用网站上的联系表单
• 状态：在 neotask.ai 查看服务状态