RK昆特牌助手

RK Gwent Assistant 是《巫师3》中昆特牌的简体中文实用模组。

描述
此版本添加了可配置的昆特牌辅助功能，无需控制台命令，也不会永久修改玩家的卡牌收藏。它适用于测试、无障碍和单人使用。

主要功能
- F6：确认后为当前对局解锁助手，然后向你方抽一张牌。
- F7：在支持的预设卡牌之间循环，不会向对手添加卡牌。
- F8：可选的瞬间获胜，默认禁用，启用时需要确认。
- 每局抽牌上限为 1 到 30；默认是 10。
- 游戏内设置位于 选项 > 模组 > RK Gwent Assistant。
- 输入诊断会显示已接收的输入计数和最后一次拒绝的原因。
- 安装和卸载脚本会保留无关模组、共享配置、自定义键位绑定和未知文件。

安装
1. 完全退出《巫师3》。
2. 将 ZIP 解压到临时文件夹。不要覆盖来自其他模组的共享 XML 或输入配置。
3. 在解压后的包中打开 PowerShell 并运行：
  & '.\mods\modRkGwentCheatAssistant\Install.ps1' -GameRoot 'D:\Games\The Witcher 3'
4. 将 GameRoot 替换为实际的游戏安装路径。如果 Documents 文件夹被重定向，请添加 -UserDirectory 并填入实际的《巫师3》文档路径。
5. 启动游戏，并在脚本编译后检查 选项 > 模组 > RK Gwent Assistant。

卸载
关闭游戏并运行：
& '.\mods\modRkGwentCheatAssistant\Uninstall.ps1' -GameRoot 'D:\Games\The Witcher 3'

要求
- 当前脚本环境必须支持 @addMethod 和 @wrapMethod 注解。
- 请勿为此模组安装《赛博朋克 2077》的 redscript 编译器。
- 此模组仅支持简体中文。

兼容性与已知限制
- 在此安装环境中构建并测试：重制版 UI 5.00c，EXE 5.0.0.1044392，DX12。
- 未在官方 4.04、其他重制版构建、其他语言或其他昆特牌规则模组上验证。
- 直接获胜行为不保证适用于所有锦标赛、任务、成就或奖励流程。
- 抽牌计数器记录的是已发送的请求，而不是已确认添加的卡牌，并且无法可靠检测所有动画或对手回合状态。
- 不支持更改卡牌强度、替换特定手牌或撤销已经结算的效果。
- 请备份存档，并先在普通的非关键对局中测试。不要在锦标赛或一次性任务中首次使用。

验证
- 游戏玩法脚本和中文本地化在基本游戏内确认后已冻结。
- 安装和卸载回归测试在 PowerShell 7 和 Windows PowerShell 5.1 下通过。
- 最终 ZIP 具有严格允许列表、逐文件 SHA-256 清单和 ZIP SHA-256 附属文件。