From f01750b0346ac1756296c1c95ac187aa8537c520 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E4=BA=91=E7=AB=AF=E5=AE=A2?= <107686912+Kirito520Asuna@users.noreply.github.com> Date: Sun, 21 Dec 2025 16:22:52 +0800 Subject: [PATCH] =?UTF-8?q?=E6=B4=BB=E5=8A=A8=E6=9C=9F=E9=99=90=E9=80=9A?= =?UTF-8?q?=E7=9F=A5=E5=99=A8=20(#2535)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * feat(js): 初始化活动期限通知器插件 - 创建主执行文件 main.js - 添加插件配置文件 manifest.json - 编写基础设置界面 settings.json - 建立项目说明文档 README.md - 实现异步主函数结构 - 配置插件元数据和依赖项 - 定义用户可配置选项 - 设置默认启用状态和快捷键 - 添加作者信息和联系方式 - 描述核心功能和使用注意事项 * feat(activity): 添加活动切换通知功能 - 新增活动配置读取逻辑，支持指定活动名称列表和活动键 - 实现活动主函数，根据配置决定通知所有或指定活动 - 添加通知工具模块，支持异步发送包含标题和内容的通知 - 在主文件中引入活动和通知工具模块，完善执行流程 * feat(activity): 新增OCR点击活动功能 - 实现OcrClickActivity函数，支持OCR识别并点击活动 - 添加活动名称匹配与切换计数逻辑 - 记录活动坐标及剩余时间信息 - 更新activityMain函数以配合新活动切换流程 - 优化活动页面打开与关闭的键盘操作逻辑 * feat(activity): 增加活动OCR识别与剩余时间获取功能 - 新增ocrRegionConfig配置对象，定义活动及剩余时间识别区域 - 修改OcrClickActivity函数，支持默认OCR区域配置和活动识别逻辑优化 - 增加activityOk状态标识，用于判断是否完成所有活动识别 - 实现OcrRemainingTime函数，用于识别并返回指定活动的剩余时间 - 重构activityMain主流程，支持循环识别多个活动及其剩余时间 - 集成通知模块，发送活动名称和对应剩余时间的通知消息 - 引入外部脚本执行机制，通过eval动态加载notice.js配置文件 * chore(activity): 添加待办注释以优化活动切换逻辑 - 在活动切换循环前添加 '//todo:拉到顶部' 注释 - 为后续优化活动切换时的滚动行为做准备 * feat(activity): 增加活动切换尝试次数限制 - 添加 index 和 maxIndex 变量控制循环次数 - 设置最大尝试次数为10次 - 超出最大尝试次数时记录警告日志并退出循环 - 避免无限循环导致脚本卡死 * chore(activity): 添加待办注释和空行优化代码结构 - 在循环开始前添加了两个新的待办注释 - 在条件判断后添加了滑动一页的待办注释 - 为代码逻辑段落间增加了空行以提高可读性 * chore(activity): 更新活动切换注释 - 将注释中的“滑动一页”修改为“向下滑动一页”以提高可读性 * feat(activity): 实现活动自动化处理主函数 - 添加活动主函数 activityMain 用于自动化处理活动流程 - 集成打开活动页面、OCR识别与点击功能 - 引入活动Map记录已识别活动避免重复处理 - 实现循环处理机制并支持指定活动列表过滤 - 增加页面滑动到底判断逻辑防止无限循环 - 添加最大尝试次数限制及对应日志警告 - 完善注释说明提升代码可读性与维护性 * fix(ActivitySwitchNotice): 调整OCR识别区域坐标配置 - 更新活动识别区域坐标为(197, 220, 292, 701) - 更新剩余时间识别区域坐标为(497, 202, 1417, 670) - 优化识别精度以提高切换检测准确性 * refactor(activity): 重构活动切换通知逻辑 - 移除冗余的notice.js文件引用 - 引入activity.js工具文件 - 更新主函数调用activityUtil.activityMain方法 - 确保异步执行上下文正确处理 * feat(activity): 添加页面滚动功能 - 新增 scrollPage 异步函数用于控制页面滚动 - 支持设置滚动方向、距离和速度参数 - 实现鼠标按键控制和步进式滚动逻辑 - 添加详细的函数文档注释 - 集成延时控制和步长配置选项 * feat(activity): 添加活动切换通知功能 - 新增xyConfig配置对象定义top和bottom坐标 - 在activity.js中引入notice.js脚本 - 优化代码格式调整maxIndex变量声明空格 - 修复条件判断语句中的语法错误 - 完善活动切换逻辑注释说明 * feat(activity): 新增活动页面滚动功能 - 添加genshinJson配置对象定义画布尺寸 - 实现scrollPagesByActivity函数支持页面滚动 - 支持向上或向下滚动操作 - 集成坐标移动与页面滚动逻辑 - 设置默认滚动参数适配画布高度 - 保留原有OCR点击活动功能 * refactor(activity): 优化活动点击处理函数参数和映射逻辑 * refactor(activity): 优化活动切换通知的滚动逻辑 - 移除eval执行外部脚本的方式，提高安全性 - 更新scrollPagesByActivity函数实现更稳定的滚动操作 - 增加循环次数与调整滚动参数以提升准确性 - 导出新增的工具方法和配置对象供其他模块使用 * feat(activity): 优化活动切换与滚动逻辑 - 修改鼠标移动注释，明确移动到指定坐标位置 - 为OcrClickActivity函数新增defaultActivityCount参数，支持传入初始活动计数 - 在活动识别主循环中提前声明switchToActivityCount变量，便于复用 - 调整OcrClickActivity调用方式，传递已有的switchToActivityCount值 * feat(activity): 新增滑动到顶功能并优化滑动逻辑 - 新增 scrollPagesByActivityToTop 方法实现自动滚动至顶部 - 增加 toTopCount 和 scrollPageCount 配置项用于控制滑动行为 - 修改 scrollPagesByActivity 方法支持可配置的滑动次数 - 调整 OCR 活动点击函数参数格式以提高可读性 * feat(activity): 实现活动页面滚动功能 - 添加滚动到顶部功能，调用scrollPagesByActivityToTop方法 - 实现向下滑动一页功能，调用scrollPagesByActivity方法 - 移除待办注释，完成页面滚动逻辑 - 整合滚动功能到主循环中，优化用户体验 * feat(ActivitySwitchNotice): 增加返回主界面逻辑并优化设置提示 - 新增 isInMainUI 函数用于判断当前是否处于主界面 - 实现 toMainUi 异步函数确保脚本运行前回到主界面 - 更新设置项标签，明确活动名称可选填且默认推送所有有剩余时间的活动 - 调整代码结构以支持新增功能模块 - 修复部分语法问题以提高代码健壮性 * 图 * feat(ActivitySwitchNotice): 添加控制是否先返回主界面的设置选项 - 修改设置项名称从 enable 为 toMainUi - 根据设置值控制是否执行返回主界面逻辑 - 更新设置标签描述信息 - 默认启用该功能以保持向后兼容性 * chore(activity): 调整活动工具函数导出并优化主入口执行逻辑 - 注释掉 activityUtil 中的 OcrRemainingTime 导出项 - 在 main.js 中添加异步立即执行函数以支持 toMainUi 切换逻辑 - 为主入口逻辑增加 settings.toMainUi 条件判断 * feat(ActivitySwitchNotice): 添加默认按键设置选项 - 在设置中为活动页面按键添加默认值"F5" - 更新配置以支持自定义按键绑定 - 优化用户体验，减少手动输入需求 * feat(ActivitySwitchNotice): 添加活动配置并触发按键事件 - 在 activityUtil 中暴露 config 配置对象 - 在主流程中添加按键事件调用逻辑 - 使用 activityKey 配置触发键盘操作 * fix(ActivitySwitchNotice): 优化活动切换逻辑并移除冗余配置 - 将活动快捷键模拟从 keyDown/keyUp 改为 keyPress - 移除多余的按键释放操作 - 注释掉未使用的 config 导出 - 移除主函数中重复的按键触发逻辑 * refactor(activity): 替换等待函数提升代码可读性 - 将 wait() 函数调用替换为 sleep(ms) - 统一使用 sleep 函数处理异步等待逻辑 - 提高代码一致性和维护性 * fix(activity): 修复回到顶部逻辑判断条件 - 修改循环跳出条件判断逻辑，避免无限循环 - 确保超过最大尝试次数时能正确抛出错误 - 提高页面滚动到顶部功能的稳定性 * fix(activity): 更新OCR识别区域配置 - 将OCR识别区域从ocrRegion变量更改为config.activity配置 - 确保OCR识别使用正确的活动区域参数 - 保持原有的注释和逻辑结构不变 * feat(activity): 支持自定义OCR识别区域配置 - 修改scrollPagesByActivityTop函数签名，新增ocrRegion参数支持传入自定义OCR区域配置 - 默认使用ocrRegionConfig.activity作为OCR识别区域配置 - 更新OCR对象创建逻辑，使用传入的ocrRegion参数替代原有的config.activity配置 - 保持原有功能不变，增强函数灵活性和可配置性 * fix(activity): 调整活动识别区域坐标和尺寸 - 修改activity识别区域的x、y坐标及宽高参数 - 更新width从292到226，height从701到616 - 调整x坐标从197到267，y坐标从220到197 * fix(activity): 修复活动地图更新逻辑 - 修正 activityMap 初始化赋值错误 - 更新活动地图遍历方式，使用 keys() 方法 - 修复活动地图新增逻辑，避免重复设置相同键值 - 确保只添加新发现的活动到 activityMap 中 * fix(ActivitySwitchNotice): 修复通知文本中键值对顺序错误 - 调整forEach回调函数参数顺序，确保键值对正确显示 - 保持代码逻辑一致性，避免数据展示混乱 * feat(activity): 增加活动切换次数记录功能 - 在OcrClickActivity函数中新增lastName参数用于记录上一个活动名称 - 新增resObject对象统一管理活动切换状态和坐标信息 - 优化活动识别逻辑，避免重复识别相同活动 - 更新函数调用方式以传递LastActivityName参数 - 修复活动切换计数可能不准确的问题 - 完善活动地图更新机制，确保数据一致性 * feat(activity): 添加鼠标移动操作以优化活动切换逻辑 - 在回到顶部逻辑前添加鼠标移动至坐标(0,20)的操作 - 在OCR点击活动逻辑前添加鼠标移动至坐标(0,20)的操作 - 提升活动切换准确性与稳定性 * fix(ActivitySwitchNotice): 调整通知文本格式 - 修改键值对分隔符为单个空格 - 移除键值之间的冒号符号 - 保持每行末尾换行符一致 * fix(ActivitySwitchNotice): 修复活动切换工具中的OCR识别逻辑 - 统一鼠标移动函数调用的代码风格，增加参数间的空格 - 在成功返回顶部时添加日志信息输出 - 增强OCR识别结果判断条件，避免访问空数组导致异常 * fix(ActivitySwitchNotice): 优化活动切换逻辑和OCR识别流程 - 修改OcrClickActivity函数参数默认值，将lastName默认值设为null - 增强活动识别结束条件判断，避免无限循环 - 添加活动识别过程中的日志记录以便调试 - 引入双变量记录上一个活动名称以提高准确性 - 重构主循环逻辑，确保能正确识别所有活动 - 修复在特定条件下无法退出循环的问题 - 完善活动切换次数统计和活动映射更新机制 * feat(activity): 优化活动页面滚动与OCR识别逻辑 - 新增 scrollPagesByActivityToTop 函数，通过连续检测顶部活动名称相同来确认已到顶 - 修改 scrollPagesByActivity 支持自定义滚动参数（total, waitCount, stepDistance） - 重构 activityMain 函数，改为逐页扫描活动并统一发送通知 - 调整 OCR 日志级别从 info 改为 debug - 注释掉旧版 OcrClickActivity 和 activityMain 实现 - 在 main.js 中增加一次 toMainUi 调用以确保界面状态稳定 * refactor(activity): 移除废弃的活动处理函数并优化日志输出 - 删除了已注释的 OcrClickActivity 函数实现 - 移除了已注释的 activityMain 主函数代码 - 优化了活动剩余时间识别的日志格式 - 清理了无用的活动处理逻辑和冗余注释 - 简化了活动识别与点击的核心流程 - 提升了代码可读性和维护性 * fix(notice): 修复通知文本格式化问题 - 修复了模板字符串中变量未正确插入的问题 - 确保键值对在通知中正确显示 - 保持换行符一致以维持原有格式 * fix(ActivitySwitchNotice): 修复通知文本格式化问题 - 将字符串拼接方式从双引号改为模板字符串 - 修复了键值对显示异常的问题 - 确保通知文本正确换行显示 * fix(notice): 移除多余的通知文本包装 - 删除了发送通知时多余的反引号包裹 - 确保通知文本格式正确显示 - 避免了因格式错误导致的通知发送失败问题 * feat(activity): 新增活动剩余时间解析与排序通知功能 - 添加解析原神活动剩余时间字符串为总小时数的函数 - 支持多种时间格式如"22天14小时"、"5小时"等 - 实现按剩余小时数升序排列活动通知内容 - 更新活动时间存储结构以包含原始文本和计算后的小时数 - 优化通知消息展示格式，突出剩余时间信息 * fix(activity): 修复活动时间记录日志格式 - 在日志信息中明确添加“小时”单位以提高可读性 - 保持原有变量替换逻辑不变 - 确保日志输出的一致性和准确性 * feat(activity): 增强活动页面底部检测逻辑 - 新增基于活动名称集合的重复页判断机制 - 计算当前页与上一页活动名称重合率，防止无效滚动 - 设置重合率阈值为70%，超过则判定已到底部 - 每页新增活动计数器，若为零且非首页则停止扫描 - 保留原有底部判断方式，形成双重保险机制 - 优化日志输出，增强调试与运行状态可视化 * feat(activity): 新增活动去重逻辑 - 引入previousPageActivities集合用于记录已识别活动 - 防止同一页活动被重复处理 - 提升活动切换提醒准确性 * feat(activity): 增强活动扫描与通知功能 - 新增 settingsParseInt 函数用于安全解析配置数值 - 添加 notifyHoursThreshold 配置项，支持自定义通知时间阈值 - 优化滚动逻辑中的参数格式和日志输出 - 增加活动即将结束标识（剩余时间≤24小时） - 过滤掉超出时间阈值的活动，仅通知符合条件的活动 - 更新通知文案，显示时间筛选条件 - 修复多处代码格式和空格问题，提升可读性 * docs(ActivitySwitchNotice): 更新README文档内容 - 补充项目概述与功能特性说明 - 添加用户使用指南与快速开始步骤 - 详细描述配置选项与高级设置 - 增加文件结构与核心模块介绍 - 完善注意事项与工作原理说明 - 提供输出示例与使用环境要求 - 整理文档结构，提升可读性与实用性 * docs(ActivitySwitchNotice): 更新 README 配置说明 - 修正 settings.json 文件链接格式 - 统一文档中文件引用的展示方式 - 提高配置说明的可读性 * fix(ActivitySwitchNotice): 修复设置项默认值语法错误 - 修正 settings.json 中 notifyHoursThreshold 字段的默认值语法 - 添加缺失的冒号以符合 JSON 格式要求 * fix(ActivitySwitchNotice): 修复活动通知筛选逻辑并优化排序 - 调整活动筛选条件，确保仅包含剩余时间小于阈值的活动 - 对筛选后的活动按剩余时间进行升序排序 - 更新通知发送逻辑以使用排序后的活动列表 - 修正日志记录中的活动数量显示问题 - 移除无用的代码注释和空行 * feat(activity): 优化活动通知逻辑以提高性能 - 使用 Map 过滤活动数据而不是数组排序 - 减少不必要的数据转换操作 - 提升活动扫描和通知发送的效率 - 保持原有通知阈值和日志功能不变 * fix(activity): 修复活动名称列表分割方法 - 将 splice 方法更正为 split 方法以正确分割活动名称 - 更新 README 中的默认通知阈值描述 --- repo/js/ActivitySwitchNotice/README.md | 175 +++++++ .../assets/paimon_menu.png | Bin 0 -> 2372 bytes repo/js/ActivitySwitchNotice/main.js | 46 ++ repo/js/ActivitySwitchNotice/manifest.json | 14 + repo/js/ActivitySwitchNotice/settings.json | 25 + .../js/ActivitySwitchNotice/utils/activity.js | 446 ++++++++++++++++++ repo/js/ActivitySwitchNotice/utils/notice.js | 27 ++ 7 files changed, 733 insertions(+) create mode 100644 repo/js/ActivitySwitchNotice/README.md create mode 100644 repo/js/ActivitySwitchNotice/assets/paimon_menu.png create mode 100644 repo/js/ActivitySwitchNotice/main.js create mode 100644 repo/js/ActivitySwitchNotice/manifest.json create mode 100644 repo/js/ActivitySwitchNotice/settings.json create mode 100644 repo/js/ActivitySwitchNotice/utils/activity.js create mode 100644 repo/js/ActivitySwitchNotice/utils/notice.js diff --git a/repo/js/ActivitySwitchNotice/README.md b/repo/js/ActivitySwitchNotice/README.md new file mode 100644 index 000000000..305d6431e --- /dev/null +++ b/repo/js/ActivitySwitchNotice/README.md @@ -0,0 +1,175 @@ +# 活动期限通知器 + +## 项目概述 + +这是一个用于《原神》游戏的自动化脚本工具，主要功能是自动检测游戏内活动的剩余时间，并在活动即将结束时发送通知提醒玩家。 + +## 功能特性 + +- ✅ 自动返回游戏主界面并打开活动页面 +- ✅ OCR识别活动列表和剩余时间 +- ✅ 自动滚动浏览所有活动页面 +- ✅ 智能解析剩余时间（支持"22天14小时"等格式） +- ✅ 可配置的通知阈值（默认8760小时内结束的活动） +- ✅ 支持指定特定活动进行监控 +- ✅ 防重复检测机制 +- ✅ 异常处理和错误恢复 + +--- + +## 用户使用指南 + +### 快速开始 + +#### 1. 安装与配置 +- 确保游戏分辨率为 **1920×1080**（推荐分辨率） +- 将脚本导入到 BetterGI 脚本管理器中 +- 在脚本设置界面进行个性化配置 + +#### 2. 基础设置 +在 [settings.json]() 中可以配置以下参数： + +| 设置项 | 说明 | 默认值 | +|--------|------|--------| +| `toMainUi` | 执行前是否自动返回游戏主界面 | true | +| `activityNameList` | 监控的特定活动名称（用\|分隔） | 空（监控所有活动） | +| `notifyHoursThreshold` | 通知时间阈值（小时） | 8760（365天） | +| `activityKey` | 打开活动页面的快捷键 | F5 | + +### 使用流程 + +#### 自动模式（推荐） +1. 启动脚本后，程序会自动： + - 检测当前是否在游戏主界面 + - 如未在主界面，自动返回主界面 + - 按设定的快捷键打开活动页面 + - 开始扫描所有活动 + +#### 手动模式 +1. 关闭 `toMainUi` 选项 +2. 确保游戏处于主界面状态 +3. 启动脚本开始扫描 + +### 功能详解 + +#### 活动筛选 +- **全部活动监控**：`activityNameList` 保持空值，监控所有有剩余时间的活动 +- **指定活动监控**：填写活动关键词，如 `海灯节\|盛典`，只监控包含这些关键词的活动 + +#### 时间通知机制 +- 默认监控所有活动（`notifyHoursThreshold`=8760小时） +- 可设置阈值，如设置为24，则只通知剩余时间≤24小时的活动 +- 即将结束的活动会在通知中标记 `<即将结束>` + +#### 智能防重复 +- 自动识别已扫描过的活动页面 +- 防止因页面滚动不准确造成的重复识别 +- 自动判断是否已滚动到页面底部 + +### 注意事项 + +#### 使用环境要求 +- ✅ 游戏分辨率为 1920×1080（最佳兼容性） +- ✅ 游戏处于前台运行状态 +- ✅ 活动页面可通过设置的快捷键正常打开 + +#### 运行期间注意事项 +- 🚫 运行期间请勿手动操作鼠标 +- 🚫 避免切换窗口或最小化游戏 +- ⚠️ 如遇异常可重新启动脚本 + +### 高级配置 + +#### 自定义快捷键 +如活动页面不是F5打开，可在 `activityKey` 中修改为对应按键。 + +#### 时间阈值设置 +根据个人需求设置 `notifyHoursThreshold`： +- 24：只关注24小时内结束的活动 +- 168：关注一周内结束的活动 +- 720：关注一个月内结束的活动 + +### 输出示例 + +通知消息格式如下： +``` +原神活动剩余时间提醒: +> 海灯节庆典 剩余时间：3天14小时<还剩 86 小时> +> 风花节活动 剩余时间：1天5小时<还剩 29 小时><即将结束> +``` + +**`以上为用户使用指南全部内容`** +--- + + +## 文件结构 + +``` +ActivitySwitchNotice/ +├── utils/ +│ ├── activity.js # 核心活动处理逻辑 +│ └── notice.js # 通知发送功能 +├── main.js # 主入口文件 +├── manifest.json # 插件配置文件 +├── settings.json # 用户设置界面定义 +└── README.md # 说明文档 +``` + + +## 核心模块 + +### [activity.js]() - 活动处理核心 + +主要包含以下功能函数： + +- `scrollPage()` - 页面滚动基础函数 +- `scrollPagesByActivity()` - 按页滚动活动列表 +- `scrollPagesByActivityToTop()` - 滚动到活动列表顶部 +- `parseRemainingTimeToHours()` - 解析剩余时间文本为小时数 +- `OcrRemainingTime()` - OCR识别剩余时间 +- `activityMain()` - 主流程控制函数 + +### `notice.js` - 通知模块 + +- `sendNotice()` - 发送活动提醒通知，按剩余时间排序 + +### [main.js]() - 主程序入口 + +- 检测是否在主界面 +- 返回主界面功能 +- 执行主流程 + +## 配置选项 + +在 [settings.json]() 中可配置以下参数： + +| 配置项 | 类型 | 说明 | +|--------|------|------| +| `toMainUi` | Boolean | 是否先返回主界面再执行 | +| `activityNameList` | String | 指定活动名称（用\|分隔） | +| `notifyHoursThreshold` | Number | 通知阈值（小时） | +| `activityKey` | String | 打开活动页面的快捷键 | + +## 工作原理 + +1. 自动返回游戏主界面 +2. 按配置快捷键打开活动页面 +3. 滚动到活动列表顶部 +4. 逐页扫描所有活动 +5. OCR识别每个活动的剩余时间 +6. 解析时间为小时数并过滤 +7. 发送符合条件的活动提醒 + +## 注意事项 + +- 请确保游戏分辨率为1920×1080以获得最佳效果 +- 脚本运行期间请勿操作鼠标 +- 某些特殊活动可能无法正确识别剩余时间 +- 建议在游戏空闲时运行此脚本 + +--- + +## 其它 + +作者：云端客 +脚本反馈邮箱：doutianmianxia@qq.com \ No newline at end of file diff --git a/repo/js/ActivitySwitchNotice/assets/paimon_menu.png b/repo/js/ActivitySwitchNotice/assets/paimon_menu.png new file mode 100644 index 0000000000000000000000000000000000000000..c424325b17a4956f7802352e7609bfcff2721afa GIT binary patch literal 2372 zcmV-K3A^@*P)Px#1ZP1_K>z@;j|==^1poj532;bRa{vGi!vFvd!vV){sAK>D2-!(QK~z{rt(SRF zR96@7{OrIrs3OB6ST- zP@DTTKA&cd-_x`4ifbQ;v^!UEWYd=r=ft5o>jaWdZ$#*F1Dp=`Lw#i>UdiRG$$NWQ zlS!qJbxWbLunJ)v#?D#+4Ko*L&U1#Kww~+hpIblw8}X6L@I3V>qTOd=&jwpmmE@tP zN6PlU71k%NS0-b{sVwYPN+w3?*E%@$g9jWc1ShNWOUqVas)}Z=D&g zor^(ddmGo&$7^Bli&I(H`jA5yHPeBFc|eOy)65lLn65z7v3Rt#cd}#T%%3oS_UaWY zP8XsoYg`}%_!_r5rlgw?!gfco5(B+3n1mL!af6==BzpXu8{&uT3qW6mS~El zkk8E=nsSFID@2ckOt;?zeTP8kFWU_L<(r{v?++`_P}J1FJ zrGzD=Wn-M71IC)Hz~luUn6cEC1O>prF&HzQw!v`aH!xiFElga#ftK|K6j!LeQ~fcd zu+pkpT)duyod@HvcufdKo4P~8+8;*FJ6JPb9Y(ejI`+W`*mDLlI_jSS1!4JxCG0UD zjGX)uI0x;=R2zR7yM)5TEgZ8vA~DL$8>v}OxltdFg0S1arJ|~;ihCNEj?QkRP&zVj z41%F+IE+Xf^I2P(TeuM)kAkquN&(Ks|A_jR&0Ndi6qZ$E%2INE=P)evj^tWD4GO}l zs|660<>Kz0L`bDQTlvJ_ zd*fhAC$o!g1)mB9VKP}S5-webP*{r6(tI2{eg@gOg$bAczCL=vv$<53XC zkeQu}q9VFy$(tdpeg^M=ojCvFHMF#d*ud8xObT(KlbXT*a1qj;9&~keb5F|ifiUJp zNhv9icK(5G$#b-d>yYrnMFa##prLW#L-Bw@#s88sxTm*NR@Wfn@W}xeH4txvNhA_- zcq#jW+`Iw^Y1d>OFVNK}fV`&#XU@hWEkpUF{2C@MnmesS7C)bBQI0pl_)qhZ`REaH zbDpBOT!@R8ZXho^3q6ur^t9F?BQ1rEbE?8D^!SPMuy^t0T9ku#bS|6c^{Bu}MgWpb_a$GGT7-OE0cORWTp;=~E8}W|#CW zR${z~Eqp`wL7jee<~rcixt~x{E}+8X!^F>HL`^VR!V1gg=di+jLJq*rB>)Q@{g7Lj zN99xl$_gIiNnRc|O*L9+cNVVl#e~`R*dBe9y@5R87vNS>8Xjb1<5}5<`I$FqjvfA{ zJ{#fD2dJ13WAB0QFoW(@F(=Q`N}ACvu7 z94CBkV1wTuWpOIxN6it998EI_F8V*b>3*K`Kbcg3(3`{ZXAAT4bR7q)3 zi8tS63pzXdYS4k;sTtc~=+|VZ=M}SYR<;_3-Qba3-?kI z@t^~J`z(Eg++aT0lFm2#AOF&x$eXiTPDp7 z;rzyS?wDrzH8d>N!Q5>Jw(UO$fv{#+$=c8<2qR6M$*06z3(!p0ZLKAKm_<8f>KcaW zD?;EHxOd1!^DJDqu(_;R)XLV2!$I8I4&R6q7;oW)^}CL8txPKF!PbNS!W0rV$88s8 zyGKB6kw0#xq;n$%hBwJN2#F7dP7#9<6del#`#`8ISPy>D+c2;{HUVl@8(`$M2PW>3 z7-Q~*9Wn7r`7O`VI~H~U2hk!@J|r+OaV_~#E-csV!lVV>RK9J;^`s2e1q2j4nK*SX zGZ)dZKfxvV0K9gdz}34C(5Yl$!kg!F3Wgp>VC)%%!qQ5vd2ljv^5GwL7@MQMN9={` zxc~SmS}1mjByBi&DgoNon-Ca%l1BE@0_1GH$rL%t!bs { + let captureRegion = captureGameRegion(); + let res = captureRegion.Find(RecognitionObject.TemplateMatch( + file.ReadImageMatSync("assets/paimon_menu.png"), + 0, + 0, + 640, + 216 + )); + captureRegion.dispose(); + return !res.isEmpty(); +}; + +async function toMainUi() { + let ms = 300 + let index = 1 + await sleep(ms); + while (!isInMainUI()) { + await sleep(ms); + await genshin.returnMainUi(); // 如果未启用，则返回游戏主界面 + await sleep(ms); + if (index > 3) { + throw new Error(`多次尝试返回主界面失败`); + } + index += 1 + } +} + +(async function () { + if (settings.toMainUi){ + await toMainUi(); + } + await main(); + await toMainUi(); +})(); + +/** + * @returns {Promise} + */ +async function main() { + await activityUtil.activityMain() +} \ No newline at end of file diff --git a/repo/js/ActivitySwitchNotice/manifest.json b/repo/js/ActivitySwitchNotice/manifest.json new file mode 100644 index 000000000..67e54cb94 --- /dev/null +++ b/repo/js/ActivitySwitchNotice/manifest.json @@ -0,0 +1,14 @@ +{ + "name": "活动期限通知器", + "version": "0.0.1", + "description": "", + "settings_ui": "settings.json", + "main": "main.js", + "authors": [ + { + "name": "云端客", + "links": "https://github.com/Kirito520Asuna" + } + ], + "dependencies": [] +} \ No newline at end of file diff --git a/repo/js/ActivitySwitchNotice/settings.json b/repo/js/ActivitySwitchNotice/settings.json new file mode 100644 index 000000000..e2d093dec --- /dev/null +++ b/repo/js/ActivitySwitchNotice/settings.json @@ -0,0 +1,25 @@ +[ + { + "name": "toMainUi", + "type": "checkbox", + "label": "启用先返回主界面后执行切换", + "default": true + }, + { + "name": "activityNameList", + "type": "input-text", + "label": "活动名称(使用|分割)<可不填 默认推送所有有剩余时间的活动>" + }, + { + "name": "notifyHoursThreshold", + "type": "input-text", + "label": "通知剩余时间阈值<单位:小时>(默认 8760小时=365天)", + "default": "8760" + }, + { + "name": "activityKey", + "type": "input-text", + "label": "打开活动页面按键(不填，默认：F5)", + "default": "F5" + } +] diff --git a/repo/js/ActivitySwitchNotice/utils/activity.js b/repo/js/ActivitySwitchNotice/utils/activity.js new file mode 100644 index 000000000..1698768f9 --- /dev/null +++ b/repo/js/ActivitySwitchNotice/utils/activity.js @@ -0,0 +1,446 @@ +function settingsParseInt(str, defaultValue) { + try { + return str ? parseInt('' + str) : defaultValue; + } catch (e) { + log.warn(`settingsParseInt error:${e}`) + return defaultValue; + } +} + +const config = { + activityNameList: (settings.activityNameList ? settings.activityNameList.split('|') : []), + activityKey: (settings.activityKey ? settings.activityKey : 'F5'), + toTopCount: settingsParseInt(settings.toTopCount,10),//滑动到顶最大尝试次数 + scrollPageCount: settingsParseInt(settings.scrollPageCount,4),//滑动次数/页 + notifyHoursThreshold: settingsParseInt(settings.notifyHoursThreshold, 8760),//剩余时间阈值(默认 8760小时=365天) +} +const ocrRegionConfig = { + activity: {x: 267, y: 197, width: 226, height: 616},//活动识别区域坐标和尺寸 + remainingTime: {x: 497, y: 202, width: 1417, height: 670},//剩余时间识别区域坐标和尺寸 +} +const xyConfig = { + top: {x: 344, y: 273}, + bottom: {x: 342, y: 791}, +} + +const genshinJson = { + width: 1920,//genshin.width, + height: 1080,//genshin.height, +} + +/** + * 滚动页面的异步函数 + * @param {number} totalDistance - 总滚动距离 + * @param {boolean} [isUp=false] - 是否向上滚动，默认为false(向下滚动) + * @param {number} [waitCount=6] - 每隔多少步等待一次 + * @param {number} [stepDistance=30] - 每步滚动的距离 + * @param {number} [delayMs=1] - 等待的延迟时间(毫秒) + */ +async function scrollPage(totalDistance, isUp = false, waitCount = 6, stepDistance = 30, delayMs = 1000) { + let ms = 600 + await sleep(ms); + leftButtonDown(); // 按下左键 + await sleep(ms); + // 计算总步数 + let steps = Math.floor(totalDistance / stepDistance); + // 开始循环滚动 + for (let j = 0; j < steps; j++) { + // 计算剩余距离 + let remainingDistance = totalDistance - j * stepDistance; + // 确定本次移动距离 + let moveDistance = remainingDistance < stepDistance ? remainingDistance : stepDistance; + // 如果是向上滚动，则移动距离取反 + if (isUp) { + //向上活动 + moveDistance = -moveDistance + } + // 执行鼠标移动 + moveMouseBy(0, -moveDistance); + // 取消注释后会在每一步后等待 + // await sleep(delayMs); + // 每隔waitCount步等待一次 + if (j % waitCount === 0) { + await sleep(delayMs); + } + } + // 滚动完成后释放左键 + await sleep(ms); + leftButtonUp(); + await sleep(ms); +} + +/** + * 根据活动状态进行页面滚动 + * @param {boolean} isUp - 是否向上滚动，默认为false + */ +async function scrollPagesByActivity(isUp = false, total = 90, waitCount = 6, stepDistance = 30) { + // 根据滚动方向设置坐标位置 + // 如果是向上滚动，使用顶部坐标；否则使用底部坐标 + let x = isUp ? xyConfig.top.x : xyConfig.bottom.x + let y = isUp ? xyConfig.top.y : xyConfig.bottom.y + // 记录滑动方向 + log.info(`活动页面-${isUp ? '向上' : '向下'}滑动`) + // 注释：坐标信息已注释掉，避免日志过多 + // log.info(`坐标:${x},${y}`) + // 根据配置的滑动次数执行循环 + for (let i = 0; i < config.scrollPageCount; i++) { + // 移动到坐标位置 + await moveMouseTo(x, y) + //80 18次滑动偏移量 46次测试未发现偏移 + await scrollPage(total, isUp, waitCount, stepDistance) + } +} + +/** + * 通过滚动页面直到到达顶部位置 + * 该函数会持续滚动页面，直到检测到页面顶部的标识不再变化为止 + * @returns {Promise} 无返回值，当到达顶部时函数执行结束 + * @throws {Error} 如果尝试滚动超过10次仍未到达顶部，抛出错误 + */ +async function scrollPagesByActivityToTop(ocrRegion = ocrRegionConfig.activity) { + let topName = null // 用于存储检测到的顶部标识文本 + let index = 0 // 记录滚动尝试次数的计数器 + // 无限循环，直到到达顶部后通过return退出 + while (true) { + // 检查是否已超过最大尝试次数(10次) + if (index >= config.toTopCount) { + throw new Error("回到顶部失败") // 超过尝试次数抛出错误 + } + await moveMouseTo(0, 20) + index++ // 增加尝试次数计数器 + let captureRegion = captureGameRegion(); // 获取游戏区域截图 + const ocrObject = RecognitionObject.Ocr(ocrRegion.x, ocrRegion.y, ocrRegion.width, ocrRegion.height); // 创建OCR识别对象 + + // ocrObject.threshold = 1.0; + let resList = captureRegion.findMulti(ocrObject); // 在指定区域进行OCR识别 + captureRegion.dispose(); // 释放截图资源 + if (topName !== resList[0].text) { + topName = resList[0].text + } else { + log.info(`回到顶部成功`) + // break + return + } + await scrollPagesByActivity(true, 80 * 4, 6, 60) + } + +} + +/** + * 滚动到活动页面最顶部（优化版） + * 通过连续检测顶部活动名称相同来确认已到顶，更加健壮 + * @param {Object} ocrRegion - OCR识别区域，默认为活动列表区域 + * @throws {Error} 如果超过最大尝试次数仍未检测到稳定顶部，则抛出错误 + */ +async function scrollPagesByActivityToTop(ocrRegion = ocrRegionConfig.activity) { + let ms = 800 + let topActivityName = null; // 上一次检测到的顶部活动名称 + let sameTopCount = 0; // 连续出现相同顶部名称的次数 + const requiredSameCount = 1; // 需要连续几次相同才确认到顶（推荐 2~3） + let attemptIndex = 0; // 总尝试次数计数器 + const maxAttempts = config.toTopCount; // 可配置，默认为15次 + + log.info("开始滚动到活动页面顶部..."); + + while (attemptIndex < maxAttempts) { + attemptIndex++; + log.info(`第 {attemptIndex} 次尝试回顶`, attemptIndex); + + // 移动鼠标到安全位置，避免干扰截图 + await moveMouseTo(0, 20); + + // 截图 + OCR 识别活动列表区域 + let captureRegion = captureGameRegion(); + const ocrObject = RecognitionObject.Ocr( + ocrRegion.x, + ocrRegion.y, + ocrRegion.width, + ocrRegion.height + ); + // 可选：提升识别率 + // ocrObject.threshold = 0.8; + + let resList = captureRegion.findMulti(ocrObject); + captureRegion.dispose(); + + // 如果完全没识别到任何活动，可能是页面异常或已在顶（极少情况） + if (resList.length === 0) { + log.warn("顶部OCR未识别到任何活动条目，可能是页面为空或识别失败"); + // 再尝试一次向上滚大距离 + // await scrollPagesByActivity(true); // true = 向上 + await scrollPagesByActivity(true, 80 * 4, 6, 60); + await sleep(ms); + continue; + } + + // 取当前识别到的最顶部活动名称（resList[0] 通常是列表最上面的） + const currentTopName = resList[0].text.trim(); + + log.info(`当前检测到的顶部活动: {currentTopName}`, currentTopName); + + // 判断是否与上一次相同 + if (currentTopName === topActivityName) { + sameTopCount++; + log.debug(`顶部活动连续相同 ${sameTopCount} 次`); + + if (sameTopCount >= requiredSameCount) { + log.info(`已连续 {sameTopCount} 次检测到相同顶部活动，确认回到页面最顶部！`, sameTopCount); + return; // 成功回到顶部 + } + } else { + // 顶部名称变了，说明还在向上滚动，重置计数 + topActivityName = currentTopName; + sameTopCount = 1; // 这次算第一次 + } + + // 未达到稳定状态，继续向上滚动一页（可根据实际情况调整滚动距离） + // 这里使用更大滚动距离确保能快速回顶 + // await scrollPagesByActivity(true); // true = 向上 + // 可选：加大单次滚动量（如果你发现默认一页不够） + await scrollPagesByActivity(true, 80 * 4, 6, 60); + + await sleep(ms); // 给页面滚动和渲染留时间 + } + + // 超过最大尝试次数仍未稳定 + throw new Error(`回到活动页面顶部失败：尝试 ${attemptIndex} 次后仍未检测到稳定顶部活动`); +} + +/** + * 解析原神活动剩余时间字符串，返回总小时数 + * 支持格式示例： + * "剩余时间：22天14小时" → 542（22*24 + 14） + * "剩余时间：5小时" → 5 + * "剩余时间：3天" → 72（3*24 + 0） + * "剩余时间：1天23小时" → 47 + * "剩余：10天" → 240（也支持部分关键词匹配） + * + * @param {string} timeText - OCR识别出的剩余时间文本 + * @returns {number} 总剩余小时数（整数，四舍五入向下取整） + * 如果解析失败，返回 0 + */ +function parseRemainingTimeToHours(timeText) { + if (!timeText || typeof timeText !== 'string') { + return 0; + } + + // 提取数字和单位（支持中英文冒号、空格等） + const dayMatch = timeText.match(/(\d+)\s*天/); + const hourMatch = timeText.match(/(\d+)\s*小时/); + + let days = 0; + let hours = 0; + + if (dayMatch) { + days = parseInt(dayMatch[1], 10); + } + if (hourMatch) { + hours = parseInt(hourMatch[1], 10); + } + + // 天数转小时 + 原有小时 + const totalHours = days * 24 + hours; + + return totalHours; +} + +/** + * 可选：返回格式化字符串，如 "542小时（22天14小时）" + */ +function formatRemainingTime(timeText) { + if (!timeText || typeof timeText !== 'string') { + return "解析失败"; + } + + const dayMatch = timeText.match(/(\d+)\s*天/); + const hourMatch = timeText.match(/(\d+)\s*小时/); + + const days = dayMatch ? parseInt(dayMatch[1], 10) : 0; + const hours = hourMatch ? parseInt(hourMatch[1], 10) : 0; + const totalHours = days * 24 + hours; + + const original = timeText.trim(); + return `${totalHours}小时（${days > 0 ? days + '天' : ''}${hours > 0 ? hours + '小时' : ''}）`; +} + +/** + * OCR识别活动剩余时间的函数 + * @param {Object} ocrRegion - OCR识别的区域坐标和尺寸 + * @param {string} activityName - 活动名称 + * @param {string} key - 要识别的关键词，默认为"剩余时间" + * @returns {string|null} 返回识别到的剩余时间文本，若未识别到则返回null + */ +async function OcrRemainingTime(activityName, key = "剩余时间", ocrRegion = ocrRegionConfig.remainingTime) { + let captureRegion = captureGameRegion(); // 获取游戏区域截图 + const ocrObject = RecognitionObject.Ocr(ocrRegion.x, ocrRegion.y, ocrRegion.width, ocrRegion.height); // 创建OCR识别对象 + // ocrObject.threshold = 1.0; + let resList = captureRegion.findMulti(ocrObject); // 在指定区域进行OCR识别 + captureRegion.dispose(); // 释放截图资源 + for (let res of resList) { + if (res.text.includes(key)) { // 检查识别结果是否包含关键词 + log.debug(`{activityName}--{time}`, activityName, res.text); // 记录日志 + return res.text // 返回识别到的文本 + } + } + // 没有识别到剩余时间 + return null; +} + + +/** + * 活动主函数：扫描所有活动页面，识别剩余时间，最后统一发送通知 + */ +async function activityMain() { + const ms = 1000; + await sleep(ms); + + // 1. 打开活动页面（默认 F5） + await keyPress(config.activityKey); + await sleep(ms * 2); // 给活动页面多点加载时间 + + // 2. 先强制滚动到最顶部（非常重要！） + try { + await scrollPagesByActivityToTop(); + await sleep(ms); + } catch (e) { + log.warn("回到顶部失败，但继续尝试执行"); + } + + // 3. 初始化存储所有活动的 Map + let activityMap = new Map(); // key: 活动名称, value: 剩余时间文本 + let previousPageActivities = new Set(); // 新增：记录上一页识别到的所有活动名称（用于重复页判断） + + let lastPageBottomName = null; // 上一次扫描到的页面最底部活动名 + let sameBottomCount = 0; // 连续出现相同底部活动名的次数 + let scannedPages = 0; + const maxPages = 25; // 防止意外死循环的安全上限 + let sameBottomCountMax = 1; // 连续相同底部活动名的最大次数 + + // 4. 主循环：逐页向下扫描 + while (scannedPages < maxPages) { + scannedPages++; + log.info(`正在扫描第 {scannedPages} 页`, scannedPages); + // 移动鼠标到安全位置，避免干扰截图 + await moveMouseTo(0, 20); + // 获取当前页面活动列表区域截图并 OCR + let captureRegion = captureGameRegion(); + const ocrObject = RecognitionObject.Ocr( + ocrRegionConfig.activity.x, + ocrRegionConfig.activity.y, + ocrRegionConfig.activity.width, + ocrRegionConfig.activity.height + ); + let resList = captureRegion.findMulti(ocrObject); + captureRegion.dispose(); + + // 如果本页完全没有识别到活动，可能是到底了或 OCR 失败 + if (resList.length === 0) { + log.info("当前页未识别到任何活动，视为已到页面底部"); + break; + } + // ============ 新增：提前判断是否为重复页 ============ + const currentPageNames = new Set(); + for (let res of resList) { + currentPageNames.add(res.text.trim()); + } + + // 计算与上一页的重合率 + if (previousPageActivities.size > 0) { + let overlapCount = 0; + for (let name of currentPageNames) { + if (previousPageActivities.has(name)) overlapCount++; + } + const overlapRatio = overlapCount / previousPageActivities.size; + + // 如果重合率 >= 70%（可调整），认为滚动未生效，是重复页 + if (overlapRatio >= 0.7) { + log.info(`检测到当前页与上一页高度重复（重合率 ${Math.round(overlapRatio * 100)}%），已到达底部，停止扫描`); + break; + } + } + + // 更新上一页记录（为下一轮做准备） + previousPageActivities = currentPageNames; + // ================================================= + + let currentPageBottomName = null; // 本页最下面的活动名 + let newActivityCountThisPage = 0; + + // 遍历当前页所有识别到的活动条目 + for (let res of resList) { + const activityName = res.text.trim(); + + // 如果设置了指定活动列表，只处理包含这些关键词的活动 + if (config.activityNameList.length > 0) { + const matched = config.activityNameList.some(keyword => activityName.includes(keyword)); + if (!matched) { + continue; // 不关心的活动，跳过不点击 + } + } + + // 避免重复点击同一个活动（防止 OCR 误识别或页面抖动） + if (activityMap.has(activityName)) { + log.info(`活动已记录，跳过重复点击: ${activityName}`); + } else { + await click(res.x, res.y); // 点击进入活动详情 + await sleep(ms); + + let remainingTimeText = await OcrRemainingTime(activityName); + if (remainingTimeText) { + const totalHours = parseRemainingTimeToHours(remainingTimeText); + if (totalHours <= 24 && totalHours > 0) { + remainingTimeText += '<即将结束>' + } + activityMap.set(activityName, { + text: remainingTimeText, + hours: totalHours + }); + log.info(`成功记录 → {activityName} {remainingTime} 共计: {hours} 小时`, activityName, remainingTimeText, totalHours); + newActivityCountThisPage++; + } + + await sleep(ms); + } + + // 更新本页最下面的活动名 + currentPageBottomName = activityName; + } + // 备用判断：本页一个新活动都没加，也认为到底（双保险） + if (newActivityCountThisPage === 0 && scannedPages > 1) { + log.info("本页无新活动添加，确认已到底"); + break; + } + // 5. 判断是否已到达页面底部 + if (currentPageBottomName && currentPageBottomName === lastPageBottomName) { + sameBottomCount++; + if (sameBottomCount >= sameBottomCountMax) { + log.info("连续{sameBottomCountMax}次检测到相同底部活动，已确认到达页面最底部，扫描结束", sameBottomCountMax); + break; + } + } else { + sameBottomCount = 0; // 重置计数 + } + lastPageBottomName = currentPageBottomName; + + // 6. 向下滑动一页，继续下一轮 + await scrollPagesByActivity(false); // false = 向下滚动 + await sleep(ms); + } + let activityMapFilter = new Map(); + Array.from(activityMap.entries()) + .filter(([name, info]) => info.hours <= config.notifyHoursThreshold) + .forEach(([name, info]) => activityMapFilter.set(name, info)); + // 7. 全部扫描完毕，统一发送通知（只发一次！） + if (activityMapFilter.size > 0) { + log.info(`扫描完成，共记录 {activityMap.size} 个活动，即将发送通知`, activityMapFilter.size); + await noticeUtil.sendNotice(activityMapFilter, `原神活动剩余时间提醒(仅显示剩余 ≤ ${config.notifyHoursThreshold} 小时的活动):`); + } else { + log.warn("未识别到任何活动，未发送通知"); + } +} + +this.activityUtil = { + // config, + activityMain, + // OcrRemainingTime, +} diff --git a/repo/js/ActivitySwitchNotice/utils/notice.js b/repo/js/ActivitySwitchNotice/utils/notice.js new file mode 100644 index 000000000..2270fca24 --- /dev/null +++ b/repo/js/ActivitySwitchNotice/utils/notice.js @@ -0,0 +1,27 @@ +/** + * 发送通知的异步函数 + * @param {Map} map - 包含通知内容键值对的Map对象 + * @param {string} title - 通知的标题 + * @param {boolean} noNotice - 是否不发送通知的标志 + */ +async function sendNotice(map, title, noNotice) { + // 如果设置了不发送通知且map为空，则记录日志并返回 + if (noNotice && !map) { + log.info(`无通知内容`) + return + } + // 按剩余小时升序排序（即将结束的在前） + const sortedEntries = Array.from(map.entries()) + .sort((a, b) => a[1].hours - b[1].hours); + + let noticeText = title ? title + "\n" : "\n" + for (const [name, info] of sortedEntries) { + noticeText += `> ${name} ${info.text}<还剩 ${info.hours} 小时>\n`; + } + // 发送通知 + notification.send(noticeText) +} + +this.noticeUtil = { + sendNotice, +} \ No newline at end of file