bettergi-scripts-list/repo/js/ActivitySwitchNotice/README.md

32 KiB
Raw Permalink Blame History

活动期限/周本通知器

本次识别结果 JSON

正常运行脚本即可在脚本根目录生成 recognition-result.json(完整路径:C:\Users\oldwang\Downloads\BetterGI\User\JsScript\ActivitySwitchNotice\recognition-result.json),固定文件名、每次运行覆盖,不追加历史。manifest.saved_files 已声明此文件跨脚本更新保留,下次运行仍会覆盖。

  • 顶层字段:schemaVersion、runId、startedAt、updatedAt、finishedAt、status、stage、error、sections。时间为 UTC ISO 字符串;runId 使用本次开始时间。
  • status 为 running / completed / failed。completed 仅表示原业务流程正常结束,不表示所有数据识别成功或通知送达;读取时应核对本次时间及各项状态。
  • 每个 sections 项有 status、data、reason;状态包括 pending(待执行)、running、observed(已观测)、unknown、skipped、failed、not_run(流程提前退出)。null 表示未知,不能作为零使用。
项目 data 字段
mapMission requested 选择的关键词、matches 匹配文本列表(ok、text);空列表不证明没有任务
holyRelics text、count 当前数量、total 容量、remaining 剩余空间、threshold 提醒阈值
dailyCommission daily 委托奖励和 physical 原粹树脂消耗;各含 use、total,无效非有限数值写为 null
longTermTrainingPoints pointNumber 点数、expireTime 从 OCR 提取的过期数字、expireTimeText 过期原文;缺测为 null,过期数字沿用原识别逻辑,不是时间戳
campaignArea text、count 本周消耗减半剩余次数、total;非提醒日为 skipped
activity uid、names 扫描到的名称、details 详情数组(name、可选 common、text、hours、desc)、complete: null(完整性未确认);受原有筛选及分页逻辑限制

写入时机:初始化/游戏操作前先清空旧数据并写入 running;阶段开始、取得识别数据(通知前)及跳过时覆盖;流程结束写入 completed,异常写入 failed 和错误原因。未执行项保留 null,不混入上次数据;已经保存的本次数据可在后续通知失败时保留。活动在扫描结束、通知前保存汇总,扫描中途失败时该项没有完整结果。

写文件使用 await file.writeText(path, JSON字符串, false) 并检查返回值。首次写入失败会立即终止;后续写入失败会中止流程并尝试保存失败状态。如磁盘不可写、宿主强制停止或进程退出,可能无法落盘/收尾,文件可能仍是旧文件、running 或不完整 JSON;请结合运行日志、时间和 runId 判断,不能仅凭文件存在认定本次成功。此接口不提供原子写入保证。

项目概述

这是一个用于《原神》游戏的自动化脚本工具,主要功能是自动检测游戏内活动的剩余时间,并在活动即将结束时/每周指定日期自动提醒征讨领域减半剩余次数发送通知提醒玩家。


功能特性

  • ✅ 自动返回游戏主界面并打开活动页面
  • ✅ OCR识别活动列表和剩余时间
  • ✅ 自动滚动浏览所有活动页面
  • ✅ 智能解析剩余时间(支持"22天14小时"等格式)
  • ✅ 可配置的通知阈值(默认8760小时内结束的活动)
  • ✅ 支持指定特定活动进行监控
  • ✅ 支持活动黑名单过滤功能(0.0.5版本,新增支持为黑名单活动设置特定条件,只有满足条件时才过滤,注:特定条件为空默认没有条件)
  • ✅ 防重复检测机制
  • ✅ 异常处理和错误恢复
  • ✅ 自动提醒征讨领域减半剩余次数(0.1.1版本起支持多选提醒日)
  • ✅ 每日委托奖励 / 原粹树脂 / 长期训练点提醒(0.0.7/0.1.9版本)
  • ✅ 地图识别任务提醒(0.0.8版本)
  • ✅ 圣遗物剩余空间检测提醒(0.1.5版本)
  • ✅ 新活动通知-存储活动名称列表进行历史对比(0.1.0版本)
  • ✅ 支持独立通知功能(0.0.4版本新增 因BGI不支持WebSocket,需搭配bettergi-scripts-tools+开启JS HTTP 权限使用)前往bettergi-scripts-tools部署

核心思维导图

整体架构流程图

