فهرست منبع

新增 Windows 便携版 exe 打包支持并移除 RS485 方向脚控制

- 新增 packaging/(launcher 启动器、PyInstaller spec、build_exe.bat、依赖与说明),同一套后端加前端可打成单文件 exe 在 Windows 上双击运行
- 新增 backend/paths.py 抽象运行路径:源码运行仍用 backend/,打包后只读资源走 sys._MEIPASS、配置与快照落 exe 同级 data/,避免 onefile 退出后数据丢失
- app.py 抽出 main() 作为共用入口,增加 SPA 静态资源兜底路由,Windows 下重启服务接口返回 400、hostname 改用 platform.node()
- 按现场要求删除 serial_port.py 的 Rs485Direction 及全部方向 GPIO 逻辑,写路径统一为 _write_and_flush(),并移除 config.py 中三项 SERIAL_RS485_DIR_* 配置
- 同步更新 AGENTS.md 部署记录与 .gitignore(忽略 dist/build/.venv-exe/data)
wenhongquan 1 هفته پیش
والد
کامیت
cc90255848

+ 1 - 8
.commandcode/taste/taste.md

@@ -1,9 +1,2 @@
 # Taste
-
-## Communication
-- Communicates in Chinese and expects replies in Chinese. Confidence: 0.7
-- States feature requests as terse, numbered requirement lists (in Chinese), describing the desired outcome/user benefit rather than implementation details. Confidence: 0.5
-
-## Workflow
-- Expects the agent to read and follow the project's AGENTS.md / agent instructions before acting (reminds the agent to check it). Confidence: 0.7
-- Project convention that documentation (AGENTS.md) be updated alongside each code/hardware change; expects the agent to do this proactively. Confidence: 0.6
+See [taste/taste.md](taste/taste.md)

+ 6 - 0
.commandcode/taste/taste/taste.md

@@ -0,0 +1,6 @@
+# Taste
+- Communicates in Chinese and expects replies in Chinese. Confidence: 0.7
+- States feature requests as terse, numbered requirement lists (in Chinese), describing the desired outcome/user benefit rather than implementation details. Confidence: 0.5
+- Expects the agent to read and follow the project's AGENTS.md / agent instructions before acting (reminds the agent to check it). Confidence: 0.7
+- Project convention that documentation (AGENTS.md) be updated alongside each code/hardware change; expects the agent to do this proactively. Confidence: 0.6
+- Declines redundant large file transfers over the slow network — when a build artifact is already published somewhere reachable (e.g. an SMB share), don't also copy it back to the local machine unless asked. Confidence: 0.5

+ 6 - 0
.gitignore

@@ -10,3 +10,9 @@ worktrees/
 
 # Runtime auto snapshots (dzxj_dtu config backups)
 backend/backups/
+
+# Windows 便携版 exe 打包产物
+/dist/
+/build/
+/.venv-exe/
+/data/

+ 13 - 11
AGENTS.md

@@ -47,6 +47,7 @@
   - 部署时 `/dev/ttyUSB0` 不存在(未插 USB-RS485),串口显示未连接,属硬件未接,非软件问题;需要时插 USB-RS485 或在网页把串口改回板载 `/dev/ttyS8`(注意 ttyS8 历史上「能发不能收」)。
 
 - **2026-11-03 RS485 方向脚配置(adb serial `faeb8ddfc39b2ded`,IP `192.168.10.5` 与 `192.168.199.149` 同机!)**:
+  - ⚠️ **2026-11-06 已按现场要求移除「发送前拉高方向 GPIO」的软件逻辑**:`serial_port.py` 的 `Rs485Direction` 类、`_init_rs485_dir()` / `_close_rs485_dir()` / `_rs485_write()`(改为纯 `_write_and_flush()`)全部删除,`config.py` 的 `SERIAL_RS485_DIR_GPIO/PRE_DELAY/POST_DELAY` 三项配置一并移除。设备 `/etc/default/dzxj_dtu` 里遗留的 `SERIAL_RS485_DIR_*` 环境变量已无人读取(可删掉)。ttyS8 现在完全依赖板载 485 收发器的自动方向,软件不再操作 GPIO0_C4(line20);以下为历史记录:
   - ⚠️ **重大事实更正**:`192.168.199.149`(root/123456,同时持有 `192.168.10.5`)设备树实际是 **Rockchip RK3562 IDO EVB3562 V2**(`cat /proc/device-tree/model`),**不是**项目概览里一直写的 RK3588;它和经 adb 操作的第二块板是**同一台**(env/备份时间戳一致)。下文 GPIO line 号、`ff260000.gpio` 等均为 RK3562 实测。
   - 需求:485 总线发送前先把方向脚 **拉高、保持 10ms 再发**,`flush/tcdrain` 等最后一位发完后**立刻切回接收**;程序启动/连接默认**低电平**。
   - 方向脚硬件 = **GPIO0_C4_d**(复用名 SPI0_MOSI_M0/PWM1_M0/UART6_CTSN_M0)。RK3562 gpiochip0=gpio0(`ff260000.gpio`,32 线),C 组偏移 16,C4 = line **20**(C3=line19 即 DHT11 已验证)。已排除复用冲突:uart6(`ff6b0000`) **disabled**、无 `/dev/spidev*`、pwm1(`ff700020`) 无导出通道;`gpioset gpiochip0 20=0/1` 可正常申请切换。
@@ -63,6 +64,13 @@
   - ⚠️ **当前 ttyS8 仍 `rx:0`(tx 正常涨)**:软件拉脚已证实,收不到回包属物理层——需现场确认 485 收发器的 **DE/RE 真的接到 GPIO0_C4**(line20)、A/B 未接反/松动、线架已上电。这正是历史上 ttyS8「能发不能收」的现象,方向脚接对后应恢复。
   - 调试技巧:该脚被服务占用时 `gpioget/gpioset` 报 `Device or resource busy`;看实时电平用 `/sys/kernel/debug/gpio`(grep gpio-20)。抓发送高电平窗口可临时把 `SERIAL_RS485_DIR_POST_DELAY` 调大(如 0.1)再触发查询,验证完改回重启。`/dev/mem` mmap 在该内核被禁(Permission denied)。
 
