SuperAPI AI 工具集

presence

通用与其它

查看项目

更新于 10-15 19:55

技能介绍

Presence 是 cloddsbot 项目中的在线状态与活动追踪模块,用于管理用户在线状态、记录跨设备活动并同步状态信息。

用途:为聊天或协作场景提供用户在线状态展示、活动追踪和多设备状态同步。

主要能力:支持 online、away、dnd、offline 四种状态,以及自定义状态文本;可记录活动事件(如消息、频道、时间戳)并查询近期活动;可查看用户已连接设备、设置单设备状态、强制同步;提供 statusChange、online、offline 等事件回调;支持按空闲时间自动切换为 away 或 offline。

使用方式:聊天命令包括 /presence 查看状态、/presence who 查看在线者、/presence activity 查看近期活动、/presence online|away|dnd|offline 设置状态、/presence status "In a meeting" 设置自定义状态、/presence devices 查看设备、/presence sync 强制同步。TypeScript 侧通过 import { createPresenceService } from 'clodds/presence' 创建服务,可配置 heartbeatIntervalMs、awayAfterMs、storage('redis' | 'memory')与 redisUrl;随后可调用 getStatus、getStatuses、setStatus、setCustomStatus、clearCustomStatus、recordActivity、getActivity、getDevices、setDeviceStatus、getOnlineUsers、sync、getSyncStatus 等方法,并监听事件。

适用场景:需要展示成员在线状态、追踪活跃度、在多设备间保持一致状态的应用。

限制:资料未提供具体部署要求、性能指标、收费信息或平台兼容性说明;存储仅列出 redis 与 memory 两种选项。