graph TD
    A[主程序入口 main.js] --> B[初始化 init]
    B --> C[加载工具模块]
    C --> D[tool.js, ws.js, notice.js, campaignArea.js, activity.js, mapMission.js, HolyRelics.js]
    D --> E[读取 manifest.json]
    E --> F[检查是否返回主界面]
    F --> G[toMainUi]
    G --> H[执行主功能 main]
    H --> I[地图识别任务检查]
    I --> J[圣遗物剩余空间检查]
    J --> K[每日委托检查]
    K --> L[征讨领域检查]
    L --> M[活动页面扫描]
    M --> N[返回主界面]
    N --> O[程序结束]

活动扫描核心流程

graph TD
    A[activityMain函数] --> B[初始化配置]
    B --> C[打开活动页面 F5]
    C --> D[滚动到页面顶部]
    D --> E[开始逐页扫描]
    E --> F[OCR识别活动列表]
    F --> G{是否有活动?}
    G -->|否| H[结束扫描]
    G -->|是| I[遍历当前页活动]
    I --> J[白名单过滤]
    J --> K{是否在白名单?}
    K -->|是| L[继续处理]
    K -->|否| M[根据关系模式判断]
    M --> N{relationship=true?}
    N -->|是| O[跳过]
    N -->|否| L[继续处理]
    L --> P[黑名单过滤]
    P --> Q{是否在黑名单?}
    Q -->|是| R[条件检测]
    Q -->|否| S[点击活动]
    R --> T{条件满足?}
    T -->|是| U[跳过]
    T -->|否| S[点击活动]
    S --> V[OCR识别剩余时间]
    V --> W[解析时间转小时]
    W --> X[应用阈值过滤]
    X --> Y[存储活动信息]
    Y --> Z[向下滚动一页]
    Z --> E
    H --> AA[过滤符合条件活动]
    AA --> BB[按剩余时间排序]
    BB --> CC[发送通知]
    CC --> DD[流程结束]

征讨领域提醒流程

graph TD
    A[campaignAreaMain函数] --> B[获取当前星期]
    B --> C{是否为提醒日?}
    C -->|否| D[结束函数]
    C -->|是| E[打开冒险之书 F1]
    E --> F[点击秘境坐标]
    F --> G[点击征讨领域坐标]
    G --> H[OCR识别周次数]
    H --> I{剩余次数>0?}
    I -->|否| J[结束函数]
    I -->|是| K[发送通知]
    K --> L[流程结束]

通知发送机制

graph TD
    A[sendNotice函数] --> B[检查通知类型配置]
    B --> C[获取通知模式]
    C --> D{BGI通知?}
    D -->|是| E[notification.send]
    C --> F{独立通知?}
    F -->|是| G[wsUtil.sendText]
    C --> H{两者都发送?}
    H -->|是| E
    H -->|是| G
    E --> I[发送完成]
    G --> I
    I --> J[流程结束]

配置解析流程

graph TD
    A[配置初始化] --> B[parseWhiteActivity]
    A --> C[parseBlackActivity]
    B --> D[白名单列表解析]
    C --> E[黑名单条件解析]
    D --> F[建立whiteActivityNameList]
    E --> G[建立blackActivityMap]
    F --> H[设置relationship逻辑]
    G --> H
    H --> I[配置完成]

核心组件依赖关系

graph LR
    subgraph "工具模块"
        A[activity.js - 活动处理]
        B[notice.js - 通知发送]
        C[campaignArea.js - 征讨领域/每日委托]
        D[ws.js - WebSocket通信]
        E[tool.js - 通用工具/Record/主界面]
        F[mapMission.js - 地图任务识别]
        G[HolyRelics.js - 圣遗物空间检查]
    end
    
    subgraph "主控模块"
        H[main.js - 主入口]
        I[settings.json - 配置]
    end
    
    H --> A
    H --> B
    H --> C
    H --> F
    H --> G
    A --> B
    A --> E
    C --> B
    C --> E
    F --> B
    F --> E
    G --> B
    G --> E
    I -.-> A
    I -.-> B
    I -.-> C
    I -.-> D
    I -.-> F
    I -.-> G

逻辑流程

