更新日志

约 5665 字大约 19 分钟

2025-04-22

记录 ResourceTool 每个版本的功能更新、Bug 修复与优化改进。

v1.6.5

📅 2025-04-22

🎬 媒体库屏蔽重构

管理员统一配置：媒体库屏蔽改为管理员统一配置，非白名单用户自动隐藏，Emby 管理员自动跳过
白名单用户配置：新增白名单用户配置，配置变更时自动全量同步
自动应用屏蔽规则：新建/导入用户自动应用屏蔽规则，用户面板移除自助入口

🎟️ 邀请码绑定实例

所属实例字段：邀请码新增「所属实例」字段，支持限定到特定 Emby 实例
实例筛选与校验：列表按实例筛选，兑换时校验实例匹配

保存前可用性验证：所有 Cookie 保存入口新增可用性验证，不可用拒绝保存并提示原因

🌐 访问线路管理优化

URL 字段拆分：线路 URL 编辑拆分为协议、域名、端口三个独立字段
折叠显示：用户面板线路展示优化，相同协议和端口时折叠显示

⚡ 预缓存版本数截断

按类型限制版本数：按 item 类型限制预缓存版本数，管理员不受限制

📡 TG 频道转发降级

自动降级：FORWARDS_RESTRICTED 自动降级为下载图片重新上传

🔧 其他改进

实例配置新增「公网地址」字段
修复 sync.Map 内存泄漏，移除废弃的求片回调代码

v1.6.4.5

📅 2025-04-20

🤖 TG Bot 绑定流程优化

一键绑定：/create 统一生成绑定码+深链接，用户一键绑定，绑定码锁定目标 TG 用户
快捷白名单：/perm 支持回复未绑定用户时指定用户名直接设白名单

📺 Emby 播放兼容性

同 IP 设备合并：设备流控同 IP 合并，修复 iOS/Android 客户端被计为两台设备的问题
路由日志修复：正确显示 Emby for iOS 等客户端名称

🔐 访问线路可见性修复

永久用户可见：标准模式的永久用户现在也能看到隐藏线路

🎨 管理后台

签到模式实例新增积分编辑字段
修复创建自备配置时 Source 字段丢失问题

v1.6.4.4

📅 2025-04-18

🏗️ 实例管理页面（全新）

独立页面：从 302 配置中拆分出独立的「实例管理」页面，每个实例一张可折叠卡片
集中管理：Bot 配置、运营模式、签到积分、同步导入默认值、媒体库屏蔽、求片配置集中在实例卡片内

🔁 积分自动续费（全新）

自动续费：到期扫描支持积分自动续费，用户积分充足时自动扣积分续期
自动通知：续费成功自动通知用户

🔄 积分兑换续期

主动兑换：用户可通过 Bot 使用积分主动兑换续期天数

📱 Bot 命令菜单优化

动态菜单：命令菜单按用户身份动态显示，新增「网盘配置」「福利中心」子菜单
统一布局：所有菜单按钮统一两个一排布局

🛡️ 开服配置页面重构

统一卡片：注册配置合并为统一卡片，按实例分组展示

👤 用户管理增强

白名单标记：新增白名单标记字段（is_whitelist），与「永久」区分
新增字段：新增积分、最后签到、最后播放时间字段展示

🐛 Bug 修复

修复 115 API 返回空数组时 JSON 解析崩溃
修复邀请码兑换永久类型时通知文案错误
修复 /start 菜单点击帮助按钮卡死（UTF-8 截断问题）

v1.6.4.3

📅 2025-04-16

🔧 预缓存逻辑优化

播放让路机制：预缓存让路机制，实际播放时自动让路，避免阻塞播放
并发去重：自备秒传并发去重，修复详情页预缓存设备校验

📱 Bot 菜单与命令优化

设备合并：「我的设备」合并原「我的会话」，离线设备仅显示最近 3 个
独立命令：「访问线路」独立为 /status 一级命令

🎯 停止播放增强

主动终止：新增服务端主动终止编码方式

🤖 Bot 重载稳定性

延迟重载：重载时增加延迟避免 Telegram API Conflict
副 Bot 独立启停：新增副 Bot 独立启停 API

