For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /reward/records.md.

打赏记录与确认

适用版本 1.0.0 | 后台路径:内容 → 打赏

静态收款码无法自动获知付款是否完成,所以插件默认把访客提交的记录存为「待确认」,由站长对照收款通知后决定是否上墙。爱发电订单由平台确认收款,走另一条链路。

状态

状态来源是否上墙
待确认前台提交(未开启自动通过)、爱发电订单(未开启自动确认)否
已确认站长手动确认、或开启了自动通过 / 自动确认是
已拒绝站长手动拒绝否

「已确认」的记录才会出现在赞助者墙与统计里;拒绝的多为无法核对到账的提交,不会删除原始数据。

确认流程

  1. 访客扫码打赏后,在页面里填写并提交打赏信息
  2. 记录进入「内容 → 打赏」,状态为待确认
  3. 对照微信 / 支付宝账单核对金额与单号(建议开启「要求填写交易单号」)
  4. 在列表里确认或拒绝;确认后立即出现在赞助者墙
  5. 也可以在设置里开启「提交后自动通过」,跳过人工确认

后台记录页

能力说明
搜索关键词匹配昵称、留言与交易单号
状态筛选待确认 / 已确认 / 已拒绝
批量操作批量确认、批量拒绝、批量删除
编辑点击列表行修改昵称、金额、留言、打赏时间等字段
手动新增补录线下收到的打赏;打赏时间可指定
导出按当前筛选导出 CSV,单次最多 20000 条
待办提示有新的待确认记录时,页面顶部显示提示卡片

CSV 首列为打赏时间(未填写时取记录入库时间,服务器时区);以 = + - @ 开头的内容会加前缀转义,避免被表格软件当成公式执行。

前台表单字段

字段必填说明
打赏金额是大于 0,最多两位小数
打赏方式否微信 / 支付宝,默认微信
昵称是最长 30,展示在赞助者墙
联系方式否最长 100,仅后台可见
交易单号按开关开启「要求填写交易单号」后显示且必填,最长 64
头像链接按开关开启「允许访客填写头像地址」后显示,仅接受 http(s) 或站内路径
留言按开关开启「允许填写留言」后显示,最长 200
验证码按开关开启「提交时校验图形验证码」后显示
  • 打赏时间由服务端写入,不接受访客指定,避免伪造历史日期;补录历史打赏请走后台新增
  • 提交接口每 IP 10 分钟 5 次,验证码每 IP 1 分钟 10 张,超出会提示「提交过于频繁」
  • 验证码 5 分钟过期、一次性使用、不区分大小写

权限

角色权限可做的事
打赏记录查看浏览列表与详情、导出前的筛选查看
打赏记录管理新增、编辑、确认、拒绝、删除、同步爱发电、导出 CSV

只有「查看」权限的账号不能改动记录,适合只读对账的协作者。

推荐配法

人工确认(默认):开启交易单号与验证码,关闭自动通过。每条记录都能与账单对应,适合大多数站点。

小额快速上墙:开启自动通过、关闭交易单号与头像,保留验证码与留言。省去每天确认的操作,但需要接受少量无效记录。

只做对账:开启交易单号与联系方式,关闭留言与赞助者墙。记录只作为收款台账,不对外展示。

注意事项

  • 待确认记录不会出现在赞助者墙,也不会计入前台统计
  • 开启「提交后自动通过」后,访客提交即上墙,无法先审核;遇到刷屏可临时关闭提交开关
  • 删除记录不可恢复,批量删除前建议先导出 CSV
  • 头像地址由访客填写,浏览器会直接请求该地址;对隐私敏感时保持该开关关闭
  • 插件不采集访客 IP,限流只在内存中按来源 IP 做短时计数,重启即失效;站点在 CDN / 反向代理之后时,请确认代理正确透传 X-Forwarded-For