更新日志 / Changelog

本文件记录 Cloud Term 每个版本的升级改动。版本号遵循 语义化版本。

[0.2.2] - 2026-07-28

新增 / Features

• 新建连接支持免认证配置：不填认证方式时，默认尝试使用本机 ~/.ssh 目录下的私钥登录。
• 终端标签支持自定义宽度，并优化标签样式与拖拽体验。

优化 / Improvements

• 皮肤适配各类弹框：对话框、弹窗等浮层在皮肤模式下样式统一。
• 设置页性能优化：设置项订阅按字段拆分、终端主题重设异步化，降低卡顿。
• 官网首页外观预览增至 7 种，修正浅色终端图例；演示截图改用 WebP 格式。

修复 / Fixes

• 修复 macOS 触控板下右键菜单需要点击两次才能关闭的问题。
• 修复终端标签拖拽时样式错乱的问题。
• 清理 antd v6 废弃 API 与 React 控制台告警。

[0.2.1] - 2026-07-23

修复 / Fixes

• 修复收藏栏样式不跟随皮肤的问题。

[0.2.0] - 2026-07-23

新增 / Features

• 新增皮肤系统：内置 8 款皮肤（翡翠林海 / 极光之夜 / 赛博霓虹 / 午夜星河 / 落日沙丘 / 樱花和风 / 水墨青山 / 蔚蓝海岸），一键切换「背景图 + 界面配色 + 配套半透明终端主题」；支持自定义皮肤（上传壁纸或按配色自动生成渐变背景，可调界面底色、主色、背景色罩强度与终端主题），皮肤随设置云同步。同时新增 8 款 Glass 半透明终端主题可单独使用。
• 新增终端插件体系（设置 → 插件，开关随设置云同步）：
  • 命令补全（默认关闭）：内置约 45 个常用 CLI 的子命令与参数补全，并结合本会话与命令历史给出整行建议，Tab 采纳 / ↑↓ 选择 / Esc 关闭。
  • 文件预览（默认开启）：识别终端输出中的文件名，Ctrl/Cmd + 点击预览图片 / 视频 / 音频 / PDF / Markdown / 文本日志；office、csv 等格式桌面端调系统应用打开、Web 端下载。
  • IP 归属查询（默认开启）：划词选中 IPv4 后从悬浮菜单查询归属地、运营商、ASN 等信息。
  • 任务完成通知（默认开启）：命令运行超过阈值（默认 15 秒，可在插件设置中调整）且你已切走时，推送系统通知或应用内通知，点击可跳回对应终端。
• 新增「固定到终端底部」：划词菜单 / 右键菜单的「固定」会把命令存为代码片段并固定到终端底部命令条，单击即发送；可选择「仅当前连接」或「所有连接」生效，片段列表中也能随时固定 / 取消固定。
• 新增连接的启动命令与环境变量：连接表单「高级功能」中可配置连接后自动执行的启动命令，以及每行 KEY=VALUE 的环境变量（优先经 SSH env 静默注入，被服务器拒绝时回落为 export）。
• 新手引导扩展为 5 步：新增「皮肤选择」与「启用插件」两块内容，常用偏好扩充到 6 项，引导窗口更宽并按系统外观自动预选深浅主题。
• 小程序新增绑定邮箱：账号 → 编辑资料中可绑定 / 换绑 / 解绑邮箱（邮箱验证码验证）。

优化 / Improvements

• 终端右键菜单自动避让窗口边缘：靠近底部时向上展开、靠近右侧时向左展开，不再被裁切；修复皮肤模式下右键菜单与划词菜单背景半透明导致的可读性问题。
• 调整两项默认值：「选择文本即复制」「右键粘贴」改为默认关闭（老用户已保存的设置不受影响），右键默认弹出终端菜单。
• 文字战机小游戏射击特效改为电弧效果。
• 官网文档全面更新，补充皮肤、插件、固定命令条、启动命令与环境变量等章节，并重制全部演示截图与动图。

[0.1.6] - 2026-07-17

新增 / Features

