[Bug] 有X费次要资源的卡牌，使用子弹时间免费后，不消耗次要资源，也没有效果

[iouter]

模块范围

Public API（公开 API）

严重程度

Minor（轻微）

发生了什么？

有X费次要资源的卡牌，使用子弹时间免费后，不消耗次要资源，也没有效果

复现步骤

1.打出子弹时间
2.打出一张带X费次要资源的卡牌（蕾忍的哈利路小旋风）

期望行为

原版X消耗的费和星，打出次要时间后，都会正常消耗，所以这里也应该正常消耗

日志 / 堆栈

RitsuLib 版本

0.4.45

运行环境

No response

[ritsukage-local-analyzer]

Warning

此分析由 AI 自动生成，仅供开发者参考，最终判断请以人工确认为准。如有疑问建议结合本地环境进一步复现确认。

摘要

该问题集中在“被子弹时间变为免费”的卡牌与 RitsuLib 的 X 次级资源费用交互：卡牌可被打出，但 X 次级资源没有按可用数量结算，导致依赖该 X 值的效果也可能为 0 或不触发。影响范围看起来偏向次级资源费用/免费出牌桥接逻辑，建议优先用最小复现卡确认后在免费标记与 X 次级资源解析处修正。

重点结论

项目	结论
简单介绍	子弹时间把非原版 X 费卡变为免费后，带 X 次级资源的卡没有正常消耗次级资源，也没有按 X 值产生效果。
可能原因	较高置信度：RitsuLib 将 SetToFreeThisTurn 统一绑定为“即将免费打出”，而次级资源支付解析在 isFree 时会把 X 次级资源的 AmountToSpend 置 0；若该 X 条款是可选支付，还会把 Value 置 0。
可能解决方案	1) 让“能量/星星免费”与“次级资源免费”分离，X 次级资源不应仅因子弹时间免费而被清零；2) 或在子弹时间/SetToFreeThisTurn 绑定侧识别带 X 次级资源的卡，按原版 X 费例外逻辑避免把该次级 X 支付标记为免费。
需要补充	缺少运行环境与可观察日志/截图；但复现步骤、版本和涉及卡牌已足以开始本地验证。

展开详细分析、证据与验证

问题描述

期望行为

• 打出子弹时间后，再打出带 X 次级资源的卡牌时，应像原版 X 能量/星星费用一样按当前可用资源结算。
• 次级资源应被正常消耗，卡牌效果应按实际 X 值生效。

实际行为

• 报告者观察到：带 X 次级资源的卡牌在子弹时间免费后，不消耗次级资源，也没有效果。

复现步骤

1. 打出子弹时间。
2. 打出一张带 X 费次级资源的卡牌，例如「蕾忍的哈利路小旋风」。

环境与版本

• RitsuLib 版本：0.4.45
• 模块范围：Public API（公开 API）
• 严重程度：Minor（轻微）

日志、附件与原文摘录

• 原文：有X费次要资源的卡牌，使用子弹时间免费后，不消耗次要资源，也没有效果
  • 要点：免费出牌状态把 X 次级资源结算短路，用户可见结果是无消耗且效果缺失。
• 日志块为空，未提供截图或存档。

详细分析依据

• 原版子弹时间只对“非原版 X 能量费”的手牌调用 SetToFreeThisTurn()：official-source/src/Core/Models/Cards/BulletTime.cs:19、official-source/src/Core/Models/Cards/BulletTime.cs:21、official-source/src/Core/Models/Cards/BulletTime.cs:23。这说明原版逻辑本身保留了 X 能量费卡的特殊结算路径。
• SetToFreeThisTurn() 会把能量费用和星星费用设为 0：official-source/src/Core/Models/CardModel.cs:1266。原版 ResourceInfo 同时区分了 spent 与 value，例如 EnergySpent / EnergyValue、StarsSpent / StarValue：official-source/src/Core/Entities/Cards/ResourceInfo.cs:8、official-source/src/Core/Entities/Cards/ResourceInfo.cs:15、official-source/src/Core/Entities/Cards/ResourceInfo.cs:20、official-source/src/Core/Entities/Cards/ResourceInfo.cs:27。
• RitsuLib 当前把所有 CardModel.SetToFreeThisTurn 调用绑定到免费出牌标记：src/Cards/FreePlay/Patches/FreePlayBindingPatches.cs:16、src/Cards/FreePlay/Patches/FreePlayBindingPatches.cs:26。随后次级资源 CanPlay / SpendResources 补丁会用 FreePlayBindingRegistry.IsCardFreeForUpcomingPlay(__instance) 生成支付计划：src/Combat/SecondaryResources/Patches/SecondaryResourceCardPatches.cs:40、src/Combat/SecondaryResources/Patches/SecondaryResourceCardPatches.cs:71。
• X 次级资源解析中，isFree 会直接导致 amountToSpendForX = 0：src/Combat/SecondaryResources/SecondaryResourceCosts.cs:1026、src/Combat/SecondaryResources/SecondaryResourceCosts.cs:1031、src/Combat/SecondaryResources/SecondaryResourceCosts.cs:1032。若该 X 条款不是 required cost，还会让 effectiveXValue 为 0：src/Combat/SecondaryResources/SecondaryResourceCosts.cs:1041。
• 提交阶段也会跳过 IsFree 行的实际消耗：src/Combat/SecondaryResources/SecondaryResourceCosts.cs:693；CommitFree 的注释明确说明免费 ledger 不修改资源数量：src/Combat/SecondaryResources/SecondaryResourceCosts.cs:757。
• 因此，本 issue 更像是语义边界问题：子弹时间的“能量/星星费用归零”被桥接成了“所有次级资源支付也免费”，但 X 次级资源应更接近原版 X 能量/星星的例外行为。

