noname-shuying/mengsan/assets/cards/README.md

# 梦三卡牌立绘规范

2026-10-03：铁甲战士94张已全部接入：新增67、沿用27、暂缓0；另有衍生巨石。68张新增完整5:7水墨立绘使用 `mengsan_ic_*.png`。刘备专属牌组与空无色牌组已分目录和牌组类，详情见 [制作清单](../../../../../sts2-card-capture-20261003/generation/铁甲战士制作清单.md)、[全部立绘预览](../../../../../sts2-card-capture-20261003/generation/铁甲战士立绘预览.md) 及 [牌组结构](../../cards/packs/README.md)。尚未进行实机验收。

用户于 2026-10-02 指定以截图 `C:\Users\Diuse\Downloads\Ai\49.png` 中“防御”为同系列基准。

- 后续新增及转换的梦三卡牌使用约 5:7 的完整竖幅立绘；手牌常规尺寸 112×156，窄屏 82×114。禁止直接使用横向拆包图作为运行时卡面，也不要拉伸横图。
- 运行时 PNG 限制在 480×672 像素以内、单张不超过 300 KiB；5:7 立绘统一缩小到 480×672，现有小图不放大，其他旧比例等比例缩小。生成的大原图必须先优化再接入，不裁切、不拉伸；保留透明度、文件名和引用。使用 `node extension/术樱包/mengsan/tools/optimize-card-art.cjs --all` 批量处理，或将 `--all` 换成单张实际卡牌 PNG 的绝对路径；需要 sharp，可由 `MENGSAN_SHARP_MODULE` 指定模块位置。共享牌的 `record-art.py` 已在写入流程中调用优化器。
- 批量优化只处理 `mengsan_*.png` 运行时卡牌，参考原件如 `wound-original.png` 不参与。
- 画风：泛黄宣纸、黑褐水墨、飞白与淡赭色、中国古代人物或兵器；根据卡牌效果独立安排竖幅构图。拆包图只作题材参考，不修改拆包原件。
- 立绘不绘制名称、费用、花色、强化角标或边框。左上花色点数、左侧中段费用、右下名称由游戏原生节点和梦三样式叠加；左侧信息栏和右下名称需留空间。
- 卡牌定义使用 `fullimage: true` 与明确的 `image` 路径，不使用横图 `fullskin`。`mengsan_ic_`、`mengsan_colorless_`、`mengsan_event_`、`mengsan_status_`、`mengsan_curse_` 已按前缀接入 `ui/hand/style.css` 的本地完整卡面选择器；其他命名的新增卡牌须单独接入，长牌名同时加入长名称窄屏规则。保持 `cover`，不使用 `100% 100%` 拉伸。
- 费用和强化角标继续使用现有 `data-*` 与伪元素，避免向卡牌子节点写入额外文字而触发十周年 UI 扫描。
- 不改变卡牌费用、效果、强化、奖励与存档数据；不修改全局标准/军争牌或十周年 UI。
- 接入后检查完整立绘、花色/费用/名称、扇形叠牌、悬停放大和窄屏。文件检查、隔离行为测试及预览不代表实机验收。

现有本地卡面检查：愤怒、飞剑回旋镖、剑柄打击、全身撞击、熔融之拳及晕眩统一竖幅；防御与重杀原有竖幅保留。

## 卡牌描述（2026-10-02）

后续卡牌只描述当前费用与当前效果，不写是否可升级/强化、次数或上限，也不写升级前后对比或升级后变化。普通牌显示普通数值，已强化的牌直接显示其当前数值。此规范同步适用于悬停介绍、静态翻译、奖励摘要、牌库详情及磨砺选择说明；保留强化机制、操作按钮和紧凑 +X 角标。

闪电霹雳已按本规范接入竖幅水墨立绘。

双重打击：对应拆包 twin_strike.png 的双道斩击主题，使用同规格竖幅水墨立绘。1费，两次独立伤害；描述只显示当前牌数值。

铁斩波：对应拆包 iron_wave.png 的钢刃与防护波主题；竖幅水墨立绘。1费，先获得格挡再攻击，沿用护甲、脆弱、力量与易伤规则；描述只显示当前牌数值。

头槌：对应拆包 headbutt.png 的额头撞击主题；竖幅水墨立绘。1费，先攻击再选择一张个人弃牌置于个人抽牌堆顶部。移动原实体牌，保留ID、花色、强化与词缀，不新增永久牌。

突破：对应拆包 breakthrough.png 的突破包围与群体横扫主题；5:7竖幅宣纸水墨立绘。1费，先通过原生 loseHp 失去1点生命，再对所有存活敌方造成9点伤害。失去生命不抵扣格挡；等待正常濒死/救援结算，若角色死亡或战斗结束则停止攻击。描述只显示当前牌费用与效果。

预备打击：对应 setup_strike.png 的挥拳与蓄势主题；5:7竖幅宣纸水墨立绘。1费，先造成7点伤害，再在当前完整回合内获得2点临时力量。按网页主表而非未正式发布的更新历史实现；描述只显示当前效果。临时力量可叠加，独立于永久力量，当前完整回合结束/死亡/战斗退出时清理。

