yinjianm
8c130adcc9
Expose `cpuCores` in backend status collection with multi-command fallback and surface it in the status panel as a localized CPU core badge under the CPU model. Adjust terminal group UX by adding a server-level close-all control in the SSH tab group header. Reduce accidental quick command execution by switching list interaction to single-click select + double-click execute, while preserving keyboard Enter and context-menu execution paths.
117 lines
6.8 KiB
Markdown
117 lines
6.8 KiB
Markdown
# 变更提案: ssh-group-close-and-script-input-sanitize
|
|
|
|
## 元信息
|
|
```yaml
|
|
类型: 功能增强
|
|
方案类型: implementation
|
|
优先级: P1
|
|
状态: 实施中
|
|
创建: 2026-04-12
|
|
```
|
|
|
|
---
|
|
|
|
## 1. 需求
|
|
|
|
### 背景
|
|
当前工作区顶部终端标签栏已经把 SSH 会话聚合为“服务器组头”，但组头本身只能切换，不能像单个终端标签那样直接关闭。用户希望在服务器组头上也能出现一个关闭入口，并且点击后一次关闭该服务器下的全部终端，避免逐个点子标签关闭。同时，“添加新连接”的脚本模式虽然已经支持空格、空行和 Markdown 围栏清洗，但脚本值仍只会去掉双引号，像 `-p '$Moka1998A'` 这样的单引号包裹密码会被原样保存，导致实际密码多出 `'`。
|
|
|
|
### 目标
|
|
- 在 `TerminalTabBar.vue` 的 SSH 服务器组头中加入一个独立的关闭按钮，点击后关闭该服务器下全部终端。
|
|
- 保持现有“组头切服务器、组内终端在次级标签条管理”的交互模式，不改后端协议和会话模型。
|
|
- 修正脚本模式参数解析，对单引号和双引号包裹值统一去壳，让密码、代理名、标签、备注等字段都落成真实值。
|
|
|
|
### 约束条件
|
|
```yaml
|
|
范围约束: 仅改前端工作区终端标签栏、脚本模式解析链路和相关文案，不改后端 API
|
|
交互约束: 服务器组头的主点击行为仍然是激活该服务器，不让新增关闭按钮抢占原有点击语义
|
|
兼容性约束: 非 SSH 的 RDP/VNC 顶层标签保持现状；脚本模式已有的空格、空行和 Markdown 围栏清洗继续保留
|
|
数据约束: 仅移除成对包裹值的外层引号，不修改值内部合法字符
|
|
```
|
|
|
|
### 验收标准
|
|
- [ ] SSH 服务器组头出现可见的关闭按钮，点击后能关闭该服务器下全部终端
|
|
- [ ] 组头关闭按钮不会误触发组头本身的激活切换，单个终端标签关闭行为保持不变
|
|
- [ ] 脚本模式导入 `-p '$Moka1998A'` 时，实际保存的密码是 `$Moka1998A` 而不是带 `'`
|
|
- [ ] `packages/frontend` 的构建校验通过
|
|
|
|
---
|
|
|
|
## 2. 方案
|
|
|
|
### 技术方案
|
|
沿用现有 `TerminalTabBar.vue` 对 SSH 会话按 `connectionId` 聚合的结果，在服务器组头按钮内部增加一个次级 `X` 按钮。该按钮通过本地分组会话列表拿到当前服务器的所有 `sessionId`，逐个复用已有的 `session:close` 事件链路关闭，避免引入新的后端或 store 协议。视觉上保持现有“服务器组头胶囊 + 终端子标签”的样式语言，只在 hover 和激活态补充关闭入口。
|
|
|
|
脚本模式解析继续保留在 `useAddConnectionForm.ts` 中处理，新增统一的“去掉成对包裹引号”辅助逻辑，并将参数切分从“只识别双引号”扩展为“同时识别单引号和双引号”。这样 `-p '$Moka1998A'`、`-proxy 'ssh 1'`、`-note 'foo bar'` 等值都能保留真实内容而不带外层引号。
|
|
|
|
### 影响范围
|
|
```yaml
|
|
涉及模块:
|
|
- frontend: TerminalTabBar.vue 的 SSH 组头按钮与关闭交互
|
|
- frontend: useAddConnectionForm.ts 的脚本模式参数切分与值清洗
|
|
- frontend: locales 文案（组头关闭提示）
|
|
预计变更文件: 5-6
|
|
```
|
|
|
|
### 风险评估
|
|
| 风险 | 等级 | 应对 |
|
|
|------|------|------|
|
|
| 组头关闭按钮触发冒泡，误切到服务器而不是关闭整组 | 中 | 在关闭按钮处理器中显式 `stopPropagation()` / `preventDefault()` |
|
|
| 批量关闭同组终端时，本地分组列表在关闭过程中变化导致遗漏 | 低 | 先基于当前分组生成 `sessionId` 快照，再逐个发送关闭事件 |
|
|
| 单引号解析过宽，误删值内部字符 | 低 | 只去掉首尾成对且同类型的包裹引号，不处理内部字符 |
|
|
|
|
---
|
|
|
|
## 3. 核心场景
|
|
|
|
### 场景: 关闭某台服务器下的全部终端
|
|
**模块**: frontend / TerminalTabBar
|
|
**条件**: 当前连接类型为 SSH，且同一 `connectionId` 下存在 1 个或以上终端
|
|
**行为**: 用户点击服务器组头右侧的关闭按钮，组件基于当前分组会话快照逐个发出既有 `session:close` 事件
|
|
**结果**: 该服务器下的全部终端标签被关闭，其他服务器标签保持不变
|
|
|
|
### 场景: 脚本模式导入带单引号的密码
|
|
**模块**: frontend / useAddConnectionForm
|
|
**条件**: 用户在脚本模式中输入 `-p '$Moka1998A'` 这类带单引号包裹的参数值
|
|
**行为**: 解析阶段按单引号/双引号感知切分参数，并在取值时移除成对外层引号
|
|
**结果**: 提交给后端的密码值为 `$Moka1998A`，不会附带 `'`
|
|
|
|
---
|
|
|
|
## 4. 技术决策
|
|
|
|
> 本方案涉及的技术决策，归档后成为决策的唯一完整记录
|
|
|
|
### ssh-group-close-and-script-input-sanitize#D001: 组头关闭复用现有单会话关闭链路，脚本值统一做外层引号去壳
|
|
**日期**: 2026-04-12
|
|
**状态**: ✅采纳
|
|
**背景**: 本次需求是现有前端交互增强，不需要改变后端会话协议，但要确保“整组关闭”和“脚本值去壳”都尽量复用既有链路，避免引入新的状态分叉。
|
|
**选项分析**:
|
|
| 选项 | 优点 | 缺点 |
|
|
|------|------|------|
|
|
| A: 组头关闭复用现有 `session:close` 事件，脚本值统一做外层引号去壳 | 改动边界小，直接复用现有关闭和提交流程，风险低 | 组头关闭是逐个关闭，不是单事件批量关闭 |
|
|
| B: 新增“按 connectionId 批量关闭”专用事件，并重写脚本解析器 | 语义更集中，理论上更便于后续扩展 | 需要扩展事件协议，改动面更大，超出这次需求边界 |
|
|
**决策**: 选择方案 A
|
|
**理由**: 当前需求聚焦前端交互与输入清洗，复用既有关闭链路与表单提交链路更符合“保守修改”和最小影响原则。
|
|
**影响**: 影响 `TerminalTabBar.vue`、`useAddConnectionForm.ts` 及相关 locale 文案。
|
|
|
|
---
|
|
|
|
## 5. 成果设计
|
|
|
|
### 设计方向
|
|
- **美学基调**: 延续现有终端标签栏的黑绿运维胶囊风格，不新增跳脱视觉体系的新按钮样式
|
|
- **记忆点**: 服务器组头在保持整块高亮的同时，hover 后能露出一个紧贴右侧的整组关闭入口
|
|
- **参考**: 现有 `TerminalTabBar.vue` 的服务器组头与子标签胶囊风格
|
|
|
|
### 视觉要素
|
|
- **配色**: 沿用组头当前 `border-primary/60 + bg-primary/10` 激活色系，关闭按钮 hover 时使用 `bg-header` / `text-foreground`
|
|
- **字体**: 延续当前标签栏字号体系，不引入额外字体变化
|
|
- **布局**: 关闭按钮嵌在服务器组头右侧，避免破坏左侧 server icon + 名称 + 计数的既有结构
|
|
- **动效**: 延续现有 150ms 渐隐渐显，关闭按钮默认隐藏，hover 组头时显现
|
|
- **氛围**: 保持当前运维面板风格，不追加新纹理或装饰
|
|
|
|
### 技术约束
|
|
- **可访问性**: 关闭按钮保留独立 `title`，避免只靠图标表达语义
|
|
- **响应式**: 继续兼容现有移动端/桌面端标签栏高度，不新增超出标签高度的控件
|