docs(DLPilot): 面向二供的使用说明入库——使用说明.md 从解压安装包写起（安装/硬件连接/界面总览与快速开始/左列HDMI源端/右列光机控制/命令参考/典型流程/数据判读/FAQ/版本沿革），§3 嵌标注版主界面截图（manual-img/）并配四条上手要点；拓扑表述按勘误校准：HDMI 与 RS485 同接转接板、GD32E230 为板上主控 MCU（逻辑控制），不用 GD32 网关说法；记录转接板上电默认开光机（§3/§7.1）；PDF 不入库、本地保留（暂存时排除，md 可随时重出）；AGENTS.md 进度登记

DLPilot/AGENTS.md

@@ -256,3 +256,13 @@ python publish_gitea.py ../release/DLPilot-v<版本>-win64.zip --replace --insec
   为预置 COM15 配置，本机 COM5 运行态已还原未入库）。遗留（未随本版处理）：
   `dlpc_rs485.py` 的 `except OSError` 把写超时（SerialTimeoutException）与设备
   拔出混判，一次转换器停滞即断链误报"设备拔出"。
+- 2026-10-14 新增面向二供的独立使用手册 `使用说明.md` + `使用说明.pdf`（基于
+  README 与 v0.4.3 Release 编写，从解压安装包写起的操作级文档，含命令参考/典型
+  流程/FAQ/版本沿革；不随发布 zip 分发，单独发给供应商）。PDF 由 md 生成：
+  python-markdown → Chrome headless 矢量打印 → pymupdf 回填目录页码/页脚/元数据，
+  两遍编译（第一遍定位各章节页码，第二遍回填目录），构建脚本为一次性临时产物
+  未入库；后续改 md 后需按同流程重出 PDF。文档拓扑表述已按用户勘误校准：
+  HDMI 与 RS485 接同一块转接板，GD32E230 是板上主控 MCU（逻辑控制），无独立
+  "GD32 网关"说法（README/根 README/本文其他处旧措辞待同步）。§3 界面总览含
+  标注版主界面截图（`manual-img/ui-overview-quickstart.png`，手册配图目录）与
+  四条快速开始要点；已记录"转接板上电默认开光机"新事实（§3/§7.1）。现 11 页。

DLPilot/使用说明.md

