# efficient_tool

**Repository Path**: chztech/efficient_tool

## Basic Information

- **Project Name**: efficient_tool
- **Description**: 一个方便提高效率的小工具
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-23
- **Last Updated**: 2025-11-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 上位机系统

基于 PySide6 开发的上位机界面应用程序，支持从CSV配置文件加载模块和执行项。

## 功能特性

- 简约美观的浅蓝色调界面设计
- 三栏布局：顶部栏、主体、底部栏
- 两级垂直导航栏
  - 一级导航：一级模块列表
  - 二级导航：二级模块列表
- 从CSV配置文件加载模块和执行项
- 执行项工厂模式，支持多种执行类型（Python、Shell等）
- 每个执行项可独立执行脚本
- 实时显示执行状态

## 安装依赖

```bash
pip install -r requirements.txt
```

## 运行程序

```bash
# 使用默认配置文件（config.csv）
python main.py

# 指定配置文件路径
python main.py /path/to/config.csv
```

## 配置文件格式

配置文件为CSV格式，包含以下列：

- 一级模块
- 二级模块
- 执行类型（python、shell等）
- 脚本绝对路径
- 脚本参数1-5

示例：

```csv
一级模块,二级模块,执行类型,脚本绝对路径,脚本参数1,脚本参数2,脚本参数3,脚本参数4,脚本参数5
编译阶段,拷贝文件,python,/home/test1.py,arg1,,,,
编译阶段,git操作,python,/home/test2.py,arg1,arg2,,,
打包阶段,打包版本,shell,/home/test.bash,,,,
```

## 使用说明

1. **加载配置**：程序启动时自动加载 `config.csv`，或点击"加载配置"按钮选择其他配置文件
2. **选择模块**：在一级模块列表中选择模块，二级模块列表会显示对应的二级模块
3. **执行脚本**：在二级模块页面中，每个执行项块都有"执行"按钮，点击即可执行对应的脚本
4. **查看状态**：执行项会显示执行状态（就绪、执行中、执行成功、执行失败）

## 界面说明

- **顶部栏**：显示系统标题
- **主体左侧**：两级导航栏
  - 一级：一级模块列表
  - 二级：当前一级模块下的二级模块列表
  - 加载配置按钮
- **主体右侧**：二级模块内容显示区域
  - 显示该二级模块下的所有执行项块
  - 每个执行项块显示执行类型、脚本路径、参数等信息
  - 每个执行项块都有独立的执行按钮
- **底部栏**：显示状态信息和版本号

## 项目结构

```
.
├── main.py                 # 主程序入口
├── config_loader.py        # CSV配置加载器
├── exec_item_factory.py    # 执行项工厂（工厂模式）
├── second_module_page.py   # 二级模块页面
├── config.csv             # 配置文件示例
├── requirements.txt        # 依赖列表
└── README.md              # 说明文档
```

## 扩展执行类型

如需添加新的执行类型，可以在 `exec_item_factory.py` 中：

1. 创建新的执行项类（继承 `ExecItemBase`）
2. 在 `ExecItemFactory._exec_item_classes` 中注册新类型

示例：

```python
class CustomExecItem(ExecItemBase):
    def execute(self):
        # 实现自定义执行逻辑
        pass

ExecItemFactory.register_exec_item('custom', CustomExecItem)
```


## 其他补充
顶部栏 上位机系统 这个标签去掉，加载配置和保存配置放到左边，同时增加运行按钮。点击运行按钮可以运行所有的模块