Nexus/docs/changelog/2026-06-01-terminal-empty-layout-fix.md

Changelog: 终端页空状态布局修复

日期: 2026-06-01

摘要

修复 #/terminal 无会话时页面模板叠层：空状态与「选择服务器」对话框同时出现、工具栏显示无意义的 ... / 断开。

动机

用户反馈终端页存在「模板问题」；生产页表现为空状态文案 + 弹窗服务器列表 + 未连接工具栏三层叠在一起，不符合 2026-06-01-terminal-spa-iteration-design.md 空状态规范。

变更

• 侧栏自适应：保留 v-main 的 --v-layout-left 缩进；菜单开合时终端宽度随动，xterm 在动画后 fit()；桌面 persistent / 移动端 temporary 浮层
• 侧栏遮挡修复：nexus-terminal-main 不再 padding:0（保留 Vuetify 侧栏留白）
• 取消进入 /terminal 时自动 showServerDialog = true
• 空状态改为内嵌可搜索服务器列表（点击即 newSession）
• 打开对话框时隐藏空状态（!showServerDialog）
• 无会话时隐藏会话工具栏
• 侧栏 v-list-subheader 移入 v-list；浅色主题终端区背景跟随主题
• 快捷命令编辑文案去掉字面量 \r

涉及文件

• frontend/src/pages/TerminalPage.vue

验证

1. cd frontend && npm run type-check
2. vite build 后访问 https://api.synaglobal.vip/app/#/terminal：仅见内嵌列表，无自动弹窗
3. 标签栏「+」仍可打开对话框，且不与空状态同时显示

迁移 / 重启

仅前端构建部署。