完美打击：对应 perfected_strike.png 的精准挥刀主题；全幅5:7竖幅宣纸水墨立绘。2费，基础6点伤害，本场战斗每张当前名称含“打击”的牌增加2点伤害。统计手牌、个人抽牌堆、个人弃牌堆、消耗牌及本人打出区的真实牌，去重并包含此牌自身；生成/复制/变形即时生效，不读取永久牌组、不统计公共或敌方牌。描述只显示当前牌费用与效果。

余烬：对应 cinder.png 的灼热弯刀与燃尽主题；5:7完整竖幅宣纸水墨立绘。2费，先造成18点伤害，再从当时自己的剩余手牌中随机消耗一张。遵循网页0.101.0后的手牌规则，不消耗抽牌堆顶部。通过原生失牌事件移入私有消耗区，不进入弃牌堆/洗牌，不更改永久牌组；没有手牌时仍造成伤害。描述只显示当前费用与效果。

放血：对应 bloodletting.png 的气血换取力量主题；完整5:7竖幅宣纸水墨立绘。0费，先通过原生 loseHp 失去3点生命，再获得2点当前费用，不增加费用上限。等待濒死救援；死亡、战斗结束或切换后不再获得费用。属于技能牌，缠身不额外增加攻击费用；描述只显示当前费用与效果。

坚毅：对应 true_grit.png 的顶住巨岩、防御与坚忍主题；完整5:7竖幅宣纸水墨立绘。1费，先获得7点格挡，再从当时自己的剩余手牌中随机消耗一张；当前选择模式通过原生选牌事件选择自己的手牌。移动原实体牌到私有消耗区，保留ID、花色、当前状态和词缀，不改永久牌组；无手牌时仍获得格挡。等待格挡事件，防止战斗结束、换场、死亡及陈旧选牌继续失牌；沿用脆弱的格挡衰减。描述只显示当前费用与效果。

破灭：对应 HAVOC/havoc.png 的宽刃旋斩与黑披风主题；完整5:7竖幅宣纸水墨立绘。普通1费，当前另一状态0费；免费使用自己的抽牌堆顶部实体牌，再仅消耗该原牌。费用豁免绑定原生选择/使用父链和实体身份，不改卡牌费用或词缀，愤怒生成的副本正常进入自己的弃牌堆，不跟随原牌消耗（对应Wiki0.104.0修复）。原生可用性和目标规则保持有效，无法使用的堆顶牌仍消耗；目标由原生使用流程选择。空抽牌堆不洗牌、不触发抽牌不足失败。保留当前数值、ID、花色、词缀和永久牌组，防止换场/死亡期间陈旧使用。描述只显示当前费用和效果。

耸肩无视：对应 SHRUG_IT_OFF/shrug_it_off.png 的耸肩摊手、厚重肩甲弹开攻击主题；完整5:7竖幅宣纸水墨立绘。1费，先通过原生 changeHujia 获得8点格挡，再通过原生 draw 抽1张牌；当前牌直接显示其实际格挡值。沿用脆弱对格挡的衰减与个人牌堆抽牌/洗牌/不足失败流程；等待格挡完全结算，战斗结束、死亡、换场或个人牌堆被替换后不再抽牌，不触碰公共和其他角色牌堆，不修改永久牌组；无消耗关键词。描述只显示当前费用与效果。

武装：对应 ARMAMENTS/armaments.png 的系紧金属护臂、加固防护主题；完整5:7竖幅宣纸水墨立绘。1费，先获得5点格挡，再选择强化一张当时的手牌；当前全体状态强化所有当时的手牌。仅对现有强化规则允许的牌生效，已满级、状态牌、永恒词缀、消耗牌及本次使用的实体牌不参与；没有符合条件的手牌仍获得格挡。等待原生格挡及选牌事件，战斗结束、换场、死亡、牌堆替换或选择期间失去该牌后不提交陈旧选择。复制真实牌元数据，保留ID、花色、点数、词缀并刷新费用与+X角标；不写永久牌组，退出战斗恢复临时强化。描述只显示当前费用和效果。运行时PNG缩小并量化，拆包原件保留。

战栗：对应 TREMBLE/tremble.png 的蜷缩颤抖、恐惧易伤主题；完整5:7竖幅黑褐宣纸水墨立绘，不使用横向裁切，不烘焙文字或边框。1费，对一名存活敌人施加3层易伤；当前强化状态施加4层。沿用人工制品抵消、攻击伤害增加50%向上取整与自身回合末减少1层规则；技能牌不造成直接伤害，不承受缠结的攻击牌额外费用。使用后原生消耗，仅退出本场战斗；未使用而弃置仍进入弃牌堆，永久牌组保留。战斗结束、自己或目标死亡及非敌方目标不施加。描述只显示当前费用及当前效果，无强化资格或未来变化说明。运行时PNG保持比例缩小至480×672并量化压缩，拆包参考原件不改动。

