# mars-modifier

**Repository Path**: ghostmice/mars-modifier

## Basic Information

- **Project Name**: mars-modifier
- **Description**: MarsAdmin开源框架修改器
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2026-03-18
- **Last Updated**: 2026-04-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Mars Admin 修改器

一键修改 Mars Admin 项目的包名、目录名、项目名等，快速定制属于自己的后台管理系统。

作者：程序员GhostMice

## 功能

- 修改包名（com.mars -> com.xxx.xxx）
- 修改目录名、模块名前缀
- 修改 artifactId、groupId
- 修改站点名称、站点描述、移动端应用名称
- 自动重命名启动类（MarsAdminApplication -> XxxAdminApplication）
- 自动重命名 SQL 文件
- 配置数据库地址、端口、库名、账号、密码
- 配置 Redis 地址、端口、密码、数据库号
- 批量删除 IDE 生成文件（.idea、target、.iml 等）
- 检查更新
- 赞赏支持（微信 / 支付宝）

## 使用方式

### 直接运行

```bash
cd mars-modifier
pip install -r requirements.txt
python app.py
```

### 打包为 exe

```bash
cd mars-modifier
pip install -r requirements.txt
build.bat
```

打包后的 `MarsModifier.exe` 在 `dist` 目录下，双击即可运行，无需 Python 环境。

## 使用步骤

1. 从官网下载 ZIP 格式的 Mars Admin 项目包
2. 打开修改器，选择下载的压缩包
3. 填写要修改的内容（包名、项目名等）
4. 如需修改数据库/Redis 配置，点击顶部「⚙ 配置参数」
5. 点击「🚀 开始执行」，选择输出目录
6. 修改完毕后点击「📂 打开输出目录」查看结果

## 环境要求

- Python 3.8+
- customtkinter
- Pillow

依赖安装：

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

## 目录结构

```
mars-modifier/
├── app.py              # GUI 主程序
├── modifier.py         # 核心修改引擎
├── version.py          # 版本信息
├── config.ini          # 默认配置
├── gen_icon.py         # 图标生成脚本
├── icon.ico            # 应用图标
├── build.bat           # 打包脚本
├── run.bat             # 快速启动脚本
├── requirements.txt    # 依赖清单
├── version.json        # 版本检查文件
└── img/                # 赞赏码图片
    ├── wechat.jpg
    └── alipay.jpg
```

## 常见问题

**Q: 修改后的项目能直接运行吗？**

A: 可以。修改器会替换所有代码中的包名、类名、配置引用，修改后的项目可以直接用 IDE 打开并运行。

**Q: SQL 文件里的用户数据（聊天记录等）会被修改吗？**

A: 不会。修改器只替换代码结构相关的内容（包名、模块名、配置等），SQL 中的业务测试数据（如用户昵称）不会被修改，可以在导入数据库后自行清理。

**Q: 打包的 exe 运行时杀毒软件报警怎么办？**

A: PyInstaller 打包的 exe 可能被部分杀毒软件误报，添加信任即可。软件本身仅在检查更新时有网络请求，可放心使用。

**Q: 支持 macOS / Linux 吗？**

A: GUI 基于 tkinter + customtkinter，理论上跨平台支持。但打包脚本（build.bat）仅适用于 Windows，其他系统可直接 `python app.py` 运行。