v1.6.4.2

📅 2025-04-15

🌐 TG 群组选择器优化

搜索选择器：TG 群组 ID 输入改为搜索选择器，支持按名称搜索群组

🛡️ 输入过滤增强

HTML 标签过滤：新增 HTML 标签过滤，防止 XSS 注入
异常路径拦截：网关异常路径拦截增强

v1.6.4.1

📅 2025-04-13

📱 移动端全面优化

卡片视图：所有管理页面新增移动端卡片视图，替代横向滚动表格
统一设计：统一卡片操作栏设计，搜索/筛选区域优化

📋 日志页面重构

移动端重构：移动端完全重构，分类标签始终可见

🌐 用户面板 UI 重构

卡片式布局：「我的媒体库」和「我的求片」页面改为卡片式布局

🔧 后端改进

Emby 用户和邀请码列表接口新增分页和全局统计

v1.6.4

📅 2025-04-11

🎬 求片系统（全新）

TMDB 搜索：Bot 和用户面板均支持 TMDB 搜索 → 确认 → 提交求片
管理后台：新增求片管理页面，支持完成/拒绝/通知用户

🎬 媒体库自助管理（全新）

自助切换：用户可在 Bot 和面板中自行切换指定媒体库的显示/隐藏
自动屏蔽：开号时自动屏蔽默认隐藏媒体库

🎯 签到与积分模式（全新）

签到积分：/checkin 每日签到获取随机积分，/points 查余额，/exchange 积分兑换
管理员操作：/score 手动调整积分，/low_activity 活跃度检测

🔐 安全码机制（全新）

安全码验证：/setcode 设置安全码，/delme 自删需验证，/changetg 换绑需验证

🔄 TG 换绑审批（全新）

审批机制：已绑定其他 TG 时创建审批请求，管理员一键批准/拒绝

🎉 /create 快捷开号增强

自动绑定：回复群内用户自动绑定 TG，密码私信发送
绑定链接：非回复模式自动生成 24h 绑定深链接

🤖 Bot 交互全面增强

新增命令：新增 /mydevices、/myfavorites、/online、/count、/leaderboard 等命令
菜单重构：/start 主菜单重构为多级内联键盘，/lookup 用户信息卡片带操作按钮

⚡ HDHive 解锁优化

限流适配：适配接口限流规则，多账号自动切换，限流后自动等待重试

💾 播放缓存与秒传优化

文件指纹复用：缓存新增文件指纹复用，减少 115 接口调用

🔧 其他改进

数据库新增多个索引，新增求片记录表和换绑审批表
前端新增求片管理、我的求片、我的媒体库页面

v1.6.3.2

📅 2025-04-09

🔗 ed2k/磁力链接解析增强

批量拆分修复：修复逗号拼接的批量 ed2k 链接无法正确拆分的问题
大小写兼容：ed2k/磁力链接大小写不敏感，扩展 AICH/分块哈希支持

🔐 注册功能改进

实例选择：多实例注册支持实例选择下拉菜单，切换时自动清空邀请码
模板用户校验：开放注册开关新增模板用户校验

🩹 登录页稳定性修复

重试机制：注册实例请求增加重试机制，修复 401 拦截器循环问题

v1.6.3.1

📅 2025-04-19

🎨 界面优化

活跃会话版本号：播放中的会话卡片现在显示客户端完整版本号（如 Infuse-Direct 7.8.1 · Apple TV），之前仅显示客户端名称
版本号跳转 Wiki：右上角版本号徽章点击后在新标签页打开 ResourceTool Wiki，方便快速查阅文档

v1.6.3

📅 2025-04-19

🐳 Emby 容器内存监控（全新）

