koishi-plugin-tmp-activity-reminder


TMP活动提醒插件

一个专为卡车模拟器车队设计的智能活动管理插件，支持自动从车队平台和TruckersMP API获取活动信息，并在QQ群组中发送提醒消息。

功能特性

$3

- 双数据源支持: 同时从车队平台和TruckersMP API获取活动数据
- 智能提醒: 在活动开始前指定时间发送提醒消息
- 档位检查: 自动检查活动档位上传状态并提醒管理
- 多群组支持: 分别配置管理群和主群，发送不同类型的消息

$3

- 数据源选择: 可独立配置服务器、起点、终点的信息来源
- 定时任务: 自定义活动检查和信息发送时间
- 消息模板: 支持变量的自定义消息模板
- 提醒时间: 可配置多个活动开始前提醒时间点

$3

- 详细日志: 多级别的日志记录选项
- 调试模式: 完整的调试信息输出
- API监控: 记录API请求和响应详情
- 性能监控: 记录定时任务执行情况

安装配置

$3

#### API配置
- 使用HTTPS协议: 选择是否使用HTTPS
- 车队平台URL: 您的车队平台地址（不包含协议）
- 车队平台TOKEN: API访问令牌
- VTC ID: 您在TruckersMP的VTC ID

#### 管理群配置
- 活动检查时间: 检查活动档位状态的时间（HH:mm格式）
- 信息发送时间: 发送档位提醒的时间（HH:mm格式）
- 管理群组ID: 接收管理提醒的群组ID列表

$3

为以下信息选择数据来源（车队平台API或TMP API）：
- 服务器信息
- 起点信息
- 终点信息

还可配置是否显示活动横幅。

$3

#### 管理群消息
- 档位已上传消息: 当活动档已上传时显示的消息
- 档位未上传消息: 当活动档未上传时的提醒消息

#### 主群配置
- 主群群号: 接收活动提醒的群组ID列表
- 活动提醒消息模板: 支持以下变量：
- {name}: 活动名称
- {server}: 服务器名称
- {startingPoint}: 起点位置
- {terminalPoint}: 终点位置
- {distance}: 距离
- {banner}: 活动横幅（如果启用）
- {timeLeft}: 剩余时间（分钟）
- 活动提醒时间: 活动开始前多少分钟发送提醒

$3

启用以下日志记录功能用于调试：
- 调试模式: 启用详细调试日志
- 记录API响应: 记录API请求和响应详情
- 记录定时任务: 记录定时任务执行详情
- 记录活动匹配: 记录活动数据匹配过程
- 记录消息发送: 记录消息发送详情

使用方法

$3

插件会自动执行以下任务：
- 每日凌晨2点重置数据
- 在配置的时间检查活动数据
- 发送档位状态提醒到管理群
- 发送活动开始提醒到主群

$3

#### 活动查询
活动查询

手动检查今日活动数据，返回活动数量统计。

#### 活动DEBUG
活动DEBUG

查看插件当前的调试信息，包括数据状态和配置。

#### 重置数据
重置数据

手动重置今日的活动数据和提醒记录。

消息变量

在活动提醒消息模板中可使用以下变量：

| 变量名 | 说明 | 示例 |
|--------|------|------|
| {name} | 活动名称 | 周末联运活动 |
| {server} | 服务器名称 | 欧服一区 |
| {startingPoint} | 起点位置 | 柏林 - 德国 |
| {terminalPoint} | 终点位置 | 巴黎 - 法国 |
| {distance} | 距离 | 1200 |
| {banner} | 活动横幅URL | https://example.com/banner.jpg |
| {timeLeft} | 剩余时间(分钟) | 60 |

技术支持

如果遇到问题：
1. 首先启用调试模式查看详细日志
2. 检查API配置是否正确
3. 确认群组ID和权限设置
4. 查看定时任务是否正常执行

版本信息

- 支持平台: Koishi
- 依赖: HTTP请求、定时任务
- 适配器: 支持主流聊天平台（除邮件适配器外）

活动查询

text
手动检查今日活动数据，返回活动数量统计。

#### 活动DEBUG
活动DEBUG

text
查看插件当前的调试信息，包括数据状态和配置。

#### 重置数据
重置数据

text
手动重置今日的活动数据和提醒记录。

消息变量

在活动提醒消息模板中可使用以下变量：

| 变量名 | 说明 | 示例 |
|--------|------|------|
| {name} | 活动名称 | 周末联运活动 |
| {server} | 服务器名称 | 欧服一区 |
| {startingPoint} | 起点位置 | 柏林 - 德国 |
| {terminalPoint} | 终点位置 | 巴黎 - 法国 |
| {distance} | 距离 | 1200 |
| {banner} | 活动横幅URL | https://example.com/banner.jpg |
| {timeLeft} | 剩余时间(分钟) | 60 |

技术支持

如果遇到问题：
1. 首先启用调试模式查看详细日志
2. 检查API配置是否正确
3. 确认群组ID和权限设置
4. 查看定时任务是否正常执行

版本信息

- 支持平台: Koishi
- 依赖: HTTP请求、定时任务
- 适配器: 支持主流聊天平台（除邮件适配器外）