OpenTerminal/CHANGELOG.md

# OpenTerminal 更新日志

## v1.0.22 - 2026-10-08

### 输入法
- **修复中文输入法候选窗不跟随光标**(v1.0.21 回归):v1.0.21 的构建环境中终端组件依赖未按锁定版本安装,安装包实际打进的是不含上游输入法修复的旧版本;本版本恢复 v1.0.20 所用的终端组件版本,候选窗重新紧贴光标。

### 安装包
- 不再提供 MSI 安装包(electron-updater 本就不支持 MSI 自动更新),统一使用 NSIS exe 安装包。

### 内部
- 打包流程新增依赖一致性校验:构建前自动比对实际安装的依赖与锁定清单,不一致即中止,防止同类问题再次发生。

## v1.0.21 - 2026-10-07

### 背景图体验
- **浅色主题不再「洗白」**：设置背景图后，调低透明度在任何主题下都是压暗图片（此前浅色主题下调透明度会把图洗成白色，文字完全看不清）。
- **文字自动提亮**：图片模式下终端文字对比度提升到 WCAG AA 级别，浅色主题的深色文字在壁纸上也能清晰可读。
- **新增「背景压暗」滑杆**（设置 → 主题）：在图片之上叠加独立压暗层，图片保持饱和度的同时整体变暗，亮图建议 30–50%。
- 背景图默认透明度从 60% 调整为 30%。

### 性能
- 设置写入不再让所有终端窗格重写参数并重排（字段级订阅，只有相关窗格响应）。
- SFTP 文件列表虚拟滚动：上万条目的目录（如 node_modules）不再卡死窗口。
- 单个窗格崩溃不再拖垮整个工作区：每个面板独立错误边界 + 重试按钮。
- SSH 底部面板拖动更顺滑；传输面板与监控图表的渲染开销显著降低。

### 安装包体积
- 安装包精简约 **90MB**（内置依赖 98MB → 8.1MB）：纯界面依赖不再重复打进安装包。

### 安全加固
- SFTP 上传/下载与 ZMODEM 收发的本地路径，只接受通过系统对话框选择的位置，阻断恶意构造路径的读写。
- SSH 私钥文件增加校验（必须是 ≤1MB 的普通文件）。
- 窗口安全选项显式固定（contextIsolation / nodeIntegration / webSecurity），不再依赖默认值。

### 稳定性修复
- ZMODEM：写入错误正确终结传输、进度事件节流、会话 detach 时补发终结事件。
- 连接/命令配置文件损坏时自动备份旧文件再重建，不再静默丢配置。
- 布局模板应用失败时恢复原布局；锁屏期间后弹出的浮层也被正确禁用。
- 发布通道防降级（拒绝把旧版本盖到更新通道），资产按 sha512 校验。
- SFTP 各操作增加超时兜底，半死连接自动重试一次。
- 启动链路与主机密钥校验多处加固。

### 其他
- 终端标签的自动编号标题（「终端 3」）现在跟随界面语言切换。
- 锁屏快捷键 Ctrl+L 改用物理键位判定，Dvorak 等非 QWERTY 布局也能正确触发。
- 设置页移除无效的「更新通道」下拉框。

## v1.0.20 - 2026-10-01

### 输入法修复
- **修复中文输入法候选窗不跟随光标**：此前在终端里输入中文时（尤其是 Kimi Code、Claude Code 等高频刷新的 TUI 界面），候选窗会漂到远离光标的位置；现已紧贴光标显示。内置终端组件升级至包含上游输入法修复的版本。

### 锁屏加固
- **锁定期间移除应用菜单**：Alt 键唤出的菜单里「重新加载 / 开发者工具 / 缩放」可通过鼠标点击绕过键盘拦截，锁定期间整个菜单摘除，解锁后自动恢复。
- Ctrl+L 立即锁屏的按键判定重构为独立模块并补充 29 条测试用例，防止回归。
- 全局唤起快捷键的录制器保留 Ctrl+L 不允许占用，避免全局注册在系统层静默禁用紧急锁屏。
- 修复：系统休眠或窗口失焦后，锁屏密码框的冷却倒计时可能超过真实截止时间，导致可输入时间被无谓延长。

## v1.0.19 - 2026-09-28

