常见问题与排障

能登录，但没有项目或不能创建任务

先确认登录身份和项目。没有项目时创建项目或接受邀请；只能查看时，请管理员核对职责、自定义权限和身份组映射。

项目权限和外部账号权限需要分别满足。管理员身份不会自动授予 Gitea 仓库写权限。

CLI 登录成功，后续命令仍提示认证错误

运行 discernctl auth status，确认服务器地址。检查 DISCERNLENS_TOKEN、DISCERNLENS_CONFIG、DISCERNLENS_API_URL 和兼容变量 DISCERNLENS_URL 是否覆盖个人登录。

旧会话过期或上游授权撤销时重新登录；服务端未启用 CLI 登录时联系管理员。CLI 先检查 API 主版本，兼容性错误也会阻止操作。

推理服务在电脑上可用，任务却失败

按顺序检查：

1. 任务运行环境是否能解析并访问该地址。
2. 是否误用了 localhost，或使用了受保护的地址和平台网段。
3. 模型名是否是服务接受的名称，而非孔明显示名。
4. 推理 Key 是否正确；不要用孔明 Platform Secret 代替。
5. TLS 证书、端口、协议及实际请求路径是否匹配。

使用 仅检查 并查看详情中的解析地址、有效配置和脱敏错误。不要通过重复启动高负载实验来排查连通性。

质量评测显示 INFRA_FAILED

这表示没有取得有效质量证据。检查运行器、模型响应、结果文件、指标和样本数量。与 QUALITY_FAILED 分开处理，后者意味着有效证据未通过阈值。

复制实验后找不到原来的 API Key

这是只写凭据的预期行为。复制输入和历史结果不会回填密钥，重新提供本次运行的推理 Key。

多实验负载互相影响，结果不稳定

检查是否有多个无前置依赖的节点同时压测同一个服务。要比较不同并发，改为串行并保持其他条件一致；也检查服务是否受到其他业务流量影响。

实验日志为空或不完整

平台只保留最近 64 KiB。旧运行器可能不支持回传；网络或后台回传失败也可能导致缺失。已有记录中没有的内容不能事后补回，日志缺失本身不等同于压测失败。

孔明环境信息与当前服务不一致

先查看采集时间。环境在选择服务时采集，提交后固定；复制、重试和流程复用不会刷新。重新选择服务并采集，创建新实验或新版本。

分析失败时可以手动填写未知字段。项目默认模型已配置但不可用时不会自动切换到个人账户。

找不到 Gitea 仓库或任务预检失败

确认个人 Gitea 连接有效，且你对目标仓库有写权限。旧只读授权需要按页面提示撤销并重新连接。还应核对模型连接、基础分支、环境沙箱与可用能力。

取消或重试提示版本冲突

重新查询执行，读取最新强 ETag，确认当前状态后再操作。冲突可能意味着其他人已经修改资源，不要重复提交过期版本。

等待命令超时只停止本机等待，远端通常继续运行。需要取消时显式调用取消命令并再次确认状态。

通知没收到，但任务已经成功

在项目通知页查看投递状态，核对渠道地址、签名、请求头和接收端响应。通知故障不改写任务结论。入队失败需要服务端日志排查，历史通知不能保证补发。

向管理员提供什么信息

提供项目 slug、任务或执行 ID、发生时间、页面中的脱敏错误码及操作步骤。涉及流程时同时说明失败节点和外部资源状态。不要附带 API Key、完整签名 URL 或未脱敏日志。