+- **2026-11-06 17:32 部署「移除方向脚软件控制」版到 192.168.199.149**(ssh root/123456,即同一台 RK3562):
+  - 只更新两个文件:`backend/modules/serial_port.py`(md5 `403d1f292375cba4debe660656568dcc`)、`backend/config.py`(md5 `85b8d7fd0b4645a76a836b8ae420e4ed`);部署前设备版本正好等于 git HEAD(`a2c3e8a2…` / `eefb2859…`),**app.py 未动**。
+  - 备份:`modules/serial_port.py.bak_20261106_173210`、`config.py.bak_20261106_173210`、`/etc/default/dzxj_dtu.bak_20261106_173210`。
+  - 同时删除 `/etc/default/dzxj_dtu` 里已失效的 `SERIAL_RS485_DIR_GPIO/PRE_DELAY/POST_DELAY` 及其注释(备份见上)。
+  - 验证:venv `py_compile` 通过;重启后服务 active、串口 connected `/dev/ttyS8`、MQTT 连上 `xt.wenhq.top:8581`、Nextion ttyS9 正常、DHT11 线程启动;日志无任何 RS485 方向控制输出,`/sys/kernel/debug/gpio` 里 gpio-20 未被申请;12s 内 `tx 2960→3120`(轮询持续发帧,`_write_and_flush()` 正常),`rx:0`(既有物理层问题)。
+  - 部署后发现 `serial_config.json` 是 **`/dev/ttyS8 @ 115200`**(重启前 17:28 的连接日志也是 115200,非本次部署引入);**17:34 已按现场要求用 `POST /api/serial/connect` 改回 9600 并持久化**(日志 `串口配置已保存: /dev/ttyS8 @ 9600`,重连后 `connected=true`、15s 内 `tx 3840→4000`、`rx:0` 仍为物理层问题)。
+
 ### 第四块板:另一块 RK3562(adb serial `f5b6307ad44bf190`,eth0 192.168.129.153)
 
 - **接入**:`adb devices` 见 `f5b6307ad44bf190`(仍自报 mako/Nexus_4),`adb shell` 直接 root;Ubuntu 20.04、Python 3.8.10、内核 aarch64,hostname `ido`,eth0=`192.168.129.153`,docker0=172.17.0.1。与第二块板不是同一台(adb serial、IP 均不同)。
@@ -247,18 +255,12 @@ journalctl -u dzxj_dtu | grep -E 'DHT11|环境传感器'
 - 轮询线程 `port_poll_loop` 每轮之间睡 `poll_interval_ms`(dtu_config,默认 5000ms);这是「轮间」间隔,和队列内「帧间」节拍是两层,别混淆。
 - 串口调试页时间戳只精确到秒(`%H:%M:%S`),0.2s 的相邻两帧在界面上看似同一瞬间,实为队列正常节拍。
 
-### RS485 方向脚软件控制(2026-10-29 新增,可选)
+### RS485 方向脚软件控制(2026-10-29 新增 → **2026-11-06 已移除**)
 
-板载 TTL 转 RS485 模块若是**自动方向**且切换太慢,会出现典型症状:**DTU 发帧正常(总线上能抓到),但从机(线架)的回包一个字节都收不到**(`/proc/tty/driver/serial` 里 `tx` 涨、`rx` 不动),而同一帧用 PC 的 USB-RS485 发出去从机就正常回复。
+⚠️ **现已无此功能**:`serial_port.py` 不再包含 `Rs485Direction` 类与 `_init_rs485_dir()` / `_close_rs485_dir()`,所有写路径统一走简单的 `_write_and_flush()`(`ser.write()+flush()`,仅 tcdrain 保证最后一位发完);`config.py` 的 `SERIAL_RS485_DIR_GPIO` / `SERIAL_RS485_DIR_PRE_DELAY` / `SERIAL_RS485_DIR_POST_DELAY` 也已删除,设备 `/etc/default/dzxj_dtu` 里的同名环境变量会被忽略。ttyS8 完全依赖板载 485 收发器的自动方向。
 
-- 实现:`serial_port.py` 的 `Rs485Direction` 类,把所有写路径统一收口到 `_rs485_write()`:配置了方向 GPIO 时,发送前拉 TX 电平 → `ser.write()+flush()`(tcdrain 等最后一位发完)→ 立刻切回 RX 电平。
-- 配置(环境变量,`/etc/default/dzxj_dtu`):
-  - `SERIAL_RS485_DIR_GPIO=gpiochip0:25`(格式 `chip:line`;低电平为发送态则写 `gpiochip0:25:low`)
-  - `SERIAL_RS485_DIR_PRE_DELAY=0.001`(切到发送态后等待秒数)
-  - `SERIAL_RS485_DIR_POST_DELAY=0.001`(发完等待秒数再切回接收)
-- 未配置该变量时行为与原来完全一致(不控制方向);gpiod 缺失/申请失败会自动降级,不影响串口主流程。
-- 前提:485 模块必须有可接出的 **DE/RE 脚**;纯自动流向模块(无 DE 脚)无法软件修复,只能换模块或用 USB-RS485。
-- 注意:RK3562 EVB3562 的 `ttyS8` **只复用了 TX/RX 两个脚**(`uart8m0-xfer`),RTS 没有引出来,设备树也没有 rs485 属性,所以**不能靠内核 RS485/RTS 模式**解决。
+历史背景(排查时可参考):板载 TTL 转 RS485 模块若是**自动方向**且切换太慢,会出现典型症状——**DTU 发帧正常(总线上能抓到),但从机(线架)的回包一个字节都收不到**(`/proc/tty/driver/serial` 里 `tx` 涨、`rx` 不动),而同一帧用 PC 的 USB-RS485 发出去从机就正常回复。曾用软件拉 DE/RE 方向脚(GPIO0_C4/line20)验证过时序,但现场要求不再由软件控制。若今后 ttyS8 再出现「能发不能收」,优先排查物理层(DE/RE 接线、A/B 极性、线架上电),或改用 `/dev/ttyUSB0`(USB-RS485)。
+注意:RK3562 EVB3562 的 `ttyS8` **只复用了 TX/RX 两个脚**(`uart8m0-xfer`),RTS 没有引出来,设备树也没有 rs485 属性,所以**不能靠内核 RS485/RTS 模式**解决。
 
 ### V5 协议(2026-10-23)重点
 
