跳到主要内容

points export - 导出服务器成员积分

命令名称

/points export

描述

此命令允许您将 Discord 服务器的成员积分数据导出为 CSV 文件,用于跟踪、统计、排行榜管理和奖励发放。您可以指定积分的时间周期、设置自定义日期范围、限制导出成员的数量,以及选择性地包含特定的钱包类型。

用法

/points export [period] [date_range] [limit] [wallet]

参数

可选参数:

  • [period]:积分数据的统计时间范围。
    • All:导出成员的当前积分余额(默认)。
    • Today, This Week, This Month, 7-Day, 30-Day:导出在该特定周期内累计获得的积分总数。
    • Custom:允许您使用 [date_range] 参数定义一个特定的日期范围。
  • [date_range]:设置自定义的日期范围(例如:2025-01-01,2025-12-31)。
    • 仅在 [period] 设置为 Custom 时需要填写。
  • [limit]:导出的成员数量上限。
    • 默认值为 0,表示导出所有当前积分余额大于 0 的成员。
  • [wallet]:选择要包含在导出数据中的特定钱包类型。
    • None:不包含钱包数据(默认)。
    • BTC, ETH, SOL:包含与每位成员关联的所选钱包地址。

示例

  • 示例 1:导出所有成员的当前积分余额为 CSV 文件。

    /points export
  • 示例 2:导出过去 7 天内获得积分最多的前 100 名成员。

    /points export period:7-Day limit:100
  • 示例 3:导出自定义日期范围内所有成员获得的积分,并包含其关联的 BTC 钱包信息。

    /points export period:Custom date_range:2025-07-01,2025-07-31 wallet:BTC

注意事项

  • 此功能仅限于 ULTIMATE 订阅等级。
  • 导出的文件格式为 CSV 文件(逗号分隔值)。
  • 如果 period 设置为 Custom,您必须在 date_range 参数中提供有效的起始和结束日期(格式为 YYYY-MM-DD)。
  • 导出非 All 周期的数据时,导出的数字代表该时间段内累计获得的积分,而非当前余额。

常见问题

  • 问:All 和其他周期选项有什么区别?

    答:All 导出成员当前的积分余额。其他周期(例如,This Month7-Day)导出成员在该时间段内累计获得的积分总额。

  • 问:如果我设置了 limit,但有积分的成员数量不足怎么办?

    答:导出的文件将只包含所有有积分的成员,不会创建空的条目。

  • 问:我可以导出单个成员的数据吗?

    答:此命令导出服务器范围的数据。要查看单个成员的积分,请使用相应的成员特定命令(例如:/profile)。