故障恢复

先运行以下三条命令，它们分别检查本机、身份和目标工作流：

datacore doctor
datacore auth status
datacore --json conductivity list "<实验 ID 或页面链接>"
datacore --json conductivity status "<轮次页面链接>"

现象	先做什么	不要做什么
CLI 无法启动	datacore doctor	反复重装前不看诊断结果
Agent 没发现 Skills	datacore skills list	把同一 Skill 手工复制到多个目录
登录失效	datacore auth login	借用他人 Token
页面可见但 CLI 无权访问	检查当前 CLI 身份与项目成员关系	绕过服务端权限
长任务等待超时	查询 status	直接重复提交
五折部分失败	retry-fold --fold N	重建已完成的折

登录或授权失效

重新运行 datacore auth login。不要借用或索取其他人的 Token。

Agent 没有发现 Skills

先运行 datacore skills list，确认 canonicalPath 下两个 Skill 均已安装。然后重新同步目标 Agent：

datacore skills install --agent claude-code --force

如果需要确认 Agent 实际应读取的内容，可运行 datacore skills read datacore。

也可以用 npx skills add https://datacore-cli.dp.cd.mba -g -y 交给标准 Skills 管理器处理。重启或新建 Agent 会话后再验证；多数 Agent 只在会话启动时扫描 Skills。

权限不足

当前 DataCore 用户没有目标项目或实验权限。确认项目成员关系；不要切换身份或绕过后端判断。

实测文件校验失败

先执行只读的 validate。根据返回的行、列、推荐编号或数值问题修正文件，再上传。上传时服务端还会复检。

Bohrium 凭据错误

由用户在 DataCore 中管理自己的 AccessKey 与项目号。CLI 不使用平台默认凭据，也不会要求在聊天或命令行中输入密钥。

本地等待超时

云端任务可能仍在执行。先查询 status，不要直接重复提交。

五折只有部分失败

状态会分别显示五折。使用 retry-fold --fold N --yes 只补交失败或未启动的折，已完成的折不会重建。

临时服务错误或限流

查看错误中的 retryable 和 action。可重试错误使用有限次数的退避重试，重试前仍需先查状态，避免重复创建任务。