@@ -453,7 +455,7 @@ journalctl -u dzxj_dtu | grep -E 'DHT11|环境传感器'
 | 换架后未自动接管             | 严格图解口径:必须**原机先连续 2 次无匹配 81 判离线**,同地址新 UID 持续回 81 才会接管(`_takeover_panel`,先 0x10 再读卡)。看日志是否有冲突告警→「判定离线并停止读卡」→「按离线替换接管」;原机仍在线时只记冲突不替换。另查地址段是否包含该地址、固件是否回带 UID 的 81 |
 | 配置地址一直等待/超时        | 确认线架已上电、配置卡放在目标天线、串口在线;默认 60s 超时,可重试;成功后看日志"线架配置地址完成: 天线=x 地址=y"                                   |
 | 配置被改坏/丢失              | 「数据备份」页从自动快照恢复(`backend/backups/`,每类保留 20 份)                                                                  |
-| 线架不回带 UID 的 81 | 默认开启读卡兜底(`PANEL_READ_FALLBACK_KEEPALIVE=true`):81 连续缺失时补发 0x03 读卡,**读卡有应答即判在线**,故现网这批只回全 0 探测、不回点名 81 但读卡正常的固件可正常使用;仅当读卡也无应答才判离线。要切纯图解口径(在线完全靠 81)把该开关置 false(需固件支持点名 81)。若 81/0x03 都收不到(`/api/data/serial` 无 `01 03 90...`),看 `grep -E "^\s*8:" /proc/tty/driver/serial`:发查询时 `tx` 涨 `rx` 不动 = 板载 485 收不到回包 → 配 `SERIAL_RS485_DIR_GPIO` 或改用 `/dev/ttyUSB0`(USB-RS485 已验证可通) |
+| 线架不回带 UID 的 81 | 默认开启读卡兜底(`PANEL_READ_FALLBACK_KEEPALIVE=true`):81 连续缺失时补发 0x03 读卡,**读卡有应答即判在线**,故现网这批只回全 0 探测、不回点名 81 但读卡正常的固件可正常使用;仅当读卡也无应答才判离线。要切纯图解口径(在线完全靠 81)把该开关置 false(需固件支持点名 81)。若 81/0x03 都收不到(`/api/data/serial` 无 `01 03 90...`),看 `grep -E "^\s*8:" /proc/tty/driver/serial`:发查询时 `tx` 涨 `rx` 不动 = 板载 485 收不到回包 → 属物理层问题(方向脚软件控制已于 2026-11-06 移除,不再由软件拉 DE/RE),查 DE/RE 接线与 A/B 极性,或改用 `/dev/ttyUSB0`(USB-RS485 已验证可通) |
 
 ## 注意事项(重要)
 

BIN
backend/__pycache__/app.cpython-310.pyc


BIN
backend/__pycache__/config.cpython-310.pyc


BIN
backend/__pycache__/paths.cpython-310.pyc


+ 46 - 11
backend/app.py

@@ -8,14 +8,17 @@ import json
 import os
 import re
 import logging
+import platform
 import uuid
 
-# 配置文件路径
-SERIAL_CONFIG_FILE = os.path.join(os.path.dirname(os.path.abspath(__file__)), 'serial_config.json')
-MQTT_CONFIG_FILE = os.path.join(os.path.dirname(os.path.abspath(__file__)), 'mqtt_config.json')
+from paths import DATA_DIR, RESOURCE_ROOT
+
+# 配置文件路径(DATA_DIR:源码运行=backend/,PyInstaller 单文件 exe=exe 同级 data/)
+SERIAL_CONFIG_FILE = os.path.join(DATA_DIR, 'serial_config.json')
+MQTT_CONFIG_FILE = os.path.join(DATA_DIR, 'mqtt_config.json')
 
 # 静态文件目录(前端构建产物或由 nginx 提供)
-STATIC_FOLDER = os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), 'frontend', 'dist')
+STATIC_FOLDER = os.path.join(RESOURCE_ROOT, 'frontend', 'dist')
 
 # 导入配置
 from config import (
@@ -162,7 +165,7 @@ dtu_config = {
     'address_range': dict(DEFAULT_ADDRESS_RANGE)
 }
 
-DTU_CONFIG_FILE = os.path.join(os.path.dirname(os.path.abspath(__file__)), 'dtu_config.json')
+DTU_CONFIG_FILE = os.path.join(DATA_DIR, 'dtu_config.json')
 
 # 本地自动快照目录(每次写配置前自动快照,可在"数据备份"页恢复)
 BACKUP_DIR = config_backup.BACKUP_DIR
@@ -2838,8 +2841,14 @@ serial_client.set_status_callback(serial_status_handler)
 mqtt_client.set_data_callback(mqtt_data_handler_extended)
 mqtt_client.set_status_callback(mqtt_status_handler)
 
-# 设备配置文件路径
-DEVICE_CONFIG_FILE = '/root/dzxj_dtu/devices.json'
+# 设备配置文件路径:设备(Linux)沿用历史路径 /root/dzxj_dtu/devices.json,
+# 其他平台(如 Windows 便携版)落 DATA_DIR,避免写到不存在的 /root 目录。
+_LEGACY_DEVICE_CONFIG_FILE = '/root/dzxj_dtu/devices.json'
+DEVICE_CONFIG_FILE = (
+    _LEGACY_DEVICE_CONFIG_FILE
+    if os.path.isdir(os.path.dirname(_LEGACY_DEVICE_CONFIG_FILE))
+    else os.path.join(DATA_DIR, 'devices.json')
+)
 
 
 def save_device_config():
@@ -2923,6 +2932,17 @@ def sync_panel_config():
 def index():
     return send_from_directory(STATIC_FOLDER, 'index.html')
 
+
+# 前端静态资源兜底:设备上由 nginx 提供,Windows 便携版/source 直连 5001 时由 Flask 提供
+@app.route('/<path:filepath>')
+def serve_frontend_file(filepath):
+    """优先返回 dist 下的真实文件,其余非 API 路径回 index.html(SPA 路由)"""
+    if filepath.startswith('api/'):
+        abort(404)
+    if os.path.isfile(os.path.join(STATIC_FOLDER, filepath)):
+        return send_from_directory(STATIC_FOLDER, filepath)
+    return send_from_directory(STATIC_FOLDER, 'index.html')
+
 # 404错误处理器 - 解决SPA路由刷新问题
 @app.errorhandler(404)
 def page_not_found(e):
@@ -5664,7 +5684,9 @@ def check_env_sensor_alarms(temperature, humidity, dtu_temperature):
 
 # ========== 运行数据备份 / 恢复 ==========
 
-SYSTEM_ENV_FILE = '/etc/default/dzxj_dtu'
+SYSTEM_ENV_FILE = ('/etc/default/dzxj_dtu'
+                   if os.path.isdir('/etc/default')
+                   else os.path.join(DATA_DIR, 'dzxj_dtu.env'))
 
 _SNAPSHOT_TARGETS = {
     'dtu_config': DTU_CONFIG_FILE,
@@ -5842,7 +5864,8 @@ def backup_export():
                 'customer_id': dtu_config.get('customer_id'),
                 'firmware_version': dtu_config.get('firmware_version'),
                 'hardware_version': dtu_config.get('hardware_version'),
-                'hostname': os.uname().nodename,
+                'hostname': (os.uname().nodename if hasattr(os, 'uname')
+                             else platform.node()),
             },
             uid_prefix=_dtu_uid_prefix(),
         )
