签到与积分
约 1512 字大约 5 分钟
2025-04-11
签到与积分系统是 ResourceTool 签到模式下的核心运营机制。用户通过每日签到获取积分，积分可兑换白名单、续期、解封、邀请码等权益，实现用户自治运营。
前置条件
签到与积分功能仅在 实例管理 中将运营模式设为「签到模式」并开启签到后才可使用。标准模式下这些 Bot 命令不会生效。
核心概念
| 概念 | 说明 |
|---|---|
| 积分 | 用户的虚拟货币，通过签到获取，可兑换各类权益 |
| 白名单 | 白名单用户不受到期扫描影响，相当于永久会员 |
| 自动续费 | 用户到期时如果积分充足，系统自动扣积分续期 |
| 活跃度检测 | 管理员检查长期不播放的用户 |
用户 Bot 命令
以下命令由用户在 Telegram Bot 中使用：
/checkin — 每日签到
每天使用一次，获取随机积分（范围由管理员在实例管理中配置）。
用户发送: /checkin
Bot 回复: ✅ 签到成功！获得 7 积分，当前余额 127 积分签到积分范围
默认为 1~10 积分，管理员可在 实例管理 中调整每次签到的最少和最多积分。
/points — 查看积分余额
查看当前账户的积分余额。
用户发送: /points
Bot 回复: 💰 你的积分余额：127 积分/exchange — 积分兑换
使用积分兑换各类权益。发送命令后 Bot 会显示可兑换的选项菜单：
| 兑换项 | 默认积分 | 说明 |
|---|---|---|
| 白名单 | 1000 | 升级为白名单用户，不受到期扫描影响 |
| 解封 | 500 | 被封禁时可使用积分自助解封 |
| 邀请码 | 100 | 生成一个邀请码，可分享给其他人 |
| 续期 | 300 / 30天 | 主动使用积分延长到期时间 |
续期兑换
管理员可在实例管理中设置「兑换续期积分」为 0 来关闭此功能。续期天数也可自定义。
/setcode — 设置安全码
设置个人安全码，用于保护敏感操作（自删账号、换绑 TG）。
用户发送: /setcode
Bot 回复: 请输入你的安全码（4~20 位字符）
用户发送: mypassword123
Bot 回复: ✅ 安全码已设置/delme — 自删账号
删除自己的 Emby 账号。如果已设置安全码，需先验证安全码。
不可逆操作
账号删除后无法恢复，用户需重新注册。
/changetg — 换绑 Telegram
将 Emby 账号绑定到新的 Telegram 账号。如果已设置安全码，需先验证。
换绑审批
如果目标 TG 账号已绑定了其他 Emby 用户，系统会创建审批请求，管理员在 Bot 中收到通知后一键批准或拒绝。
/userinfo — 个人信息
查看自己的账号信息，包括用户名、到期时间、积分余额、密码等。
/mydevices — 我的设备
查看当前绑定的在线设备列表，离线设备仅显示最近 3 个。
/myfavorites — 我的收藏
查看 Emby 中的收藏列表。
/status — 访问线路
查看所有可用的 Emby 访问线路及其在线状态。
管理员 Bot 命令
以下命令仅管理员可用：
/score — 调整积分
手动调整用户积分。回复用户消息或指定用户名使用。
管理员回复用户消息: /score +100
Bot 回复: ✅ 已为用户 xxx 增加 100 积分，当前余额 227 积分
管理员回复用户消息: /score -50
Bot 回复: ✅ 已为用户 xxx 扣除 50 积分，当前余额 177 积分/low_activity — 活跃度检测
检测长期未播放的不活跃用户。需要先在实例管理中开启活跃度检测并设置不活跃天数。
管理员发送: /low_activity
Bot 回复: 📊 不活跃用户（超过 30 天未播放）：
1. user_a — 最后播放 45 天前
2. user_b — 最后播放 60 天前/create — 快捷开号
管理员在群组或私聊中快速创建 Emby 账号。
| 使用方式 | 行为 |
|---|---|
| 回复群内用户消息 | 自动创建账号并绑定该用户的 TG，密码通过私信发送（群内不显示密码） |
| 直接发送 | 生成绑定码和深链接，用户点击链接一键绑定，绑定码锁定目标 TG 用户 |
/perm — 设置白名单
回复用户消息设置白名单。支持回复未绑定用户时指定用户名直接设白名单。
管理员回复用户消息: /perm
Bot 回复: ✅ 已将用户 xxx 设为白名单
管理员回复未绑定用户消息: /perm username123
Bot 回复: ✅ 已将用户 username123 设为白名单/lookup — 查看用户信息
查看指定用户的详细信息卡片，包含操作按钮（续期、封禁、解封等）。
/online — 在线用户
查看当前在线的用户列表。
/count — 用户统计
查看用户总数、活跃数、到期数等统计信息。
/leaderboard — 积分排行榜
查看用户积分排行榜。
积分自动续费流程
到期扫描定时任务触发
↓
检查用户是否到期
↓
┌─ 积分 ≥ 续费积分 → 自动扣积分 → 续期 → 通知用户「已自动续费」
└─ 积分不足 → 禁用用户 → 通知管理员配合建议
建议同时开启签到和自动续费，这样活跃用户通过日常签到积累积分，到期时自动续费无感续期，减少管理员人工操作。
Bot 菜单结构
Bot 的 /start 命令会显示多级内联键盘菜单，按用户身份动态显示不同选项：
普通用户看到的菜单：
- 个人信息 | 我的设备
- 访问线路 | 求片
- 签到 | 积分兑换
- 网盘配置 | 福利中心
管理员额外看到的菜单：
- 用户管理 | 在线用户
- 积分排行 | 活跃度检测
所有菜单按钮统一为两个一排的布局，移动端操作更友好。