🛰️ Warframe 助手
插件名称： astrbot_plugin_warframe_helper
当前版本： v0.3.2
面向 Warframe 国服与国际服的信息查询和交易助手。
插件可以查询当前世界状态、裂缝、奸商、仲裁、突击、平原循环、装备资料、掉落地点、遗物奖池及 Warframe Market 交易信息，并支持条件订阅提醒。
🚀 快速开始
| 想查什么 | 命令 |
|---|---|
| 当前警报 | @bot 警报 |
| 当前裂缝 | @bot 裂缝 |
| 钢铁裂缝 | @bot 钢铁裂缝 |
| 虚空商人 | @bot 奸商 |
| 当前仲裁 | @bot 仲裁 |
| 每日突击 | @bot 突击 |
| 夜灵平原状态 | @bot 夜灵平原 |
| 查询武器 | @bot 武器 武器名 |
| 查询掉落 | @bot 掉落 物品名 |
| 查询遗物 | @bot 遗物 遗物名 |
🌍 世界状态
| 命令 | 说明 |
|---|---|
@bot 警报 | 查看当前警报 |
@bot 裂缝 | 查看全部裂缝 |
@bot 普通裂缝 | 只查看普通裂缝 |
@bot 钢铁裂缝 | 查看钢铁之路裂缝 |
@bot 九重天裂缝 | 查看九重天裂缝 |
@bot 奸商 | 查看虚空商人状态 |
@bot 仲裁 | 查看当前仲裁任务 |
@bot 突击 | 查看每日突击 |
@bot 电波 | 查看午夜电波任务 |
@bot 入侵 | 查看当前入侵 |
@bot 集团 | 查看集团任务 |
@bot 平原 | 查看平原循环概览 |
@bot 夜灵平原 | 查看夜灵平原昼夜 |
@bot 魔胎之境 | 查看魔胎之境循环 |
@bot 地球昼夜 | 查看地球昼夜循环 |
@bot 双衍王境 | 查看双衍王境状态 |
@bot 双衍王镜 | 双衍王境 的别名 |
@bot 轮回奖励 | 查看轮回奖励 |
@bot 执行官猎杀 | 查看执行官猎杀 |
@bot 钢铁奖励 | 查看钢铁之路奖励 |
🖥️ 指定游戏平台
世界状态类命令支持附加平台参数：
pc
ps4
xb1
swi
cn
示例：
@bot 裂缝 cn
@bot 突击 国服
不填写平台时使用管理员配置的默认平台。
国服接口失败时，插件可能自动切换其他国服数据来源；所有国服来源都失败后，可能回退到国际服 PC 数据，避免命令完全报错。
🔔 条件订阅
创建订阅
@bot 订阅 条件 [次数或永久]
示例：
@bot 订阅 钢月
仓库 README 将“钢月”解释为：
钢铁 + 月球 + 全能 + 生存
订阅夜灵平原黑夜，并在触发 3 次后结束：
@bot 订阅 夜灵平原 黑夜 3
管理订阅
| 命令 | 说明 |
|---|---|
@bot 订阅列表 | 查看当前订阅 |
@bot 退订 条件 | 删除指定订阅 |
@bot 退订 全部 | 清空全部订阅 |
订阅是否能主动推送，取决于管理员是否启用了定时检查和当前平台是否支持主动消息。
🔫 武器、战甲和 MOD
| 命令 | 说明 |
|---|---|
@bot 武器 名称 | 查询武器资料 |
@bot 战甲 名称 | 查询战甲资料 |
@bot MOD 名称 | 查询 MOD 资料 |
这些静态资料来自 Warframe PublicExport。名称无法识别时，可以尝试使用更完整的中文名或英文名。
🎁 掉落与遗物
查询掉落
@bot 掉落 物品名
可在物品名后添加返回数量，上限为 30：
@bot 掉落 物品名 20
插件会尝试把中文物品名解析为英文，但底层掉落数据中的许多条目仍以英文名记录。
查询遗物
@bot 遗物 纪元 遗物名
也可以只写遗物名：
@bot 遗物 遗物名
💰 Warframe Market 查询
| 命令组 | 作用 |
|---|---|
@bot wfmap 关键词 | 将简称或别名映射到 Warframe Market 词条 |
@bot wm ... | 查询物品买卖订单 |
@bot wmr ... | 查询紫卡（Riven）拍卖 |
@bot wfp ... | 查询价格相关信息 |
仓库 README 只列出了这三组市场命令的用途，没有给出所有子参数的完整格式。具体参数请以 bot 的实际提示或本站管理员提供的帮助为准，避免在说明书中猜测不存在的语法。
⚠️ 使用注意
- 世界状态和交易信息来自多个第三方接口，可能因接口维护而延迟或失败。
- 国服数据异常时，插件可能回退到其他来源，最终结果不一定来自同一个接口。
- 查询结果依赖外部数据源，不能保证与游戏内实时状态完全同步。
- Warframe Market 订单和价格会持续变化。
- 掉落数据中的物品名可能主要使用英文。
- 图片结果依赖 Playwright 浏览器渲染；生成失败需要管理员检查运行环境。
- QQ 官方机器人上的 Markdown 图片和翻页按钮需要管理员提前配置消息模板。
❓ 常见问题
Q：为什么查询国服却显示了国际服数据？
国服接口可能全部失败，插件最后回退到国际服 PC 世界状态，避免命令直接失败。
Q：为什么中文物品名查不到掉落？
可以尝试完整中文名、英文名或使用 @bot wfmap 关键词 查找对应词条。
Q：为什么订阅没有提醒？
可能是条件没有命中、次数已用完、主动推送未启用，或当前平台不支持主动消息。
Q：为什么市场命令参数写法不在这里？
原仓库 README 只公开了 wm、wmr 和 wfp 的功能分类，没有完整列出所有子参数，本页不擅自补写。
📎 项目信息
- 显示名称：Warframe 助手
- 当前版本：v0.3.2
- 作者：moemoli
- 开源协议：AGPL-3.0
- 项目地址：https://github.com/moemoli/astrbot_plugin_warframe_helper
