Files

T

yinjianm 1662b2b9e8 feat(frontend): polish connection tree and terminal groups

Add explorer-style tree search in the connections view with
match-path expansion, clearer count highlighting, and a refined
sidebar header layout.

Improve terminal tab grouping by keeping new sessions appended
within their server group, highlighting the active group, and
deduplicating broadcast actions to send commands once per server.

2026-03-25 23:19:53 +08:00

3.8 KiB

Raw Blame History

变更提案: terminal-group-and-broadcast-dedupe

元信息

类型: 功能增强
方案类型: implementation
优先级: P1
状态: 实施中
状态说明: 代码改动已完成，前端全量构建被现有 ConnectionsView.vue 重复属性错误阻塞
创建: 2026-03-25

1. 需求

背景

当前顶部终端标签栏已经有“服务器组头 + 终端子标签”的雏形，但同一服务器新增终端后仍会按全局尾部插入，导致不同服务器之间组关系错乱。另外，快捷指令 和 命令历史 的“发送到全部会话”仍按终端实例广播，同一服务器有多个终端时会重复执行。

目标

把服务器组头做成更稳定的胶囊式 tab group，组头固定、子标签更紧凑、激活组整块高亮。
修复多服务器并行使用时的“新增终端乱插组”问题，确保新终端始终插入到所属服务器组尾部。
将 快捷指令 与 命令历史 的“发送到全部会话”统一改成“每台服务器只执行一次”。

约束条件

范围约束: 只改前端终端标签栏、session 顺序维护和两处广播入口，不改后端协议
排序约束: 继续复用 localStorage 中的 sessionOrder，但允许在新增同组终端时做定向插入
广播约束: 每个 connectionId 最多选择一个已连接 SSH 终端，避免重复执行
兼容约束: RDP/VNC 不参与组内新增终端，也不参与 SSH 广播去重逻辑

验收标准

多台服务器并行打开时，为某台服务器新增终端会稳定插入到该服务器组尾部
顶部标签栏具备更明显的“胶囊分组”视觉，激活组有整块高亮关系
快捷指令 与 命令历史 的“发送到全部会话”都按服务器去重，只执行一次
前端构建通过

2. 方案

技术方案

在 sessionActions.ts 中新增针对 sessionOrder 的组内插入逻辑：为某连接创建新终端时，优先把新 sessionId 插到同连接最后一个 session 的后面，而不是简单追加到尾部。TerminalTabBar.vue 则继续利用连续同 connectionId 的会话数组，在组头、子标签和组尾按钮三层上补更强的胶囊边界和激活组高亮。QuickCommandsView.vue 与 CommandHistoryView.vue 共享一套“按 connectionId 选取代表会话”的广播去重策略，只对每台服务器选择一个已连接 SSH 终端发送指令。

影响范围

涉及模块:
  - frontend: session/actions/sessionActions.ts, TerminalTabBar.vue, QuickCommandsView.vue, CommandHistoryView.vue, locales
预计变更文件: 5-7

风险评估

风险	等级	应对
sessionOrder 定向插入与拖拽排序持久化冲突	中	只在“新增同组终端”时做最小插入，不改已有排序语义
广播去重选错终端，导致发到非激活或异常会话	低	只从已连接 SSH 会话中选择每个 connectionId 的首个代表
胶囊分组视觉过重影响移动端	低	保持结构复用，移动端沿用同逻辑但不额外堆复杂控件

3. 技术决策

terminal-group-and-broadcast-dedupe#D001: 新终端按 connectionId 插回组尾，广播按 connectionId 去重

日期: 2026-03-25
状态: ✅采纳
决策: 会话仍保持独立 sessionId，但新增同服务器终端时要把其 sessionId 插入到该连接组尾部；批量发送场景统一按 connectionId 选择代表会话。
理由: 问题本质是展示顺序和广播粒度，而不是底层 SSH 能力。按连接做最小排序修正和广播去重，能解决“乱加”和“重复执行”两个核心问题，而且改动边界清晰。
影响: 影响 sessionOrder 维护逻辑、顶部标签栏分组样式，以及 快捷指令 / 命令历史 两个广播入口。

3.8 KiB Raw Blame History