@@ -5956,6 +5979,13 @@ def backup_delete():
 @app.route('/api/system/restart_service', methods=['POST'])
 def restart_service():
     """重启 dzxj_dtu 服务(延时 1 秒执行,让本次响应先返回)"""
+    if os.name == 'nt':
+        # Windows 便携版没有 systemd:只能关掉程序重新运行
+        return jsonify({
+            'success': False,
+            'message': '当前为 Windows 便携版,请关闭程序后重新运行以生效',
+        }), 400
+
     def _do_restart():
         import subprocess
         time.sleep(1.0)
@@ -5968,7 +5998,8 @@ def restart_service():
     return jsonify({'success': True, 'message': 'dzxj_dtu 服务将在 1 秒后重启'})
 
 
-if __name__ == '__main__':
+def main():
+    """启动 Web 服务与后台线程(源码运行与打包 exe 共用入口)"""
     try:
         # 启动前的初始化工作
         logger.info('启动串口-MQTT网关服务...')
@@ -6113,4 +6144,8 @@ if __name__ == '__main__':
             serial_client.disconnect()
             mqtt_client.disconnect()
         except:
-            pass
+            pass
+
+
+if __name__ == '__main__':
+    main()

+ 0 - 6
backend/config.py

@@ -24,12 +24,6 @@ SERIAL_RECONNECT_MAX_RETRIES = 5  # 串口最大重连次数
 # 都经同一个发送队列,按「发送起点」固定间隔逐条发出,避免同台线架保活帧与读卡帧背靠背。
 # 注意 9600bps 下读卡(149B)/写卡(152B)单帧约 155ms,此值必须大于单帧耗时,默认 0.20s。
 SERIAL_CMD_INTERVAL = float(os.getenv('SERIAL_CMD_INTERVAL', '0.20'))
-# RS485 方向控制 GPIO(可选)。格式 "gpiochip0:25" 或 "gpiochip0:25:low"(low = 低电平为发送态)。
-# 用于板载 TTL 转 RS485 模块自动方向切换不可靠(发完立刻收不到回包)的场景,
-# 把模块的 DE/RE 接到该 GPIO,由软件在发送前拉 TX、发送完成后切回 RX。
-SERIAL_RS485_DIR_GPIO = (os.getenv('SERIAL_RS485_DIR_GPIO') or '').strip()
-SERIAL_RS485_DIR_PRE_DELAY = float(os.getenv('SERIAL_RS485_DIR_PRE_DELAY', '0.001'))  # 切到发送态后等待(秒)
-SERIAL_RS485_DIR_POST_DELAY = float(os.getenv('SERIAL_RS485_DIR_POST_DELAY', '0.001'))  # 发送完成后等待再切回接收(秒)
 
 # MQTT配置
 DEFAULT_MQTT_PORT = 1883  # 默认MQTT端口

BIN
backend/modules/__pycache__/config_backup.cpython-310.pyc


BIN
backend/modules/__pycache__/serial_port.cpython-310.pyc


+ 6 - 4
backend/modules/config_backup.py

@@ -33,10 +33,12 @@ MAX_BUNDLE_BYTES = 2 * 1024 * 1024
 DEFAULT_KEEP = 20
 DEFAULT_MIN_INTERVAL_S = 30
 
-# backend/backups(模块位于 backend/modules/ 下)
-BACKUP_DIR = os.path.join(
-    os.path.dirname(os.path.dirname(os.path.abspath(__file__))), 'backups'
-)
+# 快照目录:DATA_DIR/backups(源码运行 = backend/backups;打包后 = exe 同级 data/backups)
+try:
+    from paths import DATA_DIR as _DATA_DIR
+except ImportError:  # 以包方式导入(backend.modules.config_backup)时的兜底
+    _DATA_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+BACKUP_DIR = os.path.join(_DATA_DIR, 'backups')
 
 _SNAPSHOT_RE = re.compile(r'^(.+)_(\d{8}_\d{6})(?:_(\d+))?\.json$')
 _UID_RE = re.compile(r'^[0-9a-fA-F]{24}$')

+ 5 - 196
backend/modules/serial_port.py

@@ -29,150 +29,6 @@ class SerialConfig:
     dsrdtr: bool = False
 
 
