# csh-exceltool

**Repository Path**: dust-cat/csh-exceltool

## Basic Information

- **Project Name**: csh-exceltool
- **Description**: CSH-ExcelTool 是一个用于处理 Excel 文件的工具，内部提供了专门的功能来简化抖音店铺用户信息手动统计 Excel 文件的操作。
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: https://hexo.csh215.top/2025/10/25/cshExcelTool/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-09
- **Last Updated**: 2025-10-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Python, Excel, 抖店, 抖店客户信息

## README

## 🧮 CSH Excel Tool

> 一个用于处理抖店客户信息 Excel 的工具，旨在去除繁琐的手动操作，提高办公效率。



***



#### 📦 项目简介

> 这是一个基于 Python 和 Tkinter 构建的图形化 Excel 处理工具，主要功能包括：



- ✅ Excel 文件导入

- 🎨 自定义样式设置（字体、字号、颜色、行高、列宽）

- 💾 配置文件管理（支持保存/加载多个配置）

- 📋 历史路径记录与快速选择

- 📝 日志输出与结果查看

- 🔍 支持打包为 .exe 可执行程序（适配 PyInstaller）

> 非常适合电商运营、客服等需要频繁处理 Excel 表格的场景。



*** 



#### 🖥️ 界面预览

![(界面首页)](src/assets/dashboard222.png)


***



#### 🛠️ 功能亮点

##### 🔧 配置管理

- 支持多配置切换

- 实时生效：字体、字号、加粗、标题背景色、行高、列宽等

- 可新增、保存或更新配置文件
  
##### 🎨 样式自定义
  
- 字体选择器（宋体、仿宋、微软雅黑等）
- 标题字体颜色选择器
- 字号调节 + 加粗开关
- 十六进制颜色选择器
- 列宽精细控制（A-I 各列独立设置）
- 自定义列是否显示
##### 📁 文件历史记录
- 最近打开过的 Excel 路径自动记录
- 支持点击快速载入和删除历史
##### 📄 日志系统
- 操作日志实时显示
- 错误日志红色高亮提示
- 支持一键打开生成文件所在目录

***

#### 📁 项目结构
```
csh-exceltool/
├── excelP2.py                # 主程序入口
├── assets/                   # 图标资源、截图等
│   ├── cshExcel32.ico        # 应用图标
│   └── dashboard222.png      # 界面截图（可选）
├── configs/                  # 配置文件存储目录
│   ├── default.json          # 默认配置文件
│   └── csh.json              # csh配置文件
├── modules/                  # 核心模块
│   ├── config_manager.py     # 配置管理
│   ├── excel_processor.py    # Excel 处理逻辑
│   ├── about.py              # 关于窗口弹窗
│   └── address_splitter.py   # 地址分割方法
└── utils/                    # 工具类模块
    └── dialogCenterUtil.py   # 弹窗居中工具

```
***
#### ⚙️ 使用说明
1. 下载并安装 Python 3.1x.x 版本
2. 克隆或下载本项目代码
3. 安装依赖库：`pip install ttkbootstrap`
4. 运行 `excelP2.py` 启动应用
5. 打包成 .exe（推荐使用 PyInstaller）
   ```
    pip install pyinstaller
    pyinstaller --noconsole --version-file version.txt -n CSH-ExcelTool-1.1.2 -i assets/cshExcel32.ico excelP2.py
   ```
6. 打包后在 `dist` 目录下找到生成的可执行文件, 确保 `configs/`, `assets/` 等资源目录与 exe 同级存在。

***

#### 📦 版本更新记录
##### v1.1.2
- 优化配置输入框的placeholder样式显示
##### v1.1.1
- 新增自定义标题字体颜色
- 列宽随列前移逻辑完成
- 列宽参数动态构建
- 处理流程优化
##### v1.0.0
- 新增配置管理系统
- 支持配置切换、保存、应用
- UI 布局优化（水平居中、滚动日志、动态预览）
- Bug 修复：配置切换时颜色未同步问题
##### v0.1.0
- 基础版完成
- 支持 Excel 文件导入处理
- 提供基础样式设置功能

***

#### 📝 开发者备注
> 如果你希望扩展以下功能，请参考以下方向：

| 功能         | 描述            |
|------------|---------------|
| 🔥 快捷键支持   | 如 Ctrl+S 保存当前配置 |
| 📤 配置导出/导入 | 支持 .json 导出、导入 |
| 🪟 主题切换    | 支持 light/dark 模式 |
| 🧩 列宽智能推荐  | 根据字段内容自动推荐宽度  |

***

#### 📬 联系方式 & 贡献指南
> 欢迎提交 issue！

- Gitee 用户名：Howie
- Email：cm3036755338@yeah.net

***

#### 📜 License
> 本项目遵循 木兰宽松许可证，详情请查看 [LICENSE](LICENSE) 文件。