付费|Paid HuoNiu Credits System - 积分系统 2.5.3

本次更新对事件系统进行了大规模精简，移除了16个浪费服务器性能的废弃事件，并清理了相关代码，同时改进了UI显示和语言包：

移除16个废弃事件：​

1. thread_view - 浏览主题
2. thread_view_receive - 主题被他人浏览
3. daily_clock - 每日签到
4. soft_post_delete - 软删除回帖
5. soft_thread_delete - 软删除主题
6. post_unlike - 取消点赞回帖
7. follower_receive - 被他人关注
8. thread_reply_receive - 主题收到新回复
9. post_like - 点赞回帖
10. follow - 关注用户
11. avatar_upload - 上传头像
12. attachment_delete - 删除附件
13. birthday - 生日奖励
14. attachment_upload - 上传附件
15. attachment_download - 下载附件
16. attachment_download_receive - 附件被他人下载

移除事件的影响：​

• 减少积分写入压力：这些事件频繁触发，移除后减少了不必要的积分操作，尤其是在活跃的论坛环境中。
• 提升响应速度：减少数据库写入操作，提高了高并发场景下的整体性能。

事件列表 UI 改进：​

• 金额列展示状态：
  1. type = rand：直接显示随机范围（最小值 ~ 最大值）。
  2. amount = 0：显示灰色「未设置」提示，隐藏不必要的输入框。
  3. 正常金额：去除多余的小数显示，简化了界面。

清理移除8个不再使用的文件包括：​

• src/addons/HuoNiu/Credits/XF/Entity/UserFollow.php
• src/addons/HuoNiu/Credits/Entity/Attachment.php
• src/addons/HuoNiu/Credits/Cron/DailyClock.php
• src/addons/HuoNiu/Credits/Cron/ClockInEveryDay.php
• src/addons/HuoNiu/Credits/Event/Attachment.php
• src/addons/HuoNiu/Credits/Cron/Birthday.php
• src/addons/HuoNiu/Credits/XF/Repository/Attachment.php
• src/addons/HuoNiu/Credits/XF/Service/Attachment/Preparer.php

注意：以上文件已经不在需要，登陆服务器手动处理删除，全新安装无此影响！

语言包更新：​

• 删除了与废弃事件相关的所有词条，精简了语言包体积约5%。
• 新增词条：hn_not_set（未设置 / Not set），便于标记未配置的事件。

完成插件升级安装后，进入插件列表选项，积分插件选项设置-运行重建数据即可。

1. 新增作者批量设置资源折扣功能，可按分类筛选并批量应用限时优惠。
2. 在资源页面工具菜单中新增“批量设置折扣”入口，操作更便捷。
3. 批量优惠页面已改为 XenForo / XFRM 标准资源列表样式，显示更统一。
4. 优化资源勾选逻辑，默认不勾选，支持“应用到以上所有资源”联动选择。
5. 优化积分价格显示，单位仅显示一次，并跟随后台货币设置。
6. 修复批量优惠页面模板安装报错及列表布局异常问题。
7. 修复免费模式下的 鼓励下载者参与贡献 显示逻辑。
8. 修复批量优惠语言键值显示原键值问题。

PHP 兼容性更新

本次版本主要围绕稳定性、安全性和团购流程体验进行了全面优化，重点修复了一批可能影响支付、授权、团购状态和后台操作准确性的问题。

安全与稳定性优化​

• 强化了多项敏感操作的安全校验，减少异常请求和误操作带来的风险
• 优化了插件整体稳定性，降低部分边界情况下出现数据异常的概率
• 提升了后台与前台在权限判断上的一致性，避免“前端限制了、后端没拦住”的情况

团购功能优化​

• 修复了部分团购状态显示和识别不准确的问题
• 优化了团购完成、取消、重新发起等流程，逻辑更加稳定
• 修复了部分情况下团购结束后无法继续发起新团购的问题
• 优化了团购参与人数、目标达成、失败状态等判断逻辑
• 提升了团购在多人同时操作时的稳定性，减少重复处理和状态异常

支付与授权优化​

• 优化了积分支付流程，减少重复提交、重复扣费等异常情况
• 支付失败或流程异常时，处理逻辑更加安全，避免出现授权与扣费不一致
• 优化了资源购买后的授权判断，特殊情况下的下载限制更加准确
• 提升了购买、退款、授权变更等环节的一致性

资源与后台管理优化​

• 修复了部分资源编辑时设置项保存不准确的问题
• 优化了资源付款类型、团购参数、更新上传等相关操作体验
• 后台处理资源、团购、提现等功能时，提示和限制更加明确
• 补强了部分参数校验，减少错误配置对实际使用造成的影响

定时任务与系统维护优化​

• 优化了定时任务执行逻辑，减少过期、清理、状态检查类任务的误处理
• 修复了部分情况下统计或状态更新不准确的问题
• 提升了插件升级后旧数据的兼容与修正能力，减少历史数据遗留带来的问题

总结​

2.5.1 是一次以“稳定上线、降低风险、修复流程问题”为核心的维护升级版本。
如果你正在使用资源付费、团购解锁、积分支付、提现或自动任务相关功能，建议尽快更新到此版本。

新功能：

• 团购（Group Buy）系统：资源作者可针对付费资源发起团购活动，设置目标参与人数、每人价格、活动截止日期与最大人数上限
• 团购进度展示：资源页面内嵌团购进度块，实时显示当前参与人数、进度百分比、每人价格与距截止日期的倒计时
• 多货币团购定价：每个团购活动可为不同货币设置独立单人价格（如 CNY 35.00 / USD 5.00）；用户根据当前语言/货币偏好自动显示对应价格与支付渠道（中文界面显示人民币/支付宝，英文界面显示美元/PayPal）
• 团购状态自动流转：达到目标人数后状态自动升级为"已凑齐"；截止日期到达时若已凑齐可配置自动完成，自动为所有付款成员授权资源访问权限
• 未凑齐自动失败退款：截止日期到达时人数不足，活动自动关闭，所有已付款成员费用原路退还
• 自动延期：后台可配置截止未凑齐时自动顺延天数及最大延期次数，避免活动因参与节奏慢而意外失败
• 后台分类控制：资源分类可单独开启或关闭团购功能，与现有积分/法币销售模式独立共存

