学习算法加速

# LearningAlgoBoost 模组自学习倍率

`LearningAlgoBoost.dll` 增强“学习算法”模块带来的属性成长：游戏先按原版规则结算成长，本 Mod 再按当前进度区间放大本次增量，并始终限制在游戏给出的属性上限内。

## 环境与安装

| 项目 | 说明 |
|---|---|
| 游戏 | 可能是盗版演示版/测试版（请使用与 DLL 构建时匹配的版本） |
| 加载器 | MelonLoader（IL2CPP / .NET 6） |
| 安装文件 | `LearningAlgoBoost.dll` |

1. 完全退出游戏。
2. 将 `LearningAlgoBoost.dll` 放入游戏根目录的 `Mods` 文件夹。
3. 启动游戏后，使用带有学习算法效果的模块即可生效。

卸载时，将 DLL 移出 `Mods` 或在 ModManager 中禁用。已经写入存档的成长数值不会回退。

## 工作方式

该 Mod 钩挂学习算法的使用结算：

1. 在原版结算前记录相关属性与其上限。
2. 先让游戏正常完成本次学习算法效果。
3. 计算原本次实际增加的数值。
4. 根据“结算前进度 / 属性上限”选择倍率，将增量放大后写回。

它只处理性能、效率、品质三项学习算法关联属性；没有匹配的上限标签、上限小于等于零、属性没有变化或数值异常时，会跳过本次处理并保留原版结果。

## 默认倍率

| 结算前进度 | 默认倍率 |
|---|---:|---|
| 低于 25% | ×4 |
| 25%–低于 50% | ×3 |
| 50%–低于 75% | ×2 |
| 75% 及以上 | ×1 |

倍率应用于“本次原版新增量”，不是直接把当前属性乘倍。例如原版本次增加 2 点、当前处于 ×3 档，则目标增加量为 6 点；最终结果仍不会超过该属性的原版上限。

## 配置

本 Mod 不提供独立的“启用”开关；启用、禁用由 ModManager 管理。

配置位于 `UserData/MelonPreferences.cfg` 的 `[LearningAlgoBoost]` 分类：

| 配置项 | 默认值 | 作用 |
|---|---:|---|
| `VerboseLog` | `false` | 每次成功放大时输出详细日志。 |
| `Tier1EndPercent` | `25` | 第一档的结束百分比。 |
| `Tier2EndPercent` | `50` | 第二档的结束百分比。 |
| `Tier3EndPercent` | `75` | 第三档的结束百分比。 |
| `Tier1Multiplier` | `4` | 第一档倍率。 |
| `Tier2Multiplier` | `3` | 第二档倍率。 |
| `Tier3Multiplier` | `2` | 第三档倍率。 |
| `Tier4Multiplier` | `1` | 第四档倍率。 |

百分比会限制在 0–100，并自动保证档位从低到高。倍率最低为 1；建议使用合理的正整数，避免设置过大的数值影响游戏平衡或数值稳定性。

## 兼容性与排查

- 不修改读档流程、不保存跨存档缓存，也不长期持有游戏物品引用。
- 只在学习算法结算点处理增量；不修改机器外观、模块安装、存档选择或其他属性成长来源。
- 与同样修改 `ModuleEffectHelper.OnUsedLearningAlgo` 的 Mod 可能叠加或冲突。若成长异常，请优先禁用其他学习算法类 Mod 进行排查。
没有观察到加成时，请确认模块本身满足游戏的学习算法生效条件，并将 `VerboseLog` 临时设为 `true`，再查看 MelonLoader 日志中的 `[倍率]` 记录。

## 构建

```
dotnet build LearningAlgoBoost.csproj -c Release


构建产物：`bin/Release/net6.0/LearningAlgoBoost.dll`

---

代码由 AI 编写；使用前请自行测试并备份重要存档。