bettergi-scripts-list/repo/js/DSTCG/README.md
提瓦特钓鱼玳师 2f3291a613
提瓦特全自动钓鱼【更新】、「牌圣」【更新】 (#3808)
* 地图追踪添加编号

* 加入七圣召唤决策模型-初步训练

* fix
2026-11-09 08:39:39 +08:00

90 lines
11 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 「牌圣」(Duel Saint of TCG)
基于 BetterGI 的七圣召唤自动对战脚本。对局中任意阶段(初始手牌、重投骰子、我方/敌方回合)都可以启动,脚本会自动接管出牌、切换角色、释放技能、元素调和、重投骰子与结束回合,并把每一步决策记录到 `logs/` 目录,可用于训练本地模型。
## 功能一览
- **任意阶段启动**:自动识别当前界面(初始手牌、重投骰子、行动阶段、结束阶段)并接管对局,不需要从开局运行;结束阶段只等待自动结算,不会做无效点击。结束回合前会先关闭左侧的角色/技能/手牌详情面板(它会盖住左下角的结束回合按钮),点完按钮后校验行动权,没结束会重点一次;连续约三分钟(20 次决策)牌局毫无变化会自动退出并保存现场截图,避免整局卡死。
- **自动对战**:识别双方角色、血量、出战位、充能、元素附着、骰子与手牌,自动选择并执行动作。
- **行动牌**:自动打出事件牌、支援牌、场地牌与装备牌;装备/圣遗物牌会自动选中角色并点击确认。同一角色同槽位只装一件,已装备时改给其他角色,所有角色都占用就跳过,避免顶替掉原来的牌。支援区满 4 张后,只有明显更好的支援牌才会顶替场上最差的一张,否则跳过;需要手动选召唤物目标的牌(如「送你一程」)脚本还不会点目标,会直接跳过而不是白交一次行动。
- **结束阶段结算**:召唤物与我方/敌方支援牌、场地牌的“结束阶段”效果都会解析成伤害与治疗,计入阵亡风险评估、结束回合的打分和对局轨迹,避免把最后一颗骰子用在即将被召唤物打死的角色身上。已打出的牌会额外读取卡面徽标:右上角的剩余次数/持续回合/倒计时,左下角的元素图标与当前数值(伤害或治疗),徽标数值优先于卡面文本,像黑色幻影这类按攻击力动态结算的伤害也能读到实际值;徽标数字读空时会分区域重试,元素颜色只作未知牌的兜底判断。卡牌库里没有的牌会点开左侧详情面板读描述,同样能取到结束阶段伤害/治疗/元素。结算伤害还会按元素计入元素反应加成,让模型区分“1 点物理”与“2 点蒸发”。
- **异常状态感知**:冻结等会让角色无法行动的异常状态会被识别(`DISABLING_STATES`),出战角色被冻结时不放技能、优先换人;状态词表按卡牌库预留了眩晕/石化/束缚,补上模板即可生效。
- **元素反应与主攻手**:读取敌方出战角色的附着元素,技能按元素反应收益加权,蒸发/融化/超载等 +2 反应额外优先,冻结、感电/超导/扩散的溅射价值也计入打分;同时评估后排角色的技能与元素爆发潜力,值得时先切换主攻角色再输出,冻结的出战角色不会硬放技能。我方出战身上的附着会被敌方技能打出反应,血量偏低或手里骰子不多时,换到干净角色躲开 +2 反应或水/冰冻结会额外加分。
- **骰子利用**:骰子不跨回合保留,模型想提前结束回合但手里还有 2 颗以上骰子、且存在专家评分明显为正的出牌或攻击动作时,会改走该动作,日志 `mode` 追加 `+usedice`;换人本身就要交出行动权、不算用掉骰子,不参与这个兜底;没有划算动作时仍正常结束,避免为了花骰子做亏动作。
- **动态费用与增益**:手牌费用按卡面数字读取实际值(已包含减费),并记录本回合“少花费/费用-”“元素爆发减能”“切换角色减费”等效果;只记录脚本自己打出的牌与技能文本,装备加成按角色和槽位归属,同槽换装会覆盖旧加成,条件触发的效果不会被当成常驻加成。
- **防守与骰子预留**:按敌方出战角色可达的最高伤害(含元素爆发充能与元素反应)加上敌方结束阶段伤害估算我方出战角色的阵亡风险;有风险时优先换到能扛过本轮威胁的健康角色、提前打出治疗/护盾牌,并预留换人所需骰子——不把最后一颗骰子交给打不死人的技能或普通牌,避免骰子用光后被对手连续行动击杀。没有阵亡压力时不会换到比出战更残且没有技能收益的角色,有伤害可打时也不会用换人白送一次战斗行动。
- **低胜率放弃**:估算胜率低于阈值(默认 10%)且落后人头、或血量差达到 35% 时,自动走“右上角设置 → 放弃对局 → 确认”放弃本局;识别抖动不会误触发。
- **元素调和**:骰子不足时自动烧掉价值最低的手牌;先单击选中再拖到右侧骰子区(与出牌顺序一致),某张牌拖动失败会自动换下一张,高价值手牌会保留,宁可放弃技能。调和后会按画面重新核对骰子,骰子仍然不足且没有可调和手牌时不会强行释放技能。
- **自动重投**:保留万能骰与出战角色对应元素骰。
- **本地模型**:由本地训练的动作评分模型选择操作,输入包含阵亡风险、换人收益、结束阶段结算与手牌价值;旧版模型会按特征名自动对齐后继续使用,模型文件缺失或格式不兼容时回退内置策略。
- **对局记录**:可选把每步决策写入 `logs/duel_*.log`(JSONL),包含局面、候选动作、实际选择、打分与胜负结果;可用于导入 Python 后台增量训练模型,也可以自行解析做复盘,不影响正常使用。
## 使用说明
1. 游戏窗口需为 16:9 比例,推荐 1920×1080 窗口模式。
2. 在 BetterGI 中启动本脚本,然后进入七圣召唤对局;任意界面均可。
3. 对局结束后脚本自动退出,可在 BetterGI 中再次启动;每次出牌/调和前都会先确认是否已进入结算界面,不会在“对局胜利/失败”界面上继续操作。
4. 首次使用建议先打一局低风险对局,确认识别与点击正常。
### 对局轨迹与训练
开启 `writeTrace` 后,每局会写入 `logs/duel_YYYYMMDD.log`(JSONL,一行一条记录)。文件包含每一步的局面、候选动作、脚本最终选择、专家/模型打分,以及开局阵容与对局结果,可以直接用 `开发/` 里的 Python 管理后台导入数据集,增量训练动作评分模型;也可以自行解析做复盘分析。轨迹只保存在本地,不会上传。同样的局面和选择连续重复(点击被面板挡住、操作没有生效)时只记录第一条,`result` 里的 `skipped_steps` 是本次过滤掉的重复决策数。
`logs/` 已在 `manifest.json` 的 `saved_files` 中声明,更新脚本时会随用户数据一起备份和恢复。
### 脚本设置
| 设置项 | 说明 | 默认 |
| --- | --- | --- |
| `useModel` | 启用本地模型;关闭时使用内置专家策略 | 开启 |
| `modelFile` | 模型文件路径(相对脚本目录) | `assets/model/policy.json` |
| `actionDelayMs` | 每次键鼠操作后的额外延时;电脑较慢时可适当调大 | 200 |
| `handCountMode` | 手牌数量识别方式:自动 / 数字识别 / 模板匹配 / 关闭 | 自动 |
| `useActionCards` | 识别并打出行动牌;关闭后手牌仅用于元素调和 | 开启 |
| `scanZones` | 识别双方支援区与召唤物区 | 开启 |
| `zoneClickFallback` | 区域卡低置信度时点击查看详情 | 开启 |
| `characterStateScan` | 点击双方出战角色读取详情面板的「角色状态/阵营出战状态」 | 开启 |
| `writeTrace` | 是否把对局轨迹写入 `logs/duel_*.log`,可用于训练 | 开启 |
| `detailLog` | 输出调试日志 | 关闭 |
| `autoSurrender` | 胜率过低时自动放弃对局 | 开启 |
| `surrenderThreshold` | 放弃对局的胜率阈值(%):0/5/10/15/20/25/30 | 10 |
## 常见问题
- **手牌显示“未知”**:悬停识别没有读到卡名。未知牌不会主动打出,但会按中等价值参与调和排序,不影响对局继续。
- **装备/圣遗物没有装上**:脚本会自动等待并点击下方“确认”按钮;若连续失败,会在本局跳过该牌。
- **某张牌打不出去**:脚本会先校验手牌数量,失败会重试;连续失败 4 次后本局不再尝试打出行动牌。
- **卡在某个界面**:先手动结束回合或关闭弹出面板,脚本会自动恢复;超过 3 分钟无法识别对局状态、或连续约三分钟(20 次决策)牌局没有任何变化,都会自动退出(后者会保存 `debug_no_progress_*.png` 现场截图)。
- **支援牌/召唤物显示未知**:新卡可能还没有对应原画模板,不影响出牌与技能决策;召唤区还会退回“点击读卡名”的兜底方式。
- **点击没反应**:在设置里把 `actionDelayMs` 调大(如 300~500)后重试。
## 目录结构
```
DSTCG/
├── main.js # 脚本主体
├── manifest.json # BetterGI 清单
├── settings.json # 设置界面
├── assets/ # 卡牌库、模型、识别模板
├── logs/ # 对局轨迹与调试截图(可用于训练)
└── 开发/ # 开发者工具(普通用户无需使用)
```
## 已知限制
- 仅适配 16:9 的 PC 客户端 UI,其他比例或云游戏画面需要重新标定坐标与模板。
- 手牌名称依赖悬停 OCR;悬停区域或详情面板布局变化时会识别为“未知牌”。
- 需要二次选择目标的事件牌(挑选、随机选牌、交换手牌、弃牌等)会被自动跳过。
- 支援牌与召唤物都依赖原画模板匹配,尚未收录模板的新牌可能识别不到。模板按 1920×1080 局内实测单档生成(支援区 99×109、召唤区 70×83),换成其他窗口尺寸需要重新生成模板。
- 角色阵亡动画、手牌遮挡等情况下可能出现短暂误读,脚本每一步都会重新读取牌桌状态。
- 卡面费用数字模板目前只收录 0/1/2/3/5,未收录的费用(如 4、6)会沿用卡牌库静态费用;减费牌读取到卡面数字时以卡面为准。
- 增益只根据脚本自己打出的牌/技能文本推断,敌方施加且界面无法识别的负面状态(冻结除外)不会计入;带“触发后/如果/每回合”等条件的装备/支援效果不会被当成常驻加成。
- 每回合最多主动打出 2 张高价值行动牌,并为后续技能与换人预留骰子;能斩杀时不会出牌。
## 开发者文档
后台管理、数据集导入、模型训练、模板制作与资源包生成等开发内容见 [开发/README.md](开发/README.md)。管理后台只用于开发维护,不启动后台也能正常使用脚本;资源更新页生成的是独立资源包,不会直接修改脚本正在使用的 `assets/`。
## 作者
提瓦特钓鱼玳师 · 反馈邮箱:hijiwos@hotmail.com