• 新增三种连接方式：连接支持「直接连接 / SSH 跳板机 / 代理访问」三种方式。跳板机引用另一条已保存连接、复用其地址与凭证，支持多级跳板链；代理访问引用「设置 → 代理」中的预设代理。
• 新增首次连接主机指纹确认：首次连接主机时展示 SHA256 / MD5 指纹供确认，可勾选「不再提示」；指纹发生变化时告警，防范中间人攻击。
• 新增划词菜单与「分享为图片」：终端选中文本弹出快捷操作菜单，支持把选中输出生成分享图（终端窗口 / 渐变卡片 / 极简纯色三种模板，支持行号、水印、深浅色与自定义标题），一键复制或保存。
• 新增终端右键菜单：粘贴、全选、在此处打开 FTP、在弹出窗口打开等操作。
• 新增实时 SSH 延迟监测：状态栏显示当前延迟，点击查看近 5 分钟延迟折线图与最低 / 最高值。
• 新增 tmux 会话管理：检测远端 tmux，支持列出 / 新建 / 进入 / 退出 / 重命名 / 结束会话，并缓存工作目录。
• 新增临时连接：「新建临时终端」可发起不保存到列表的一次性连接。
• 新增云账号登录：支持微信扫码登录（小程序确认，含扫码状态提示）与 GitHub 登录（Google 登录入口暂隐藏）。
• 新增组织协作（付费）：创建组织默认生成 Owner / Admin / Member 三种角色；Member 不能在侧栏新建，可编辑共享连接的标签 / 备注但不能编辑连接本身；支持组织 Logo、邀请提示、组织付费与订阅逻辑；付费组织内的连接仅允许上传到官方云。
• 新增「保存到个人空间」：组织共享连接可（批量）复制到个人组织与工作区，并以「{组织}->{工作区}」标记来源，hover 连接可查看。
• 新增首次启动引导：主题、字体（含默认字重）、常用偏好与云同步的四步引导，带实时预览演示终端。
• 新增内置小游戏：贪吃蛇与文字战机（ZType）打字游戏。
• 新增与连接绑定的代码片段：片段可关联特定连接，作为该机器的专属命令置顶展示。
• 新增系统托盘弹窗（桌面端）：系统栏图标点击弹出面板，显示登录 / 同步状态与快捷操作。
• 新增快捷键：新建本地终端、清空终端、开关文件传输、显示 / 隐藏片段栏、打开命令历史、打开设置等，均可自定义。
• 新增导入方式：扩充从其他平台导入连接的支持。
• 新增使用数据统计。

优化 / Improvements

• 重构设置页：设置改为全屏页面，左侧导航分为「偏好 / 管理」两组。
• 美化整体主题风格：统一翡翠绿主题，优化左侧连接栏、空态样式、连接选中态底色与图标样式。
• 优化云同步：同步密钥改为本地钥匙串存储；移除「是否同步敏感信息」配置；Gist 同步授权信息更名为 cloud-term 项目。
• 优化连接信息展示：hover 连接显示来源信息，来源放置在认证信息下方。
• 优化 shell 标签显示，增加快捷新建本地终端入口。
• 用户 ID 改为 nanoID。
• 本地服务端口冲突时自动顺延。
• 左下角「更多」按钮显示登录信息。

修复 / Fixes

• 修复 macOS 触控板轻触点击各功能键首次无反应、以及经常连带选中文字的问题。
• 修复终端划词时鼠标移出终端区域后悬浮窗不显示的问题。
• 修复邀请 Member 加入组织后看不到 workspace 连接的问题。
• 修复不能切换组织的问题。
• 修复退出登录后仍能看到组织数据的问题。
• 修复云同步图标状态不正确的问题。
• 修复微信小程序登录异常的问题。
• 正式环境屏蔽浏览器默认右键菜单。

构建与发布 / Build & Release

• 应用版本升级到 0.1.6：同步更新前端与 Rust workspace 版本号。
• 正式环境域名切换为 cloudterm.cn：新增部署脚本与官网隐私政策页面。
• 更改 npm 源地址；调整小游戏排行榜数据库结构；新增 Windows 下启动 cloud-api 服务的支持。

[0.1.5] - 2026-07-06

新增 / Features

• 新增更新日志页面：官网新增「更新日志 / Changelog」页面，通过 VitePress 引入 CHANGELOG.md 展示各版本改动，并接入站点导航。
• 新增通用 Icon 组件：新增 Icon 组件，支持加载 frontend/src/assets/icons 下的各类 SVG 图标，替代原有 ImportIcon；导入连接图标统一更换并规范尺寸为 16px，同时补充 docs/svg-icons.md 使用说明。
• macOS 新增顶部连接菜单：桌面端（Tauri）新增系统原生顶部「连接」菜单栏，可从菜单快速打开已保存的连接；左侧连接栏中未分组的连接改为直接平铺显示，不再包裹在「未分组」文件夹中。
• 新增终端断开重连提示文案：终端连接断开时增加提示重连的文案，交互反馈更清晰。
• 新增 cloud-api 后端项目：新增基于 Spring Boot 的 cloud-api Java 服务，提供鉴权（登录票据、会话管理、微信公众号登录）与云同步接口，并按 controller / dto / entity / mapper / service 分层规范项目结构。

