minecraft-modpack-git-helper

这是一个用于管理Git仓库的图形化工具，特别适合Minecraft整合包开发工作流。这只是我花一下午随便写出来的东西，目前很多功能都不完善qwq(可能有些不可名状之BUG)

功能特点

• 初始化Git仓库配置
• 从GitHub拉取最新版本
• 保存当前开发版本
• 提交更改到GitHub
• 还原到GitHub最新版本
• 友好的图形用户界面

安装要求

• Python 3.6+
• Git
• Git LFS
• 依赖库: maliang (GUI库)

使用方法

首次运行

1. 准备工作:

   • 确保已安装Git和Git LFS
   • 确保Python环境已配置(3.6+版本)

2. 配置文件设置:

   • 打开config.json文件进行编辑
   • 将is_init设为false(首次运行必须)
   • 设置正确的GitHub仓库URL(https字段)
   • (可选)设置Minecraft目录(mc_dir字段)

3. 启动程序:

   python main.py

4. 初始化向导:

   • 程序会显示初始化窗口
   • 输入你在GitHub上显示的昵称
   • 输入你的GitHub注册邮箱
   • 点击"确定"按钮开始初始化
   • 程序会自动完成以下操作:
     • 创建repositories目录
     • 初始化Git仓库
     • 配置Git用户信息
     • 安装Git LFS
     • 拉取远程仓库代码
     • 创建develop分支

常规操作指南

程序主界面包含四个主要功能按钮:

1. 从Github获取最新版本

   • 功能: 拉取远程仓库最新代码
   • 操作流程:
     • 点击按钮
     • 程序会自动:
       • 删除本地develop分支
       • 拉取远程main分支最新代码
       • 重新创建develop分支
     • 完成后会显示成功提示

2. 保存当前开发版本

   • 功能: 提交并合并当前开发内容到main分支
   • 操作流程:
     • 点击按钮
     • 在控制台输入提交信息(请详细描述更改内容)
     • 程序会自动:
       • 添加所有更改文件
       • 提交到本地仓库
       • 切换到main分支
       • 合并develop分支
     • 完成后会显示成功提示

3. 提交到Github

   • 功能: 推送本地更改到远程仓库
   • 操作流程:
     • 点击按钮
     • 程序会自动:
       • 拉取远程最新代码(避免冲突)
       • 推送本地更改到远程
     • 完成后会显示成功提示

4. 还原到Github版本

   • 功能: 放弃所有本地更改，重置到远程最新状态
   • 操作流程:
     • 点击按钮
     • 程序会自动:
       • 执行硬重置(hard reset)
       • 恢复到origin/main状态
     • 完成后会显示成功提示

注意事项

• 每次操作后程序会自动返回到主界面
• 重要操作前建议备份工作内容
• 如果操作失败，请检查控制台输出的错误信息

配置说明

配置文件config.json包含以下选项:

{
    "is_init": true,  // 是否已初始化
    "https": "https://github.com/your/repo.git",  // GitHub仓库URL
    "mc_dir": "path/to/minecraft"  // (可选)Minecraft游戏目录
}

注意事项

1. 首次使用前请确保已正确配置Git
2. 修改配置后需要重启程序
3. 程序会自动创建repositories目录存放Git仓库
4. 提交时会要求输入提交信息，请认真填写
5. 如果配置了mc_dir，程序会自动同步Minecraft模组文件