自动内存监控：新增 Docker 容器内存自动监控功能，当 Emby 容器内存超过设定阈值且处于空闲状态时自动重启容器，解决 Emby 长期运行内存泄漏问题
两种部署模式：支持 Docker Socket（同设备）和 TCP（跨设备局域网）两种连接方式，适配本机、NAS、远程服务器等各种部署场景
智能繁忙检测：重启前自动检查计划任务、近期入库活动、活跃播放会话，繁忙时不重启，不会中断用户体验
冷却保护：容器重启后进入 10 分钟冷却期，防止内存尚未稳定时重复触发
TG 通知：重启成功或失败均推送 Telegram 通知，包含内存用量、持续时间等详情
前端配置：Emby 助手页面新增「容器监控」Tab，支持配置 Docker 地址、容器名称、内存阈值、持续时长，并提供连接测试

详细配置教程见 Emby 助手 → 容器监控配置

🌐 网关 IP 转发修复

修复 IP 显示：修复 Emby 仪表盘显示所有用户 IP 为 127.0.0.1 的问题。原因是网关为防止 CVE-2021-25827 漏洞删除了所有 X-Forwarded-For 头，但未将验证过的真实 IP 重新设置回去
安全转发：先清除客户端可伪造的代理头（安全防护不变），再由网关注入经过验证的真实客户端 IP
IPv4 优先：网关监听改为 0.0.0.0（仅 IPv4），避免本机访问时显示 ::1

Emby 侧配置

修复后还需要在 Emby 后台 → 网络 → 已知代理 中添加 RT 网关的内网 IP，Emby 才会读取转发的真实 IP。详见 Emby 助手 → 已知代理配置。

📱 设备流控精准度提升

三级设备标识：设备标识从纯 UA 升级为 DeviceId > UA + IP > 空标识三级优先级
解决同 UA 误判：同一用户在多台设备上安装相同版本 App 时，因 UA 完全一致导致被识别为同一设备的问题已解决
设备信息增强：在线设备信息新增 IP、DeviceId 字段，管理员可查看更详细的设备信息
踢出 API 兼容：踢出设备 API 同时支持新格式（key）和旧格式（ua），无缝升级

🔧 其他修复

数据库导入导出：修复新增的监控字段未包含在 migration 中，导致旧数据库导入时报 no column 错误
内存显示优化：测试 Docker 连接时区分显示实际内存（减去缓存）和原始用量，未设限制时显示「无限制」
计时边界修复：超阈值持续时间恰好等于设定时长时，因精度舍入多等一个检查周期的问题已修复

v1.6.2.1

📅 2025-04-19

🔒 Emby Bot 群组安全增强

群聊隐藏密码：管理员在群组中使用 /create 创建账号时，群内消息不再显示密码，避免凭据泄露
私信发送凭据：回复用户消息创建账号时，凭据通过 Bot 私信发送给该用户；未回复用户时生成绑定链接，用户点击绑定后自动获取凭据
个人信息展示密码：用户私聊 Bot 发送 /userinfo 时，个人信息中新增密码显示，方便用户随时查看

v1.6.2

📅 2025-04-19

⚡ 秒传任务深度优化

修复大目录文件丢失：修复目录超过 1000 个文件时部分文件被跳过的严重 bug，现已支持自动分页扫描
递归目录结构保留：秒传时自动识别并保留嵌套子目录结构，目标账号会创建完整的目录层级
性能大幅提升：文件去重检查、目标账号配置加载、115 API 鉴权等操作均改为批量处理或缓存复用，减少大量重复请求
sign_check 缓存：同一文件秒传给多个目标时，二次验证只需执行一次
通知计数修正：秒传完成通知的文件数现在只统计本轮实际处理的新文件
空目录自动清理：匹配但无文件的空目录不再滞留在监听目录，自动移入待整理

👥 Emby 用户批量设备数修改

批量设备数修改：用户多选工具栏新增「设备数」下拉菜单，支持批量修改选中用户的最大同时在线设备数
常用选项：提供 1 / 2 / 3 / 5 / 10 台、不限制、封禁等选项，一键批量操作

v1.6.1.4

📅 2025-04-17

🗑️ 修复前端更新延迟问题

移除浏览器离线缓存：之前每次更新后需要手动点击「立即更新」才能看到新界面，现在部署后刷新页面即可自动加载最新版本
自动清理旧缓存：已使用过旧版本的用户，首次打开新版时会自动清除残留的旧缓存，无需手动操作