优化 / Improvements

• 重构整体 UI 布局：重构主界面布局并优化诸多样式细节，蒙层改为毛玻璃效果，更新左侧连接栏样式。
• 优化侧边栏显示/隐藏效果：优化 Web 端与 Windows 下侧边栏展开/收起的动画与体验；调整左上角「显示/隐藏所有会话」图标及其 SVG 大小。
• 美化工作区设置页面：美化左侧连接栏字体字重与工作区默认字重，优化工作区设置页 UI；默认行间距调整为 1.25、调节步进改为 0.05。
• 工作区设置抽屉改为左侧弹出：工作区设置 Drawer 改为从左侧滑出，并优化弹出动画效果。
• 增加云同步成功提醒：云同步成功后给出明确的成功提示。
• 清理无用代码。

修复 / Fixes

• 修复更改字体不生效的问题。
• 修复 macOS 下右上角标签页列表图标触控板轻触首次无反应的问题。
• 修复工作区设置中「字体大小」和「底部留白」控件宽度过宽的问题。
• 修复 Windows 下右上角系统图标与 UI 冲突的问题。
• 修复 hover 标签页不显示提示（tips）的问题。

构建与发布 / Build & Release

• 修复同一版本重复打包失败的问题：调整 Windows（build-windows-x64.ps1 / build-windows.bat）与 macOS（scripts/build-macos-target.sh）打包脚本，允许同一版本号重复打包而不报错。
• 应用版本升级到 0.1.5：同步更新前端 package.json 与 Rust workspace（含 frontend/src-tauri）的版本号。

[0.1.4] - 2026-07-02

新增 / Features

• 新增使用文档：官网新增「使用指南」页面（website/guide.md）并接入 VitePress 导航，介绍连接管理、云同步等常见用法。
• 新增可遮罩的 SSH 私钥输入组件：新增 PrivateKeyTextArea 组件，已保存或刚上传的私钥以「已保存密钥，点击此处修改」占位遮罩展示，不直接回显内容；连接表单与设置页统一使用，中英文案与样式同步完善。
• 新增标签页定位连接功能：标签页右键菜单新增「定位当前连接」，可自动打开连接侧栏、展开父文件夹并滚动到对应连接；外观设置中新增「点击标签页定位连接」开关，开启后点击标签页即可定位。
• 新增云同步强制上传：云同步面板新增「强制上传」操作，确认后可直接以本机数据覆盖云端版本，用于云端数据异常或明确以本机为准的场景。

优化 / Improvements

• SSH 后端迁移到异步 russh 实现：移除 ssh2/libssh2 依赖，终端、SFTP、实时状态采集统一改为异步 SSH 通道，增加连接/握手/操作超时、协议 keepalive、keyboard-interactive 密码回退、RSA hash 协商与更清晰的私钥解析错误提示。
• 优化右键菜单响应速度与稳定性：标签页与连接侧栏右键菜单改用 Radix 上下文菜单，改善 macOS 触控板轻触右键首次不弹、菜单打开慢或操作后延迟关闭的问题。
• 优化收藏/取消收藏交互：连接收藏状态采用乐观更新，收藏或取消收藏后立即更新列表，再异步写入后端并标记云同步待上传。
• 优化云同步对大文件的读取兼容性：GitHub Gist 同步文件被截断时改用 raw_url 拉取完整内容；GitHub 私有仓库 Contents API 返回空 content 时改用 Git Blobs API 读取，避免把已存在的大同步文件误判为远端不存在。
• 优化后台自动同步策略：定时同步或本地变更触发的后台同步在存在活动终端会话时不再无预警刷新页面应用远端数据，而是提示「待手动同步」；手动同步与启动同步仍可按预期应用远端数据。
• 优化云同步快照的本机字段处理：导出云端快照时剥离 cloudSync 和 GitHub PAT 等本机专属配置，导入远端快照时保留本机同步状态与凭证，避免跨设备覆盖或把 token 写入云端历史。

修复 / Fixes

