Skip to main content
Glama
sharrkkunjang-baka

warframe-calculator-mcp

README.md
# Warframe Calculator MCP(中文)

TypeScript ESM、stdio MCP 伤害计算与离散事件模拟器。数据规则版本 `wf-evidence-2026-07-12.2`。

## 验证
`npm run check`、`npm test`、`npm run build`。

## 通用构筑输入
```json
{"build":{"weaponId":"bo-prime-incarnon","mode":"heavy","mods":["sacrificial-steel",{"id":"galvanized-steel","stacks":4}],"conditions":{"combo":{"current":220},"active":{"galvanized-steel":true},"faction":"Grineer"},"customEffects":[{"type":"stat","stat":"critChance","operation":"final-add","value":0.2}]}}
```
`mods` 接受字符串或 `{id,rank?,stacks?,enabled?}`;`conditions` 接受 stacks、active、结构化 `combo: {mode: "full"|"initial-only"|"explicit", current?, initial?, auraBonus?}`、setPieces、targetStatusCount、faction。近战未写 combo 默认 `full`(220/12x);旧 `current` 自动映射 `explicit`,旧 `initial` 自动映射 `initial-only`。`initial-only` 只汇总武器 `baseInitialCombo`、Mod `initialCombo` effect 与 `auraBonus`,不模拟攻击攒连击或重击后的演化。解析结果返回 `resolvedComboCount`、`comboMultiplier`、`comboMode`、`initialComboBreakdown`。武器可定义 normal/heavy 等多个 mode;重击可定义倍率、强制异常、连击倍率及消耗。optimizer 使用 `slot` 替换现有槽位,不会追加。

## 工具
通用工具:`warframe_resolve_build`、`warframe_calculate_panel`、`warframe_calculate_expected_hit`、`warframe_compare_builds`、`warframe_compare_melee_builds`、`warframe_optimize_slot`、模拟与规则查询工具。旧 `warframe_calculate_xoris_detonation`、Xoris variants/Influence 以及 Torid fixture 保持兼容。

阿利乌双枪 Prime 专用 AOE 工具:`warframe_calculate_akarius_prime_aoe` 与 `warframe_compare_akarius_prime_aoe` 固化直接爆炸面板、热能传递平行元素、逐伤害类型阵营抗性、磁吸巨力、致命洪流、三类暴击 Mod、满层耀炎/无情及次要·失活长期 AFCC。`warframe_simulate_akarius_prime_aoe` 与 `warframe_compare_akarius_prime_aoe_dynamic` 进一步执行 Monte Carlo 离散事件模拟,覆盖二连发、8 发弹匣、装填、逐投射物暴击/异常、病毒/腐蚀过期、Heat 共享伤害池与刷新、异常持续缩放的剥甲时序、Corpus 敌方护盾门,以及可切换的次要·失活命中登记策略。

## 边界
当前通用核心覆盖 stat 四阶段、槽位元素组合、来源 bonus、强制 proc、套装、模式、显式层数/条件、多级暴击期望及基础 combo。动态触发时序、状态伤害词条快照、完整 stance、紫卡容量/极性、镀层击杀层持续衰减、Influence 通用传播仍未泛化;专用 Xoris Influence 模型继续作为独立 golden fixture。通用模拟器当前也不能替代阿利乌专用工具处理同发多重的 AOE 护盾门、次要·失活命中登记与热能传递平行元素。阿利乌专用动态模拟器的剩余不确定项不是缺失实现,而是游戏本身对同一发投射物/延迟爆炸的失活登记存在 grace-period 波动、且并非所有 AOE 都采用同一种敌方护盾门溢出行为;接口要求显式选择策略并可做敏感性比较。