sequenceDiagram
    autonumber
    participant Config as 配置初始化
    participant Parser as 解析器
    participant ActivityMgr as 活动管理
    participant OCRSvc as OCR 服务
    participant Filter as 过滤决策
    participant Notification as 通知服务

    Config->>Parser: 读取 settings.whiteActivityNameList
    Parser->>Parser: parseWhiteActivity(text)
    Parser-->>Config: 返回 whiteActivityNameList
    
    Config->>Parser: 读取 settings.blackActivity
    Parser->>Parser: parseBlackActivity(text, excludeList)
    Parser-->>Config: 返回 blackActivityMap

    Note over ActivityMgr: 遍历所有候选活动
    loop 每个候选活动
        Note over ActivityMgr: 检查白名单匹配
        alt 白名单不为空
            ActivityMgr->>ActivityMgr: 检查活动名是否包含白名单关键词
            alt 包含关键词
                ActivityMgr-->>ActivityMgr: 标记为白名单活动
            else 不包含关键词
                alt relationship为false(或关系)
                    ActivityMgr-->>ActivityMgr: 继续处理
                else relationship为true(与关系)
                    ActivityMgr-->>ActivityMgr: 跳过该活动
                end
            end
        end
        
        Note over ActivityMgr: 检查黑名单匹配    
        alt 黑名单不为空
            ActivityMgr->>Filter: 是否匹配黑名单?
            Filter->>Parser: getMapByKey(blackActivityMap, 活动名, reverseMatch=true)
            Parser-->>Filter: 返回条件列表
            Filter->>OCRSvc: 用 OCR 校验条件(如剩余时间、文本等)
            OCRSvc-->>Filter: 返回条件满足情况
            alt 任一条件满足
                Filter-->>ActivityMgr: 跳过该活动
            else 所有条件均不满足
                Filter-->>ActivityMgr: 保留该活动
            end
        else 匹配但无条件
            Filter-->>ActivityMgr: 直接跳过该活动
        else 未匹配黑名单
            Filter-->>ActivityMgr: 保留该活动
        end
    end

    Note over ActivityMgr: 活动筛选完成后
    ActivityMgr->>ActivityMgr: 根据whiteActivityNameList和relationship进行二次筛选
    alt relationship为true(与关系)
        ActivityMgr->>ActivityMgr: 同时满足剩余时间阈值和白名单条件
    else relationship为false(或关系)
        ActivityMgr->>ActivityMgr: 满足剩余时间阈值或白名单任一条件
    end
    ActivityMgr->>ActivityMgr: 检查剩余时间阈值
    ActivityMgr->>Notification: 发送符合条件的活动通知
    Notification-->> ActivityMgr: 通知发送完成

用户使用指南

快速开始

1. 安装与配置

  • 确保游戏分辨率为 1920×1080(推荐分辨率)
  • 将脚本导入到 BetterGI 脚本管理器中
  • 在脚本设置界面进行个性化配置

2. 基础设置

在 settings.json 中可以配置以下参数:

设置项 说明 默认值
debug 启用开发者模式(框选识别区域辅助调试) false
toMainUi 执行前是否自动返回游戏主界面 true
noticeType 通知模式(BGI通知/独立通知/独立通知和BGI通知) BGI通知
newActivityNotice 启用新活动通知(存储活动名称列表-历史对比) true
mapMissionKeys 地图识别任务提醒(多选) 伴月纪闻任务,探索派遣奖励,每日委托奖励
relationship 剩余时间与白名单启用和关系(默认或关系) false
whiteActivityNameList 白名单活动名称(用|分隔) 空(监控所有活动)
blackActivity 黑名单活动名称(用|分隔)- 支持条件语法:活动名-条件1,条件2 空(无黑名单活动)
notifyHoursThreshold 通知剩余时间阈值(小时) 8760(365天)
activityKey 打开活动页面的快捷键 F5
campaignAreaReminderDays 周本提醒日(多选) 周六,周日
campaignAreaKey 打开冒险之证的快捷键 F1
openBagKey 打开背包的快捷键 B
checkHolyRelic 启用圣遗物空间提醒 false
holyRelicsDiffCountThreshold 圣遗物剩余空间阈值 400
wsNoticeType 独立通知配置方式(自定义通知/bgi-tools通知) 自定义通知
http_api_access_ws_proxy bgi-tools获取授权wsproxy api地址 http://127.0.0.1:8081/bgi/ws-proxy/access
bgi_tools_token bgi_tools授权token 语法:tokenName=tokenValue Authorization=
ws_proxy_url WebSocket代理URL(独立通知配置) http://127.0.0.1:8081/bgi/ws-proxy/message/send
ws_url WebSocket客户端 URL(独立通知配置) ws://127.0.0.1:8080/
ws_token WebSocket客户端 token(独立通知配置) 空
action 发送类型(私聊/群聊)(独立通知配置) 私聊
send_id 发送ID(群号或QQ号,对应发送类型)(独立通知配置) 空
at_list @某人列表使用,隔开(QQ号)(独立通知配置) 空

