故障排除
本指南涵盖了您在使用 Neotask 时可能遇到的常见问题以及如何解决。
许可证与激活
"许可证密钥无效"
- 验证密钥格式：
SC-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX - 检查是否有多余空格或缺少字符
- 确保您有活动的互联网连接
- 尝试仔细重新输入密钥
"许可证已撤销"
- 您的许可证已被服务器撤销
- 在 neotask.ai 检查您的计费状态
- 如果您认为这是错误，请联系支持
"许可证已过期"
- 您的订阅已失效
- 通过计费门户续订您的套餐
- 许可证过期后应用进入只读模式
"离线宽限期已过期"
- 您已离线超过 72 小时
- 连接互联网以进行自动重新验证
- 连接后应用将恢复正常运行
"版本已阻止"
- 您的应用版本因安全原因已被阻止
- 请立即更新到最新版本
- 自动更新应该会提示您；如果没有，请从网站下载
网关问题
"网关启动失败"
- 检查端口 18789 是否可用（未被其他应用使用）
- 尝试重启应用
- 从控制面板检查网关健康状态
- 如果在 macOS 上，确保应用在系统偏好设置 → 隐私与安全性中具有必要的权限
"3 次失败锁定"
- 连续 3 次网关故障后，操作被阻止
- 重启应用以重置锁定计数器
- 如果持续发生，检查日志以查找底层错误
"网关已断开"
- 本地运行时失去连接
- 在网关面板中点击"重新连接"
- 如果持续断开，请重启应用
- 检查是否有防火墙阻止 localhost 连接
语音问题
"未检测到音频输入"
- 授予麦克风权限：
- macOS：系统偏好设置 → 隐私与安全性 → 麦克风 → 为 Neotask 启用
- Windows：设置 → 隐私 → 麦克风 → 允许应用访问
- 检查麦克风是否未静音
- 验证系统设置中选择了正确的输入设备
"唤醒词未触发"
- 确保在设置中启用了语音激活
- 检查唤醒模式是否设置为 "Porcupine"（不是 "快捷键" 或 "关闭"）
- 清晰地说出唤醒短语："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 webhooks 可能有轻微延迟（通常不超过 1 分钟）
- 刷新控制面板
- 如果 5 分钟后仍未更新，请携带支付确认联系支持
性能
"应用启动缓慢"
- 许可证验证和网关启动在启动时进行，这是正常的
- 确保您的系统满足最低要求
- 关闭不必要的后台应用
"CPU 使用率高"
- 如果使用始终监听唤醒词（Porcupine），它使用极少 CPU 但可以禁用
- 不使用时暂停语音会话
- 在活动监视器/任务管理器中检查卡住的网关进程
"内存使用率高"
- 长聊天会话会积累内存
- 定期创建新会话
- 重启应用以清除累积状态
获取帮助
- 文档：您在这里。浏览知识库。
- 支持：访问 neotask.ai/support 的支持页面
- 联系：使用网站上的联系表单
- 状态：在 neotask.ai 检查服务状态