跳至主要内容

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 週期（即 Today 等）的數據時，匯出的數字代表該時間段內累計獲得的積分，而非當前餘額。

常见问题​

  • 問：All 和其他週期選項有什麼區別？

    答：All 匯出成員目前的積分餘額。其他週期（例如，This Month，7-Day）匯出成員在該時間段內累積獲得的積分總額。

  • 問：如果我設定了 limit，但有積分的成員數量不足怎麼辦？

    答：匯出的檔案將只包含所有有積分的成員，不會創建空的條目。

  • 問：我可以匯出單一成員的資料嗎？

    答：此指令匯出伺服器範圍的資料。要查看單一成員的積分，請使用相應的成員特定指令（例如：/profile）。