注:toTopCount、scrollPageCount 已不再在设置界面开放(代码内部使用默认值 10 / 4)。


使用流程

自动模式(推荐)

  1. 启动脚本后,程序会自动:
    • 检测当前是否在游戏主界面
    • 如未在主界面,自动返回主界面
    • 按设定的快捷键打开活动页面
    • 开始扫描所有活动

手动模式

  1. 关闭 toMainUi 选项
  2. 确保游戏处于主界面状态
  3. 启动脚本开始扫描

功能详解

活动筛选

  • 全部活动监控:whiteActivityNameList 保持空值,监控所有有剩余时间的活动
  • 指定活动监控:填写活动关键词,如 海灯节\|盛典,只监控包含这些关键词的活动
  • 黑名单过滤:blackActivity 可以设置不想接收提醒的活动名称,多个活动用|分隔
  • 条件黑名单过滤:支持条件语法 活动名-条件1,条件2,只有当活动满足指定条件时才过滤
使用示例
普通黑名单: "活动A|活动B"
条件黑名单: "活动A-已完成|活动B-条件1,条件2"
混合使用: "活动A|活动C-已完成,已领取"

时间通知机制

  • 默认监控所有活动(notifyHoursThreshold=8760小时)
  • 可设置阈值,如设置为24,则只通知剩余时间≤24小时的活动
  • 即将结束(24小时内)的活动会在通知中标记 <即将结束>

逻辑关系配置

  • relationship 为 false(默认):满足"剩余时间阈值"或"白名单活动"任一条件即发送通知
  • relationship 为 true:必须同时满足"剩余时间阈值"和"白名单活动"两个条件才发送通知

智能防重复

  • 自动识别已扫描过的活动页面
  • 防止因页面滚动不准确造成的重复识别
  • 自动判断是否已滚动到页面底部

独立通知配置(0.0.4版本新增,0.1.2版本支持bgi-tools授权)

配置项说明

  • noticeType:

    • BGI通知: 使用 BetterGI 内置通知
    • 独立通知: 通过 WebSocket 发送通知
    • 独立通知和BGI通知: 同时使用两种方式
  • wsNoticeType(独立通知配置方式,0.1.2版本新增):

    • 自定义通知: 手动填写下方 WebSocket 相关参数
    • bgi-tools通知: 从 bettergi-scripts-tools 拉取授权 wsproxy 信息(需配置 http_api_access_ws_proxy 与 bgi_tools_token)
  • bgi-tools 授权配置(0.1.2版本新增):

    • http_api_access_ws_proxy: 获取授权 wsproxy 的 api 地址,默认为 http://127.0.0.1:8081/bgi/ws-proxy/access
    • bgi_tools_token: 授权 token,语法 tokenName=tokenValue(如 Authorization=xxx)
  • WebSocket 配置(自定义通知):

    • ws_proxy_url: WebSocket 代理 URL,默认为 http://127.0.0.1:8081/bgi/ws-proxy/message/send
    • ws_url: WebSocket 客户端 URL,默认为 ws://127.0.0.1:8080/
    • ws_token: WebSocket 客户端认证令牌(可选)
  • 发送配置:

    • action: 发送类型,可选 私聊 或 群聊
    • send_id: 根据 action 类型填写群号或 QQ 号
    • at_list: @ 某人列表,使用逗号分隔多个 QQ 号

使用要求

  1. 开启权限: 需要开启 JS HTTP 权限才能使用独立通知功能
  2. 配置服务: 需要搭建相应的 WebSocket 服务和代理服务器(或部署 bettergi-scripts-tools)
  3. 网络连接: 确保能够连接到配置的 WebSocket 服务器

配置示例

自定义通知:

{
  "noticeType": "独立通知",
  "wsNoticeType": "自定义通知",
  "ws_proxy_url": "http://127.0.0.1:8081/bgi/ws-proxy/message/send",
  "ws_url": "ws://127.0.0.1:8080/",
  "action": "群聊",
  "send_id": "123456789",
  "at_list": "987654321,111222333"
}

