~/content/migrating-to-1.0

Migrating to 1.0

OpenCode 1.0 中的新特性。

last_updated: "2026-01-20"

OpenCode 1.0 是对 TUI 的完全重写。

我们将基于 go+bubbletea 的 TUI 迁移到了用 zig+solidjs 编写的内部框架 (OpenTUI),之前的 TUI 存在性能和功能问题。

新的 TUI 的工作方式与旧的 TUI 类似,因为它连接到相同的 opencode 服务器。


##升级

如果您当前使用的是以前的版本,则不应自动升级到 1.0。但是,某些旧版本的 OpenCode 始终会获取最新版本。

要手动升级,请运行

bash
$ opencode upgrade 1.0.0

要降级回 0.x,请运行

bash
$ opencode upgrade 0.15.31

##UX 更改

会话历史记录更加压缩,仅显示编辑和 bash 工具的完整详细信息。

我们添加了一个命令栏,几乎所有操作都通过它进行。按 ctrl+p 在任何上下文中将其调出,并查看您可以执行的所有操作。

添加了一个会话侧边栏(可以切换),其中包含有用的信息。

我们删除了一些不确定是否有人实际使用的功能。如果缺少重要的内容,请提出 issue,我们会尽快将其添加回去。


##破坏性更改

###键绑定已重命名

  • messages_revert -> messages_undo
  • switch_agent -> agent_cycle
  • switch_agent_reverse -> agent_cycle_reverse
  • switch_mode -> agent_cycle
  • switch_mode_reverse -> agent_cycle_reverse

###键绑定已删除

  • messages_layout_toggle
  • messages_next
  • messages_previous
  • file_diff_toggle
  • file_search
  • file_close
  • file_list
  • app_help
  • project_init
  • tool_details
  • thinking_blocks
Comments (Coming Soon)

Configure Giscus in environment variables to enable comments.