故障排查
常见问题
| 现象 | 检查与处理 |
|---|---|
| AI未配置 | 在本机配置API Key并重启服务；不要在截图中展示Key |
| 超时、网络或额度错误 | 检查所配服务连接和账户状态，恢复后手动Retry |
| 结构或业务校验失败 | 阅读错误，核对输入事实与约束；保留失败记录再重试 |
| LEXICAL_ONLY | 检查本地缓存，执行knowledge:prepare后通过界面重建索引 |
| PDF无文字或导入失败 | 使用文字型文件，检查格式、编码与大小；不支持OCR |
| 来源过期、STALE | 核对上游变更，重新生成或确认，不能沿用失效审批 |
| 内容已批准但无法进计划 | 检查是否为策略外渠道适配稿，以及计划是否需要重新确认 |
| SQLite原生模块版本错误 | 使用与依赖安装时相符的Node版本，或在所选版本下重装依赖 |
恢复原则
自动修正最多一次，手动重试保留历史。不要靠删除失败样本、改写数据库或切换Demo来表示成功。恢复前可备份工作区；停服务后再处理数据库文件。