bgi-tools通知:

{
  "noticeType": "独立通知",
  "wsNoticeType": "bgi-tools通知",
  "http_api_access_ws_proxy": "http://127.0.0.1:8081/bgi/ws-proxy/access",
  "bgi_tools_token": "Authorization=xxx",
  "action": "群聊",
  "send_id": "123456789"
}

部署 bettergi-scripts-tools

1.windows exe 直接运行

前往 release 下载 带windows的zip包解压运行.exe文件即可

2.java

前往 release 下载 jar包

java -jar xxxx.jar

3.部署docker

docker pull ghcr.io/kirito520asuna/bettergi-scripts-tools:latest
docker run -d -p 8081:8081 -v /path/to/application-prod.yml:/app/application-prod.yml --name bettergi-scripts-tools ghcr.io/kirito520asuna/bettergi-scripts-tools:latest

注意事项

使用环境要求

  • ✅ 游戏分辨率为 1920×1080(最佳兼容性)
  • ✅ 游戏处于前台运行状态
  • ✅ 活动页面可通过设置的快捷键正常打开

运行期间注意事项

  • 🚫 运行期间请勿手动操作鼠标
  • 🚫 避免切换窗口或最小化游戏
  • ⚠️ 如遇异常可重新启动脚本

高级配置

自定义快捷键

如活动页面不是F5打开,可在 activityKey 中修改为对应按键。
如冒险之书页面不是F1打开,可在 campaignAreaKey 中修改为对应按键。

时间阈值设置

根据个人需求设置 notifyHoursThreshold:

  • 24:只关注24小时内结束的活动
  • 168:关注一周内结束的活动
  • 720:关注一个月内结束的活动

独立通知配置

如果需要使用独立通知功能(如发送到QQ群聊),需要:

  1. 开启JS HTTP权限
  2. 配置WebSocket相关参数
  3. 设置发送类型和ID

输出示例

通知消息格式如下:

原神活动剩余时间提醒:
> 海灯节庆典 剩余时间:3天14小时<还剩 86 小时>
> 风花节活动 剩余时间:1天5小时<还剩 29 小时><即将结束>

文件结构

ActivitySwitchNotice/
├── utils/
│   ├── activity.js     # 核心活动处理逻辑
│   ├── campaignArea.js # 征讨领域/每日委托提醒功能
│   ├── mapMission.js   # 地图识别任务提醒功能
│   ├── HolyRelics.js   # 圣遗物剩余空间检查功能
│   ├── notice.js       # 通知发送功能
│   ├── ws.js           # WebSocket通知功能
│   └── tool.js         # 通用工具(OCR/找图/Record/主界面判断等)
├── assets/             # 模板图片资源
│   ├── paimon_menu.png # 主界面判断模板
│   └── holyRelics.jpg  # 圣遗物背包入口模板
├── config/             # 运行时生成的记录文件(activity/campaignArea/dailyCommission)
├── main.js             # 主入口文件
├── manifest.json       # 插件配置文件
├── settings.json       # 用户设置界面定义
└── README.md           # 说明文档

核心模块

activity.js - 活动处理核心

主要包含以下功能函数:

  • scrollPage() - 页面滚动基础函数
  • scrollPagesByActivity() - 按页滚动活动列表
  • scrollPagesByActivityToTop() - 滚动到活动列表顶部
  • parseRemainingTimeToHours() - 解析剩余时间文本为小时数
  • OcrKey() - OCR识别剩余时间
  • activityMain() - 主流程控制函数

campaignArea.js - 征讨领域/每日委托模块

  • ocrWeeklyCount() - OCR识别征讨领域周次数
  • ocrDailyCommission() - OCR识别每日委托与体力
  • ocrLongTermTrainingPoints() - OCR识别长期训练点
  • campaignAreaMain() - 征讨领域提醒主函数
  • dailyCommissionMain() - 每日委托提醒主函数

mapMission.js - 地图识别任务模块

  • ocrMapMission() - OCR识别地图任务列表
  • mapMission() - 地图任务提醒主函数

HolyRelics.js - 圣遗物空间模块

  • checkHolyRelicsKey() - 检查圣遗物剩余空间并提醒

notice.js - 通知模块

  • sendNotice() - 发送活动提醒通知,按剩余时间排序
  • sendText() - 发送普通通知