-class Rs485Direction:
-    """RS485 收发方向 GPIO 控制(可选)。
-
-    仅当配置了 SERIAL_RS485_DIR_GPIO(如 "gpiochip0:25")时启用。
-    典型用途:板载 TTL 转 RS485 模块为"自动方向"且切换太慢时,会把从机
-    立刻返回的应答压掉(表现为:发送正常、rx 计数完全不动)。把模块的
-    DE/RE 引到空闲 GPIO 上,由本类在发送前拉高、发送完成后拉低即可解决。
-
-    任何异常都会让本类自动降级为"不控制方向",绝不影响串口主流程。
-    """
-
-    def __init__(self, spec: str, pre_delay: float = 0.001, post_delay: float = 0.001):
-        self.spec = (spec or '').strip()
-        self.pre_delay = max(0.0, float(pre_delay or 0))
-        self.post_delay = max(0.0, float(post_delay or 0))
-        self.chip_name = ''
-        self.line_offset = -1
-        self.active_low = False      # True 表示低电平为"发送态"
-        self.ready = False
-        self._line = None
-        self._chip = None
-
-    def _parse(self) -> bool:
-        parts = [p.strip() for p in self.spec.split(':') if p.strip()]
-        if len(parts) < 2:
-            logger.warning(f"RS485 方向 GPIO 配置无效(应为 gpiochip0:25[:low]): {self.spec!r}")
-            return False
-        self.chip_name = parts[0]
-        try:
-            self.line_offset = int(parts[1], 0)
-        except ValueError:
-            logger.warning(f"RS485 方向 GPIO line 号无效: {parts[1]!r}")
-            return False
-        self.active_low = len(parts) >= 3 and parts[2].lower() in ('low', 'active_low', '0')
-        return True
-
-    def open(self) -> bool:
-        """打开并申请 GPIO 输出线,成功后 ready=True"""
-        if not self.spec:
-            return False
-        if not self._parse():
-            return False
-        try:
-            import gpiod  # 延迟导入:没装 gpiod 的机器不受影响
-        except Exception as e:
-            logger.warning(f"RS485 方向 GPIO 不可用(gpiod 未安装): {e}")
-            return False
-
-        try:
-            chip_cls = getattr(gpiod, 'Chip', None) or getattr(gpiod, 'chip', None)
-            if chip_cls is None:
-                logger.warning("RS485 方向 GPIO 不可用:当前 gpiod 版本不支持 Chip/chip API")
-                return False
-            self._chip = chip_cls(self.chip_name)
-            self._line = self._chip.get_line(self.line_offset)
-            if not self._request_output(gpiod):
-                return False
-            # 上电默认处于接收态
-            self._set(False)
-            self.ready = True
-            logger.info(
-                f"RS485 方向控制已启用: {self.spec}({'低' if self.active_low else '高'}电平为发送态,"
-                f"前置 {self.pre_delay*1000:.1f}ms / 后置 {self.post_delay*1000:.1f}ms)"
-            )
-            return True
-        except Exception as e:
-            logger.warning(f"RS485 方向 GPIO 打开失败,将不控制方向: {e}")
-            self._line = None
-            self._chip = None
-            self.ready = False
-            return False
-
-    def _request_output(self, gpiod) -> bool:
-        """兼容 gpiod 1.4/1.5/2.x 的申请输出写法"""
-        attempts = []
-        # 1.5.x:line_request 对象
-        if hasattr(gpiod, 'line_request'):
-            try:
-                req = gpiod.line_request()
-                req.consumer = 'dzxj_dtu_rs485_dir'
-                req.request_type = getattr(gpiod.line_request, 'DIRECTION_OUTPUT',
-                                           getattr(gpiod, 'LINE_REQ_DIR_OUT', 2))
-                attempts.append(lambda: self._line.request(req))
-            except Exception:
-                pass
-        # 1.4.x:名称参数
-        attempts.append(lambda: self._line.request(
-            consumer='dzxj_dtu_rs485_dir',
-            type=getattr(gpiod, 'LINE_REQ_DIR_OUT', 2)))
-        # 2.x:位置参数
-        attempts.append(lambda: self._line.request('dzxj_dtu_rs485_dir', 2, 0))
-
-        last_err = None
-        for fn in attempts:
-            try:
-                fn()
-                return True
-            except Exception as e:
-                last_err = e
-        logger.warning(f"RS485 方向 GPIO 申请失败: {last_err}")
-        return False
-
-    def _set(self, is_tx: bool):
-        if self._line is None:
-            return
-        value = (0 if is_tx else 1) if self.active_low else (1 if is_tx else 0)
-        try:
-            self._line.set_value(value)
-        except Exception as e:
-            logger.warning(f"RS485 方向 GPIO 置位失败,停止方向控制: {e}")
-            self.ready = False
-
-    def to_tx(self):
-        """切换到发送态"""
-        if not self.ready:
-            return
-        self._set(True)
-        if self.pre_delay:
-            time.sleep(self.pre_delay)
-
-    def to_rx(self):
-        """切回接收态(必须在最后一位真正发完之后调用)"""
-        if not self.ready:
-            return
-        if self.post_delay:
-            time.sleep(self.post_delay)
-        self._set(False)
-
-    def close(self):
-        self.ready = False
-        try:
-            if self._line is not None:
-                self._line.release()
-        except Exception:
-            pass
-        try:
-            if self._chip is not None and hasattr(self._chip, 'close'):
-                self._chip.close()
-        except Exception:
-            pass
-        self._line = None
-        self._chip = None
-
-
 class SerialPort:
     """串口通信类,提供串口连接、读写和状态管理功能"""
     
@@ -187,7 +43,6 @@ class SerialPort:
         self.status_callback = None
         self.error_callback = None
         self.current_config = None
-        self._rs485_dir = None        # RS485 方向控制(可选)
         self.reconnect_attempts = 0
         self.max_reconnect_attempts = 3
         self.raw_response_buffer = []
@@ -260,47 +115,8 @@ class SerialPort:
 
         logger.info("串口发送队列工作线程结束")
 
-    def _init_rs485_dir(self):
-        """按配置初始化 RS485 方向控制 GPIO(未配置则不启用)"""
-        self._close_rs485_dir()
-        try:
-            import config as app_config
-            spec = getattr(app_config, 'SERIAL_RS485_DIR_GPIO', '') or ''
-            pre = getattr(app_config, 'SERIAL_RS485_DIR_PRE_DELAY', 0.001)
-            post = getattr(app_config, 'SERIAL_RS485_DIR_POST_DELAY', 0.001)
-        except Exception:
-            return
-        if not spec:
-            return
-        direction = Rs485Direction(spec, pre_delay=pre, post_delay=post)
-        if direction.open():
-            self._rs485_dir = direction
-        else:
-            self._rs485_dir = None
-
-    def _close_rs485_dir(self):
-        if self._rs485_dir is not None:
-            try:
-                self._rs485_dir.close()
-            except Exception:
-                pass
-            self._rs485_dir = None
-
-    def _rs485_write(self, data: bytes) -> int:
-        """写串口并 flush(tcdrain)。
-
-        配置了方向 GPIO 时:发送前切到发送态,最后一位发完后立刻切回接收态,
-        避免板载 485 模块方向切换滞后把从机应答压掉。
-        """
-        direction = self._rs485_dir
-        if direction is not None and direction.ready:
-            direction.to_tx()
-            try:
-                sent = self.ser.write(data)
-                self.ser.flush()
-            finally:
-                direction.to_rx()
-            return sent
+    def _write_and_flush(self, data: bytes) -> int:
+        """写串口并 flush(tcdrain),确保最后一位真正发完"""
         sent = self.ser.write(data)
         self.ser.flush()
         return sent
