JiaGuoMengCalculator 项目使用教程

JiaGuoMengCalculator 项目使用教程

1. 项目目录结构及介绍

JiaGuoMengCalculator/
├── data/
│   ├── gitattributes
│   └── gitignore
├── LICENSE
├── README.md
├── algorithm.py
├── config.json
├── config.py
├── main.py
├── requirements.txt
├── result.txt
├── screenshot.png
├── static.py
├── test.py
├── ui.py
└── update.py

• data/: 存放项目的元数据文件，如 .gitattributes 和 .gitignore。
• LICENSE: 项目的开源许可证文件，本项目使用 MIT 许可证。
• README.md: 项目的介绍文件，包含项目的功能、使用方法、更新记录等信息。
• algorithm.py: 实现项目核心算法的 Python 文件。
• config.json: 项目的配置文件，用于保存建筑的星级、等级、加成等信息。
• config.py: 配置相关的 Python 文件，可能包含一些配置项的定义和处理逻辑。
• main.py: 项目的启动文件，负责启动整个应用程序。
• requirements.txt: 项目依赖的 Python 包列表，使用 pip install -r requirements.txt 安装依赖。
• result.txt: 计算结果的保存文件，包含最优建筑排布和升级方案。
• screenshot.png: 项目界面的截图文件。
• static.py: 静态资源相关的 Python 文件，可能包含一些常量或静态数据的处理逻辑。
• test.py: 测试相关的 Python 文件，用于测试项目的各个功能模块。
• ui.py: 用户界面相关的 Python 文件，负责实现项目的可视化界面。
• update.py: 更新相关的 Python 文件，可能包含版本更新或数据更新的逻辑。

2. 项目的启动文件介绍

main.py 是项目的启动文件，负责启动整个应用程序。以下是 main.py 的主要功能：

• 初始化配置: 读取 config.json 文件中的配置信息，初始化建筑的星级、等级、加成等数据。
• 启动界面: 启动用户界面，显示建筑信息和计算结果。
• 计算最优排布: 根据用户输入的建筑信息和加成，计算最优的建筑排布方案。
• 保存结果: 将计算结果保存到 result.txt 文件中。

启动项目的方法：

1. 下载项目源代码。
2. 安装依赖：pip install -r requirements.txt。
3. 运行 main.py：python main.py。

3. 项目的配置文件介绍

config.json 是项目的配置文件，用于保存建筑的星级、等级、加成等信息。以下是 config.json 的主要内容：

{
    "buildings": [
        {
            "name": "建筑名称",
            "star": 5,
            "level": 10,
            "bonus": {
                "type1": "200%",
                "type2": "150%"
            }
        },
        ...
    ],
    "blacklisted_buildings": ["建筑名称1", "建筑名称2"],
    "money": "23,33aa",
    "policy_bonus": "300%"
}

• buildings: 建筑列表，包含每个建筑的名称、星级、等级和加成信息。
• blacklisted_buildings: 黑名单建筑列表，包含不需要或未解锁的建筑名称。
• money: 当前拥有的金币数量，格式为游戏内的格式（如：23,33aa）。
• policy_bonus: 政策加成，包含家国之光和国庆100%的buff加成。

配置文件的使用方法：

1. 打开 config.json 文件。
2. 根据游戏内的实际情况，填写建筑的星级、等级、加成等信息。
3. 将不需要或未解锁的建筑加入黑名单。
4. 填写当前拥有的金币数量和政策加成。
5. 保存配置文件，启动项目后会自动读取配置信息进行计算。