用途
Warhammer Oracle 是一个 MCP（Model Context Protocol）服务器，把《战锤 40K》和《杀戮小队》的规则、单位数据与游戏流程接入 AI 助手。你可以向 AI 助手询问数据表、战略、分队、强化、关键词、阶段序列、致伤计算等内容。
它覆盖以下游戏模式：
- Warhammer 40,000（
40k/40k_11e，默认）——完整规模战斗，第 11 版规则； - Warhammer 40,000 第 10 版（
40k_10e）——完整规模战斗，第 10 版规则（永久支持）； - Combat Patrol（
combat_patrol）——较小、适合新手的格式； - Kill Team（
kill_team）——小队级遭遇战游戏。
40K 单位、分队和强化查询默认使用第 11 版。向任何工具传入 game_mode: "40k_10e" 即可查询第 10 版数据。第 10 版支持不会因新版本加入而消失，每个已添加的 game_mode 值都会持续可用。回合序列/阶段、核心关键词和核心战略均手工整理自第 11 版核心规则。分队专属战略按阵营手工整理，采用与桌面规则相同的分层方式：第 11 版阵营包中完整详述的分队会覆盖基础圣典，未修订的圣典基线在其他地方适用。
主要能力（工具）
单位数据表查询
按名称查找单位数据表，返回属性档案、单位规模（模型数）、远程与近战武器、能力与关键词。当名称存在不同数据表时，工具会列出匹配的阵营；若名称与阵营仍有多个数据表，会列出其 ID，可回传阵营与一个 datasheet_id 进行选择。
参数：unit_name（必填）、faction（可选）、datasheet_id（可选，用于同阵营变体的精确 ID）、game_mode（可选：40k / 40k_11e（默认）、40k_10e、combat_patrol、kill_team）。
关键词或规则查询
返回官方定义、通俗解释、示例以及适用的游戏模式。
参数：keyword（必填）、game_mode（可选）。
阶段查询
按名称查询游戏阶段，返回分步说明与提示。
参数：phase_name（必填）、game_mode（可选，默认 40k）。
单位搜索
按名称、阵营、关键词或能力文本搜索单位。返回紧凑列表（最多 10 条），包含阵营、分值与关键词。
参数：query（必填）、faction（可选）、ability（可选）、max_points（可选）、game_mode（可选：40k / 40k_11e（默认）、40k_10e、combat_patrol、kill_team）。
单位对比
并排对比 2-4 个单位，在单个响应中显示每个单位的完整数据表。
参数：units（必填，2-4 个单位名称的数组）、game_mode（可选：40k / 40k_11e（默认）、40k_10e、combat_patrol、kill_team）。
回合序列
显示某游戏模式的完整回合序列，或高亮当前所处回合位置及下一步。
参数：current_phase（可选）、game_mode（可选，默认 40k）。
战略查询（lookup_stratagem）
按名称查询战锤 40,000 战略，返回 CP 消耗、阶段时机、目标与效果。
参数：name（必填）、faction（可选）、phase（可选）、detachment（可选）。
战略搜索（search_stratagems）
按名称、阵营、阶段或分队搜索战略，返回紧凑列表（最多 10 条）。
参数：query（必填）、faction（可选）、phase（可选）、detachment（可选）。
分队查询（lookup_detachment）
按名称查询分队，返回分队能力、可用强化与相关战略。
参数：name（必填）、faction（可选）、game_mode（可选：40k / 40k_11e（默认）、40k_10e）。
强化查询（lookup_enhancement）
按名称查询角色强化，返回分值消耗、所属分队与效果。
参数：name（必填）、faction（可选）、detachment（可选）、game_mode（可选：40k / 40k_11e（默认）、40k_10e）。
杀戮小队计谋查询
按名称查询 Kill Team 计谋，返回类型（战略/战术）、CP 消耗、时机与效果。
参数：name（必填）、faction（可选）、type（可选：strategic、tactical）。
致伤计算器（wound_calculator）
计算攻击档案对目标的预期伤害输出，处理重掷、武器关键词（致命命中、毁灭之伤、持续命中、洪流）、无敌豁免和 Pain 无效。
参数：attacks、hit_skill、strength、toughness、armour_save、damage（均必填）；armour_penetration、invulnerable_save、feel_no_pain、reroll_hits、reroll_wounds、weapon_keywords、wounds_per_model、game_mode（均可选）。
主任务判定（determine_primary_mission）
根据双方玩家的 Force Dispositions（第 11 版匹配赛）判定各自的主任务。每位玩家的任务从其对手的 Force Dispositions 中查找——在非镜像对局中，两名玩家会得到不同任务。仅返回任务名称，不返回完整计分/目标文本。
参数：your_disposition、opponent_disposition（均必填，取值之一：Take and Hold、Purge the Foe、Reconnaissance、Priority Assets、Disruption）。
远征查询
查询远征（叙事游玩）内容，返回远征规则、遗物、战斗特质与升级。
参数：query（必填）、faction（可选）。
使用方式
所有数据在构建时嵌入，运行时无需网络请求。数据通过 GitHub Actions 每日从 BSData 同步。
安装方式：可全局安装，或在 claude_desktop_config.json 中添加配置。具体安装命令和配置内容在提供的资料中未完整给出。
刷新单位数据（从 BSData）：资料中未给出具体命令。
适用场景
适合在桌面游玩《战锤 40K》或《杀戮小队》时，借助 AI 助手快速查阅规则、单位数据、战略、分队与致伤概率，覆盖第 10/11 版、Combat Patrol 与 Kill Team。
限制
- 所有数据为构建时嵌入，需通过同步流程更新，资料未说明更新频率之外的具体细节。
- 规则与军队规则的知识产权归 Games Workshop 所有，本工具仅供个人游戏时参考使用。
- 主任务判定仅返回任务名称，不返回完整计分/目标文本。
- 安装与数据刷新命令在资料中未完整提供。