@@ -0,0 +1,393 @@
+# DLPilot 使用说明
+
+**HDMI 源端调试 + 光机控制工具**
+
+| 项目 | 说明 |
+|---|---|
+| 适用版本 | v0.4.3（2026-10-13 发布） |
+| 适用系统 | Windows 10 / 11 x64，免安装、无需 Python |
+| 适用对象 | LT8619C（HDMI→RGB888）→ DLPC3421 投影转接板的调试、测试与校准人员 |
+| 文档日期 | 2026-10-14 |
+
+DLPilot 是配套投影转接板调试的 PC 端工具，一台电脑同时完成两件事：
+
+- **HDMI 源端**：查看板卡上报的 EDID、切换输出分辨率、向板卡全屏投放测试图案
+  （纯色、黑白测试图、自定义校准图）；
+- **光机控制**：通过 USB-RS485 控制光机——开关光机、设光强、查温度/电流、
+  PD 电源自检与功率读数、TEC 温控。
+
+界面上左右两列分别对应这两个功能域，互不干扰，可以只用其中一列。
+
+---
+
+[TOC]
+
+---
+
+## 1. 安装（从压缩包开始）
+
+### 1.1 拿到安装包
+
+安装包为 `DLPilot-v0.4.3-win64.zip`（约 67 MB），由我方对接工程师提供。
+收到后请先核对文件名中的版本号，本文档对应 **v0.4.3**；若版本更新，以随包说明为准。
+
+### 1.2 解压
+
+1. 在电脑上选择一个**可写**的本地目录，例如 `D:\Tools\`（不要解压到只读目录、
+   网络共享盘或需要管理员权限才能写入的系统目录，原因见 1.5 节）；
+2. 右键压缩包 →「全部解压」→ 目标路径填 `D:\Tools\`，确认后完成解压；
+3. 解压后得到一个 `DLPilot` 文件夹。
+
+> **注意：不要在压缩包预览窗口里直接双击运行 exe。**
+> 直接从压缩包内运行时程序被解压到临时目录，你配置的自定义图片和串口参数
+> 会写到临时目录并随其清空而丢失。务必先完整解压，再运行解压后的 exe。
+
+解压后的文件夹内容如下：
+
+| 文件 | 作用 |
+|---|---|
+| `DLPilot.exe` | 主程序，双击运行（单文件自包含，光机控制所需串口库已内置） |
+| `pattern_slots.json` | 运行配置：自定义图案栏位、测试卡区域、串口参数记忆。**删除它会丢失你的全部本地配置** |
+| `bw_*.png`（5 张） | 640×360 黑白测试图：西门子星、频率扫描条纹、渐变棋盘、波带片、综合测试卡 |
+| `solid_*.png`（10 张） | 800×600 纯色测试图（R/G/B 各 55/AA/FF + 三原色），供自定义栏位加载 |
+| `CeramixNano-*.png`（如包含） | 光机校准图案（black / white / contrast / circle_640p / caliPoint / sharpness），新版本安装包已预置到自定义栏位 |
+| `README.md` | 随包说明（与本文档内容同源） |
+
+### 1.3 首次启动
+
+双击 `DLPilot.exe`：
+
+- 首次启动比之后慢一两秒（单文件程序需要先自解压），属正常现象；
+- 程序没有数字签名，首次运行 Windows SmartScreen 可能弹出
+  「Windows 已保护你的电脑」——点「更多信息」→「仍要运行」即可；
+- 个别杀毒软件可能对加壳的单文件 exe 误报，如遇拦截请放行或将安装目录加入白名单。
+
+程序启动后出现双栏主界面（见第 3 节），即安装成功。
+
+### 1.4 升级新版本
+
+1. 关闭正在运行的 DLPilot；
+2. 解压新版本压缩包到**新的空目录**（不要直接覆盖旧目录，避免新旧文件混杂）；
+3. 如需保留旧版的自定义栏位与串口记忆：把旧目录里的 `pattern_slots.json`
+   和你自己添加的图片文件复制到新目录，覆盖同名文件即可；
+4. 双击新目录的 `DLPilot.exe`。
+
+### 1.5 为什么必须放在可写目录
+
+程序的所有本地数据（`pattern_slots.json` 配置、你添加的自定义图片）都保存在
+**exe 所在目录**，不写注册表、不写用户目录。放在只读目录会导致配置保存失败。
+两份不同目录的安装（比如两台工位电脑、或同一台电脑解压了两份）各自独立保存配置，互不影响。
+
+## 2. 硬件连接
+
+### 2.1 整体链路
+
+```
+PC(DLPilot) ──HDMI──→ LT8619C（HDMI→RGB888）──RGB888 视频──→ DLPC3421 光机
+PC(DLPilot) ──USB-RS485──→ GD32E230 主控 ───I2C 控制(0x1B)──→ DLPC3421 光机
+```
+
+HDMI 与 RS485 接的是**同一块转接板**：LT8619C 负责把 HDMI 视频转换为 RGB888；
+GD32E230 是板上的主控 MCU，负责整板逻辑控制——DLPilot 的 RS485 命令由它解析，
+再经 I2C 总线控制光机（DLPC3421）。
+
+### 2.2 HDMI 连接
+
+1. 用 HDMI 线把电脑显卡输出接到转接板 HDMI 输入；
+2. 板卡正常上电。板卡 shadow EDID 只声明 640×360@60 一种模式；
+3. 如果 Windows 没有自动点亮这块"显示器"（显示设置里看不到）：
+   启动 DLPilot，工具检测到是本系列板卡（EDID 厂商签名）接入但未进桌面时，
+   会自动把它以扩展屏方式拉回桌面；仍不行时在 Windows「显示设置」里手动改为「扩展这些显示器」。
+
+### 2.3 RS485 连接（光机控制）
+
+1. USB-RS485 转换器接电脑 USB，其 A/B 端子对应接转接板的 RS485 A/B 端子；
+2. 串口参数固定 **115200 波特率、8 数据位、无校验、1 停止位（115200 8N1）**，
+   软件默认值即为此，一般无需修改；
+3. 板卡供电建议使用满足 **PD 12V / ≥3A** 的电源适配器——软件的"电源自检"
+   就是以该挡位为正常判据（见 5.3 节）。
+
+### 2.4 上电时序（重要）
+
+DLPC3421 光机芯片启动需要几秒钟。**上电后立即发开光机/设光强/查电流命令会收到
+拒绝应答（0xFF），这是正常保护，不是故障**——稍等几秒待光机就绪后再发。
+
+## 3. 界面总览
+
+主窗口为双栏仪表盘，顶栏可切换 Dark / Light / System 外观（跟随系统为默认），
+顶栏右侧「关于」按钮内有软件版本信息：
+
+| 左列（HDMI 源端） | 右列（光机控制 RS485） |
+|---|---|
+| 显示器选择：显示器下拉 + 刷新 | 串口选择：串口下拉 + 波特率等参数 + 连接 |
+| 支持的模式（默认折叠）：分辨率下拉 + 应用 / 恢复 + 时序明细 | 电源检查：电源自检 + 功率检测 |
+| EDID 信息（默认折叠）：解算结果一览 | 串口数据：收发日志（译码 + hex）+ 清空 |
+| 测试图案：内置图案 / R·G·B 色值 / 自定义与校准栏位 / 测试卡区域选择 | 光机命令：快捷按钮排 + 预设下拉 + 自定义输入 + 温度读取 |
+| EDID 原始数据：hex 显示 + 逐字节解析 | 快捷滑条：光强 / 定时 / TEC 温度 |
+
+![DLPilot 主界面（红框标注为快速开始要点）](manual-img/ui-overview-quickstart.png)
+
+*图 1　主界面与快速开始要点*
+
+红框与编号对应四个上手要点：
+
+1. **选显示器**：左上「显示器选择」卡的下拉框选中接转接板的显示器
+   （Generic PnP Monitor），下方会显示当前实际输出分辨率/刷新率；
+   多屏或热插拔后点「刷新」重新枚举；
+2. **投测试图案**：现在的转接板**上电默认打开光机**，无需先连串口——
+   在「测试图案」卡选好测试卡区域后即可直接投放指定图案
+   （点「停止」按钮或按 ESC 退出全屏）；
+3. **连串口**：需要控制光机光强、查温度/电流等才需要串口——USB-RS485
+   转换器接好后，在「串口」卡选口（参数保持默认 115200 8N1）点「连接」；
+4. **控光机**：常用光机控制都集中在「光机命令」卡（开/关光机、查版本、
+   软件重启、TEC、温度读取、预设下拉与自定义输入），下方「快捷滑条」
+   可便捷调光强、定时投光、TEC 温度。
+
+「支持的模式」「EDID 信息」两张卡片默认折叠，点卡片标题展开。
+左列只操作显卡输出（不碰光机），右列只操作光机（不碰显卡）。
+
+## 4. HDMI 源端操作（左列）
+
+### 4.1 选择显示器
+
+1. 左上下拉框列出当前所有显示器，选中**接转接板的那一块**；
+   多屏时注意核对型号/分辨率，不要选成你的主屏；
+2. 热插拔后列表没刷新时点「刷新」重新枚举；
+3. 下拉框内容与系统识别一致；如对序号有疑问，可在 Windows「显示设置」中
+   点「识别」核对。
+
+### 4.2 查看支持的模式 / 切换分辨率
+
+1. 展开「支持的模式」卡片，下拉框列出显卡按该屏 EDID 提供的全部模式
+   （板卡正常时可见 640×360@60）；
+2. 选中模式后点「应用」即切换。**切换是临时的**：不写注册表，重启电脑或
+   重新插拔即还原，不会永久改动你的桌面设置；
+3. 测试完成后点「恢复」，回到本次打开软件时的原始模式；
+4. 卡片同时显示选中模式的时序明细，可核对像素时钟、刷新率等。
+
+### 4.3 查看 EDID
+
+- 「EDID 信息」卡片：显示从该显示器读到的 EDID 解算结果——厂商、型号、
+  尺寸、Gamma、输入类型、支持的全部模式、首选时序完整参数、校验和；
+- 「EDID 原始数据」卡片：显示 128 字节（含扩展块）原始 hex；
+  点右上「逐字节解析」按钮，可按偏移逐字段展开基础块与 CTA-861 扩展块，
+  每个字段附原始字节，适合核对板卡 EDID 是否按规格上报。
+
+### 4.4 投放测试图案
+
+1. 先在「测试卡区域」选择投放区域：
+   - `640x360`（默认）——与光机面板原生分辨率 1:1，**链路验证/校准用这个**；
+   - `800x600`——对应 demo 板首选时序；
+   - `full`——铺满所选显示器的整个屏幕；
+2. 点「测试图案」卡片中的按钮即全屏投放到所选显示器：
+   - 内置图案：纯红、纯绿、纯蓝、黑白棋盘格、网格线（程序直接绘制）；
+   - R/G/B 三行 `55 / AA / FF` 色值按钮：按通道着色的纯色，用途见 7.2 节；
+   - 自定义/校准图片栏位：见 4.5 节；
+3. 投放新图案会自动替换当前旧图案；按 **ESC** 键或点「停止测试图像」退出全屏。
+
+### 4.5 自定义图片栏位（含校准图案）
+
+「测试图案」卡片提供 **10 个可配置栏位**，每个栏位一个图案按钮 + 一个齿轮按钮：
+
+1. 点某个栏位的**齿轮**按钮，弹出配置对话框；
+2. 填写栏位名称（显示在按钮上），选择图片文件（推荐 PNG；JPG/BMP/WebP
+   依运行环境而定，PNG 最稳妥）；
+3. 保存后图片自动**复制到 exe 所在目录**，栏位按钮即可点按投放。
+   因此不要事后手动移动/删除 exe 旁的图片文件，否则栏位失效；
+4. 安装包已预置常用栏位（黑白测试图与校准图案，具体以包内为准），
+   可按上述步骤改成你自己的图。
+
+栏位配置、测试卡区域选择会自动保存在 exe 旁的 `pattern_slots.json`。
+
+## 5. 光机控制操作（右列）
+
+### 5.1 连接串口
+
+1. 「串口选择」卡片：下拉框列出所有串口，显示为 `COMx + 设备描述`。
+   多路 USB 转换器（如 CH344 四路）每一路描述不同（serial-A/B/C/D），
+   据此选口；描述相同时软件自动附物理位置区分；
+2. 波特率等参数默认 115200 8N1，与板卡固件约定一致，保持默认即可；
+3. 点「连接」。连接失败会给出简短原因（串口被占用/不存在等），
+   完整错误信息进收发日志；
+4. 上次使用的串口与参数会被记住，下次启动自动带出（预置配置带的串口如与
+   你现场不符，第一次使用时改成你的实际串口即可）。
+
+### 5.2 收发日志
+
+「串口数据 · 收发日志」卡片实时显示：
+
+- `→` 发出的命令；
+- `←` 收到的应答：**可读译码 + 原始 hex** 对照显示；
+- 错误自动附释义，例如 `err:3（I2C NACK）` 表示光机侧 I2C 无应答；
+- 点「清空」清屏。日志超过 500 行自动滚动淘汰旧条目，长时间联机不会卡顿。
+
+协议帧格式（判读 hex 时参考）：命令帧 `D5 01 LEN <ASCII命令> CRC`，
+应答帧 `B5 TYPE LEN <payload> CRC`，CRC 为自第 2 字节起的累加和低 8 位。
+
+### 5.3 电源检查
+
+「电源检查」卡片有两个按钮：
+
+- **电源自检**：自动依次查询供电协议（M301）→ PD 挡位最大电流（M302）→
+  实测母线电压（M303），并按实测电压就近判定 PD 固定挡（5/9/12/15/20/28V）：
+
+  | 显示 | 含义 |
+  |---|---|
+  | 绿底，如 `FPDO: 12V@3A` | 供电正常：12V 挡且电流 ≥3A |
+  | 红底，如 `FPDO: 9V@3A` | 挡位不符：电源没有协商到 12V 挡，请换符合要求的 PD 电源 |
+  | `ERR` | 实测电压不落在任何标准 PD 挡内，检查供电 |
+
+  说明：取电芯片的电压配置寄存器只写不可读，挡位只能靠实测电压判定，
+  所以以自检结果为准，而不是电源标称。
+
+- **功率检测**：自动依次读母线电压（M303）/ 负载电流（M304）/ 负载功率（M305），
+  读数框显示 电压(V)、电流(mA)、功率(W)。功率量程 0～295 W。
+
+### 5.4 光机命令
+
+「光机命令」卡片从上到下：
+
+1. **快捷按钮排**（最常用操作一键完成）：
+   `开光机`、`关光机`、`查版本`、`软件重启`、`开TEC`、`关TEC`、`TEC33.0°C`；
+2. **温度读取**：`查DMD温度`、`查LAMP温度`，应答数值（0.1°C 单位换算后）
+   实时填入按钮旁的显示框；
+3. **预设下拉**：常用命令清单，选中即发送；
+4. **自定义输入框**：手动输入任意命令（见第 6 节命令表），**回车即发送**。
+
+### 5.5 快捷滑条
+
+「快捷滑条」卡片三个滑条，拖到目标值后点对应按钮下发：
+
+- **光强**：拖动后点「下发电流值」（有效范围 54–800，RGB 三路同值）；
+- **定时**：设定毫秒数后点「开光机(定时)」——开光机并在到时后自动关，
+  0 表示不限时；上限 32700 ms；
+- **TEC 温度**：滑条/输入框设定凝露点 200–350（对应 20.0–35.0°C），
+  点「下发温度值」。
+
+滑条旁的数值输入框支持直接键入，回车后自动限制到有效范围并与滑条同步。
+
+## 6. 光机命令参考
+
+| 命令 | 功能 | 应答示例 / 说明 |
+|---|---|---|
+| `M1` | 协议握手 | `ok` |
+| `M730S0` / `M730S1` | 开 / 关光机 | `ok` |
+| `M730S0T2000` | 开光机并定时 2000ms 自动关 | `ok`；定时 ≤32700 ms |
+| `M731S100` | 设光强（54–800，RGB 同值） | `ok`；失败回 `err:R..G..B..` |
+| `M732` | 查三路电流设置值 | `okR110G110B110` |
+| `M737` | 查投光是否结束 | 投光进行中会**延迟应答**，属正常 |
+| `M201` / `M202` | 查 DMD / LAMP 温度 | `okTL:246` = 24.6°C |
+| `M7S0` / `M7S1` | TEC 自动控温 **开** / 关 | 注意 **S0 是开**，方向与直觉相反 |
+| `M8S330` | TEC 凝露点 33.0°C | 范围 200–350，超范围回 `err:OL` |
+| `M301` | 查供电协议（PD/QC3.0/EPR…） | ASCII 文本 |
+| `M302` | 查 PD 挡位最大电流 | mA（50mA/LSB 已换算） |
+| `M303` | 查母线电压（实测） | 如 12020 mV = 12.02 V |
+| `M304` | 查负载电流（实测） | mA，带符号（正=正向） |
+| `M305` | 查负载功率（实测） | mW，软件换算显示为 W |
+| `M999` | 查固件版本 | 如 `okv20.0.0.1` |
+| `M888` | 软件重启 | `ok` 后约 100ms 复位 |
+
+> **注意：**
+>
+> 1. 光机上电后几秒内处于启动期，此时 `M730/M731/M732` 会被就绪门禁拒绝（回 0xFF），
+>    等几秒再发即可；
+> 2. USB-RS485 转换器是半双工的：本机发送期间板上回包不会回环显示，属正常现象；
+> 3. 设光强等带数值的命令，超范围值会被板卡拒绝，请按表中范围下发。
+
+## 7. 典型操作流程
+
+### 7.1 首次整链路验证（新板卡点灯）
+
+```
+1. HDMI 接转接板，USB-RS485 接板卡 A/B，板卡上电（PD 12V/≥3A），等数秒
+2. 启动 DLPilot → 「刷新」→ 显示器下拉选中板卡（640x360@60）
+3. 光机控制：选串口 → 连接 → 点「查版本」（M999）
+   应答 okv... 即 RS485→光机 链路通；无应答见第 9 节排查
+4. 点「电源自检」：绿底 FPDO: 12V@3A 即供电合格
+5. 测试卡区域选 640x360（与光机面板原生 1:1）；转接板目前上电默认开光机，
+   可直接投图，若光机已被关闭再点「开光机」
+6. 投放测试图案目视检查 → 设光强/查温度电流（按需）
+7. 测完：「关光机」→ 分辨率「恢复」→ 停止测试图像
+```
+
+### 7.2 RGB 通道与位序检查
+
+用「测试图案」里的 R/G/B 行色值按钮（`55 / AA / FF` 三档）：
+
+1. **纯红/纯绿/纯蓝**：验证 RGB 三通道映射是否正确
+   （硬件约定 R=D[23:16]、G=D[15:8]、B=D[7:0]，投纯红时仅 R 通道应有输出）；
+2. **55 与 AA 配对**：`0x55`（01010101）与 `0xAA`（10101010）互为字节镜像，
+   专用于检出位序颠倒——位交换设置（0x606E）正确时图像应为 50% 灰阶占空比；
+3. **FF**：全高基准，配合电流读数核对满幅输出。
+
+### 7.3 校准图案投放
+
+1. 「测试卡区域」选 `640x360`（校准图按光机原生分辨率制作）；
+2. 安装包已预置校准栏位（black / white / contrast / circle_640p / caliPoint /
+   sharpness，以包内为准）；如需换用自己的校准图，按 4.5 节齿轮按钮配置；
+3. 依次点栏位按钮投放，按校准规程判读（新图案自动替换旧图案，无需先停止）；
+4. 完成后 ESC 退出。
+
+## 8. 数据判读速查
+
+| 现象/读数 | 判读 |
+|---|---|
+| 开机后发命令回 `0xFF` | 光机启动中，就绪门禁拒绝，等几秒重发 |
+| 日志出现 `err:3（I2C NACK）` | 光机侧 I2C 无应答：光机未上电/未就绪，或板卡故障 |
+| 温度应答 `okTL:246` | 24.6°C（0.1°C 单位） |
+| 电流应答 `okR110G110B110` | R/G/B 三路电流设置值均为 110 |
+| 电源自检红底 `FPDO: 9V@3A` | PD 只协商到 9V 挡，未到 12V，更换/检查电源与线材 |
+| 定时投光中 M737 无立即应答 | 正常：投光结束才应答，勿反复重发 |
+
+## 9. 常见问题（FAQ）
+
+**Q1：双击 exe 没反应 / 被 Windows 拦截。**
+SmartScreen 弹窗点「更多信息」→「仍要运行」；杀毒软件误报时放行或加白名单；
+仍不行则确认解压完整（exe 约 67 MB）。
+
+**Q2：光机命令发出去没反应。**
+按顺序排查：① 串口选对没有（115200 8N1）、A/B 线接对没有；② 先点「查版本」
+（M999）验证链路，M999 都不通就是串口/接线问题；③ M999 通但开光机回 0xFF——
+光机启动中，等几秒重试；④ 半双工转换器发送期间看不到回环是正常的。
+
+**Q3：显示器下拉里找不到板卡。**
+检查 HDMI 线与板卡供电；点「刷新」；启动 DLPilot 会自动把本系列板卡拉回扩展桌面，
+仍不行到 Windows 显示设置手动改「扩展这些显示器」，然后回软件刷新。
+
+**Q4：切了分辨率，桌面布局乱了。**
+软件的切换是临时的：点「恢复」立即还原；重启电脑或重插 HDMI 也会还原。
+不会永久改动系统设置。
+
+**Q5：自定义栏位点了没图。**
+该栏位未配置图片（点齿轮配置）；或 exe 旁的图片文件被移动/删除——重新配置一次，
+图片会重新复制到 exe 旁。
+
+**Q6：串口下拉里好几个 COM 口，选哪个？**
+下拉项带设备描述（如 USB-SERIAL CH340 / serial-A~D），选你的 USB-RS485
+转换器对应的口；描述相同的会附物理位置。拿不准就拔插一次看哪个口出现/消失。
+
+**Q7：两台电脑/两个目录各解压了一份，配置会串吗？**
+不会。配置保存在各自 exe 旁的 `pattern_slots.json`，互相独立。
+
+**Q8：软件用久了变卡。**
+v0.4.2 及更早版本存在长会话卡顿问题，v0.4.3 已修复；请确认用的是 v0.4.3
+（顶栏「关于」可查版本），旧版本请升级。
+
+**Q9：换电脑要带走哪些东西？**
+整个安装目录打包即可；至少要 `DLPilot.exe` + `pattern_slots.json`（含你的栏位
+与串口记忆）+ 你添加的自定义图片。
+
+## 10. 版本沿革
+
+| 版本 | 日期 | 要点 |
+|---|---|---|
+| v0.4.3（当前） | 2026-10-13 | 修复长会话越用越卡、命令点击无响应的问题（收发日志积压）；新增日志回归自检 |
+| v0.4.2 | 2026-09-28 | 收发日志「清空」按钮归位；恢复光机快捷按钮排（开/关光机、查版本、TEC 等） |
+| v0.4.1 | 2026-09-28 | 修复切换 Light/Dark 主题后色值按钮底色丢失；串口连接失败改为简短提示，不再撑破窗口 |
+| v0.4.0 | 2026-09-24 | 界面重写为双栏仪表盘（Fluent 风格），功能基线版本 |
+
+## 附录：技术支持
+
+遇到本文未覆盖的问题，请联系我方对接工程师反馈：
+软件版本号（顶栏「关于」）、操作步骤、收发日志截图（含原始 hex），
+光机问题请同时提供「查版本」（M999）与温度读数。