反馈规范性提醒

维度	状态
复现步骤	已提供：包含子弹时间与具体示例卡牌。
期望/实际	已提供：明确说明应消耗并生效，实际不消耗且无效果。
环境与版本	含糊：给出了 RitsuLib 0.4.45，但运行环境为 _No response_。
日志/附件	缺失：日志块为空，无截图、存档或调试输出。
标题与背景	已提供：标题能定位到 X 次级资源 + 子弹时间免费交互。

详细验证建议

• 在 0.4.45 用最小测试卡注册一个 X 次级资源 required cost，记录子弹时间前后 SecondaryResourcePaymentResolver.Plan(card, isFree) 的 AmountToSpend、Value、IsFree。
• 用同样资源注册一个 X 次级资源 optional spend，确认 isFree == true 时是否出现 Value == 0，对应“没有效果”的路径。
• 对照原版 X 能量费卡：打出子弹时间后确认该卡不被 SetToFreeThisTurn() 处理，从而保留 X 结算。
• 修正后回归固定次级资源费用、X 次级资源费用、自动打出（auto-play）和真正免费打出效果，避免把所有免费语义都改坏。

风险与未决

• “哈利路小旋风”的 X 次级资源到底是 required cost、optional spend 还是 extra spend，需要查看该 mod 卡牌实现或用调试输出确认；这会影响“无效果”的直接原因。
• 若直接停止所有带 X 次级资源卡的免费标记，可能影响同卡上的固定次级资源费用或其他明确应免费的场景。
• 更稳妥的修复可能需要把免费来源/免费资源类型建模得更细，而不是继续用单个 bool isFree 表示所有费用全免。

---

English translation

Summary

This issue centers on the interaction between cards made free by Bullet Time and RitsuLib X-cost secondary-resource payments: the card can be played, but the X secondary resource is not settled from the available amount, so effects that depend on that X value may become 0 or fail to trigger. The likely area is the bridge between free-play markers and secondary-resource payment resolution; maintainers should first confirm it with a minimal repro card, then adjust how free play applies to X secondary resources.

Key Takeaways

Item	Takeaway
Brief description	After Bullet Time makes a non-vanilla-X card free, a card with an X secondary-resource cost does not consume the secondary resource and does not apply its X-based effect normally.
Likely cause	High confidence: RitsuLib binds SetToFreeThisTurn as “free for upcoming play”, and the secondary-resource resolver sets X secondary-resource AmountToSpend to 0 when isFree is true; if the X line is optional, it also sets Value to 0.
Possible fix	1) Separate “energy/stars are free” from “secondary resources are free”, so X secondary resources are not zeroed only because of Bullet Time; 2) or recognize cards with X secondary resources on the Bullet Time / SetToFreeThisTurn binding side and mirror the vanilla X-cost exception for that secondary X payment.
Needs more info	Runtime environment and observable logs/screenshots are missing, but the repro steps, version, and affected card are enough to start local validation.

Expand detailed analysis, evidence, and verification

Problem Description

Expected behavior

• After playing Bullet Time, playing a card with an X secondary resource should settle the current available resource amount, matching vanilla X energy/star behavior.
• The secondary resource should be consumed normally, and the card effect should use the actual X value.

Actual behavior

• The reporter observed that a card with an X secondary resource, after being made free by Bullet Time, does not consume the secondary resource and has no effect.

Reproduction steps

1. Play Bullet Time.
2. Play a card with an X-cost secondary resource, for example “蕾忍的哈利路小旋风”.

Environment and Version

• RitsuLib version: 0.4.45
• Module scope: Public API
• Severity: Minor

Logs, Attachments, and Original Excerpts