• 修复 Windows 下 OpenSSH 私钥无法登录的问题：SSH 后端改为 russh 后统一在内存中解析 OpenSSH / PEM / PKCS#8 私钥，并规范化 CRLF、BOM 与末尾换行，解决部分 Windows 粘贴或导入的 OpenSSH 私钥无法登录的问题。
• 修复 GitHub 私有仓库云同步中「创建 Personal Access Token」链接无法打开的问题：桌面端改用 openExternalUrl 调用系统浏览器打开，替代默认的 <a target="_blank">，并在失败时给出提示。
• 修复连接侧栏右键菜单触发连接信息浮层的问题：右键连接时会立即隐藏并抑制连接信息浮层，避免菜单与悬浮信息同时出现。

构建与发布 / Build & Release

• 应用版本升级到 0.1.4：同步更新前端 package.json 与 Rust workspace（含 frontend/src-tauri）的版本号。
• macOS 本地打包脚本支持签名 + 公证 + 自动更新：scripts/build-macos-target.sh 使用与 GitHub Actions 一致的环境变量（APPLE_SIGNING_IDENTITY / APPLE_CERTIFICATE / APPLE_ID / APPLE_PASSWORD / APPLE_TEAM_ID / TAURI_SIGNING_PRIVATE_KEY 等）完成 Developer ID 签名、公证与原生自动更新产物（.app.tar.gz + .sig）生成；新增 CLOUD_TERM_SKIP_NOTARIZE=1 开关，可在 Apple 公证服务故障时先产出「已签名未公证」的包应急。
• 打包文件名去空格、安装后应用名保留空格：productName 保持 Cloud Term（安装后 Dock/菜单栏仍显示带空格名称），但 macOS 的 dmg / .app.tar.gz 与 Windows 的安装包文件名统一去掉空格（如 CloudTerm_0.1.4_x64.dmg）。
• 修复带空格产品名导致的 DMG 打包失败：打包前自动卸载残留的 /Volumes/Cloud Term 挂载卷并清理 rw.*.dmg 临时盘，避免 bundle_dmg.sh 因同名卷已存在而失败。
• Windows 打包脚本优化：安装包提示文件名改为从 package.json 动态读取版本号，不再写死。
• 清理重复打包脚本：删除已被 build-macos-aarch64.sh / build-macos-x64.sh + scripts/build-macos-target.sh 取代的旧脚本 build-mac.sh，并更新 README 与 requirement 文档指向新的双架构脚本。
• 忽略本地打包产物目录：将 release/ 加入 .gitignore，不再把本地收集的安装包/更新包等生成物纳入版本库。

[0.1.3] - 2026-07-01

新增 / Features

• 新增 GitHub 私有仓库云同步 provider：支持将加密同步快照保存到指定私有仓库文件，使用 Fine-grained Personal Access Token 和 Contents: Read and write 权限；每次上传都会生成 commit，并可通过 commit 历史浏览和恢复旧版本。
• 新增 Fine-grained Personal Access Token 配置：GitHub provider 可配置同步用 PAT，Gist 优先使用 PAT、无 PAT 时回退 OAuth；私有仓库 provider 仅使用 PAT，并在保存时校验仓库是否为 private、token 是否可访问目标仓库。
• 新增云同步状态提醒与活动面板：顶栏云同步图标可提示本地待上传、远端有更新、双端冲突、授权失效等状态，并展示 GitHub 账号、最近提交/同步活动、来源设备和相对时间。
• 新增云同步本地备份与历史恢复：拉取或导入前自动生成本地备份，支持在同步状态页查看和恢复；云端历史可查看快照内容统计并按修订恢复。
• 新增软件更新提醒：顶栏设置入口增加新版本提醒气泡，和云同步状态提醒保持一致的轻量提示体验。
• 新增本地打包脚本：增加 macOS Intel、macOS Apple Silicon 和 Windows x64 本地构建脚本，方便本地验证发布产物。

优化 / Improvements

• 重构云同步判定与合并逻辑：以内容指纹和同步基线代替墙上时钟版本，支持删除墓碑、三方合并、冲突识别和更稳定的本地/远端状态判断。
• 优化云同步设置体验：provider 同时只允许启用一个；GitHub 私有仓库默认推荐并置顶；provider 设置弹窗限制高度并支持内部滚动；本地备份列表自动加载并优化按钮布局；同步密钥文案从 Vault 调整为 Sync Key 语义。
• 优化云同步历史详情统计：历史快照中的 app_settings 不再按行数统计，而是解析 JSON 后统计扁平配置项数量。
• 优化 GitHub API 读取体验：缓存 GitHub 账号资料、提交列表和历史修订来源设备，减少重复请求；请求禁用缓存，降低读取旧数据概率。
• 优化 SSH 身份认证表单：改进 SSH private key 上传控件和相关样式，使密钥输入和上传体验更清晰。
• 优化 README 与构建说明：补充本地打包、平台构建和相关脚本说明。