### 更新机制调整
- **更新源改为 GitHub 优先**：检查更新先走 GitHub releases（跟随系统代理），并带 20 秒连通性探测——没有代理或连不通时不会干等，自动改用国内更新通道（强制直连）兜底。
- **GitHub releases 恢复随版本发布安装包**（exe + blockmap + latest.yml），与国内通道保持一致。

### 终端高亮：性能与兼容性
- **引擎提速**：颜色序列改为编译期预计算（不再逐处解析 hex）；高亮区间认领从线性扫描改为有序插入（二分查找）；纯文本洪流（如 cat 大文件）跳过重扫描。实测 200KB 负载：密集匹配场景提速约 19–56%，纯文本流式提速约 54%，输出与旧版逐字节一致。
- **转义序列覆盖更全**：新增 DCS/APC/PM/SOS（tmux 透传、sixel、kitty 图形协议）与 DEC 单字符序列（保存/恢复光标等）的识别，这些场景下同行的正常文本不再丢失高亮。

### 高亮设置页修复
- 「按分类分组」视图现在真正按分类聚簇（此前会被优先级排序打散）。
- 规则编辑器新增「基础规则」开关：可将自建规则加入「仅基础」模式的生效集合。
- 规则集（profile）编辑器勾选部分规则时，会列出未包含的规则。
- 「替换现有规则」导入增加确认提示，且每次打开弹窗默认回到「追加」。
- 修复若干小问题：快速连续开关规则可能丢改动、数值分级行不按阈值排序、清除背景色后色块残留等。

## v1.0.18 - 2026-09-24

- **修复 v1.0.17 的严重回归：锁屏后无法输入密码**。v1.0.17 在锁屏期间由渲染层拦截了全部键盘输入（本意是挡住缩放/刷新快捷键），但按键的默认行为正是「向聚焦的输入框插入字符」，导致锁屏界面密码框收不到任何输入、无法解锁。
- 快捷键拦截已全部移到主进程（`before-input-event`），只拦截刷新/开发者工具/缩放组合键，普通输入不受影响。
- **新增锁屏快捷键 Ctrl+L**：应用内任意位置（包括终端里）按下立即锁屏；未设置锁屏密码时不占用该组合键（shell 的 Ctrl+L 清屏不受影响）。
- **已被 v1.0.17 锁定的用户恢复方法**：完全退出应用 → 删除 `%APPDATA%\OpenTerminal\lock.json` → 重新启动（锁屏数据删除后不会再弹锁屏），升级到本版本后可重新设置锁屏密码。

## v1.0.17 - 2026-09-24

- **新增 设置 → 锁屏 选项卡**：可设置、修改、移除锁屏密码（仅存本机，scrypt 单向哈希，不存明文、无账号体系）
- **三种锁定方式**：立即锁屏、系统闲置指定时长后自动锁定（1/5/15/30/60 分钟，默认关闭）、启动时锁屏
- 锁定后以完全不透明的遮罩覆盖窗口，背后的终端会话保持运行、不会断开，解锁后恢复原状
- 密码输错进入渐进冷却（1 秒→30 秒），防止在键盘前暴力猜测
- **退出并重新启动应用后锁定仍然生效**：托盘退出、任务管理器强杀、崩溃都绕不过锁屏
- 锁定期间停用 Ctrl+R / F5 重新加载、开发者工具与缩放快捷键，避免误触终止遮罩背后的会话
- 忘记密码无法找回，只能删除本机 `%APPDATA%\OpenTerminal\lock.json` 后重新设置

- 打包版本不再读取 `ELECTRON_RENDERER_URL` / `OT_UPDATE_URL` 环境变量，阻断把应用或更新通道指向恶意地址的注入路径
- 渲染进程 preload 重新启用沙箱隔离
- known_hosts 储存无法读取或损坏时改为拒绝连接、提示修复或删除文件，不再静默覆盖全部已固定的主机指纹
- 连接时的密码／口令输入与书签的认证方式统一（密钥／agent 认证的书签不再弹出密码框、不再送出残留的已存密码）
- 修复 SSH 连接异常中断时会话退出通知漏发或重发的问题，终端不再卡在「连接中」
- 分割面板的系统监控在一侧关闭后不再误停另一侧的监控
- 会话日志索引加入路径校验，防止被篡改的索引把日志写到目录之外
- 设置保存改为原子写入，Windows 下文件被占用时自动重试，修复偶发的设置保存失败

