SmsForwarder Windows客户端

📅 2026/6/30 5:12:41
SmsForwarder Windows客户端
然而其官方提供的主动控制客户端较为基础。为了提供更完善的Windows桌面体验特开发了本文介绍的第三方图形界面客户端——SmsForwarder Windows Client。它解决了以下问题原生桌面体验提供现代化的Windows GUI告别命令行或手机浏览器访问。集中管理在一个界面中统一管理短信、通话记录、联系人并支持发送短信。安全通信支持与SmsForwarder服务端进行明文、RSA和SM4加密通信。智能提醒新消息实时托盘通知并支持图标闪烁提醒确保重要信息不遗漏。数据便携所有数据均可一键导出为CSV文件方便备份或分析。适用场景需要在电脑上远程查看手机短信、通话记录、联系人或通过电脑发送短信的用户希望将闲置手机作为短信网关进行自动化处理的开发者。2 功能特性多标签页管理短信、通话记录、联系人、发送短信、设备信息、SmsHub旧版协议一应俱全。灵活查询筛选支持按类型、关键字、分页查询短信/通话按姓名或号码精准搜索联系人。加密通信兼容明文、RSA公钥加密、SM4国密三种服务端加密模式保障数据传输安全。新消息通知新消息到达时系统托盘会弹出气泡提示并伴有图标闪烁点击即可直达最新短信详情。数据导出短信、通话记录、联系人列表可一键导出为CSV文件方便存档和分析。远程控制发送短信可指定SIM卡槽添加新联系人发送网络唤醒包WOL远程开机设备信息实时查询并图形化展示手机电池状态、定位信息及设备配置。SmsHub兼容完美支持SmsForwarder v2.4.4及以下版本的旧版轮询协议。视图自定义可根据个人喜好在菜单中自由隐藏或显示标签页。托盘集成关闭窗口时自动最小化到系统托盘双击托盘图标即可恢复主界面。3 工作原理客户端通过HTTP POST请求与SmsForwarder服务端API进行交互。其核心逻辑如下请求构造根据用户选择的加密模式将请求数据JSON格式与时间戳打包。若启用API Token则会使用HMAC-SHA256生成签名若选择RSA或SM4加密则会对整个请求体进行加密。异步网络每个API请求都由一个独立的APIWorker线程继承自QThread执行确保UI界面始终流畅不卡顿。新消息轮询程序会按设定的时间间隔自动调用服务端的sms/query接口获取最新短信。通过比对最新短信的时间戳来判断是否有新消息如有则触发托盘通知并自动刷新列表。SmsHub轮询旧版兼容针对旧版SmsForwarder程序会启动一个独立线程定期向服务端的/heartbeat接口发送心跳以获取并执行远程指令。数据展示接收到服务端的JSON响应后程序会解析数据并填充到QTableWidget表格中。用户双击短信或通话记录可查看详情。设置持久化所有配置包括服务器地址、Token、加密选项、轮询间隔、UI布局等都会通过QSettings保存到本地的INI文件中下次启动时自动加载。4 环境依赖Python3.8 及以上版本PyQt6pip install PyQt6requestspip install requests可选加密库根据您的加密模式选择安装pycryptodome用于RSA加密pip install pycryptodomegmssl-python用于SM4国密加密pip install gmssl-python若您不需要使用RSA或SM4加密功能可以不安装对应的加密库程序会自动降级但无法使用这些加密模式。5 安装与配置源码版5.1 获取代码将完整脚本代码保存为sms_forwarder_client.py。5.2 安装依赖打开终端或命令提示符执行以下命令pip install PyQt6 requests # 如果您需要使用加密功能请按需安装 pip install pycryptodome gmssl-python5.3 运行直接运行脚本python sms_forwarder_client.py成品版直接运行打包好的exe文件6 首次配置首次启动时程序会自动弹出配置窗口您需要填写以下信息服务器地址您手机上SmsForwarder服务端的API地址格式如http://192.168.1.13:7001支持IPv6。API Token手机端设置的Token用于请求签名。如未设置可留空。加密方式选择与SmsForwarder服务端一致的加密模式明文 / RSA / SM4。选择SM4时需提供16字节的密钥。选择RSA时需提供PEM格式的公钥。轮询间隔客户端自动检查新消息的时间间隔秒建议10-30秒。托盘行为勾选后点击关闭按钮会最小化到系统托盘而不是退出程序。配置完成后点击保存即可开始使用。7 使用方法所有配置和操作均在图形界面中完成无需命令行参数。7.1 参数说明脚本本身不接收命令行参数以下为GUI中的关键配置项说明配置项说明服务器地址SmsForwarder服务端API根路径支持IPv6如http://[::1]:7001。API Token服务端设置的签名Token用于增强安全性。未设置则留空。加密方式必须与服务端设置完全一致明文 / RSA / SM4。SM4 密钥选择SM4加密时必须填写一个16字节的字符串密钥。RSA 公钥选择RSA加密时必须填写PEM格式的公钥。轮询间隔新消息自动检查的时间间隔单位为秒。关闭窗口时最小化托盘决定点击关闭按钮是退出程序还是隐藏到系统托盘。7.2 典型使用示例7.2.1 示例1查询最近接收的短信运行客户端并确保已正确配置服务器地址。点击「 短信」标签页。在筛选条件中将类型选择为「接收」并设置页码为1每页显示20条。点击「 查询」按钮下方表格将列出最近的短信记录。双击任意一条记录即可在弹出的窗口中查看短信完整内容。7.2.2 示例2发送短信并接收新消息通知进入「✉️ 发送」标签页选择要使用的SIM卡槽。在「接收号码」框中输入对方手机号多个号码请用英文分号;分隔。在「短信内容」框中输入要发送的文字。点击「✅ 发送短信」按钮成功后手机会发出短信。稍等片刻不超过您设置的轮询间隔客户端系统托盘会弹出新消息通知。点击通知客户端将自动跳转到短信列表并打开最新短信的详情。8 输出说明运行后您将看到主窗口包含所有功能标签页、状态栏和菜单栏。状态栏位于窗口底部实时显示与服务器的连接状态 已连接 / 未连接以及当前操作反馈。数据表格在短信、通话记录和联系人标签页中查询结果以清晰的表格形式展示支持点击列头排序双击行查看详情。设备信息卡片在「 设备」标签页电池、定位、配置等信息以可视化卡片形式展示并支持手动刷新。系统托盘图标窗口最小化后程序将常驻系统托盘。新消息到达时图标会闪烁并弹出气泡提示。日志窗口通过菜单栏「设置 → 查看日志」打开记录所有网络请求、错误信息和新消息发现等详细日志便于排查问题。CSV导出文件点击各标签页的「 导出」按钮可将当前表格数据保存为CSV文件。文件采用utf-8-sig编码确保Excel可直接打开且中文不乱码。9 附加功能截图9.1 新消息弹窗