@@ -311,7 +127,7 @@ class SerialPort:
             with self.lock:
                 if not self.is_connected or not self.ser or not self.ser.is_open:
                     return False, "serial port not connected"
-                bytes_sent = self._rs485_write(data)
+                bytes_sent = self._write_and_flush(data)
             if self.send_callback and data:
                 self.send_callback(data.hex())
             return True, "send ok"
@@ -342,7 +158,7 @@ class SerialPort:
                 else:
                     raise TypeError("数据必须是字符串或字节类型")
 
-                bytes_sent = self._rs485_write(bytes_data)
+                bytes_sent = self._write_and_flush(bytes_data)
 
                 logger.debug(f"发送数据到串口: {bytes_data.hex()[:50]}... (共{bytes_sent}字节)")
                 return True, "发送成功"
@@ -379,7 +195,7 @@ class SerialPort:
                     return b''
                 self.raw_response_buffer.clear()
                 self.ser.reset_input_buffer()
-                self._rs485_write(data)
+                self._write_and_flush(data)
                 # 485 半双工:等最后字节发完并给收发器一点切换方向的时间
                 time.sleep(0.03)
 
@@ -579,9 +395,6 @@ class SerialPort:
                 self.current_config = config
                 self.reconnect_attempts = 0
 
-                # RS485 方向控制 GPIO(可选,未配置则跳过)
-                self._init_rs485_dir()
-
                 # 启动读取线程
                 self.read_thread = threading.Thread(target=self._read_loop, daemon=True)
                 self.read_thread.start()
@@ -606,9 +419,6 @@ class SerialPort:
         try:
             logger.info("断开串口连接")
 
-            # 释放 RS485 方向控制 GPIO
-            self._close_rs485_dir()
-
             # 阶段 0:清空发送队列中待执行的指令,避免断开后再发数据
             try:
                 while not self._cmd_queue.empty():
@@ -696,7 +506,6 @@ class SerialPort:
 
     def _close_on_error(self):
         """读取异常时关闭串口并触发状态回调,但不直接重连"""
-        self._close_rs485_dir()
         with self.lock:
             if self.ser and self.ser.is_open:
                 try:

+ 39 - 0
backend/paths.py

@@ -0,0 +1,39 @@
+"""运行路径解析:同时兼容源码运行(Linux 设备)与 PyInstaller 单文件 exe。
+
+- RESOURCE_ROOT:只读资源根目录(前端 dist 等)。打包后指向临时解压目录 sys._MEIPASS。
+- DATA_DIR:可写数据根目录(serial_config.json / mqtt_config.json / dtu_config.json /
+  devices.json / backups)。打包后默认取 exe 同级 data/ 目录,可用环境变量
+  DZXJ_DATA_DIR 覆盖;源码运行时仍是 backend 目录,行为与原来一致。
+"""
+
+import os
+import sys
+
+
+def is_frozen():
+    """是否为 PyInstaller 打包后的运行环境"""
+    return bool(getattr(sys, 'frozen', False))
+
+
+def _resource_root():
+    if is_frozen():
+        return getattr(sys, '_MEIPASS', os.path.dirname(os.path.abspath(sys.executable)))
+    return os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+
+
+def _data_dir():
+    env = (os.getenv('DZXJ_DATA_DIR') or '').strip()
+    if env:
+        return os.path.abspath(env)
+    if is_frozen():
+        return os.path.join(os.path.dirname(os.path.abspath(sys.executable)), 'data')
+    return os.path.dirname(os.path.abspath(__file__))
+
+
+RESOURCE_ROOT = _resource_root()
+DATA_DIR = _data_dir()
+
+try:
+    os.makedirs(DATA_DIR, exist_ok=True)
+except Exception:
+    pass

BIN
backend/tests/__pycache__/test_panel_registration.cpython-310-pytest-9.0.2.pyc


BIN
backend/tests/__pycache__/test_serial_port.cpython-310-pytest-9.0.2.pyc


+ 80 - 0
packaging/README_WINDOWS_EXE.md

