yinjianm
d3e8d598b8
将 SSH 顶部标签改为服务器级切换入口，并把同服务器下的 多终端切换、新增与关闭下沉到终端面板内部，修正服务器与 终端的视觉层级 同时将 Workbench 导航改为左侧图标栏，并为终端标签右键菜单 补充“关闭全部”动作，完善相关多语言文案与工作区事件处理
73 lines
3.1 KiB
Markdown
73 lines
3.1 KiB
Markdown
# 变更提案: terminal-tab-close-all
|
|
|
|
## 元信息
|
|
```yaml
|
|
类型: 修复
|
|
方案类型: implementation
|
|
优先级: P2
|
|
状态: 已完成
|
|
创建: 2026-03-29
|
|
```
|
|
|
|
---
|
|
|
|
## 1. 需求
|
|
### 背景
|
|
当前终端标签右键菜单已经支持关闭当前、关闭其他、关闭左侧和关闭右侧，但缺少“一次性关闭全部终端标签”的入口。用户希望在工作区内直接关闭所有服务器的终端标签，而不是仅针对当前服务器分组操作。
|
|
|
|
### 目标
|
|
- 在终端标签右键菜单中新增“关闭全部”。
|
|
- 点击后关闭当前工作区内全部终端标签。
|
|
- 保持现有右键菜单事件链路与会话清理逻辑，不引入新的后端依赖。
|
|
|
|
### 约束条件
|
|
```yaml
|
|
范围约束: 仅修改 frontend 菜单、工作区事件和本地化文案
|
|
行为约束: “关闭全部”作用域为当前工作区全部终端标签，不区分服务器
|
|
实现约束: 复用现有 session store 的 cleanupAllSessions 和 Workspace 事件总线
|
|
```
|
|
|
|
### 验收标准
|
|
- [x] 终端标签右键菜单在多标签场景下显示“关闭全部”。
|
|
- [x] 点击“关闭全部”后，当前工作区中的全部终端标签被关闭。
|
|
- [x] `packages/frontend` 构建通过，未引入新的类型错误。
|
|
|
|
---
|
|
|
|
## 2. 方案
|
|
|
|
### 技术方案
|
|
沿用现有 `TerminalTabBar.vue -> workspaceEvents.ts -> WorkspaceView.vue -> session.store.ts` 的前端事件链，新增 `session:closeAll` 事件。`TerminalTabBar.vue` 负责在多标签场景下渲染菜单项并发出事件，`WorkspaceView.vue` 统一接收后调用 `sessionStore.cleanupAllSessions()` 完成全部会话关闭，文案同步更新到中英文 locale 文件。
|
|
|
|
### 影响范围
|
|
```yaml
|
|
涉及模块:
|
|
- frontend: TerminalTabBar 右键菜单项
|
|
- frontend: workspaceEvents 工作区事件类型
|
|
- frontend: WorkspaceView 全部关闭处理
|
|
- frontend: zh-CN / en-US 本地化文案
|
|
预计变更文件: 5
|
|
```
|
|
|
|
### 风险评估
|
|
| 风险 | 等级 | 应对 |
|
|
|------|------|------|
|
|
| 关闭全部复用 `cleanupAllSessions()` 时影响现有退出清理逻辑 | 低 | 仅在用户主动点击菜单时调用，且该逻辑已用于工作区卸载清理 |
|
|
| 右键菜单新增项后多语言缺失导致展示 key | 低 | 同步补充 `zh-CN` 与 `en-US` 文案 |
|
|
|
|
---
|
|
|
|
## 3. 技术决策
|
|
### terminal-tab-close-all#D001: 复用工作区级事件总线和现有全部清理能力
|
|
**日期**: 2026-03-29
|
|
**状态**: 采纳
|
|
**背景**: 当前终端标签关闭动作已全部走 `WorkspaceView` 中转处理，`session.store` 已存在 `cleanupAllSessions()` 可安全关闭全部会话。
|
|
**备选方案**:
|
|
| 选项 | 优点 | 缺点 |
|
|
|------|------|------|
|
|
| A: 在 `TerminalTabBar.vue` 内循环逐个关闭 | 改动直观 | 组件直接操作关闭细节，事件层次不一致 |
|
|
| B: 新增 `session:closeAll` 事件并由 `WorkspaceView` 调用 `cleanupAllSessions()` | 与现有 close/closeOthers 链路一致，复用现有清理逻辑 | 需要补一个事件类型 |
|
|
**决策**: 选择方案 B。
|
|
**理由**: 保持终端标签菜单与工作区事件模型一致，避免在组件层直接堆叠会话清理逻辑。
|
|
|