如果这个插件对你有帮助，请点亮⭐支持一下！
✅ 账号管理 - 扫码登录/网页授权/国际服登录/多账号切换/删除，主账号快速切换
✅ 消息撤回 - 登录链接与二维码超时、完成或被拒时自动撤回，保护账号安全
✅ 数据查询 - 便签、理智、干员面板、危机合约、抽卡记录/分析、全服统计、成就、日历
✅ 建设进度 - 帝江号建设、地区建设（含调度券显示）
✅ 自动签到 - 每日自动执行森空岛签到
✅ 公告推送 - 官方公告列表/最新公告/订阅推送
✅ 订阅提醒 - 理智满值、调度券满值时自动推送；支持取消订阅
✅ 卡池分析 - 抽卡数据统计与可视化，支持限定、联合、常驻、新手与武器寻访分析
在AstrBot插件管理器中搜索 astrbot_plugin_endfield 安装，或通过Git克隆：
cd AstrBot/data/plugins
git clone https://github.com/Entropy-Increase-Team/astrbot_plugin_endfield.git确保已安装Playwright浏览器内核：
playwright install chromium| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
api_key |
string | 无 | |
auth_client_name |
string | 终末地机器人 |
网页授权登录时的显示名称 |
operator_list_bg |
string | random |
干员列表背景图 (random/bg1.png/bg2.png) |
render_timeout |
number | 30000 |
图片渲染超时时间（毫秒） |
astrbot_plugin_endfield/
├── main.py # 插件入口，指令路由
├── metadata.yaml # 插件元数据
├── _conf_schema.json # WebUI配置schema
├── core/ # 核心逻辑
│ ├── client.py # API异步客户端
│ ├── user.py # 用户数据中心
│ └── render.py # HTML渲染助手
├── data/ # 持久化存储
│ └── users.json # 用户绑定数据
└── resources/ # 资源文件
├── cache/ # 图片缓存
├── img/ # 静态图片资源
├── operator/ # 干员列表模板
├── crisis-contract/ # 危机合约模板
├── gacha/ # 抽卡分析模板
├── stamina/ # 理智模板
└── help/ # 帮助菜单模板
💡 指令前缀：默认为
/，在AstrBot配置中自定义
| 指令 | 说明 |
|---|---|
授权登陆 |
网页安全授权登录（推荐） |
扫码绑定 |
扫描二维码快捷登录 |
手机绑定 [手机号] |
验证码登录（暂不可用） |
国际服登录 |
邮箱+密码登录国际服 |
绑定列表 |
查看所有绑定账号 |
切换绑定 [序号] |
切换当前主账号 |
删除绑定 [序号] |
解绑指定账号 |
| 指令 | 说明 |
|---|---|
便签 |
账号数据总览 |
理智 |
理智查询 |
干员列表 |
持有干员图鉴 |
同步面板 |
同步干员详细战斗属性 |
<干员名>面板 |
单干员详情（技能/武器/基质） |
抽卡记录 |
近期抽卡历史 |
抽卡分析 |
全卡池统计分析 |
抽卡分析同步 |
先同步抽卡数据再分析 |
全服统计 |
全服抽卡统计与排行 |
签到 |
执行每日签到 |
日历 |
活动版本日历 |
帝江号建设 / 帝江号 |
帝江号基建进度 |
地区建设 / 建设 |
地区开发进度与调度券 |
成就列表 / 成就 |
成就达成情况 |
危机合约 / 危机 |
查询当前危机合约分数、任务和挑战记录 |
合约 [名称或ID] |
指定危机合约名称或 ID 查询 |
危机 指标 / 危机 词条 |
查看完整危机指标/词条列表 |
| 指令 | 说明 |
|---|---|
公告 |
官方公告列表 |
公告最新 |
获取最新一条公告全文 |
订阅公告 |
订阅公告推送 |
取消订阅公告 |
取消公告订阅 |
订阅理智 |
理智满值时推送 |
取消订阅理智 |
取消理智订阅 |
订阅调度券 |
调度券满值时推送 |
取消订阅调度券 |
取消调度券订阅 |
💡 发送
zmd可查看插件完整帮助菜单（图片版）。
点击展开预览图
便签 |
理智 |
|---|---|
 |
 |
干员列表 |
抽卡分析 |
|---|---|
 |
 |
帝江号建设 |
地区建设 |
|---|---|
 |
 |
公告 |
日历 |
|---|---|
 |
 |
xx面板 |
zmd |
|---|---|
 |
 |
全服统计 |
|---|
 |
危机合约 |
危机 指标 |
|---|---|
 |
 |
