故障排除

遇到问题？这里列出了常见问题和解决方案。

安装问题

TaskWarrior 未找到

错误: 未检测到 TaskWarrior

解决方案：

1. 检查是否已安装：

   task --version

2. 如果未安装，参考 安装指南

3. 确保在 PATH 中：

   which task
   # 应该输出 /usr/bin/task 或类似路径

TaskWarrior 版本过低

错误: TaskWarrior 版本过低 (2.x.x)
GDT 需要 TaskWarrior 3.0 或更高版本

解决方案：升级 TaskWarrior

macOS

brew upgrade task

Ubuntu/Debian

sudo add-apt-repository ppa:taskwarrior/taskwarrior
sudo apt update && sudo apt install taskwarrior

API Key 未配置

错误: 请设置 ANTHROPIC_API_KEY 环境变量

解决方案：

1. 获取 Key：console.anthropic.com
2. 设置环境变量：

   export ANTHROPIC_API_KEY=sk-ant-your-key

API 错误

网络连接失败

错误: 无法连接到 API 服务器

解决方案：

1. 检查网络：

   curl https://api.anthropic.com

2. 如果使用代理：

   export HTTPS_PROXY=http://your-proxy:port

速率限制

错误: API 请求过于频繁 (429)

解决方案：等待提示的时间后重试，或考虑升级 API 计划。

API Key 无效

错误: API Key 无效或已过期

解决方案：

1. 确认 Key 格式正确（以 sk-ant- 开头）
2. 在 console.anthropic.com 检查状态
3. 如果已过期，创建新 Key

TaskWarrior 错误

数据库锁定

错误: TaskWarrior 数据库被锁定

解决方案：

1. 检查其他进程：

   ps aux | grep task

2. 等待或终止：

   pkill -f "task "

3. 删除锁文件（谨慎）：

   rm ~/.task/task.lock

数据损坏

错误: TaskWarrior 数据文件损坏

解决方案：

1. 运行诊断：

   task diagnostics

2. 尝试修复：

   task rc.confirmation=off repair

会话问题

会话无法加载

错误: 无法加载会话数据

解决方案：

1. 使用新会话：

   gdt --new

2. 或删除损坏的会话：

   rm ~/.gdt/sessions/current.json

调试

启用详细日志：

DEBUG=gdt:* gdt

查看特定模块：

DEBUG=gdt:llm gdt          # AI 调用
DEBUG=gdt:taskwarrior gdt  # TaskWarrior 操作
DEBUG=gdt:session gdt      # 会话管理

获取帮助

如果以上方法都无法解决：

1. 查看完整文档
2. 检查是否有已知问题
3. 收集诊断信息后寻求帮助