# MooeToolPro

**Repository Path**: liberalchang/MooeToolPro

## Basic Information

- **Project Name**: MooeToolPro
- **Description**: 基于pyside6+ PyQt-Fluent-Widgets 的工具软件
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-17
- **Last Updated**: 2026-01-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Pyside6Template

#### 介绍
基于 **PySide6** 和 **PyQt-Fluent-Widgets** 构建的现代化桌面应用开发模板。本项目提供了一套完整的 GUI 应用程序架构，集成了常用的功能模块，旨在帮助开发者快速启动基于 Python 的桌面应用开发。

#### 主要特性
- **现代化 UI 设计**: 采用 Fluent Design 风格，界面美观、交互流畅。
- **完善的架构**: 分层架构设计（View-Controller-Model），代码结构清晰，易于维护和扩展。
- **国际化 (i18n)**: 内置完整的中英文切换支持，提供自动化翻译构建脚本。
- **主题系统**: 支持浅色/深色主题切换，支持跟随系统，可自定义主题色。
- **配置管理**: 基于 JSON 的配置文件管理，支持数据持久化。
- **日志系统**: 集成日志记录功能，支持控制台和文件输出。
- **实用脚本**: 提供资源编译、国际化更新等自动化脚本。

#### 软件架构

```
Pyside6Template/
├── app/                        # 应用源代码
│   ├── common/                 # 通用模块 (配置, 图标, 语言, 日志等)
│   ├── core/                   # 核心逻辑 (管理器, 服务, 工具类)
│   ├── model/                  # 数据模型
│   ├── ui/                     # UI 界面定义 (.ui 文件)
│   ├── views/                  # 视图层 (主窗口, 子界面)
│   └── widgets/                # 自定义组件
├── resource/                   # 资源文件
│   ├── config/                 # 配置文件
│   ├── i18n/                   # 国际化翻译文件 (.ts, .qm)
│   ├── images/                 # 图片资源
│   ├── qss/                    # 样式表
│   └── *.qrc                   # Qt 资源描述文件
├── scripts/                    # 工具脚本
│   ├── build_i18n.py           # 国际化构建工具
│   ├── compile_rcc.py          # 资源编译工具
│   └── ...
├── main.py                     # 程序入口
└── README.md                   # 项目说明文档
```

#### 安装教程

1.  **环境要求**
    - Python 3.8+
    - PySide6
    - PyQt-Fluent-Widgets

2.  **安装依赖**
    ```bash
    pip install PySide6 PyQt-Fluent-Widgets
    ```

#### 使用说明

1.  **启动应用**
    在项目根目录下运行：
    ```bash
    python main.py
    ```

2.  **国际化 (i18n) 流程**
    如果不修改界面文字，无需执行此步骤。若新增或修改了界面文本：
    - 运行构建脚本更新翻译文件：
      ```bash
      python scripts/build_i18n.py
      ```
    - 使用 Qt Linguist 编辑 `resource/i18n/` 下的 `.ts` 文件。
    - 再次运行脚本编译生成 `.qm` 文件。

3.  **资源编译**
    若修改了 `resource/images` 或 `resource/qss` 下的资源，需要重新编译资源文件：
    ```bash
    python scripts/compile_rcc.py
    ```

#### 功能模块示例
项目预置了多个功能界面的示例，位于 `app/views/subviews/`：
- **设置界面**: 包含完整的主题、语言、日志等设置项。
- **Bag 转换/录制**: 机器人开发相关的 Bag 文件处理示例。
- **文件管理**: 简单的文件操作界面示例。
- **实时状态/车辆标定**: 数据监控与参数调整界面示例。
- **PCD 查看**: 点云数据可视化示例。

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request

#### 许可证
[MIT License](LICENSE)