ws.js - WebSocket通知模块

  • send() - 发送WebSocket消息
  • sendText() - 发送文本消息
  • pullAccessWsProxyConfig() - 从 bgi-tools 拉取授权 wsproxy 配置

tool.js - 通用工具模块

  • findText() / findTextAndClick() - 通用OCR找文本/找文本并点击
  • findImg() / findImgAndClick() - 通用找图/找图并点击
  • getDayOfWeek() - 获取当前星期信息(按游戏4点刷新校准)
  • isInMainUI() / toMainUi() - 主界面判断与返回
  • openBag() - 打开背包并处理过期物品
  • Record - 记录文件统一读写类

配置选项

在 settings.json 中可配置以下参数:

配置项 类型 说明
debug checkbox 启用开发者模式(框选识别区域辅助调试)
toMainUi checkbox 是否先返回主界面再执行
noticeType select 通知模式(BGI通知/独立通知/独立通知和BGI通知)
newActivityNotice checkbox 启用新活动通知(存储活动名称列表-历史对比)
mapMissionKeys multi-checkbox 地图识别任务提醒(多选)
relationship checkbox 剩余时间与白名单启用和关系(默认或关系)
whiteActivityNameList String 白名单活动名称(用|分隔)
blackActivity String 黑名单活动名称(用|分隔)- 支持条件语法:活动名-条件1,条件2
notifyHoursThreshold String 通知剩余时间阈值(小时)
activityKey String 打开活动页面的快捷键
campaignAreaReminderDays multi-checkbox 周本提醒日(多选,默认周六/周日)
campaignAreaKey String 打开冒险之证的快捷键
openBagKey String 打开背包的快捷键
checkHolyRelic checkbox 启用圣遗物空间提醒
holyRelicsDiffCountThreshold String 圣遗物剩余空间阈值
wsNoticeType select 独立通知配置方式(自定义通知/bgi-tools通知)
http_api_access_ws_proxy String bgi-tools获取授权wsproxy api地址
bgi_tools_token String bgi_tools授权token 语法:tokenName=tokenValue
ws_proxy_url String WebSocket代理URL(独立通知配置)
ws_url String WebSocket客户端 URL(独立通知配置)
ws_token String WebSocket客户端 token(独立通知配置)
action select 发送类型(私聊/群聊)(独立通知配置)
send_id String 发送ID(群号或QQ号,对应发送类型) (独立通知配置)
at_list String @某人列表使用,隔开(QQ号) (独立通知配置)

注:toTopCount、scrollPageCount 已不再在设置界面开放(代码内部使用默认值 10 / 4)。


工作原理

  1. 自动返回游戏主界面
  2. 执行地图识别任务提醒(按配置的多选任务项)
  3. 执行圣遗物剩余空间检查提醒(如启用)
  4. 执行每日委托奖励 / 体力 / 长期训练点提醒
  5. 检查是否为设置的提醒日(默认周六/周日),如果是则执行征讨领域减半次数提醒
  6. 按配置快捷键打开活动页面
  7. 滚动到活动列表顶部
  8. 逐页扫描所有活动
  9. OCR识别每个活动的剩余时间
  10. 解析时间为小时数并过滤(包括白名单/黑名单过滤)
  11. 发送符合条件的活动提醒
  12. 对比历史记录,发送新增活动提醒

注意事项

  • 请确保游戏分辨率为1920×1080以获得最佳效果
  • 脚本运行期间请勿操作鼠标
  • 某些特殊活动可能无法正确识别剩余时间
  • 建议在游戏空闲时运行此脚本

版本历史

0.2.0 (2026-09-27)

  • bugfix: 修复 征讨领域 的 OCR 识别问题

0.1.9 (2026-08-16)

  • 新增 长期训练点识别功能(每日委托提醒中追加长期训练点与过期时间提醒)
  • 优化 地图任务 OCR 识别功能
  • 重构 OCR 任务识别逻辑,提高识别准确性
  • 优化 活动页面滚动扫描逻辑
  • 修复 任务切换通知中的页面稳定等待问题
  • 优化 活动页面滚动和鼠标操作策略
  • 更新 最低 BGI 版本依赖 0.61.0 → 0.63.0

