Skip to content

v1.14.27:可配置默认 Shell + TUI 体验优化

发布日期:2026年4月27日


🎯 一句话总结

现在可以自定义默认 Shell 了!终端和 Agent 的 shell 命令都支持配置,同时 TUI 的提示体验也更干净。


🆕 新功能:可配置默认 Shell

这次更新了什么?

新增了一个配置项,让你可以指定终端和 Agent shell 命令使用的默认 Shell(如 bash、zsh、fish 等)。

这有什么用?

  • 统一 Shell 环境:确保 OpenCode 使用的 Shell 与你的开发环境一致
  • 使用特定 Shell 功能:如果你依赖 zsh 插件或 fish 语法,现在 Agent 也能使用
  • 跨平台一致性:在不同机器上保持相同的 Shell 行为

如何使用?

通过配置文件

~/.config/opencode/config.json 中添加:

json
{
  "shell": "/bin/zsh"
}

通过桌面端设置

桌面版新增了一个设置项,可以直接在界面中管理默认 Shell,无需手动编辑配置文件。

提示:如果不配置,OpenCode 会使用系统默认 Shell。


🔧 问题修复

减少创建工作区时的终端噪音

问题:在 TUI 中创建工作区时,终端会输出大量无关的日志信息,干扰使用。

修复:优化了工作区创建流程,减少了不必要的终端输出。

对你有什么影响:创建工作区时界面更干净,专注于重要信息。


TUI 提示时机优化

更新:在 onboarding(首次设置)完成之前,不再显示提供商连接状态的检查提示。

对你有什么影响:新用户首次使用时的体验更流畅,不会在还没配置好模型前就被连接提示打扰。


Toast 通知默认时长恢复

问题:自定义 Toast 通知时,如果没有指定时长,可能会意外使用很短或很长的显示时间。

修复:当没有提供自定义时长时,恢复使用默认的 Toast 显示时长。

对你有什么影响:Toast 通知的显示时间现在更可预测。


📊 要不要升级?

情况建议
使用非默认 Shell(如 fish、zsh)✅ 强烈推荐
对终端噪音敏感✅ 推荐
新用户 onboarding 体验✅ 推荐
正常使用中可以等下次

⬆️ 升级命令

bash
opencode upgrade

📋 技术细节

点击展开完整更新列表

Core

  • Added a configurable default shell for terminals and agent shell commands, with a Desktop setting to manage it.
  • Reduced extra terminal noise while creating TUI workspaces.

TUI

  • Hid provider connection checks until onboarding is complete.
  • Restored the default toast timeout when no custom duration is provided. (@OpeOginni)

Thank you to 1 community contributor:

  • @OpeOginni:
    • fix(tui): update toast duration handling to use default value (#23395)

← 返回更新日志