- 新增 CI（GitHub Actions）：类型检查 + 10 个离线测试 + 构建
- 窗口隐藏到托盘时，冻结检测日志不再把定时器节流误报为约 1 分钟的「卡死」

## v1.0.16 - 2026-09-23

- **内置规则 11 条 → 22 条**：新增危险/破坏性命令（`rm -rf`、`mkfs`、`dd if=`、`chmod 777`、`drop database`、管道给 `sh` 等）、疑似密钥/令牌提醒、删除/移动/覆盖操作、新建/创建操作、日志级别、退出码、HTTP 状态码、耗时（毫秒）、百分比进度、网络与 IP 地址、时间日期、`root@` 提示符、Shell 关键字、字符串、环境变量等
- **状态词三分配色且不分大小写**：成功（`Success` / `Succeeded` / `Successfully` / `good` / `done` / `OK` / `✓`）、警告（`Warning` / `Caution` / `Deprecated` / `⚠`）、错误与致命（`Error` / `NG` / `err` / `bug` / `fail` / `FATAL` / `CRITICAL` / `PANIC` / `✗`）各自一种颜色
- `not ok` / `not found` 正确显示为错误，不会被误染成成功绿
- **数值分级取色**：百分比低于 20% 红、20–50% 黄、50–80% 浅绿、80% 以上绿；退出码、HTTP 状态码、耗时同样按数值分级取色
- **高亮模式三档**：全部 / 仅基础（只保留错误、成功、警告、危险命令、密钥等关键规则，开销约为全部的 1/4）/ 关闭（零开销）
- 规则支持「忽略大小写」与「数值分级」开关，编辑器内可用测试文本实时预览着色效果
- 规则可导入 / 导出 JSON，方便团队分享同一套配色
- **按主机规则集**：可把规则子集存成命名规则集，并在 SSH 连接编辑里绑定给某台主机（默认关，未绑定的主机跑全部规则）
- **命中/耗时统计**：每条规则在本会话的命中次数与扫描耗时（默认关，关闭时零开销）
- **高亮颜色跟随终端主题**：规则颜色映射到当前主题的调色板，换主题不再突兀（默认关）

- 高亮设置页新增分类列（安全 / 状态 / 文件 / 网络 / 文本 / 数值），可按分类分组查看规则
- 修复高亮设置页工具栏在窄窗口下标签被挤成竖排、按钮不靠右的问题

- 新增关键词高亮规则回归测试（词边界、大小写、反向词、数值分级、导入导出、分块流），`npm test` 全量通过

## v1.0.15 - 2026-09-20

- **自定义终端背景图片**：设置 → 主题 → 背景图片，可为终端指定任意本地图片作为背景，并支持 10%–100% 的图片不透明度调节；移除图片后恢复纯色背景
- **主题编辑器重名提醒**：新建/编辑主题与内置或其他主题重名时给出黄色提示（仍可保存）
- 主题编辑器种子颜色自动规范化，非法颜色值不再能进入自定义主题
- 自定义主题颜色数据损坏时自动修复为默认色，并记录告警日志

- 设置弹窗左侧导航选中项文字改为白色，与未选中项对比度一致（修复蓝色文字在深色背景上看不清的问题）
- 设置弹窗背景图片、透明度等新增控件与四语言（简/繁/英/日）文案同步上线

- 渲染进程与主进程新增冻结时长探测日志，便于后续诊断"卡死无响应"类问题

## v1.0.14 - 2026-09-20

- 修复上传 **大于约 250KB** 的文件会被静默损坏的问题（文件大小正确但内容出现字节错乱）
- 修复每次下载泄漏一个远端文件句柄、每次传输遗留一个 SFTP 通道的问题；服务器协议异常不再导致整个应用退出
- 上传遇到同名文件时先询问是否覆盖；删除多个文件时部分失败会如实报告
- 权限编辑修复：未知权限的文件不再误发 `chmod 000`；GID 留空不再被误改成 UID 的值；正确显示并保留 setuid / setgid / sticky 特殊位
- chmod / chown 增加超时，远端无响应不再永久转圈

- 修复 SSH 输出中文乱码（跨网络包被截断的多字节字符）
- 修复按 Tab 接受补全后命令历史丢失或记录错乱的问题
- 修复 Ctrl+U / Ctrl+W 等编辑键被写进命令历史（表现为历史里出现"两条命令拼接"）
- `cd ~/目录`、`cd $HOME/...` 现在能正确记忆目录，新终端按此恢复
- 中文行内的网址链接点击范围不再错位；窗口尺寸过小时不再向终端发送异常尺寸
- SSH 会话退出时显示真实退出码；ZMODEM 超时/出错不再向终端和日志倾倒乱码

