# ToolBox

**Repository Path**: xing-yu-41/tool-box

## Basic Information

- **Project Name**: ToolBox
- **Description**: 一个杂七杂八的小工具箱
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-26
- **Last Updated**: 2025-10-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 多功能工具箱

一个基于命令行界面的可扩展多功能工具箱，使用Python开发，支持打包成exe文件。

## 特性

- 🔧 **模块化设计**: 基于插件系统，易于扩展新功能
- 🖥️ **命令行界面**: 简洁直观的命令行交互界面
- ⚙️ **配置管理**: 支持配置文件管理和个性化设置
- 📦 **一键打包**: 支持打包成独立的exe文件
- 🔌 **插件系统**: 支持动态加载和管理功能模块

## 项目结构

```
Tool/
├── main.py              # 主程序入口
├── requirements.txt     # 依赖包列表
├── build.py            # 打包脚本
├── config.json         # 配置文件（运行后自动生成）
├── core/               # 核心模块
│   ├── __init__.py
│   ├── cli_interface.py    # 命令行界面
│   ├── plugin_manager.py   # 插件管理器
│   └── config_manager.py   # 配置管理器
└── plugins/            # 插件目录
    ├── __init__.py
    ├── calculator.py       # 计算器插件
    ├── system_info.py      # 系统信息插件
    └── text_tools.py       # 文本处理工具插件
```

## 安装和运行

### 1. 安装依赖

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

### 2. 运行程序

```bash
python main.py
```

### 3. 打包成exe文件

```bash
python build.py
```

打包完成后，exe文件将位于 `dist/ToolBox.exe`

## 内置功能模块

### 计算器 (calc)
- 支持基本四则运算
- 支持括号优先级
- 用法: `calc 1 + 2 * 3`

### 系统信息 (sysinfo)
- 显示CPU、内存、磁盘信息
- 显示系统基本信息
- 用法: `sysinfo`

### 文本处理工具 (text)
- Base64编码/解码
- URL编码/解码
- 哈希值计算 (MD5, SHA1, SHA256)
- 文本统计
- 大小写转换
- 用法: `text base64 encode Hello`

## 内置命令

- `help` - 显示帮助信息
- `list` - 列出所有已加载的功能模块
- `clear` - 清屏
- `config` - 配置管理
- `exit` / `quit` - 退出程序

## 开发新插件

### 1. 创建插件文件

在 `plugins/` 目录下创建新的Python文件，例如 `my_plugin.py`

### 2. 继承BasePlugin类

```python
from core.plugin_manager import BasePlugin

class MyPlugin(BasePlugin):
    def __init__(self):
        super().__init__()
        self.name = "myplugin"
        self.version = "1.0.0"
        self.description = "我的插件描述"
        
    def execute(self, args):
        # 实现插件功能
        print("Hello from my plugin!")
        return True
```

### 3. 重启程序

插件将自动被加载和识别。

## 配置文件

程序首次运行时会自动生成 `config.json` 配置文件，包含以下配置项：

- `version`: 程序版本
- `language`: 界面语言
- `auto_save`: 自动保存配置
- `plugin_auto_load`: 自动加载插件
- `log_level`: 日志级别
- `theme`: 界面主题
- `plugins`: 插件启用/禁用状态

## 系统要求

- Python 3.6+
- Windows/Linux/macOS
- 依赖包见 requirements.txt

## 许可证

MIT License

## 贡献

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