修复 / Fixes

• 修复 GitHub Gist token 失效时只显示通用失败的问题，现在会提示授权已失效并引导重新连接。
• 修复设置或数据变更后云同步状态没有及时提示待上传的问题。
• 修复 Tauri v2 下弹出新窗口打开连接失效的问题。
• 修复 Windows 下窗口无法放大的问题。
• 修复 macOS Intel 打包失败的问题。
• 修复 GitHub 私有仓库配置保存时因 Gist 字段缺失导致的异常，并补充 public 仓库、token 无效、权限不足、仓库不可访问等明确提示。

构建与发布 / Build & Release

• 将应用版本升级到 0.1.3。
• 新增和调整 macOS 与 Windows 本地打包脚本，支持分别构建 macOS Intel、macOS Apple Silicon 和 Windows x64。
• 优化 Tauri 更新清单生成脚本和发布产物处理，提升本地与 CI 打包一致性。

[0.1.1] - 2026-06-30

新增 / Features

• 新增「记住上次打开的连接」开关（外观设置 → 启动），默认开启。开启后，下次启动会自动恢复上次关闭应用时正打开的连接标签页。Web 端与桌面端通用。
• 桌面端关闭确认（恢复会话）：当关闭开关后、关闭应用时仍有打开的标签页，会弹窗询问「下次启动是否恢复」。选择「是」仅下次启动恢复一次，选择「否」则本次不恢复。该确认仅桌面端（Tauri）生效，Web 端因浏览器限制无法弹自定义关闭对话框。
• 桌面端自动更新：集成 Tauri updater，支持检查新版本、后台下载更新包、下载完成后提示重启安装，并通过签名清单校验更新包。Web 端继续使用检查更新后跳转官网下载页的逻辑。
• 云同步活动显示来源设备：同步快照会记录上传设备名称，云同步弹窗的最近活动中可查看每次上传来自哪台设备。桌面端优先读取系统设备名，Web 端使用浏览器平台信息兜底。
• 官网首页下载卡片识别当前平台：官网会根据访问设备标记「当前平台」，并从 update.json 动态回填 Windows/macOS 下载地址。

优化 / Improvements

• ZMODEM 传输完成后自动聚焦当前标签页：使用 sz 下载、rz 或拖拽上传完成后，终端会在提示符重绘后自动重新获得焦点，无需再手动敲击回车即可继续输入。Web 端与桌面端通用。
• 优化云同步逻辑：同步元数据使用当前应用版本号；GitHub API 请求禁用缓存，减少读取到旧 Gist 数据的概率；同步密钥不一致时给出更明确的解密失败提示；本地/远端状态时间展示更准确。
• 云同步凭证统一存储到 localStorage：桌面端不再使用系统 keychain，避免 macOS/Windows 在未签名或签名变化的构建中反复弹出钥匙串授权提示。请妥善保护本机环境与 GitHub token。
• 统一品牌展示为 Cloud Term：更新应用标题、桌面端配置、官网、README、设置页、终端预览等位置的品牌文案。
• 优化启动 Logo：启动加载页增加品牌背景光效，并统一使用新的品牌大小写。
• 增强会话恢复兼容性：恢复已打开标签页时兼容字符串类型连接 ID，降低历史本地数据导致恢复失败的概率。

修复 / Fixes

• 修复多次 GitHub Actions 桌面端打包异常，包括环境变量、签名密钥准备和构建产物路径问题。
• 移除前端依赖中的私有 npm registry 配置，避免外部环境安装依赖失败。

构建与发布 / Build & Release

• 新增自动生成 Tauri update.json 的脚本，支持从桌面端构建产物提取更新包、签名、下载地址和校验文件。
• 调整桌面端发布 workflow：分别构建 Windows x64、macOS Intel、macOS Apple Silicon，并生成官网部署用的更新产物。
• 将应用版本升级到 0.1.1，Tauri 版本号改为跟随前端 package.json。

[0.1.0] - 2026-06-28

首个发布版本。

• 新增「应用」设置页
• 支持检查更新（桌面端自动更新）
• 修复若干已知问题