mcpField
P
pubnub-presence

pubnub-presence

github.com/pubnub开发658 次安装7 周前更新
代码仓库

关于 pubnub-presence

pubnub-presence 是面向 PubNub 实时应用开发的 Presence 专项技能，提供状态事件编排、断连处理和多设备同步模式，并要求以 PubNub MCP 或官方文档确认 API 细节。

主要功能

  1. 01指导 Presence 启用与频道规则配置
  2. 02先获取初始在线状态，再处理实时事件
  3. 03区分离开、超时与断连状态
  4. 04提供心跳、超时和多设备设计参考
  5. 05强调大频道的事件量控制

适用场景

  1. 01实现频道成员在线状态显示
  2. 02同步初始占用状态与加入、离开事件
  3. 03处理断连和多设备在线状态
  4. 04在测试环境验证 Presence 事件流

MCP 相关

该技能指定使用 PubNub MCP 工具查询 SDK 文档，并可在测试环境验证事件流。涉及 API 形状、限制、配置或实时操作时，要求启用 PubNub MCP。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/pubnub/skills --skill pubnub-presence

安装后在 Claude Code 中输入/pubnub-presence确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

tile.json
evals/
instructions.json
summary_infeasible.json
summary.json
evals/scenario-0/
capability.txt
criteria.json
task.md
evals/scenario-1/
capability.txt
criteria.json
task.md
evals/scenario-2/
capability.txt
criteria.json
task.md
evals/scenario-3/
capability.txt
criteria.json
task.md
evals/scenario-4/
capability.txt
criteria.json
task.md
references/
dropped-connections.md
multi-device-sync.md
presence-patterns.md
presence-setup.md

详细介绍

PubNub Presence 专家

优先级： PubNub MCP 工具和 pubnub.com/docs 是关于 API 形式、限制和配置值的权威来源。本技能是关于模式、顺序和设计权衡的权威来源。

缺少 PubNub MCP 工具时： 仅当本会话没有 PubNub MCP 工具（通常位于命名空间 user-pubnub）时，才将 PubNub MCP 视为不可用。如果这些工具已列出，不要询问用户是否检查过 MCP。如果工具不可用，且任务需要 API 形式、限制、工具架构、配置值或实时 keyset/runtime 操作：告知用户一次应启用 PubNub MCP（https://www.pubnub.com/docs/ai/pubnub-mcp-server）；本技能仍可提供模式、顺序和设计权衡。不要将训练数据视为这些事实的权威来源——不要凭记忆给出确定的 SDK 方法签名、数值限制或 MCP 工具参数列表。继续提供模式级指导，或在启用 MCP 前暂停处理依赖事实的部分。Chat 问题仍应转至 Chat SDK 文档/MCP（get_chat_sdk_documentation），而非 Core SDK。

核心工作流

  1. 启用并限定范围 — Presence add-on + Presence Management 频道规则（presence-setup.md）。
  2. 启用 Presence 订阅 — 通过 get_sdk_documentation 获取 API。
  3. 先获取初始状态，再接收事件流 — 使用 hereNow 获取初始在线人数；使用加入/离开/超时事件获取增量变化。
  4. 调整心跳/超时 — 权衡延迟与事件量（presence-setup.md）。
  5. 处理断连 — dropped-connections.md + 退避。
  6. 多设备 — multi-device-sync.md。

参考指南

参考资料用途
presence-setup.mdPortal 前置要求、心跳调整
presence-patterns.md可扩展的 Presence 模式
dropped-connections.md状态类别与 Presence 离开事件的区别
multi-device-sync.md多设备场景下的 userId 设计

事件编排

阶段操作
初始连接后，先获取在线人数（hereNow），再将空 UI 状态视为可信
实时应用加入/离开/超时/状态变更增量 — 从 SDK 文档获取事件形式
高在线人数预期会收到间隔事件；批量更新 UI
离开体验区分主动离开、超时和断连（dropped-connections.md）

限制

MCP 工具

  • get_sdk_documentation — Presence API、hereNow、状态
  • subscribe_and_receive_pubnub_messages — 在 staging 环境中验证事件流

另请参阅

  • pubnub-app-developer — 发布/订阅基础功能
  • pubnub-app-context — 与 Presence 配合使用的持久化用户元数据
  • pubnub-observability — Presence 频繁抖动操作手册
  • pubnub-scale — 大型事件场景下的在线人数

评论

支持 Markdown