0.1.8 (2026-07-08)

  • 重构 活动配置文件读写逻辑(新增 Record 类统一数据读写)
  • 新增 配置文件管理和重复通知检测功能(秘境征讨/每日委托避免重复发送相同内容)
  • 新增 日期格式化功能(YYYY-MM-DD)
  • 优化 秘境征讨和每日委托的通知逻辑

0.1.7 (2026-06-05)

  • 修复bug

0.1.6 (2026-05-30)

  • uid api改本体

0.1.5 (2026-04-24)

  • 新增圣遗物剩余空间检测提醒

0.1.4 (2026-04-23)

  • 单例模式 配置唯一实例

0.1.3 (2026-03-28)

  • 修复异常配置导致无法运行

0.1.2 (2026-03-23)

  • 新增云端配置功能
  • 改变wsproxy授权方式(授权token或bettergi-scripts-tools<版本需求0.0.7>授权拉取)

0.1.1 (2026-03-16)

  • 周本提醒日 升为多选
  • 适配新秘境征讨UI

0.1.0 (2026-02-01)

  • 新增 新活动通知(存储活动名称列表-历史对比)

0.0.8 (2026-01-22)

  • 新增 地图识别任务提醒 如:

    0.0.8-00 0.0.8

0.0.7 (2026-01-19)

  • 新增每日委托提醒

0.0.6 (2026-01-06)

  • 功能优化:新增识别uid通知提醒 实例: 0.0.6

0.0.5 (2026-01-04)

  • 性能优化:优化滚动到顶部算法,减少页面滚动次数,提升初始化效率
  • 功能增强:新增条件黑名单过滤机制,支持基于活动状态的动态过滤策略
  • 代码重构:新增 parseBlackActivity 函数,实现黑名单配置的结构化解析
  • 架构改进:重构黑名单匹配逻辑,引入条件匹配引擎,支持多条件复合判断
  • 数据结构优化:引入 blackActivityMap 配置项,使用 Map 数据结构提升查找性能
  • 逻辑优化:增强活动过滤算法,集成条件匹配验证机制
  • 初始化流程:重构配置加载流程,新增 init 函数统一处理配置项初始化
  • 文档完善:更新配置项文档,补充条件黑名单语法说明

0.0.4 (2026-01-01)

  • 新增 独立通知配置功能,支持通过 WebSocket 发送通知
  • 新增 ws.js 模块,实现 WebSocket 通知功能
  • 新增 noticeType 配置选项,用于选择通知模式
  • 新增 ws_proxy_url、ws_url、ws_token 配置选项
  • 新增 action、send_id、at_list 配置选项用于发送设置

0.0.3 (2025-12-29)

  • 修复 修复了活动过滤逻辑问题,将activityNameList更改为whiteActivityNameList以保持一致
  • 新增 黑名单与白名单的互斥过滤机制,黑名单中剔除白名单
  • 新增 在配置中增加了relationship参数,用于控制剩余时间与白名单活动的逻辑关系
  • 新增 支持剩余时间和白名单的"与"关系和"或"关系配置
  • 新增 标记界面显示 已完成 的活动

0.0.2 (2025-12-22)

  • 新增 征讨领域周次数提醒功能
  • 新增 campaignArea.js 模块,包含征讨领域相关功能
  • 新增 campaignAreaKey 配置选项,用于自定义冒险之书页面快捷键
  • 新增 campaignAreaReminderDay 配置选项,用于配置提醒日
  • 改进 增强滚动到顶部功能的稳定性
  • 新增 活动黑名单过滤功能,支持通过 blackActivityNameList 配置项排除不关心的活动
  • 新增 特殊活动时间格式支持,针对"砺行修远"等活动提供周数显示
  • 新增 额外OCR识别支持,可识别特定活动的附加信息(如"本周进度")
  • 改进 活动过滤逻辑,增强黑名单匹配准确性
  • 改进 通知显示格式,增加活动描述信息展示
  • 修复 若干已知问题,提升脚本稳定性

0.0.1 (2025-12-21)

  • 新增 活动期限检测与通知功能
  • 新增 OCR识别活动列表和剩余时间
  • 新增 自动滚动浏览所有活动页面
  • 新增 智能解析剩余时间(支持"22天14小时"等格式)
  • 新增 可配置的通知阈值功能
  • 新增 指定特定活动监控功能
  • 新增 防重复检测机制
  • 新增 异常处理和错误恢复机制

其它

作者:云端客
脚本反馈邮箱:[email protected]