万智牌卡牌中文翻译工具

解决卡牌翻译的查名痛点

玩万智牌时，玩家经常需要查阅特定卡牌的官方中文名称。大多数卡牌数据库默认使用英文，而官方中文译名往往分散在不同的社区网站中。手动检索这些译名不仅效率低下，打断游戏或制表流程，而且在处理复杂卡牌名时极易出现拼写错误。

核心机制与工作流

该技能通过调用专门的卡牌 API 来自动化翻译查询过程。

• 触发方式：可以使用 /mtg-translate 命令进行单卡查询，或者通过自然语言直接触发，例如说“翻译 [卡牌名]”或“[卡牌名] 中文叫什么”。
• 批量处理：针对牌表或大量收藏，支持使用 /mtg-translate-batch 命令直接处理 Excel 文件中的完整卡牌列表。
• 数据获取：核心脚本位于 utils/mtg_translator.py。它会优先向 Scryfall API 发起请求以获取简体中文版本。若未找到匹配项或缺少本地化条目，则会自动降级并尝试备用数据源 大学院废墟 API (sbwsz.com)。
• 结果返回：匹配成功后，技能会返回结构化数据，包含本地化的卡牌名称以及其他相关的卡牌详细信息。

适用场景与注意点

• API 依赖性：该技能完全依赖外部 API 的可用性和数据准确性。网络波动、速率限制或源数据库结构的意外变更都可能导致查询失败。
• 语种支持：目前支持 zhs（简体中文）和 zht（繁体中文）两种语言，暂不支持其他语种。
• 文件要求：批量翻译严格依赖于格式正确的 Excel 文件。在处理大型数据集前，强烈建议检查表头并确保英文卡牌名的拼写准确无误。