QTermWidget

从 https://github.com/lxqt/qtermwidget.git fork 而来，为了自己的一些开源项目（quardCRT/quard_star_tutorial）而修改。复用了大量原始代码但同时也大量修改了很多，因此只能作为一个单独的项目存在。

主要修改如下：

• 从原项目中删除了pty部分的实现，因为原项目中的实现不支持windows，因此在这里引入ptyqt(同样是来自我的个人Fork版本)，这样就跨平台支持linux/windows/macOS了。windows环境同时支持mingw和msvc，这部分对应代码改动比较大。
• 清理了Session的代码，将部分代码向前或向后移动到了TerminalWidget和Vt102Emulation中，使得代码更加清晰。termwidget此时有两个主要的类，TerminalDisplay和Vt102Emulation，TerminalDisplay负责绘制，Vt102Emulation负责解析和处理终端数据，而更高层次的Session以及SessionManager、SessionGroup等类都应该交由上层应用自行实现。这样的设计使得termwidget更加灵活，可以适应更多的应用场景。
• 修改了部分东亚字符的特殊处理，修复方式比较hack，但是对中文用户体验更好。
• 增加了选中字符的强调颜色设置透明度的功能，而不仅仅是反色处理。
• 增加了zmodem检测的功能，可以自动检测zmodem的传输请求发送singal
• 增加了块选择和列选择组合按键
• 增加开放了一些已有的内部API接口对外，方便外部配置设置使用。
• 修复了一些可能的问题，以及在windows上的一些小问题。
• 从原项目中拣选了部分未完成的PR，进行了一些修改和整合。
• 去除全部的构建依赖，使用 CMake 构建，通过 add_subdirectory(lib) 引入即可，极为方便通过源码引入其他项目。
• 移植上游 DCS/APC/SOS/PM 控制串吞吃支持与 DECRQM 模式查询应答。
• 移植上游选择区修复系列（块选择/列选择边界、三击选行等）与双宽高行绘制修复。
• 移植上游 Fill 背景模式（背景图等比缩放填满整个终端，裁剪溢出部分）。
• 修复翻译链：lrelease 编译 .ts 为 .qm 并内嵌进 qrc 资源，运行时按系统 locale 自动加载。
• 修复静态库 res.qrc 资源被链接器剥离导致配色方案不可用的问题。
• 升级 vendored utf8proc 至 2.11.3（Unicode 17 数据）。
• 字符管线升级为 char32_t，修复 BMP 外字符（emoji 等）代理对拆分问题。
• 增加 OSC 52 剪贴板读写开关（默认允许，保持现有行为兼容）。注意：允许时远程程序可写本地剪贴板，有安全风险，上层应用可用 setOsc52Enabled(false) 关闭。
• 屏幕缓冲区安全修复（越界访问防护）。
• 修复 Emulation 默认解码器未初始化的问题。
• 支持 OSC 8 显式超链接（Ctrl+点击打开、右键复制链接地址，优先于正则 URL 匹配）。
• 支持同步输出模式 CSI ? 2026（TUI 批量重绘防闪屏，带超时/输入兜底强制刷新）。
• 支持 kitty 键盘协议级别 1+2（按键消歧义与重复/释放事件上报）。
• 支持 Sixel 图形协议（终端内嵌位图显示，图像随行滚动入历史，资源上限防护）。
• 支持 Kitty 图形协议核心子集（APC 分块传输、PNG/RGBA/RGB、zlib 压缩、z-index 分层显示、id/放置管理与删除语义、命令应答）。
• 支持花样下划线（SGR 4:1-4:5 五种样式：单线/双线/波浪/虚线/点线，4:0 关闭，58/59 独立下划线色设置与复位）。
• 支持 SGR 38/48 冒口子参数真彩（38:5:n、38:2::r:g:b 与 48 同款，容忍色彩空间空位）。
• 支持编程连字渲染（可选开关，默认关）：开启时等宽连字字体下 ASCII 运算符序列渲染为连字字形（字体默认整形），关闭时显式禁用 liga/calt 特性（Qt 基线 6.8）；含样式边界不跨片段、跨度脏区配套扩展；TerminalDisplay::setLigaturesEnabled(true) 开启。

目录结构

• lib/include/ — 对外公共头文件
• lib/src/emulation/ — 终端数据解析与处理（Vt102Emulation、Screen 等）
• lib/src/display/ — 终端绘制（TerminalDisplay）
• lib/src/widget/ — 对外组件封装（QTermWidget）
• lib/src/util/ — 配色、键位、过滤器、历史缓冲等辅助类
• lib/third_party/utf8proc/ — vendored utf8proc 2.11.3
• lib/third_party/ptyqt/ — vendored ptyqt（跨平台 pty 实现）
• lib/resources/ — 配色方案、键位布局、翻译与 res.qrc（qrc 前缀 :/lib/qtermwidget）
• example/ — 示例程序

构建

依赖 Qt6（Core/Gui/Widgets/Network/Xml/Multimedia 模块）。

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --parallel

构建完成后会得到静态库 qtermwidget（CMake 目标别名 ZzQTermWidget::qtermwidget）以及示例程序 qtermwidget_example。

配色方案、键位布局与翻译均已通过 qrc 内嵌进静态库并在运行时自动初始化/加载（翻译按系统 locale 匹配），无需额外部署资源文件。

常用选项：

• -DZZQTERMWIDGET_BUILD_EXAMPLE=OFF 关闭示例程序的构建。
• -DZZQTERMWIDGET_INSTALL=OFF 关闭安装规则的生成。

作为子项目引入时，只需在你的 CMakeLists.txt 中：

add_subdirectory(path/to/ZzQTermWidget/lib)
target_link_libraries(your_target PRIVATE ZzQTermWidget::qtermwidget)

测试

• 测试位于 tests/，使用 Qt 官方 QTest 框架（Qt6::Test），无第三方依赖。
• 选项 -DZZQTERMWIDGET_BUILD_TESTS=ON（默认开）；运行：ctest --test-dir build --output-on-failure。
• 新增核心逻辑（解析器、屏幕缓冲、宽度判定等）必须附带回归测试。

性能与渲染回归：

• tst_benchmark：渲染性能基线（解析吞吐 / 全量重绘 / 局部刷新 / 整屏滚动），真实增量口径（updateImage 比对段 + lastDirtyRegion 离屏渲染段），进 ctest 但无硬性性能断言，数字仅 Release 构建下有参考意义。
• tst_rendering：像素等价性测试，批次聚合与 Legacy 两条绘制路径双渲染逐像素比对，以及跨度脏区/滚动快路径的增量重放等价（脏区渲染到上帧 vs 全量渲染），是绘制路径改造的安全网。

一些注意：

• 原始项目使用 CMake 构建，本项目同样使用 CMake 构建（顶层 CMakeLists.txt、lib/CMakeLists.txt、lib/third_party/ptyqt/CMakeLists.txt）。
• 内部头文件（Emulation/Screen/TerminalDisplay 等，安装时会被平铺导出）的字符管线签名已由 wchar_t 迁移至 char32_t、rendition 由 quint8 扩展至 quint16，直接使用这些内部头的下游项目需同步适配。
• 在Qt6.11.1上测试通过。
• 本项目完全遵守原始项目的LICENSE，修改新增的代码也遵守原始项目的LICENSE。

以下为原始的README：

README.md