v1.6.1.3

📅 2025-04-15

🛡️ Emby 用户识别优化

减少无效请求：当 Emby 中的用户已被删除时，系统会记住该结果 5 分钟，不再反复查询
减少重复告警：已知不存在的用户告警只在首次出现时记录，后续自动静默
自动恢复：5 分钟后自动重新检测，用户被重新创建后可正常识别

v1.6.1.2

📅 2025-04-13

⚡ 预缓存性能优化

详情页请求去重：Infuse 等客户端进入详情页时会发送大量并发请求，新增 2 秒窗口去重机制，同一条目只触发一次预缓存
移除高频日志：管理员和白名单用户的放行日志（高峰期每秒 50+ 条）已移除，减少日志噪音
内存自动清理：去重缓存每 5 分钟自动清理过期条目，防止内存泄漏

🛡️ 详情页预缓存策略增强

自备网盘用户：浏览详情页时使用个人 Cookie 触发预缓存，与播放路径保持一致
bypass302 用户自动跳过：不走 302 重定向的用户，详情页不再触发无意义的预缓存
设备超限用户跳过：设备数已达上限的用户跳过预缓存，避免浪费 115 API 调用

🎨 前端体验优化

弹窗防误关：编辑弹窗添加点击外部不关闭保护，防止误触丢失表单内容
移动端视口修复：修复移动端浏览器地址栏收缩时页面高度异常的问题

v1.6.1

📅 2025-04-10

⚡ 播放快速路径（全新）

播放请求节流器：同一用户短时间内对同一视频的重复请求直接返回缓存结果，大幅降低响应延迟
异常频率保护：60 秒内同一视频+IP 请求超过 20 次自动限流，返回 429 状态码

🔗 分享播放重构

分享直链模式：副号直接获取分享直链，无需先秒传再取直链，减少 API 调用
多副号随机轮询：配置多个分享副号时自动随机选择，单个失败自动尝试下一个
分享文件自动清理：副号接收的文件在缓存过期后自动删除，避免空间占用增长
秒传回退携带直链：秒传全部失败时复用已获取的分享直链，避免重复请求

📦 源文件信息缓存

元数据缓存（5 分钟）：多个用户播放同一视频时，源文件信息只需查询一次，覆盖秒传、自备网盘、Pickcode 三条播放路径

🎬 HDHive ed2k 资源支持

ed2k 网盘类型支持：HDHive ed2k 资源自动解锁并发布到 Telegraph 页面
Telegraph 自动集成：自动创建账号和管理 token，失效时自动重建

📥 批量离线下载

批量离线 API：多条 ed2k / magnet 链接一次提交，无需逐条等待 4 秒间隔
自动切换：2 条及以上自动使用批量 API，单条走原有逻辑
失败回退：批量失败时自动回退到逐条提交，确保兼容性

📊 转存通知增强

资源名称始终显示：移除「链接数 ≤ 3 才显示资源名」的限制
番号提取：自动从消息中提取番号信息并在通知中展示
Telegraph 标题清洗：通知中显示干净的资源名称
隐藏链接提取：修复转存监控未提取藏在可点击文字后的链接的问题

🩺 Emby 用户策略同步优化

禁用/启用不覆盖权限：先读取用户完整权限策略，仅修改禁用状态再写回，不再覆盖其他权限设置
已有用户不触碰权限：同步用户时仅对新建用户设置权限
Bot 启动重试：网络瞬时故障时最多重试 3 次

🔑 自备网盘配置同步

Cookie 双向同步：用户面板修改 Cookie 时自动同步到关联的 115 配置
自动清理：清空 Cookie 时自动删除关联配置并解除绑定
缓存路径和回收站密码同步：修改时同步更新到关联配置

🧹 其他

移除 Gimy 配置页面和 Jumi 搜索/记录页面
回收站密码输入框新增显示/隐藏切换按钮
用户解析失败时记录完整尝试链路，便于排查问题

v1.6.0

📅 2025-04-01

🛡️ 设备流控系统（全新）

