koishi-plugin-platform-clock 车队平台打卡排行榜插件
656 字
3 分钟
koishi-plugin-platform-clock 车队平台打卡排行榜插件
🕐 项目介绍
koishi-plugin-platform-clock 是一款车队平台打卡统计 Koishi 插件。插件调用车队平台接口，按活动开始日期统计成员打卡次数，生成前 10 名打卡排行榜图片，并支持定时推送到群聊。排行榜以精美的 PNG 图片发送，前三名拥有金银铜特殊徽章，让打卡激励一目了然。
车队平台1.0积分统计插件，支持按日期查询积分排行榜，并以精美图片形式展示。同时支持每周/每月定时推送排名。
⭐ 开源地址：https://github.com/opwop1/koishi-plugin-platform-clock
✨ 功能特性
- 按日期范围统计：基于打卡记录的
activityStartTime字段精确统计 - 精美排行榜图片：以 PNG 图片形式发送，视觉呈现更直观
- 前三名徽章：金银铜特殊徽章彰显荣誉
- 车队编号匹配：根据用户 ID 自动匹配并展示车队编号
- 定时推送：每周日 22<00> 推送周榜，每月最后一天 22<00> 推送月榜
- 权限控制：仅允许 OneBot 适配器使用指令，支持限制指令可用群聊与推送群聊
- 自动分页：接口数据自动按
totalPage请求全部分页
📦 前置依赖
| 依赖 | 说明 |
|---|---|
| koishi-plugin-puppeteer | 用于将排行榜 HTML 渲染为图片 |
| OneBot 适配器 | 用于执行查询指令和发送定时排行 |
⚙️ 配置项
| 配置项 | 类型 | 必填 | 说明 |
|---|---|---|---|
platformUrl | string | 是 | 车队平台地址，例如 https://example.com |
token | string | 是 | 车队平台 API Token |
allowedGroups | string[] | 否 | 允许使用查询指令的群聊 ID 列表 |
sendGroups | string[] | 否 | 定时推送排行榜的群聊 ID 列表 |
token仅用于请求用户信息接口；打卡记录接口按当前平台接口格式请求，两个接口都会自动分页拉取全量数据。
📋 指令说明
打卡排行
别名：clock-rank
查询指定日期范围内的打卡排行榜，日期筛选使用打卡记录的 activityStartTime 字段，统计同一 userId 在范围内的记录数量。
格式：
打卡排行 <开始日期> <结束日期>示例：
打卡排行 2026-07-01 2026-07-22clock-rank 2026-07-01 2026-07-22使用限制：
- 仅限 OneBot 适配器
- 仅限
allowedGroups中配置的群聊使用 - 日期格式必须为
YYYY-MM-DD - 开始日期不能晚于结束日期
⏰ 定时推送
| 任务 | 时间 | 统计范围 |
|---|---|---|
| 周排行 | 每周日 22<00> | 本周周一至周日 |
| 月排行 | 每月最后一天 22<00> | 当月 1 日至月末 |
推送目标为 sendGroups 中配置的群聊，插件只会向 OneBot 机器人发送消息。
🖼️ 排行榜图片内容
- 排名、成员名称和打卡次数
- 前三名金银铜特殊徽章
- 匹配成功时显示车队编号
- 统计日期范围和参与人数
📄 许可证
MIT License
文章分享
如果这篇文章对你有帮助，欢迎分享给更多人！
koishi-plugin-platform-clock 车队平台打卡排行榜插件
https://www.114512.xyz/posts/koishi-plugin-platform-clock/相关文章智能推荐
1
koishi-plugin-ets2-tools-tmp 欧卡tmp信息查询插件
代码分享一款专为欧洲卡车模拟2（ETS2）与美国卡车模拟（ATS）玩家打造的多功能 Koishi 插件，集成 TruckersMP 数据查询与车队活动管理，支持玩家信息、服务器路况、里程排行、智能活动提醒等功能。
2
koishi-plugin-auto-exit-group 自动退群管家
代码分享一款 Koishi 自动退群管理插件（仅限 OneBot 平台），基于白名单机制定时检查机器人所在群列表，自动退出未设置的群组，支持多适配器实例、手动检查指令与白名单查看。
3
koishi-plugin-adapter-mail-pro 邮件适配器
代码分享基于 @satorijs/adapter-mail 扩展的 Koishi 邮件适配器插件，支持 SMTP 发送与 IMAP 接收邮件，可让 Koishi 机器人像处理普通聊天消息一样收发邮件，兼容 QQ 邮箱、163、Gmail、Outlook 等主流邮箱服务。
4
ets-map-example 欧卡在线地图示例
代码分享一个 ETS2 欧洲卡车模拟 2 地图代码示例项目，包含标准地图和 ProMods 地图，支持双颜色主题切换，附带可在线访问的地图演示页面。
5
欧卡专用服务器安装教程（Linux）
游戏教程从零开始在欧洲卡车模拟 2 中搭建自己的专用服务器（Dedicated Server）：云服务器选型与端口放行、SteamCMD 安装、服务端部署、server_packages 生成与上传、server_config 完整配置详解，一文搞定联运房间搭建。
随机文章随机推荐
欢迎来到我的知识分享站！
文章
6
分类
2
标签
21
总字数
5,006
运行时长
0 天
最后活动
0 天前
站点域名www.114512.xyz
Fireflyv6.16.6
Astrov7.2.4
Nodev25.9.0
pnpmv11.22.0
构建时间2026年9月10日 17:43:26
系统信息Windows / x86_64