本次所有更新项目​

1. 已吊销状态标签改用内联灰色背景（#888 白字），原样式类无可见背景色
2. 其他未知状态标签从灰色样式类改为无背景纯文本，避免与已吊销混淆
3. 提现记录 ID 链接移除弹出层属性，改为直接跳转详情页
4. 提现标签页计数改用全局统计数据，修复切换标签后计数随筛选条件变化的 bug
5. 支付网关充值 balance_before/balance_after = 0：在队列事务时补全缺失的货币列名，根因为 XF Entity toArray() 不包含 getter 属性
6. 货币列名前缀错误：回退前缀从错误的 credits_ 修正为正确的 hn_

更新修复

资源发布表单：

积分分类中仍显示"免费"支付选项**：后台分类的"文件销售模式"设置为"虚拟货币"时，发布页面支付类型中依然显示"免费"选项。根本原因：`hn_category_add_resource` 模板中免费选项未做条件过滤，无论分类模式如何均始终渲染。修复后仅当 `hn_payment_mode` 为空（自动）或 `free` 时才显示"免费"选项。

资源发布表单：

选择"外部购买"类型时支付选项未隐藏**：用户选择"外部购买"后，支付类型（积分/金币）区块仍保持可见，导致积分价格与外部购买价格同时存入数据库并在列表/详情页同时显示两套价格。修复后切换至"外部购买"时，整个支付类型区块及有效期、库存等付费专属字段自动隐藏，并同步清空所有积分和金额输入框，避免脏数据写入。

资源发布表单：

切换至"外部购买"后"鼓励下载者贡献"选项未隐藏**：先选"免费"使鼓励下载贡献区块显示，再切换到"外部购买"时该区块残留可见。修复后 `hnSyncResourceType()` 主动隐藏 `.js-hn-free-contributor`，覆盖此场景。

资源发布表单（新增模式）：

JS 初始化时序问题**：`hn_category_add_resource` 模板插入位置在 `resource_type` radio 之前，IIFE 即时执行时 DOM 中尚无类型选择器，导致初始 sync 失效（已选"外部购买"时字段未自动隐藏）。修复后改用 `DOMContentLoaded` 确保整个 DOM 就绪后再执行初始化，编辑表单（`readyState` 已为 `interactive/complete`）同样兼容。

修复

已购买资源列表状态不更新：
购买过期后，"已购买的资源"列表仍显示"已购买"而非"已过期"。修复后优先调用 `isExpired()` 判断，状态显示改为实时计算。

已购买资源列表过期状态标签样式：
修复列表中状态标签颜色，过期显示红色、有效显示绿色、其他（撤销/退款）显示灰色。

数据迁移后购买通知串连：
迁移数据后，购买通知发送给错误的作者，并显示错误的资源名称。修复后改用 `purchase_id`。

积分排行榜所有用户积分总值显示为"1"：
修复后改用单次 SQL 聚合查询，返回正确的 `[user_id => value]` 格式。

积分交易排行榜同上问题：
`getTotalTransactions()` 存在相同的返回格式错误及 N+1 查询问题，一并修复。

1. 新增分类付款模式（自动/免费/积分/真实货币/混合）
2. 移除冗余的"允许贡献者检查分类"选项
3. 事件编辑器"适用分类"字段增加说明文字
4. 修复"要求贡献资源"勾选后数量输入框不显示的问题
5. 新增购买须知/免责声明，后台可配置，支持明暗主题

修复

- 提现管理 - 标记完成弹窗缺少转账单号输入框（无法提交）
- 提现页面 - 最低金额提示缺少货币单位
- 修复多货币资源销售的金币记账不一致问题（无论买家用哪种货币支付，卖家金币始终以基准货币定价为准）
- 修复购买积分页面 PayPal / 支付宝的货币转换提示计算错误，避免对已换算金额重复换算
- 修复提现页面 PayPal 预计到账提示与实际提现金额计算不一致的问题
- 修复提现页面 PayPal 货币转换提示文案，提现场景下改为显示“获得 USD”而非“支付 USD”
- 修复提现页面“预计获得”预览，PayPal 收款时同步显示 USD 副值
- 修复提现页面 PayPal 预览显示不稳定的问题

新功能

- 提现页面 - 收款方式从硬编码"支付宝"改为后台可配置
- 后台新增设置：可用收款方式（支付宝 / 微信 / PayPal / 银行转账 多选）
- 后台新增设置：金币锚定/记账基准货币（默认 CNY，ISO 4217 标准下拉列表），金币收益与该货币按 1:1 结算
- 后台新增设置：提现 PayPal 汇率（锚定货币→USD），与支付页购买汇率完全独立
- 提现流程 - 移除独立“金币兑换汇率”设置，避免重复换算导致逻辑臃肿
- 提现页面 - 选择 PayPal 收款时实时显示预计 USD 到账金额
- 提现页面 - PayPal 汇率提示改为独立提示块，并抽离为可翻译 phrase
- 提现页面 - 新增提现预览 AJAX 接口，统一返回手续费、实际到账金额与 PayPal USD 参考值
- 提现管理 - 查看页与确认完成弹窗均显示 PayPal USD 打款参考金额，方便管理员操作
- 用户提现详情页 - 新增 PayPal USD 打款金额显示