TanXinandTanXin
1ce345d61b
release: 发布 v2.0.0 Gem-Alpha 架构解耦与交互体验升级版本 (#123)
## 本次版本更新内容（v2.0.0 — Gem-Alpha 重大里程碑版本）
本次发布为 CloudSSH **v2.0.0** 重大版本更新（代号
**Gem-Alpha**），包含后端与前端大文件深层次架构解耦瘦身、核心交互体验升级、SFTP
路径面包屑与三向排列表头、命令片段动态占位符与模糊搜索、多标签页内联重命名与上下文操作、以及 AI Agent 助手响应式窗口与移动端深度适配。
---
### 一、核心更新要点
#### 1. 架构深度解耦瘦身与代码健康治理
- **分享审计持久化管道解耦（`src/worker/share-audit-writer.ts`）**：抽离
`ShareAuditWriter`，统一封装审计记录排空、防抖刷新与排他写入锁；
- **RFC 4256 交互式键盘认证状态机解耦（`src/worker/ssh-interactive-auth.ts`）**：抽离
`KeyboardInteractiveAuthHandler`，独立管理多轮挑战 ID、超时看门狗及响应组包；
- **弱网断线保持与重连缓冲解耦（`src/worker/ssh-detached-buffer.ts`）**：抽离
`DetachedSessionBuffer`，独立负责 128KB 有界环形缓冲队列与重连补偿逻辑；
- **远端操作系统探测执行器解耦（`src/worker/os-detect.ts`）**：抽离
`detectAndPersistRemoteOS`，封装探测执行、解析与 UserDB 持久化；
- **SFTP 前端大文件解耦**：
- 抽离
`SFTPEditorCoordinator`（`frontend/src/sftp-editor-session.ts`）：独立管理编辑器挂载、编码探测、冲突检测与覆盖保存；
- 抽离 `sftp-dialogs.ts`：管理文件/目录创建、重命名与删除交互对话框及路径合法性校验；
- 抽离 `sftp-helpers.ts` 与 `sftp-transfer.ts`：封装面包屑解析、多维排序算法与异步传输状态模型；
- **代码健康规范治理**：全局显式补充 `parseInt` 10 进制基数，清理冗余构造函数与导入，收敛严格类型断言与类型告警。
#### 2. SFTP 与核心交互体验优化
- **SFTP
路径面包屑与可排列表头**：支持可点击直达的面包屑导航，保留文本框快速跳转与失焦自动恢复；表头支持文件名、大小、修改时间三向排序，目录智能置顶；
- **SFTP 工具栏新建文件**：点击工具栏「新建文件」按钮弹出命名弹窗，通过 0 字节探测上传后无缝调起在线编辑器；
- **命令片段模糊搜索与一键复制**：片段库新增实时搜索过滤，支持名称与命令模糊匹配；列表项增加一键复制到剪贴板按钮；
- **终端快捷键增强**：macOS 新增 `Cmd+F` 调出搜索栏，`Cmd+K` / `Ctrl+Shift+K`
清除终端屏幕缓冲区（`terminal.clear()`），并完好保留 Linux/Bash 默认的 `Ctrl+K` 剪切行尾逻辑。
#### 3. 易用性增强与多标签/Agent 体验
- **服务器卡片一键克隆**：提供一键克隆操作，完整复用主机、端口、用户名、跳板机关系与标签，安全清空敏感凭据，自动附加 `(Copy)`
后缀；
- **片段动态参数占位符**：支持 `{{variable}}` 语法，插入或执行前自动解析变量并弹出输入弹窗，支持默认值与输入记忆；
- **多标签页双击内联重命名与上下文菜单**：双击标签页标题直接进行内联编辑（`Enter` 保存，`Esc`
取消，空值/纯空白自动恢复原名）；右键标签弹出操作菜单（重命名、克隆会话、关闭其他、关闭当前）；
- **AI Agent 助手体验全面升级**：
- **动态 Clamp 响应式窗口**：参考 SFTP 采用 `min(clamp(420px, 40vw, 600px), 100%)`
弹性自适应宽度，顶栏对齐 `h-12` 规范并内联 `smart_toy` 助手图标；
- **桌面端严格限制在终端区域**：分栏高度严格限制在 `#terminal-area`
内部，绝不遮挡顶部状态栏右上方的双端延迟展示（`#term-info`）与连接状态；
- **移动端全屏覆盖与软键盘联动**：移动端保持全屏覆盖（`position: fixed; top:
48px;`）保证小屏下充裕的对话阅读空间；打开 Agent
时联动隐藏底部软键盘终端快捷工具栏，彻底解决输入框和发送按钮被遮挡问题；退出返回终端后自动恢复工具栏；
- **诊断 Prompt 预设与触控热区强化**：提供 4 组一键场景诊断 Prompt 胶囊（分析报错、系统负载、端口网络、Docker
状态），移动端全面优化 Prompt
胶囊（`32px`）、发送按钮（`40px`）、代码块操作（`30px`）和高危命令确认弹窗按钮触控热区；支持按 `Esc` 快速退出
Agent 返回终端。
---
### 二、提交列表
- `70042c2` feat: 提交 Gem-Alpha 版本（SFTP增强/片段占位符/标签菜单/大文件解耦瘦身） (#120)
- `78dca39` feat: Gem-Alpha 增量迭代（AI Agent 窗口响应式与移动端优化 / 标签重命名缺陷修复 /
文档同步） (#122)
- `0b04480` fix: 恢复移动端 AI Agent 全屏覆盖布局以保障小屏交互空间
- `0c19ac2` fix: 移动端打开 AI Agent 时自动隐藏底部终端快捷键工具栏
- `50171c7` release: 发布 v2.0.0 Gem-Alpha 架构解耦与交互体验升级版本
---
### 三、关联 Issue / PR
- 关联 PR：#120, #122
---
### 四、验证结果
- ✅ `pnpm run typecheck`：通过（Worker + Frontend 0 错误）
- ✅ `pnpm test`：通过（66 个测试文件，755 项测试全数通过）
- ✅ `pnpm run build:frontend`：通过（单 bundle 确定性构建并内联至
`src/worker/html.ts`）
- ✅ `pnpm run test:e2e`：通过（75 项 Playwright 端到端及 axe 无障碍测试全部通过，1
项按平台条件跳过）
- ✅ `pnpm run verify`：完整本地质量门禁验证全绿通过
---------
Co-authored-by: TanXin <tanxin@example.com>
2026-09-04 14:14:08 +08:00
..
2026-08-28 22:19:13 +08:00
2026-08-20 11:42:28 +08:00
2026-08-28 22:19:13 +08:00
2026-08-20 11:42:28 +08:00
2026-08-20 11:42:28 +08:00
2026-08-20 11:42:28 +08:00
2026-08-13 11:25:50 +08:00
2026-09-04 14:14:08 +08:00
2026-08-20 11:42:28 +08:00
2026-08-20 11:42:28 +08:00
2026-08-20 11:42:28 +08:00
2026-08-20 11:42:28 +08:00