你可以通过替换资源文件来自定义渲染图片样式：
路径： AstrBot/data/plugins/astrbot_plugin_endfield/resources/
| 功能 | 自定义方式 |
|---|---|
| 理智图背景 | 替换 img/stbg.png |
| 干员列表背景 | 替换 operator/img/opbg.png |
- 基础查询 (帝江号建设/地区建设/订阅理智/日历)
- 公告系统 (列表获取与推送)
- 抽卡辅助 (全服统计/模拟抽卡)
- 管理员功能 (全员签到/数据同步)
- MaaEnd远程控制 (状态监控与远程操作)
点击展开版本历史
- 🧹 失效绑定：Framework Token 失效或会话过期时自动删除对应绑定，并尽力同步清理服务端记录
- 🔇 后台日志：同一失效 Token 只处理一次，避免理智推送持续刷出重复错误
- 🗜️ 资源体积：压缩预览图与背景图，插件包体积降至 AstrBot 16MB 限制以内
- 🧹 发布清理：移除缓存文件，保留 HarmonyOS 字体文件不变
- 🎨 危机合约渲染：移除参考 App UI 的返回、问号、重载控件，改为插件报告顶部信息条
- 🧭 指令引导：图片与帮助菜单补充
/危机 指标、/合约 [名称或ID]使用提示
- ✨ 危机合约：新增
危机合约/危机/合约 [名称或ID]查询 - 📊 危机指标：新增
危机 指标/危机 词条完整指标视图 - 🎨 渲染模板：新增红黑风格危机合约图片，展示最高评分、任务、奖章、挑战记录与队伍头像
- 🔌 API 适配：接入最新
/api/endfield/card/crisis-contract，自动从card/detail读取contractId
- ✨ 抽卡分析：新增联合寻访（如“辉光庆典”）记录拉取与展示，合并至 UP 寻访统计
- 🔧 抽卡分析：UP 判定支持多 UP 角色列表，修复联合/庆典池只识别单 UP 的问题
- 🎨 抽卡分析：统计文案调整为“UP寻访”，覆盖限定与联合寻访
- 🐛 抽卡分析渲染：修复无六星情况下的抽卡分析报错问题，以及未开启据点情况下的据点渲染报错问题
- 🐛 公告渲染：修复长图公告（如《塔卫二畅游指南》系列）渲染截断和被挤压变形的问题
- 🔧 干员面板：
/api/endfield/card/char与云崽一致，随请求传入roleId/serverId（与便签同一角色上下文） - 🔧 图片渲染：
render_timeout配置对page.goto等全流程生效，不再写死 15s - 🔧 抽卡分析：分页拉取全量记录，避免统计不完整
- 🔧 签到 / 自动签到：请求携带
role_id、server_id；自动签到通知与订阅 ID 规范化、日志完善 - 🔧 面板同步列表：干员名为空时用
template_id兜底显示 - 🎨 干员面板：暴击率等展示与「计算异常 / 未同步」提示区分优化
- 🎨 干员面板：武器区展示基质属性（gemSkills），基质名称/星级/图标
- 🎨 抽卡分析：三列布局，统计区增加平均出红与 6/5/4 星总量
- 🔧 便签页：角色稀有度与徽章显示
- 🔧 帝江号建设：接口适配
- 📐 干员面板排版修复
- ✨ 新增成就显示
- ✨ 地区建设新增调度券显示
- ✨ 新增调度券满值订阅
- ✨ 移除 Wiki 和 攻略 模块，后续再添加
- 🚀 优化版本日历：伸展时间轴并提升渲染宽度（3000px），解决拥挤
- 🔧 修复日历页尾 Logo显示不全的问题
- 🚀 国际服支持
- ✨ 新增全服统计
- 🛡️ 登录成功/超时/被拒后自动撤回二维码或链接
- 🚀 优化协议端调用
- 📊 优化 API 日志
- ✨ 干员面板修复
- 🚀 理智推送逻辑重构
- 🎨 菜单与 UI 修复: 解决了帮助菜单图片渲染可能失败的问题
- 🔧 全模块局部 import 顶层化，修复 getaddrinfo 同步阻塞问题
- 🔧 森空岛自动签到修复，具体查看配置项
- ✨ 添加并重构干员面板 (
xxx面板)：全新左右布局，支持展示武器被动、精炼、装备套装属性及详情 - 🎨 帮助菜单图片版重绘 (
zmd) - 🚀 修复了 IDE 格式化可能导致的模板语法破碎问题
- 🔧 修复公告订阅逻辑，简化配置项
- ✨ 新增
/日历指令，自动获取Wiki横幅 - 🎨 优化日历UI和绑定列表显示
- 🔧 完善自动签到与订阅理智功能
- ✨ 新增
/帝江号建设、/地区建设指令 - 🎨 重构信赖与心情展示UI
- ✨ 新增公告列表渲染 (
/公告) - ✨ 新增单条公告详情 (
/公告 <序号>) - 🚀 优化图片动态填充逻辑
- 📊 重构抽卡分析，移除5星标记
- ⚡ 提升渲染稳定性，超时延长至30s
- ⚡ 抽卡分析异步化优化
- 🎨 便签面板UI重绘
- 🐛 修复干员列表显示问题
- 🖼️ 帮助菜单改为图片输出
- 🐛 修复理智查询问题
- ✨ 新增干员列表功能
- 云崽：endfield-plugin
- Astrbot：astrbot_plugin_endfield
- Nonebot2：nonebot-plugin-endfield
特别感谢：
- @QingYingX & @浅巷墨黎
- 终末地协议终端 提供的底层API封装
- 所有贡献者和测试者
✅ 检查是否已执行 playwright install chromium。如果在 AstrBot 环境下缺失依赖，请在 WebUI 的日志页面右上角 使用内置的 pip安装 功能安装 playwright，并确保无头浏览器已正确安装。
✅ 这种报错通常由插件重复加载或 AstrBot 框架版本未对齐引起。尝试完全重启 AstrBot 框架（而非仅重载插件）通常即可解决。
✅ 可能原因：
网络干扰：环境开启了全局代理导致 Token 校验失败，请尝试关闭代理重试。
配置文件冲突：若上述无效，请尝试删除插件 data/users.json 中对应的绑定记录，或去协议终端删除绑定后重新扫码。
✅ 这种情况通常是 API 握手失效或缓存过期。请尝试删除该账号绑定，并重新执行 /授权登陆 或 /扫码绑定。
✅ 检查 resources/cache/ 目录的读写权限，尝试手动删除缓存目录下的临时文件后重试。
💡网络环境： 绑定或查询失败时，请优先确认 Bot 部署环境的网络连通性。