@@ -0,0 +1,80 @@
+# Windows 便携版 exe(打包与使用说明)
+
+把本项目的后端(Flask + Socket.IO)和前端(`frontend/dist`)打成一个 **单文件 exe**,
+在 Windows 电脑上双击即可运行,用浏览器管理 DTU/线架(现场调试、演示、PC 端应急操作)。
+
+> 注意:这不是给 RK 板子用的安装包。设备端仍跑 Linux + `systemctl` + `/dev/ttyS8`;
+> 本 exe 是「在 Windows 电脑上跑的同一套管理端」。
+
+## 一、构建(在 Windows 上)
+
+前置:Python 3.10+(勾选 Add to PATH)、Node.js(构建前端时需要)。
+
+```bat
+:: 在项目根目录执行
+packaging\build_exe.bat
+```
+
+脚本会依次:检查/构建前端 → 建 `.venv-exe` 虚拟环境装依赖 → PyInstaller 打包。
+
+产物:`dist\dzxj_dtu.exe`(单文件,约 14.7 MB)。
+
+手动构建等价命令:
+
+```bat
+python -m venv .venv-exe
+.venv-exe\Scripts\activate
+pip install -r packaging\requirements_windows.txt
+python -m PyInstaller --noconfirm --clean --distpath dist --workpath build\pyinstaller packaging\dzxj_dtu.spec
+```
+
+## 二、使用
+
+1. 把 `dzxj_dtu.exe` 拷到任意目录双击运行(控制台窗口会显示地址和数据目录)。
+2. 程序自动打开浏览器 `http://127.0.0.1:5001/`;端口被占用时会直接打开已有实例。
+3. 首次运行会在 exe 同级创建 `data\` 目录:
+
+```
+dzxj_dtu.exe
+data\
+  serial_config.json   串口配置(首次运行自动识别 USB-RS485 口)
+  dtu_config.json      DTU 身份/地址段/端口映射
+  mqtt_config.json     MQTT 连接参数
+  devices.json         线架绑定表(地址↔UID)
+  backups\             配置自动快照
+```
+
+4. 网页里「串口」页选 COM 口(USB-RS485,9600 8N1)连接,即可按地址段扫描线架。
+
+关闭控制台窗口或按 `Ctrl+C` 即退出。
+
+## 三、可选环境变量
+
+| 变量 | 默认 | 说明 |
+| --- | --- | --- |
+| `DZXJ_HOST` | `127.0.0.1` | 监听地址;局域网其它设备要访问就设 `0.0.0.0`(会触发防火墙提示) |
+| `FLASK_PORT` | `5001` | 监听端口 |
+| `DZXJ_DATA_DIR` | `exe同级\data` | 配置/快照存放目录 |
+| `LOG_LEVEL` | `INFO` | 日志级别 |
+
+设置方式(临时):`set DZXJ_HOST=0.0.0.0 && dzxj_dtu.exe`
+
+## 四、Windows 版功能差异
+
+| 功能 | 说明 |
+| --- | --- |
+| 串口 / MODBUS-RTU / 线架扫描 / 读卡 / 下发卡号 | ✅ 正常(用 USB-RS485 的 COM 口) |
+| MQTT 上行/下行、注册、告警 | ✅ 正常 |
+| Web 管理界面(Vue 前端) | ✅ 内嵌在 exe 内 |
+| DHT11 温湿度 | ❌ 无 GPIO,启动时已自动关闭(`DHT11_ENABLED=false`) |
+| Nextion 串口屏 | ❌ 默认端口 `/dev/ttyS9` 不存在,启动时已自动关闭(`NEXTION_ENABLED=false`) |
+| 「重启服务」按钮 | ❌ 没有 systemd,提示关闭程序后重开(`/api/system/restart_service` 返回 400) |
+| 固件 OTA 脚本、网络静态 IP 配置 | ⚠️ 依赖 Linux 工具(`ip`/`nmcli`/`reboot`),不可用 |
+
+## 五、排障
+
+- **双击闪退**:在 `cmd` 里执行 `dzxj_dtu.exe` 看报错;常见原因是端口被占用或杀软拦截。
+- **浏览器没自动打开**:手动访问控制台打印的地址。
+- **找不到串口**:确认 CH340/CP210x 驱动已装,设备管理器里能看到 COM 口。
+- **中文乱码**:`chcp 65001` 后重新运行,或把控制台字体改成支持中文的字体。
+- **打包报 `frontend/dist` 不存在**:先 `cd frontend && npm install && npm run build`。

+ 40 - 0
packaging/build_exe.bat

@@ -0,0 +1,40 @@
+@echo off
+setlocal enabledelayedexpansion
+cd /d "%~dp0.."
+
+echo ==========================================
+echo  DZXJ DTU - build Windows portable exe
+echo ==========================================
+
+where python >nul 2>nul
+if errorlevel 1 (
+  echo [ERROR] python not found in PATH. Install Python 3.10+ first.
+  exit /b 1
+)
+
+echo [1/4] check frontend\dist ...
+if not exist "frontend\dist\index.html" (
+  echo        frontend\dist missing, building ...
+  pushd frontend
+  call npm install
+  if errorlevel 1 (popd & exit /b 1)
+  call npm run build
+  if errorlevel 1 (popd & exit /b 1)
+  popd
+)
+
+echo [2/4] prepare venv .venv-exe and install deps ...
+if not exist ".venv-exe\Scripts\python.exe" python -m venv .venv-exe
+call ".venv-exe\Scripts\activate.bat"
+python -m pip install --upgrade pip
+python -m pip install -r packaging\requirements_windows.txt
+if errorlevel 1 exit /b 1
+
+echo [3/4] pyinstaller onefile build ...
+python -m PyInstaller --noconfirm --clean --distpath dist --workpath build\pyinstaller packaging\dzxj_dtu.spec
+if errorlevel 1 exit /b 1
+
+echo [4/4] done
+echo        output: %CD%\dist\dzxj_dtu.exe
+dir /b dist\dzxj_dtu.exe
+exit /b 0

+ 84 - 0
packaging/dzxj_dtu.spec

@@ -0,0 +1,84 @@
+# -*- mode: python ; coding: utf-8 -*-
+"""PyInstaller 打包配置:Windows 单文件便携 exe。
+
+构建(Windows):
+    python -m PyInstaller --noconfirm --clean --distpath dist --workpath build\\pyinstaller packaging\\dzxj_dtu.spec
+
+产物:dist\\dzxj_dtu.exe(单文件,双击即用;配置写在 exe 同级 data\\ 目录)
+"""
+
+import os
+
+ROOT = os.path.abspath(os.path.join(SPECPATH, '..'))
+BACKEND_DIR = os.path.join(ROOT, 'backend')
+FRONTEND_DIST = os.path.join(ROOT, 'frontend', 'dist')
+
+if not os.path.isdir(FRONTEND_DIST):
+    raise SystemExit('缺少前端构建产物 frontend/dist,请先在 frontend 执行 npm run build')
+
+# 前端 dist 打进包内,运行时从 sys._MEIPASS/frontend/dist 提供(见 backend/paths.py)
+datas = [(FRONTEND_DIST, 'frontend/dist')]
+
+hiddenimports = [
+    # 后端模块(backend/ 为 pathex,modules 是命名空间包,必须显式声明)
+    'app',
+    'config',
+    'paths',
+    'modules.serial_port',
+    'modules.mqtt_client',
+    'modules.modbus_rtu',
+    'modules.network_config',
+    'modules.dht11_sensor',
+    'modules.nextion_display',
+    'modules.config_backup',
+    # Socket.IO 动态加载的异步驱动
+    'engineio.async_drivers.threading',
+    'engineio.async_drivers',
+    'flask_socketio',
+    'socketio',
+    'simple_websocket',
+    # pyserial 平台相关实现
+    'serial.tools.list_ports_windows',
+    # 运行时可选依赖
+    'paho.mqtt.client',
+    'psutil',
+]
+
+a = Analysis(
+    ['launcher.py'],
+    pathex=[BACKEND_DIR],
+    binaries=[],
+    datas=datas,
+    hiddenimports=hiddenimports,
+    hookspath=[],
+    runtime_hooks=[],
+    excludes=[
+        'tkinter', 'PyQt5', 'PyQt6', 'PySide6',
+        'matplotlib', 'numpy', 'pandas', 'scipy',
+        'IPython', 'jupyter', 'notebook', 'pytest',
+        'gpiod', 'smbus', 'RPi',
+    ],
+    noarchive=False,
+)
+
+pyz = PYZ(a.pure)
+
+exe = EXE(
+    pyz,
+    a.scripts,
+    a.binaries,
+    a.datas,
+    [],
+    name='dzxj_dtu',
+    debug=False,
+    bootloader_ignore_signals=False,
+    strip=False,
+    upx=False,
+    runtime_tmpdir=None,
+    console=True,
+    disable_windowed_traceback=False,
+    argv_emulation=False,
+    target_arch=None,
+    codesign_identity=None,
+    entitlements_file=None,
+)

+ 147 - 0
packaging/launcher.py

@@ -0,0 +1,147 @@
+"""DZXJ DTU Windows 便携版启动器。
+
+职责:
+1. 在导入后端前注入桌面运行所需的环境变量(数据目录、监听地址、关闭 GPIO/串口屏);
+2. 首次运行时自动挑一个可用 COM 口写入 serial_config.json(现场插 USB-RS485 即可用);
+3. 启动后台线程等待端口就绪后自动打开浏览器;
+4. 调用 backend/app.py 的 main() 启动服务。
+
+源码直接运行:python packaging/launcher.py
+打包运行:见 packaging/build_exe.bat
+"""
+
+import json
+import os
+import socket
+import sys
+import threading
+import time
+import webbrowser
+
+ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+BACKEND_DIR = os.path.join(ROOT, 'backend')
+IS_FROZEN = bool(getattr(sys, 'frozen', False))
+EXE_DIR = os.path.dirname(os.path.abspath(sys.executable))
+
+HOST = os.getenv('DZXJ_HOST') or '127.0.0.1'
+PORT = int(os.getenv('FLASK_PORT') or 5001)
+
+
+def _prepare_env():
+    """设置默认环境变量(已存在则以用户设置为准)"""
+    data_dir = os.getenv('DZXJ_DATA_DIR') or (
+        os.path.join(EXE_DIR, 'data') if IS_FROZEN else BACKEND_DIR
+    )
+    os.makedirs(data_dir, exist_ok=True)
+    os.environ['DZXJ_DATA_DIR'] = data_dir
+
+    os.environ.setdefault('FLASK_HOST', HOST)
+    os.environ.setdefault('FLASK_PORT', str(PORT))
+    # 桌面版没有板载 GPIO / Nextion 串口屏
+    os.environ.setdefault('DHT11_ENABLED', 'false')
+    os.environ.setdefault('NEXTION_ENABLED', 'false')
+    os.environ.setdefault('LOG_LEVEL', 'INFO')
+    return data_dir
+
+
+def _port_in_use(host, port, timeout=0.3):
+    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+        s.settimeout(timeout)
+        return s.connect_ex((host, port)) == 0
+
+
+_USB_SERIAL_HINTS = ('usb', 'ch340', 'ch341', 'ch343', 'cp210', 'ft232', 'ftdi',
+                     'pl2303', 'rs485', 'uart', 'serial')
+
+
+def _pick_usb_serial_port():
+    """挑一个最像 USB-RS485 适配器的串口;无法判断时返回 None。
+
+    规则:优先描述里含 USB/CH340/CP210x/FTDI 等关键字的口;若系统只有一个串口则直接用。
+    """
+    try:
+        import serial.tools.list_ports
+
+        ports = sorted(serial.tools.list_ports.comports(), key=lambda p: p.device)
+    except Exception:
+        return None
+    if not ports:
+        return None
+    for p in ports:
+        desc = f'{p.description or ""} {p.hwid or ""}'.lower()
+        if any(h in desc for h in _USB_SERIAL_HINTS):
+            return p.device
+    return ports[0].device if len(ports) == 1 else None
+
+
+def _ensure_serial_config(data_dir):
+    """首次运行:把探测到的 USB 串口写成串口配置,避免默认连 /dev/ttyS8 报错"""
+    path = os.path.join(data_dir, 'serial_config.json')
+    if os.path.exists(path):
+        return
+    port = _pick_usb_serial_port()
+    if not port:
+        return
+    config = {
+        'port': port,
+        'baudrate': 9600,
+        'timeout': 0.1,
+        'bytesize': 8,
+        'parity': 'N',
+        'stopbits': 1,
+    }
+    try:
+        with open(path, 'w', encoding='utf-8') as f:
+            json.dump(config, f, indent=2, ensure_ascii=False)
+        print(f'[启动器] 已自动选择串口: {port}')
+    except Exception as e:
+        print(f'[启动器] 写入串口配置失败: {e}')
+
+
+def _open_browser_when_ready(url, host, port, timeout=60.0):
+    deadline = time.time() + timeout
+    while time.time() < deadline:
+        if _port_in_use(host, port):
+            try:
+                webbrowser.open(url)
+            except Exception:
+                pass
+            return
+
+
+def main():
+    data_dir = _prepare_env()
+
+    if sys.path and sys.path[0] != BACKEND_DIR:
+        sys.path.insert(0, BACKEND_DIR)
+    elif not sys.path:
+        sys.path.append(BACKEND_DIR)
+
+    url = f'http://{HOST}:{PORT}/'
+    print('=' * 60)
+    print(' DZXJ DTU 管理端(Windows 便携版)')
+    print(f' 访问地址: {url}')
+    print(f' 数据目录: {data_dir}')
+    print(' 关闭本窗口或按 Ctrl+C 退出')
+    print('=' * 60)
+
+    if _port_in_use(HOST, PORT):
+        print(f'[启动器] 端口 {PORT} 已被占用,直接用浏览器打开 {url}')
+        try:
+            webbrowser.open(url)
+        except Exception:
+            pass
+        return
+
+    _ensure_serial_config(data_dir)
+    threading.Thread(
+        target=_open_browser_when_ready, args=(url, HOST, PORT), daemon=True
+    ).start()
+
+    import app as backend_app
+
+    backend_app.main()
+
+
+if __name__ == '__main__':
+    main()

+ 9 - 0
packaging/requirements_windows.txt

@@ -0,0 +1,9 @@
+Flask==2.3.3
+Werkzeug==2.3.7
+Flask-Cors==4.0.0
+flask-socketio==5.3.6
+pyserial==3.5
+paho-mqtt==1.6.1
+python-dotenv==1.0.1
+psutil==6.1.0
+pyinstaller>=6.10,<7