设备在线数量限制：可限制每个用户同时使用的客户端数量，防止账号共享滥用
精准流控：仅作用于登录认证、播放信息获取、视频播放三个关键环节，浏览媒体库、加载海报等日常操作不受影响
双层超时机制：设备空闲 5 分钟即可被新设备替换；完全无活动 30 分钟后自动移除
平滑过渡：不会立即中断多设备用户的播放，下次播放时自动清理最久未使用的多余设备
管理员豁免：管理员账号不受设备流控约束
灵活配置：支持全局默认设备数上限，也可为每个用户单独覆盖（设为 0 表示不限制）
活跃设备管理页：管理员可实时查看所有用户的在线设备信息，并支持手动踢出指定设备
预缓存联动：被设备流控拦截的用户不会触发预缓存，避免浪费 115 接口额度
新用户继承：新建或同步的用户自动继承全局默认设备上限

独立配置管理：自备网盘用户的 115 Cookie 改为独立的账号配置管理，与内置 115 账号采用相同的管理方式
自动数据迁移：升级后首次启动自动创建独立配置并建立关联，无需手动操作
旧数据清理：迁移完成后自动清除旧 Cookie 字段
兼容播放：优先读取独立配置中的 Cookie，同时兼容未迁移的旧数据

修复误报过期：115 服务器暂时无法连接时，不再错误地标记 Cookie 已过期
共用 Cookie 检测合并：同一份 Cookie 被多个用户共用时，检测一次即同步给所有关联用户
去除重复提醒：已迁移用户自动跳过旧检测流程

📺 预缓存增强

版本数限制：预缓存最多处理前 2 个清晰度版本，避免大量版本导致 115 接口调用过多
快速浏览检测统一：电影、剧集、季详情共用同一个频率检测窗口
单集冷却机制：已触发过预缓存的剧集不会重复触发

🎨 界面优化

115 配置页面重构：从平铺卡片列表改为弹窗编辑模式，「清理助手」功能合并到配置弹窗中
用户管理界面优化：编辑弹窗重新布局，所有字段新增详细描述，统一表单样式
用户列表排序优化：按 Emby 实例分组，管理员排前

🧹 其他

移除用户级秒传分流规则功能
修复安全防护页面「默认设备数上限」保存不生效的问题
被封禁用户在请求播放信息时即被拦截
删除 115 账号配置时，确认弹窗显示配置名称

v1.5.8

📅 2025-03-20

🔐 Emby 访问线路隐藏功能

线路隐藏选项：可隐藏特定访问线路
永久用户可见：隐藏线路可设置为对永久用户可见
自动过滤：用户面板根据用户类型自动过滤可见线路
管理开关：线路管理页面新增「隐藏」和「永久可见」开关

🔑 115 加密兼容性增强

更新 115 加密公钥，适配最新算法
保留旧公钥备用，确保向后兼容
解密时自动尝试新旧两个公钥

⚡ 播放服务优化

新增成功预加载缓存，避免重复请求 115 API
分享播放日志增强，区分秒传和转存来源
秒传服务重试逻辑优化，提升稳定性

v1.5.7

📅 2025-03-10

🔧 115 离线下载优化

修复部分磁力、ed2k 链接离线添加失败的问题
适配新的离线处理方式，提升成功率

🎬 剧迷功能调整

移除剧迷浏览、搜索和详情页
保留剧迷 TG 配置和派发相关功能

🔗 Pickcode 模式增强

新增支持 ?pickcode=abc/filename.mkv 链接格式

🌐 面板访问稳定性优化

关闭 Caddy 默认管理端口，减少端口冲突导致的重启问题

v1.5.6

📅 2025-03-01

🔐 分享播放与秒传增强

sign_check 支持：分享秒传新增二次验证支持
三级兜底：自备模式下，分享资源支持「分享秒传 → 分享转存 → 分享直链」三级兜底
修复分享播放缓存命中后可能使用错误 Cookie 的问题
修复分享资源刷新时丢失秒传/转存链路的问题

📑 日志增强

新增分享解析、目标覆盖、秒传目标、转存状态等关键日志
便于排查分享播放问题

✅ 稳定性补充

新增分享秒传/转存相关测试用例，降低回归风险