文档

快速上手

comcom analytics 是一款免费的分析仪表板，可自动统计 Discord 服务器的消息、表情回应、语音和成员动态，将社区的成长与活跃度可视化。只需三步即可完成接入。

访问 analytics.comcom.app，使用 Discord 登录。
将 Bot 添加到你拥有“管理服务器”权限的服务器。
从接入时起自动开始统计，数据会反映到仪表板。

仅统计接入之后产生的数据，无法回溯获取历史数据，建议尽早接入。

自定义

排除 Bot 数据

可以将其他 Bot 的发言作为噪音排除。在设置页面把 Bot 消息从统计对象中移除后，即可只查看真人成员的活动。

筛选频道

可以选择要分析的文字/语音频道。排除管理用频道或日志频道，让数据更贴近社区的真实情况。

查看者（viewer）管理

可以指定与哪些成员共享仪表板。也可以向非管理员的运营成员授予只读权限。

仪表板使用指南

通过左侧导航可以查看社区的各个方面。每个页面附带截图的详细说明请参阅 /product。

页面	内容
概要	整体趋势、每周 AI 摘要、成员构成一览。
频道	文字/语音频道的排行与走势。
身份组	各身份组的成员数与活跃度。
成员	成员的个人活动历史与卡片展示。
对比	通过匿名相对指标查看你的服务器在同类别服务器中成员数和活跃度所处的位置（需设置类别标签）。
流入	新加入/退出的走势，以及各邀请链接的流入排行。
统计信息	消息、表情回应、语音的时间序列，以及频道散点图。
行为日志	搜索并查看表情回应、语音的单条日志。

如果你运营多个服务器，可在概要、频道、身份组、成员各页面右上角同时显示 2 个以上的服务器（仅限管理员且所有服务器均为 Pro 方案）。

Discord 命令

所有功能都可以通过 Discord 中的 /comcom 命令（子命令）调用。部分子命令可能因环境而异。

命令	内容
/comcom member <user>	成员分析卡片。可在动画 LV/EXP HUD ⇄ 详细仪表板之间切换。
/comcom channels	服务器概要仪表板 ⇄ 频道排行（按消息/按语音）。
/comcom leaderboard	服务器 EXP 排行榜 + 你的排名。
/comcom heatmap	活动热力图（星期×时段，消息+语音）。
/comcom room	像素风“房间”GIF + 按钮导航。
/comcom poll	创建社区投票（问题/选项/期限/多选）。
/comcom help	显示全部命令列表。
/comcom slot	随机抽选一名成员的 GIF 演出（无奖品）。

EXP / 等级 / 排名机制

EXP 是根据已记录活动计算的累计值，只会增加（不会减少）。

dailyEXP = min(messages,100)·1 + max(0,messages-100)·0.25   // soft cap
         + min(voiceMinutes,240)·0.5                     // 4h/day cap
         + reactionsGiven·0.5 + reactionsReceived·1 + mentionsReceived·1

EXP   = Σ dailyEXP  (all recorded days, only grows)
Level = floor( sqrt(EXP / 50) )

等级对应称号：Newcomer(0–4) → Regular(5–11) → Active(12–21) → Veteran(22–34) → Elite(35–49) → Legend(50+)。全期间的 EXP、等级、排名每晚通过批处理更新。

使用准则

运营小贴士

语音活动自接入后开始累积。全期间排名会在批处理更新后显示。
综合查看消息、语音、表情回应，可以发现发言不多但贡献很大的成员。
利用热力图掌握活跃时段，优化活动和公告的发布时机。

隐私

成员卡片仅限本人查看自己，或拥有“管理服务器”权限的管理员执行。按钮操作仅限执行者本人。个人邮箱等个人信息（PII）无论在仪表板还是 API/MCP 中都绝不会公开。

数据解读

数值基于接入之后的真实数据。全期间 EXP、排名、全期间语音由夜间统计（precompute）更新，因此接入初期部分数据可能显示为“等待统计”。

常见问题

可以免费使用吗？

可以。基础仪表板和命令完全免费。付费方案（Pro）按服务器规模计费，可使用 API/MCP 访问等附加功能。

可以获取历史数据吗？

不可以。统计从 Bot 接入时开始，无法回溯获取过去的数据。

命令没有显示。

全局命令的生效可能需要几分钟。用 Ctrl/Cmd+R 重新加载 Discord 可清除缓存。

移除 Bot 后数据会怎样？

移除 Bot 后将无法访问仪表板。重新接入后，移除期间的数据不会被记录，统计从重新接入时起恢复。

可以对比多个服务器，或与其他服务器做基准比较吗？

可以。自己运营的多个服务器可在概要等页面右上角合并显示（仅限管理员且所有服务器为 Pro）；与其他服务器的比较，只需设置类别标签，即可在“对比”页面以匿名相对指标查看。单个服务器名称和成员信息绝不会向其他运营者公开。

故障排查

接入初期数据为空或很少

统计从 Bot 接入时开始，因此接入初期可显示的数据较少属于正常现象。经过几天到一周左右的日常活动积累后，数值会趋于稳定。

只有语音数据比其他指标滞后

部分语音相关统计由夜间批处理完成，因此与消息、表情回应相比，反映可能滞后最多几天。随着时间推移会自动补齐。

成员卡片无法执行、按钮没有反应

成员卡片仅限本人查看自己的卡片，或拥有“管理服务器”权限的管理员执行。按钮操作也仅限执行命令的本人，其他成员点击不会有反应。

出现权限不足的错误

添加 Bot 或更改设置需要 Discord 服务器端的“管理服务器”权限。确认权限后仍未解决时，请重新加载仪表板以刷新缓存的权限信息。