# Tms-controller

**Repository Path**: zynwh/tms-controller

## Basic Information

- **Project Name**: Tms-controller
- **Description**: TMS Controller 是一款专业的液冷机通信控制软件，采用 Python 开发，提供直观的图形用户界面，支持通过串口与各种液冷机设备进行通信。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 15
- **Forks**: 5
- **Created**: 2025-09-04
- **Last Updated**: 2026-01-22

## Categories & Tags

**Categories**: testing

**Tags**: 储能行业液冷机测试, Python

## README

# TMS Controller - 液冷机通信控制软件

一个功能完整的液冷机通信控制软件，支持多种打包方式，适用于不同操作系统平台。

## 🚀 功能特性

- **串口通信管理**：自动检测和配置串口设备
- **协议解析**：支持多种液冷机通信协议（TCL、TF等）
- **数据记录**：实时数据记录和日志管理
- **图形界面**：基于Tkinter的现代化用户界面
- **配置管理**：灵活的配置文件系统
- **跨平台支持**：Windows、macOS、Linux全平台兼容

## 📦 打包方式

本项目支持多种打包方式，满足不同部署需求：

### 1. PyInstaller 打包
```bash
python script/build.py
```
- ✅ 单文件可执行程序
- ✅ 包含所有依赖和资源文件
- ✅ 支持图标和元数据配置

### 2. Nuitka 编译打包
```bash
python script/build_nuitka.py
```
- ✅ Python代码编译为C语言
- ✅ 更快的启动速度和运行性能
- ✅ 更好的代码保护
- ✅ 跨平台原生可执行文件

### 3. 统一打包构建
```bash
python script/unified_build.py
```
- ✅ 一键执行所有打包方式
- ✅ 统一输出目录管理
- ✅ 自动生成构建报告
- ✅ 清理临时文件

## 📁 项目结构

```
tms-controller/
├── src/                          # 源代码目录
│   ├── ui/                      # 用户界面模块
│   ├── serial/                  # 串口通信模块
│   ├── protocol/                # 协议解析模块
│   └── utils/                   # 工具模块
├── resources/                   # 资源文件
│   ├── favicon.ico             # Windows图标
│   ├── favicon.icns            # macOS图标
│   └── favicon.png             # Linux图标
├── protocol_configs/           # 协议配置文件
├── script/                     # 打包脚本
│   ├── build.py               # PyInstaller打包
│   ├── build_nuitka.py        # Nuitka打包
│   ├── unified_build.py       # 统一打包
│   └── build_config.json      # 打包配置
├── output/                     # 打包输出目录
│   └── dist/                   # 可执行文件
├── main.py                     # 主程序入口
├── config.json                 # 应用配置
└── requirements.txt            # Python依赖

```

## 🔧 开发环境

### 系统要求
- Python 3.8+
- Windows 10+/macOS 10.14+/Linux (Ubuntu 18.04+)

### 安装依赖
```bash
# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Linux/macOS
# venv\Scripts\activate    # Windows

# 安装依赖
pip install -r requirements.txt
```

### 开发运行
```bash
python main.py
```

## 📋 打包配置

打包配置位于 `script/build_config.json`，支持以下选项：

- **应用名称和版本**：可自定义应用名称和版本号
- **图标文件**：支持平台特定图标格式
- **控制台选项**：可选择是否显示控制台窗口
- **数据文件**：自动包含配置文件和资源
- **模块包含**：智能检测项目模块依赖

## 🎯 输出文件

打包完成后，输出文件位于 `output/dist/` 目录：

### Windows
- `tms-controller_v1.3.4.exe` - 可执行文件
- `tms-controller_v1.3.4_windows_x86_64.zip` - 分发包

### macOS
- `tms-controller_v1.3.4.app` - 应用程序包
- `tms-controller_v1.3.4_darwin_x86_64.dmg` - 磁盘镜像

### Linux
- `tms-controller_v1.3.4` - 可执行文件
- `tms-controller_v1.3.4_linux_x86_64.tar.gz` - 分发包
- `tms-controller.desktop` - 桌面集成文件
- `install.sh` - 安装脚本

## 🔍 故障排除

### 常见问题

1. **图标文件未找到**
   - 确保图标文件位于 `resources/` 目录
   - 检查文件权限和路径格式

2. **模块导入错误**
   - 验证 `src/` 目录结构完整性
   - 检查 `__init__.py` 文件是否存在

3. **打包超时**
   - Nuitka编译可能需要较长时间（10-30分钟）
   - 确保系统有足够的内存和CPU资源

### 调试模式
所有打包脚本支持调试模式，显示详细构建信息：
```bash
DEBUG=1 python script/build_nuitka.py
```

## 📄 许可证

MIT License - 详见 [LICENSE](LICENSE) 文件

## 🤝 贡献

欢迎提交Issue和Pull Request来改进项目！

## 📞 支持

如有问题，请在Gitee Issues中提交，会尽快回复。