fhcode故障排查指南

常见问题诊断、错误处理、日志分析

常见问题(10个)

Q: fhcode启动失败怎么办?

A: 检查Node版本(需18+)、查看日志~/.feihong-code/logs/error.log、执行fhcode doctor诊断。

Q: API调用超时如何处理?

A: 检查网络连接、配置proxy、增加timeout参数、切换fallback模型。

Q: 模型返回空响应?

A: 检查API Key有效性、降低max_tokens、更换模型、查看token配额。

Q: 任务卡住不响应?

A: fhcode task list查看状态、fhcode kill 终止、检查资源占用。

Q: 权限不足错误?

A: Windows以管理员运行、Linux使用sudo、检查文件权限、验证token权限范围。

Q: 配置文件损坏?

A: 删除~/.feihong-code/config.json重新初始化、或fhcode config reset恢复默认。

Q: 内存溢出怎么办?

A: 增加系统内存、启用上下文压缩、关闭不必要插件、重启fhcode释放内存。

Q: 如何收集诊断信息?

A: fhcode doctor --verbose输出详细诊断、--log-level debug开启调试日志。

Q: 常见错误码含义?

A: E001: API Key无效、E002: 网络超时、E003: Token配额不足、E004: 模型不可用。

Q: 联系技术支持?

A: GitHub Issues提交bug报告、Discord社区求助、企业版联系专属客户经理。