Chirp

Appearance

Chirp

面向游戏开发的轻量实时通信后端骨架

核心说明
快速开始

界面预览

应用原型文档 →
chirp 管理台：管理台 · 总览管理台 · 总览

核心链路

当前建议优先验证 gateway + auth + chat。

双平面架构

游戏平面与 App 平面独立部署，跨平面通信是 chat 原生能力——同协议直连、注册白名单、版本协商。

双协议接入

TCP 和 WebSocket 使用同一套长度前缀 Protobuf Packet 协议。

明确能力边界

可选 Redis 增强；社交、语音、通知、搜索、SDK 完成度不一致，见能力矩阵。

当前定位 ​

Chirp 目前是“可运行的核心通信骨架 + 一批实验性扩展”，不是所有目录都同等成熟的完整产品套件。

优先阅读：

  • 核心说明：当前可用链路、协议、服务边界和本地验证命令
  • 能力矩阵：各服务、SDK、应用的真实完成度
  • 导言：文档定位、当前支持路径和边界说明
  • 安装：开发环境和依赖准备
  • 快速开始：本地构建、Docker Compose 和冒烟测试（smoke test）
  • API 概述：Packet envelope、消息 ID 和核心流程
  • 整体架构：服务拓扑、数据流和架构判断

文档分层 ​

层级代表页面用途
当前运行时CORE, CAPABILITY_MATRIX, guide/getting-started, api/overview, architecture, server_plane当前可用链路、协议和边界约束
入门指南guide/introduction, guide/installation, guide/getting-started, guide/deployment环境准备、本地构建和验证
专题 / 历史design-notes/DEPLOYMENT, design-notes/DISTRIBUTED_DEPLOYMENT, design-notes/SCALABILITY*, design-notes/game_chat_*, design-notes/npc_dialog_system, design-notes/INTEGRATION_TEST_FIXES设计记录、演进方案和旧版说明
兼容页API, QUICKSTART兼容入口，优先跳转到维护中的页面

核心服务 ​

服务默认端口当前状态说明
GatewayTCP 5000 / WS 5001Supported登录、登出、心跳（heartbeat）、会话绑定、可选 Redis 跨实例踢人（kick）
AuthTCP 6000Supported基础令牌流程（token flow）；依赖满足时构建增强认证实现
ChatTCP 7000 / WS 7001Supported私聊、历史、离线队列（offline queue）；依赖满足时构建增强存储路径
Server GatewayTCP 8100Experimental服务平面枢纽：游戏服出站长连接（persistent connection）+ service_id+secret 凭证，消息注入、事件离线排队重投，见服务器平面
NPC Dialog无监听端口Experimental纯服务器平面客户端：消费 npc.player_message 事件，按关键词规则回复并注入 chat，见服务器平面

关键边界 ​

当前架构对“游戏聊天后端骨架、本地验证、协议接入和二次开发”是合理的。它还不是生产级统一通信平台：gateway 尚未转发聊天等业务包，chat 仍是独立接入口，服务器平面的注入链路已在回环级打通（chat 侧消费注入消息，NPC 对话环路有进程级冒烟测试 --smoke-npc），部分高级能力缺少统一会话和验证链路。