• Original: 有X费次要资源的卡牌，使用子弹时间免费后，不消耗次要资源，也没有效果
  • Key point: the free-play state appears to short-circuit X secondary-resource settlement; the user-visible result is no resource spend and no effect.
• The log block is empty; no screenshot or save file was provided.

Detailed Analysis Basis

• Vanilla Bullet Time calls SetToFreeThisTurn() only for cards whose vanilla energy cost is not X: official-source/src/Core/Models/Cards/BulletTime.cs:19, official-source/src/Core/Models/Cards/BulletTime.cs:21, official-source/src/Core/Models/Cards/BulletTime.cs:23. This shows vanilla intentionally preserves the special X-energy settlement path.
• SetToFreeThisTurn() sets energy and star costs to 0: official-source/src/Core/Models/CardModel.cs:1266. Vanilla ResourceInfo also distinguishes spent amounts from values, such as EnergySpent / EnergyValue and StarsSpent / StarValue: official-source/src/Core/Entities/Cards/ResourceInfo.cs:8, official-source/src/Core/Entities/Cards/ResourceInfo.cs:15, official-source/src/Core/Entities/Cards/ResourceInfo.cs:20, official-source/src/Core/Entities/Cards/ResourceInfo.cs:27.
• RitsuLib currently binds every CardModel.SetToFreeThisTurn call to a free-play marker: src/Cards/FreePlay/Patches/FreePlayBindingPatches.cs:16, src/Cards/FreePlay/Patches/FreePlayBindingPatches.cs:26. The secondary-resource CanPlay / SpendResources patches then pass FreePlayBindingRegistry.IsCardFreeForUpcomingPlay(__instance) into payment planning: src/Combat/SecondaryResources/Patches/SecondaryResourceCardPatches.cs:40, src/Combat/SecondaryResources/Patches/SecondaryResourceCardPatches.cs:71.
• In X secondary-resource resolution, isFree directly makes amountToSpendForX = 0: src/Combat/SecondaryResources/SecondaryResourceCosts.cs:1026, src/Combat/SecondaryResources/SecondaryResourceCosts.cs:1031, src/Combat/SecondaryResources/SecondaryResourceCosts.cs:1032. If the X line is not a required cost, effectiveXValue also becomes 0: src/Combat/SecondaryResources/SecondaryResourceCosts.cs:1041.
• The commit phase also skips actual spending for IsFree lines: src/Combat/SecondaryResources/SecondaryResourceCosts.cs:693; CommitFree explicitly states that the free ledger does not mutate resource amounts: src/Combat/SecondaryResources/SecondaryResourceCosts.cs:757.
• Therefore, this looks more like a semantic boundary bug: Bullet Time’s “energy/stars cost becomes zero” is being bridged into “all secondary-resource payments are free”, while an X secondary resource should behave closer to vanilla X energy/stars and remain an exception.

Feedback Hygiene Reminder

Dimension	Status
Reproduction steps	Provided: includes Bullet Time and a concrete example card.
Expected/actual	Provided: clearly states it should consume and take effect, but actually does neither.
Environment/version	Ambiguous: RitsuLib 0.4.45 is provided, but runtime environment is _No response_.
Logs/attachments	Missing: the log block is empty, with no screenshot, save, or debug output.
Title/background	Provided: the title points to the X secondary-resource + Bullet Time free-play interaction.

Detailed Verification Suggestions

• On 0.4.45, register a minimal test card with an X secondary-resource required cost, then log AmountToSpend, Value, and IsFree from SecondaryResourcePaymentResolver.Plan(card, isFree) before and after Bullet Time.
• Register the same resource as an X secondary-resource optional spend and confirm whether isFree == true produces Value == 0, matching the “no effect” path.
• Compare against a vanilla X-energy card: after Bullet Time, confirm it is not processed by SetToFreeThisTurn() and therefore keeps X settlement.
• After a fix, regress fixed secondary-resource costs, X secondary-resource costs, auto-play, and truly free-play effects to avoid breaking all free semantics.

Risks and Open Questions

• Whether “哈利路小旋风” models its X secondary resource as a required cost, optional spend, or extra spend needs confirmation from that mod card implementation or debug output; that affects the immediate reason for “no effect”.
• If all cards with X secondary resources simply stop receiving free markers, fixed secondary-resource costs on the same card or other intentionally-free scenarios may be affected.
• A robust fix may need a more precise model for the source/type of free payment rather than continuing to use a single bool isFree for every cost category.

---

工具侧记录

• BAKAOLC/STS2-RitsuLib#76 · 退出码 0 · 进程 347.71s
• gpt-5.5(high) · API 346500ms · 30 轮 · ↓95058 ↑8606 · 缓存读693248 写0 · $1.0371
• MCP available: management tools exposed to Claude.

[BAKAOLC]

修正了过宽的免费打出行为和结算错误