故障排查与版本

记录版本与错误

node --version
kitta --version
kitta auth status --json

反馈时附上 CLI 与 Node 版本、操作系统、脱敏命令、退出码和错误中的 requestId/taskId。不要附 API Key、完整客户文本或含凭据的 URL。

现象	下一步
找不到 kitta	确认 Node.js 22+，检查 npm 全局目录与 PATH，重新打开终端。
输入无效，退出码 2	运行对应命令的 --help 和 --schema；用真实值替换占位符。
认证失败，退出码 3	检查服务地址与账号密钥。环境变量会覆盖钥匙串；logout 不清除环境变量。
额度不足，退出码 4	在账号内检查 API 额度；不要假定网页订阅等于可用 API 额度。
等待超时，退出码 5	保留任务 ID 并查询；不要立即创建新任务。
文件已存在	选择新的输出路径；CLI 不覆盖文件。
转写 URL 无法访问	确认远程服务能访问音频；本地文件路径和 localhost URL 无效。
声音列表不完整	使用 --all，并检查 complete、nextPage 和退出码。

npm install -g @kittaai/cli@latest
kitta --version

自动化部署应锁定自己验证过的版本。CLI 版本与 HTTP API 版本独立；不要根据包版本推测接口路径。服务端可新增响应字段，但缺失必要字段或未知状态仍可能触发客户端校验错误。

新增中英文安装、快速开始、音频操作、任务恢复、自动化、Coding Agent 和 SDK 指南。
命令参考和 SDK 示例已按 CLI/SDK 0.1.0 校验。文档发布不代表 npm 包版本已更新。
已在 Windows 验证 CLI 语音生成与恢复，以及独立 SDK 示例。脚本包装器在 PowerShell 和 Git Bash 下验证；这些检查不代表原生 macOS/Linux 端到端验收。
新增明确标注来源的合成声音设计样本；该音频不是另一处 TTS 占位命令的输出。

需要支持时，请使用 Kitta CLI 产品页底部的支持入口。脱敏后的请求或任务 ID 请通过私密渠道发送，不要放在公开报告中。