Discord 服务器数据分析机器人会把原始的成员加入、工单开启和发票付款记录，转化为一份一眼就能看懂的报告，既可以是 Discord 嵌入消息，也可以是网页仪表盘。Noxyr 通过两条斜杠命令 /status 和 /sales、仪表盘的概览页面，以及一个只读的服务器 API（可将相同数据提供给你自己的网站）来实现这一功能。本指南介绍每一项具体显示的内容。
/status：成员、工单与社区统计
/status 是仅限管理员使用的命令，共有五种视图：all、invite、sales、tickets 和 community。每个视图都接受 days 选项（7、14 或 30，默认 30），并返回附带折线图的嵌入消息，因此既可用于快速查看数字，也可用于查看趋势。
- /status invite：今天、最近 7 天以及所选时间段内的加入和离开人数，以净变化的形式显示，下方附带原始的增减人数。
- /status tickets：已开启的工单数、已关闭的工单数，以及当前仍未关闭的数量。这是 Discord 管理员最常需要的工单分析：工单是否在不断堆积，还是团队跟得上进度。
- /status sales：发票数量和总金额。总额是简单求和，而不是货币换算，因为发票可能以多种货币开具，若要换算就需要猜测汇率。
- /status community：评价数量和消息数量，用于了解一般活跃度，而非支持或收入情况。
- /status all：将以上所有字段汇总在一个嵌入消息中，适合周一早上的摘要。
图表在服务器端绘制，并以图片形式附加。如果图表渲染因任何原因失败，命令仍会以文字形式回复数字，而不会直接报错。成员和消息数量只会从 Noxyr 加入服务器当天开始统计，因此上个月才添加的机器人不会显示数年的历史数据。
/sales：收入、主要买家与报告样式
/sales 提供 Discord 机器人除单一总额之外所需的销售统计。它有三个子命令，均仅限管理员使用，且都可以私密回复，或通过 post 选项发布到频道中。
- /sales report：该时段的收入、已付款订单数、售出件数、发票数量、按状态（成功、待处理、失败）和按付款方式的细分，以及热销商品。时段选项包括最近 7 天、最近 30 天、最近 90 天或全部时间。
- /sales top：买家排行榜，可按订单数量或消费金额排序，并可按货币筛选，最多显示 25 位买家。
- /sales style：设置嵌入颜色、横幅和缩略图、报告与排行榜的自定义标题、页脚文字、默认排行榜人数、是否在提及旁显示买家名称，以及哪些发票状态计入收入。若将三种状态全部关闭，则会被拒绝，因为一份从不将任何内容计为收入的报告对任何人都没有用处。
这两条命令在运行前都会检查“管理员”权限或已设置的管理员身份组，与仪表盘所使用的管理员限制相同。
仪表盘概览显示的内容
仪表盘的概览页面与 /status 并不是同一份报告。它是你进入服务器时首先看到的页面，概括了店铺和支持两方面的情况：分类数、商品数和有效优惠码数量、发票总数、评价总数、最近的五张发票和最近的五条评价，以及一份设置清单，列出你已开启但尚未完成配置的功能。/status 和 /sales 是你在 Discord 中按需拉取的某一时间点报告，而概览则是始终保持最新的摘要，你无需在对话中途离开键盘，就能在浏览器中随时查看。
从你自己的网站读取相同数据：服务器 API
如果你希望在自己的网站、状态页面或电子表格中显示 Discord 服务器的统计数据，服务器 API 就是桥梁。它是只读的，仅限单个服务器，并以 JSON 格式返回 /status 和仪表盘已经追踪的相同数据：
- GET /api/v1/server：名称、图标、成员人数、在线人数、助推数。
- GET /api/v1/tickets：总数、未关闭和已关闭的数量、7 天和 30 天的工单量、平均评分。
- GET /api/v1/activity?days=30：每日消息数、加入和离开人数，最多可回溯 90 天。
- GET /api/v1/invoices：发票数量，以及按货币和状态划分的收入。
- GET /api/v1/reviews：平均评分、星级分布，以及最新的公开评价。
- GET /api/v1/giveaways：进行中和已结束的抽奖数量，以及参与总数。
在仪表盘的服务器 API 页面生成密钥，并将其作为 Bearer 令牌发送。每个端点都有各自的权限范围，因此你可以共享一个仅能读取工单的密钥，而不暴露发票数据。密钥的请求上限为每分钟 60 次，这已经绰绰有余，因为工单和销售总额无需以超过每分钟一次的频率轮询。
常见问题
要查看数据分析，是否需要使用 API？不需要。/status 和 /sales 无需任何设置即可使用，仪表盘概览页面只需要登录。API 是用于将数据拉取到 Discord 之外的场景。
/status 需要付费吗？不需要。Noxyr 没有付费层级，因此每个服务器都可以使用 /status 和 /sales 的所有视图。
成员可以看到这些统计数据吗？这两条命令都需要“管理员”权限或已设置的管理员身份组，因此普通成员无法运行它们。
为什么销售总额不做货币换算？发票可以用 USD、INR、EUR 或 GBP 开具，报告会对你实际销售所用的各种货币分别求和，而不会自行编造汇率。
完整的命令列表请见 /commands；若想比较在 Discord 中运行与在仪表盘中操作的差异，请参阅仪表盘与命令对比。免费添加 Noxyr，即可在同一个机器人中使用数据分析、工单和店铺功能。