血墙：对应 BLOOD_WALL/blood_wall.png 的赤红屏障抵挡攻击主题；完整5:7竖幅黑褐宣纸水墨与暗朱红立绘，不裁切横图，不烘焙文字或边框。2费，先失去2点生命，再获得16点格挡；当前强化状态获得20点。等待原生loseHp及濒死救援结算；存活且仍在同一场战斗和同一会话中的使用者才继续获得格挡。战斗结束、死亡、换场、会话替换或角色离场后不继续。生命流失不是攻击伤害，不被护甲抵消，也不受力量、虚弱或易伤修正；格挡沿用原生changeHujia及脆弱规则，无护甲上限。技能牌不承受缠结攻击牌额外费用，无固有消耗，不改永久牌组。描述只显示当前费用和效果，不列强化资格或预告。运行时PNG保持比例缩小至480×672并量化压缩，拆包参考原件不改动。

欺凌：对应 BULLY/bully.png 的强者压制、乘虚进攻主题；完整5:7黑褐宣纸水墨竖幅，不裁切横图，不烘焙名称费用边框。0费，对一名存活敌人造成4点基础伤害，目标每有1层当前易伤额外增加2点；当前强化状态每层增加3点。每次结算读取实际目标的当前层数，仅发起一次原生攻击，不消耗易伤、不读取使用者或其他目标层数，不使用回合剩余数量代替层数。基础数值进入既有力量、临时力量、易伤50%及其他攻击修正链，易伤增幅不由牌效果重复乘算。非法负数、非整数、非有限层数或伤害溢出拒绝发起伤害。战斗结束、角色死亡、自身或友方目标不结算；不限制距离，次数不限，无固有消耗。作为攻击牌，缠结时按既有规则增加1费用并显示当前费用，响应仍免费。当前描述不列强化资格或未来效果。运行时PNG保持比例缩小至480×672并量化压缩，拆包参考原件不改动。

旋风斩：WHIRLWIND/whirlwind.png 的环形刀风连击主题，完整5:7宣纸水墨竖幅，无烘焙文字费用边框。X费，对全部敌人造成5点伤害X次，当前强化状态为8点。原生useCard支付时消耗剩余费用并固定X，一条用牌只支付、提取一次，次数不随后续加费变化；0费可使用但没有伤害。缠结先扣1附加费用再以剩余费用作X；不足附加费用不可用。破灭授权免费使用时固定现有费用作X但不扣费；响应不收费。次数仅绑定最近原生用牌、使用者、原战斗和原会话，嵌套其他牌不得借用X。逐轮重新取存活敌人，死亡或离场目标跳过，新生成敌人从下一轮参与；死亡、结束、换场、会话替换或使用者离场停止。每次等待原生伤害并沿用力量、临时力量、易伤等，不合并伤害。图鉴新增X费筛选，手牌用空文本data叠层显示X。永久牌数据不写次数，不固有消耗。描述仅当前效果，运行时480×672量化压缩，拆包原件保留。
怨恨：SPITE/spite.png 的金甲头盔、含毒巨刃与负伤反击主题；完整5:7宣纸水墨竖幅，无烘焙名称费用边框。0费，对一名存活敌人造成5点伤害；本回合失去过生命时攻击2次，当前强化状态攻击3次，每次仍为5点。读取引擎当前完整回合的changeHp历史，仅实际changedHp<0且属于本场根事件、本人时触发，护甲完全抵消或回复不触发，流失生命后再回复仍有效，不读取伤害请求量或永久状态。使用开始时固定次数，攻击期间新失血影响下一次用牌；逐次等待原生伤害并沿用力量、临时力量、易伤等修正。原战斗/会话/根事件及角色成员和存活敌对关系每次复核，死亡、结束、换场、离场后停止。无固有消耗，不写永久牌组；攻击牌沿用缠结增加1费用，响应免费。当前描述不列强化资格或预告。运行时480×672量化压缩，拆包参考原件保留。
暴走：RAMPAGE/rampage.png 的碧甲狂兽、猩红螺旋眼与逐击增强主题；完整5:7黑褐宣纸水墨竖幅，无烘焙费用名称边框。按网页正式主表1费/9伤害/每次本场加5，当前强化状态每次加9；不采用带未正式发布标记的10伤害更新。先发起一次原生攻击，结算后仅增加原实体牌的下一次基础伤害，普通连续9/14/19；力量、临时力量、易伤等沿原生链修正，不把最终伤害当作累积量。累积以实体对象绑定战斗/会话，独立暴走及同ID的另一个实体不共享，弃牌、回收、重抽和本场强化保留；永久牌组和实体牌元数据不写累积。战斗牌堆快照只携带当前会话的纯数字展示数据，详情显示当前实际伤害；退出会话清除，延迟旧清理不覆盖新会话。绑定最近原生useCard及唯一同名原牌，一次用牌只结算一次，陈旧场次/会话/根事件、非敌方目标、死亡或原牌离开本人的牌堆后不继续。伤害前检查安全整数溢出，无固有消耗；沿用缠结增加1费用，响应免费。当前描述不列强化资格或未来变化。运行时480×672量化压缩，拆包参考原件保留。