- 启动恢复失败不再导致本次运行期间会话快照永久停止保存
- 监控面板 CPU / 网络历史曲线现在会实时重绘；切到本地终端工作区时停止向服务器轮询
- 广播输入：SSH 分屏关闭一侧不再让另一侧丢失广播目标；取消勾选一个目标不再清空其余选择
- 连接失败时显示真实原因（密码错误 / 拒绝连接等），双击不再重复创建连接
- 修复"关闭其他 / 关闭右侧"会漏关标签的问题
- 界面语言切换首帧即生效；切换主题后活动标签文字颜色自动适配，不再出现浅色主题下看不清
- 私钥路径字段提示纠正为"本机路径"（此前提示为服务器路径，照做会连接失败）

- 禁止把文件拖入窗口导航；外部链接仅允许 http(s) / ftp；IPC 增加来源校验
- 仅密码认证的连接才使用存储的密码（密钥认证的连接不再回退发送密码）
- 连接书签、主机指纹等配置改为原子写入，崩溃不再导致数据丢失
- 渲染进程异常退出时自动回收其全部终端会话与日志
- 自定义主题数据损坏不再导致应用无法启动
- 内置更新通道发布改为原子操作，发布中途失败不再导致自动更新不可用

## v1.0.13 - 2026-09-20

- 支持简体中文 / 繁體中文 / English / 日本語，入口在「设置 → 系统 → 界面语言」，切换即时生效并持久化
- 全应用文案完成迁移：设置各页、工作区、终端右键菜单与搜索、SSH 连接管理、文件面板、系统监控、命令面板、托盘菜单与关闭询问
- antd 组件内置文案（空状态、分页等）随界面语言切换

- 更新日志改为**随安装包内置**，离线也能查看；不再依赖网络接口
- 更新日志支持多语言：按当前界面语言显示，某版本缺翻译时自动回退简体中文

- 修复「关闭按钮行为 = 每次询问」不生效的问题（此前会被静默改回「最小化到托盘」，选项形同虚设）
- 高亮规则不再因字段形状问题被静默丢弃：优先级字符串、0/1 布尔值、缺失前景色等会被自动修复，未知字段保留
- 设置解析告警写入 `settings-warnings.log`，配置异常可追溯

- 终端右上角工具条可配置（设置 → 渲染与行为）：打开工作区目录（默认开启）、记录会话日志、打开日志目录
- 「打开工作区目录」按钮：一键在资源管理器打开终端当前目录，随 `cd` 实时跟踪
- 全局唤起快捷键改为**按键录制**：点击输入框后直接按组合键，Esc 取消、退格清空；需带修饰键或功能键，避免误占普通按键
- 「输入建议」「记录命令历史」默认关闭（已有安装会一次性重置，之后手动开关不再被覆盖）
- 修复设置弹窗内容列无法滚动的问题（antd v6 容器类名变更导致），主题页去掉多余的双层滚动条
- 界面细节：渲染模式与界面语言按钮改为连体分段样式，选中态文字对比度修正

发布时由 `scripts/sync-changelog.cjs` 自动把 RELEASE_NOTES.md 合并进此文件；
内容随安装包内置，「关于」页的更新日志直接读这里，不依赖网络。

## v1.0.12 - 2026-09-20

### 浅色主题对比度修复
- 标签栏/侧栏颜色改为按主题背景亮度自适应：浅色主题下标签栏与终端同色系（不再出现浑浊灰色条），深色主题外观不变
- 修复浅色主题下标签呈深色块、白字的问题：标签底色与文字改由主题变量接管，非活动标签浅底深字，活动标签文字自动压深
- 设置弹窗全面适配浅色主题：字体、高亮、主题等页面的标签/描述/表格/调色板文字改为跟随主题前景色，浅色下清晰可读

### 稳定性
- 会话日志写入改为每文件缓冲 + 单条写循环：高输出场景下合并写入、顺序有保障，不再随写入次数无限堆积
- 设置保存串行化：托盘修改关闭行为与设置界面保存并发时不再互相覆盖丢更新