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)

