跳转到内容

故障排查

错误:unsupported; install a recent V2 release。

检查:

终端窗口
opencode --version

使用官方入口升级到最近 V2,再执行 uc sync。UltraCode 不会替你自动升级,除非你显式运行 uc up。

直接使用:

终端窗口
~/.local/bin/uc doctor

并把 ~/.local/bin 加入 shell PATH。安装器不会未经允许改写所有 shell 配置。

UltraCode 不管理 Provider。检查你在 OpenCode 中原有的模型选择与认证;不要把这些凭据发送给 UltraCode 安装器或文档网站。

终端窗口
uc sync

私有运行时会重新检查固定浏览器。不要安装全局 Playwright 来掩盖问题。

这是预期行为。打开提示中的路径,决定是否手动采用 UltraCode 值。用户已有 default_agent、MCP 或本地修改不会被静默覆盖。

通常表示当前不是 linked worktree,或目标/任务文件缺失。按提示创建 worktree 与 .ralph/ralph-tasks.md。

  • 3:任务未完成或达到轮数上限;阅读 PROGRESS 和 HANDOFF。
  • 5:最终有未提交变更;审查 diff 后提交,再决定是否继续。

执行:

终端窗口
uc doctor
opencode --version

公开报告问题时移除私有路径、项目名、令牌和凭据。不要附送真实模型会话或认证文件。