lawless/docs/设计文档/GDD-29-聊天与信息传递系统设计.md

# GDD-29 聊天与信息传递系统设计

> 文档类型：游戏设计文档（Game Design Document）
> 版本：1.0
> 日期：2026-07-02
> 关联文档：GDD-02（✅46 区域聊天与广播）、GDD-07（帮派门派社交四系统）、GDD-08（✅D07 每层独立频道 / ✅D17 附近的人）、GDD-09（✅60-62 祖地传音/追杀令通报）、GDD-13（佣兵悬赏）、GDD-14（✅68 全服通报与情报购买）、GDD-16（✅S09 传音与社交表达 / 师徒道侣结义关系链）、TDD-04（数据库表结构）、TDD-05（API接口设计）

> **定位**：聊天与信息传递是洪荒大陆玩家社交的底层基础设施。本文档在 GDD-16 ✅S09（区域频道+私聊+传音符+表情称号）的基础上，系统性地设计完整的频道层级、消息类型、安全防护、存储策略与社交联动机制，为师徒/道侣/结义/帮派/门派/家族等社交关系提供通信载体，落实「玩家互动优先」(✅97) 的设计哲学。

---

## 已确认决策记录（GDD-29 本地，跨文档引用写 `GDD-29 ✅C0X`）

| # | 决策 |
|---|------|
| ✅C01 | **频道七层架构**：种族频道 / 区域频道 / 世界频道 / 帮派频道 / 门派频道 / 家族频道 / 队伍频道 + 私聊 + 传音符，共 9 类通信通道 |
| ✅C02 | **世界层级与频道映射**：区域频道按 `world_tier` 隔离（✅D07），跨层通信需消耗「传音符」道具 |
| ✅C03 | **消息类型六类**：文字 / 表情 / 系统广播 / 战报分享 / 物品链接 / 位置分享 |
| ✅C04 | **敏感词三级过滤**：实时拦截（违法/广告）+ 延迟审核（谐音/变体）+ 人工复核队列 |
| ✅C05 | **刷屏防护四件套**：频率限制 + 自动禁言 + 举报机制 + 新人静默期 |
| ✅C06 | **屏蔽/黑名单双轨**：个人屏蔽（单向，对方无感）+ 帮派/组织黑名单（帮主/长老操作，影响频道权限） |
| ✅C07 | **系统消息差异化呈现**：天启广播（全服金光横幅）/ 拍卖广播（频道内嵌卡片）/ 世界事件（区域弹幕）/ 渡劫成功（全服通报+特效） |
| ✅C08 | **聊天记录存储**：本地缓存最近 200 条/频道 + 服务端保留 7 天历史 + 过期自动清理 |
| ✅C09 | **聊天社交联动**：从聊天消息可直接发起组队邀请 / 交易请求 / 好友申请 / 师徒邀请，消息体携带操作按钮元数据 |
| ✅C10 | **表情系统**：基础表情免费 + 高阶表情通过成就/商城获取；表情消息与文字消息同等存储 |
| ✅C11 | **称号展示**：聊天消息携带当前称号前缀，称号可在聊天设置中切换/隐藏 |
| ✅C12 | **传音符跨层规则**：传音符可跨世界层级发送私聊消息；消耗数量随层级差距递增（跨 1 层 = 1 张，跨 2 层 = 3 张，跨 3 层 = 5 张） |

---

## 第一章 频道层级体系

### 1.1 频道总览

洪荒大陆的通信体系由 **9 类频道** 构成，按作用范围从窄到宽排列：

| 频道类型 | 作用范围 | 解锁条件 | 消息可见性 | 频道颜色（客户端） |
|----------|----------|----------|-----------|-------------------|
| **队伍频道** | 当前队伍成员（2-5 人） | 创建/加入队伍 | 仅队伍成员 | 绿色 |
| **家族频道** | 当前家族成员（5-15 人） | 加入家族 | 仅家族成员 | 粉色 |
| **门派频道** | 当前系统门派全体成员 | 加入门派 | 仅门派成员 | 蓝色 |
| **帮派频道** | 当前帮派全体成员 | 加入帮派 | 仅帮派成员 | 紫色 |
| **区域频道** | 同一世界层级同一区域的所有玩家 | 进入该区域 | 同区域可见 | 白色 |
| **种族频道** | 同一种族同一世界层级的所有玩家 | 创角选择种族 | 同族同层可见 | 金色 |
| **世界频道** | 当前服务器所有在线玩家 | 筑基期（层级 2）解锁 | 全服可见 | 红色 |
| **私聊** | 两名指定玩家 | 无限制 | 仅双方 | 橙色 |
| **传音符** | 跨层级的两名指定玩家 | 消耗传音符道具 | 仅双方（跨层） | 青色 |

### 1.2 频道详细规则

#### 1.2.1 队伍频道

| 维度 | 规则 |
|------|------|
| 成员上限 | 5 人（组队上限） |
| 消息保留 | 本地缓存，队伍解散后清除 |
| 特殊功能 | 支持物品链接分享、位置分享、战报快捷分享 |
| 语音 | 不支持（纯文字游戏，不设语音频道） |

#### 1.2.2 家族频道

| 维度 | 规则 |
|------|------|
| 成员上限 | 15 人（家族满级上限，GDD-07 §4.2） |
| 消息保留 | 本地缓存 + 服务端保留 7 天 |
| 特殊功能 | 家族事件通知、义团共享委托进度播报 |
| 权限 | 家族族长可设置「仅管理可发言」模式（应对家族内部纠纷） |

#### 1.2.3 门派频道

| 维度 | 规则 |
|------|------|
| 成员上限 | 按系统门派设定（数百至数千） |
| 消息保留 | 本地缓存 + 服务端保留 3 天 |
| 特殊功能 | 门派委托播报、功法库更新通知、同门求助标记 |
| 权限 | 掌门/长老可禁言普通弟子；频道内可发布「同门求助」标记（黄色感叹号） |

#### 1.2.4 帮派频道

| 维度 | 规则 |
|------|------|
| 成员上限 | 按帮派等级（数百至数千） |
| 消息保留 | 本地缓存 + 服务端保留 7 天 |
| 特殊功能 | 帮派领地播报、竞标通知、帮派副本组队、分红通知 |
| 权限 | 帮主/副帮主/长老可禁言；可设置「精英频道」子频道（仅精英以上可见） |
| 子频道 | `#帮派-公告`（仅管理可发言）、`#帮派-精英`（精英以上可见）、`#帮派-全体` |

#### 1.2.5 区域频道

| 维度 | 规则 |
|------|------|
| 范围 | 当前 `world_tier` + 当前区域 `zone_id` 内所有在线玩家 |
| 消息保留 | 仅本地缓存（服务端不持久化区域消息） |
| 消息上限 | 显示最近 100 条，超出滚动清除 |
| 特殊功能 | 区域事件播报（妖潮、世界 Boss、混沌裂隙等）、附近玩家求助 |
| 限制 | 炼气期（层级 1）区域频道仅本种族可见（✅D03 出生地隔离） |

#### 1.2.6 种族频道

| 维度 | 规则 |
|------|------|
| 范围 | 同一 `race_id` + 同一 `world_tier` 的所有在线玩家 |
| 消息保留 | 本地缓存 + 服务端保留 3 天 |
| 特殊功能 | 祖地追杀令通报（✅61）、祖地入侵预警（✅60）、种族事件播报 |
| 限制 | 层级 1（凡界）种族频道为默认频道；层级 2+ 种族频道需手动切换 |

#### 1.2.7 世界频道

| 维度 | 规则 |
|------|------|
| 范围 | 当前服务器所有在线玩家 |
| 解锁条件 | 筑基期（层级 2）及以上 |
| 消息保留 | 本地缓存 + 服务端保留 1 天 |
| 频率限制 | 每 30 秒可发 1 条（防止刷屏） |
| 特殊功能 | 全服通报（天启/渡劫/稀有宝物获取）、情报购买入口（✅68） |
| 消耗 | 每条消息消耗 100 铜钱（小额经济 sink） |

#### 1.2.8 私聊

| 维度 | 规则 |
|------|------|
| 范围 | 两名指定玩家，不受世界层级限制（同层） |
| 消息保留 | 本地缓存 + 服务端保留 14 天 |
| 特殊功能 | 支持所有消息类型；可发起组队/交易/好友/师徒邀请（✅C09） |
| 限制 | 对方可屏蔽私聊（✅C06）；被屏蔽后发送方显示「消息已发送」但对方不可见 |

#### 1.2.9 传音符（跨层私聊）

| 维度 | 规则 |
|------|------|
| 范围 | 跨世界层级的两名指定玩家 |
| 消耗 | 传音符道具，数量随层级差距递增（✅C12） |
| 获取途径 | 生活技能制作 / 商城购买 / 世界事件掉落 / 坊市交易 |
| 消息保留 | 同私聊（14 天） |
| 限制 | 炼气期玩家不可使用传音符（层级 1 禁跨层通信） |

**传音符消耗表**：

| 层级差距 | 消耗数量 | 示例 |
|----------|----------|------|
| 同层 | 0 张（普通私聊即可） | 层级 2 → 层级 2 |
| 跨 1 层 | 1 张 | 层级 2 → 层级 3 |
| 跨 2 层 | 3 张 | 层级 1 → 层级 3 |
| 跨 3 层 | 5 张 | 层级 1 → 层级 4 |
| 跨 4 层 | 8 张 | 层级 1 → 层级 5 |

> 传音符消耗递增设计意图：鼓励玩家在同层级内自然社交，跨层通信为稀缺资源消耗型交互，与「层级越高官方存在感越低」(✅D18) 一致。

---

## 第二章 频道与世界层级的映射

### 2.1 层级频道隔离规则

世界层级（`world_tier`）是频道可见性的核心过滤维度：

| 频道类型 | 层级隔离规则 | 说明 |
|----------|-------------|------|
| 队伍频道 | 不隔离 | 跨层组队时队伍频道正常工作 |
| 家族频道 | 不隔离 | 家族成员可跨层通信 |
| 门派频道 | 按层级隔离 | 层级 2 的门派频道与层级 3 的门派频道独立 |
| 帮派频道 | 不隔离 | 帮派成员可跨层通信 |
| 区域频道 | 严格隔离 | 仅同层同区域可见 |
| 种族频道 | 按层级隔离 | 同种族不同层级各有独立频道 |
| 世界频道 | 按层级隔离 | 各层级有独立世界频道（层级 1 无世界频道） |
| 私聊 | 不隔离 | 同层私聊无限制 |
| 传音符 | 跨层 | 专门用于跨层通信，消耗道具 |

### 2.2 各层级频道可用性矩阵

| 层级 | 队伍 | 家族 | 门派 | 帮派 | 区域 | 种族 | 世界 | 私聊 | 传音符 |
|------|------|------|------|------|------|------|------|------|--------|
| 1 凡界 | ✅ | ✅ | ❌ | ❌ | ✅（仅本族） | ✅ | ❌ | ✅ | ❌ |
| 2 灵界 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| 3 道界 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| 4 圣界 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| 5 神域 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |

> 层级 1（凡界）无门派/帮派/世界频道，强化「种族摇篮」的沉浸感（✅D03）；门派与帮派系统在层级 2（灵界）才激活（✅D04）。

### 2.3 频道切换规则

| 规则 | 说明 |
|------|------|
| 默认频道 | 进入游戏后默认显示「区域频道」+「队伍频道」（如有队伍） |
| 频道切换 | 玩家可手动切换活跃发送频道，聊天输入框左侧显示当前频道标识 |
| 多频道接收 | 玩家可同时接收所有已加入频道的消息，通过标签页或颜色区分 |
| 频道折叠 | 玩家可折叠/隐藏不关注的频道（不影响接收，仅影响显示） |
| 频道通知 | 可设置各频道的消息通知级别：全部 / 仅 @我 / 仅系统消息 / 静音 |

---

## 第三章 消息类型

### 3.1 消息类型总览

| 消息类型 | 标识 | 支持频道 | 说明 |
|----------|------|----------|------|
| **文字消息** | `TEXT` | 全部 | 纯文本内容，最大 200 字符 |
| **表情消息** | `EMOJI` | 全部 | 系统预设表情，发送后以动画形式展示 |
| **系统广播** | `SYSTEM` | 由系统决定 | 天启/渡劫/拍卖/世界事件等系统级通知 |
| **战报分享** | `BATTLE_REPORT` | 队伍/家族/帮派/区域 | 点击可查看完整战报详情 |
| **物品链接** | `ITEM_LINK` | 全部 | 点击可查看物品详情，支持对比 |
| **位置分享** | `LOCATION` | 队伍/家族/帮派 | 点击可打开地图并标记位置 |

### 3.2 消息体结构

```json
{
  "msg_id": "uuid",
  "channel_type": "REGION | FACTION | WORLD | GUILD | SECT | FAMILY | TEAM | WHISPER | VOICE_SCROLL",
  "channel_id": "zone_id | guild_id | sect_id | family_id | team_id | target_character_id",
  "world_tier": 2,
  "sender": {
    "character_id": "uuid",
    "name": "玩家名",
    "race_id": "human",
    "realm_tier": 3,
    "title": "金丹修士",
    "guild_name": "青云帮",
    "sect_name": "青云剑宗"
  },
  "msg_type": "TEXT | EMOJI | SYSTEM | BATTLE_REPORT | ITEM_LINK | LOCATION",
  "content": "消息文本内容",
  "extra_data": {},
  "timestamp": "2026-07-02T10:30:00Z",
  "is_muted": false
}
```

### 3.3 各消息类型详细设计

#### 3.3.1 文字消息

| 维度 | 规则 |
|------|------|
| 最大长度 | 200 字符（UTF-8，含表情字符） |
| 最小长度 | 1 字符 |
| 空格限制 | 不允许纯空格消息 |
| @功能 | 支持 `@玩家名` 提及（私聊不支持 @） |
| 链接 | 自动识别为纯文本（不渲染为超链接，防钓鱼） |

#### 3.3.2 表情消息

| 维度 | 规则 |
|------|------|
| 基础表情 | 免费，约 30 个（洪荒主题：抱拳、飞剑、打坐、渡劫等） |
| 高阶表情 | 通过成就解锁 / 商城购买 / 活动获取（如「龙族之怒」「凤妖涅槃」等种族专属表情） |
| 展示方式 | 聊天框内以动画形式播放（约 1-2 秒），不影响其他消息阅读 |
| 发送频率 | 与文字消息共享频率限制 |

#### 3.3.3 系统广播

系统广播由服务端自动触发，玩家不可手动发送。详细差异化呈现见第七章。

#### 3.3.4 战报分享

| 维度 | 规则 |
|------|------|
| 触发方式 | 战斗结束后点击「分享战报」按钮 |
| 展示内容 | 战斗双方名称/境界/种族、战斗结果、关键回合摘要、战报链接 |
| 点击行为 | 点击打开战报详情弹窗，显示完整ATB战报日志（GDD-03 v2.1） |
| 限制 | 每场战斗只能分享 1 次；同一战报不可重复分享到同一频道 |

#### 3.3.5 物品链接

| 维度 | 规则 |
|------|------|
| 触发方式 | 背包界面长按物品 → 「分享到聊天」 |
| 展示内容 | 物品名称（品色标记）、品阶、品质、基础属性摘要 |
| 点击行为 | 点击打开物品详情弹窗，可与自身装备对比 |
| 限制 | 绑定物品可分享但对方不可交易；已上架交易行的物品不可分享 |

#### 3.3.6 位置分享

| 维度 | 规则 |
|------|------|
| 触发方式 | 地图界面点击「分享位置」 |
| 展示内容 | 区域名称、坐标、世界层级 |
| 点击行为 | 点击打开地图并标记该位置（仅同层可见） |
| 限制 | 层级 1 玩家不可分享位置给跨层玩家 |

---

## 第四章 敏感词过滤与反诈骗机制

### 4.1 敏感词三级过滤体系

| 过滤级别 | 触发时机 | 处理方式 | 覆盖范围 |
|----------|----------|----------|----------|
| **L1 实时拦截** | 消息发送时 | 消息不发送，客户端提示「包含违规内容」 | 违法词汇、政治敏感、广告引流、色情 |
| **L2 延迟审核** | 消息发送后异步审核 | 审核期间消息正常显示；若命中则标记为「已折叠」+ 发送者警告 | 谐音变体、拆字、图片文字识别、新型诈骗话术 |
| **L3 人工复核** | L2 标记为可疑的消息 | 进入人工审核队列，24 小时内处理；处理前消息可见但带「待审核」标记 | 误判申诉、新型违规模式 |

### 4.2 敏感词库结构

| 分类 | 示例 | 处理 |
|------|------|------|
| **违法类** | 涉政/涉暴/涉恐 | L1 直接拦截 |
| **广告类** | 外挂/代练/私服/微信号/QQ群 | L1 直接拦截 |
| **色情类** | 明确色情词汇 | L1 直接拦截 |
| **诈骗类** | 充值返利/中奖通知/账号交易 | L1 拦截 + 客户端弹窗防诈骗提示 |
| **变体类** | 谐音/拆字/拼音首字母 | L2 延迟审核 |
| **游戏内违规** | 恶意辱骂/种族歧视/人身攻击 | L2 延迟审核 + 玩家举报 |

### 4.3 反诈骗机制

| 机制 | 说明 |
|------|------|
| **关键词预警** | 消息中出现「转账」「汇款」「支付宝」「微信支付」等关键词时，客户端弹窗提醒「谨防诈骗」 |
| **链接拦截** | 所有消息中的 URL 自动转为纯文本，不可点击；官方链接由系统消息单独推送 |
| **新号静默** | 新注册账号（≤ 3 天）在世界频道发言频率额外限制为每 60 秒 1 条 |
| **举报奖励** | 成功举报诈骗行为的玩家获得小额铜钱奖励（每日上限 3 次） |
| **黑名单同步** | 被系统判定为诈骗的账号自动加入全服黑名单，所有频道禁言 |

### 4.4 敏感词库更新策略

| 策略 | 说明 |
|------|------|
| **Nacos 动态下发** | 敏感词库存储在 Nacos 配置中心，服务端热加载，无需重启 |
| **每日增量更新** | 运营团队每日审核新增敏感词，通过 Nacos 推送 |
| **玩家举报采集** | 有效举报自动采集上下文，辅助 L2 审核模型训练 |
| **多语言支持** | 支持中文/英文/拼音/emoji 组合过滤 |

---

## 第五章 刷屏/骚扰防护

### 5.1 频率限制

| 频道 | 频率限制 | 超限处理 |
|------|----------|----------|
| 世界频道 | 30 秒/条 | 提示「发言过快，请稍后再试」 |
| 区域频道 | 5 秒/条 | 同上 |
| 种族频道 | 5 秒/条 | 同上 |
| 门派/帮派/家族频道 | 3 秒/条 | 同上 |
| 队伍频道 | 1 秒/条 | 同上 |
| 私聊/传音符 | 2 秒/条 | 同上 |

### 5.2 自动禁言规则

| 触发条件 | 禁言时长 | 说明 |
|----------|----------|------|
| 1 分钟内发送 10 条相同/近似消息 | 10 分钟 | 基础防刷屏 |
| 10 分钟内被 3 名不同玩家举报 | 30 分钟 | 社区自治 |
| 1 小时内累计自动禁言 3 次 | 24 小时 | 升级惩罚 |
| 被系统判定为广告机器人 | 永久禁言 | 需人工审核解除 |
| 24 小时内累计被举报 10 次 | 进入人工审核队列 | 审核期间禁言 |

### 5.3 举报机制

| 维度 | 规则 |
|------|------|
| 举报方式 | 长按消息 → 「举报」→ 选择原因（辱骂/广告/诈骗/骚扰/其他） |
| 举报冷却 | 同一玩家每 5 分钟可举报 1 次（防止恶意刷举报） |
| 举报上限 | 每日最多举报 20 名不同玩家 |
| 举报处理 | L2 自动审核 + L3 人工复核；处理结果通过系统邮件通知举报者 |
| 误举报 | 若举报被判定为恶意，举报者扣除信誉分（接 GDD-16 ✅S05 声望系统） |

### 5.4 新人静默期

| 维度 | 规则 |
|------|------|
| 静默期 | 新账号创角后 1 游戏天（= 现实 8 小时）内，世界频道不可发言 |
| 可用频道 | 区域频道 + 种族频道 + 私聊（可接收不可发送受限） |
| 解除条件 | 完成新手引导事件链 / 炼气期突破至筑基期 |
| 设计意图 | 防止批量注册小号刷屏/诈骗，与「炼气期禁充值」(✅D19) 理念一致 |

---

## 第六章 屏蔽/黑名单系统

### 6.1 个人屏蔽

| 维度 | 规则 |
|------|------|
| 屏蔽方式 | 长按消息 → 「屏蔽该玩家」；或在对方资料页点击「屏蔽」 |
| 屏蔽上限 | 最多屏蔽 200 名玩家 |
| 屏蔽效果 | 对方所有频道消息不可见；对方私聊消息不接收；对方无法查看你的位置分享 |
| 对方感知 | **无感**（对方消息正常发送，仅自己不可见） |
| 解除 | 在设置 → 屏蔽列表中手动解除 |
| 屏蔽持久化 | 服务端存储，换设备同步 |

### 6.2 帮派/组织黑名单

| 维度 | 规则 |
|------|------|
| 操作权限 | 帮主/副帮主/长老可操作帮派黑名单 |
| 黑名单效果 | 被列入黑名单的玩家无法加入该帮派；若已在帮派中则被踢出（需帮主确认） |
| 门派黑名单 | 系统门派由 NPC 掌门自动管理；自建门派无黑名单（个人私有） |
| 家族黑名单 | 家族族长可踢人，无独立黑名单（家族人数少，直接管理即可） |

### 6.3 义团/道侣关系中的屏蔽

| 场景 | 规则 |
|------|------|
| 道侣屏蔽 | 道侣关系中不可屏蔽对方（需先和离，GDD-16 §1.4.1） |
| 义团屏蔽 | 义团成员可屏蔽其他成员，但义团频道消息仍可见（仅私聊被屏蔽） |
| 师徒屏蔽 | 师父可屏蔽徒弟，徒弟可屏蔽师父；师徒频道消息仍可见 |

---

## 第七章 系统消息格式规范

### 7.1 系统消息分类与差异化呈现

| 消息类型 | 呈现方式 | 频道范围 | 持续时间 | 示例 |
|----------|----------|----------|----------|------|
| **天启广播** | 全服金光横幅 + 音效 | 全服所有频道 | 10 秒 | 「天启降临！[玩家名] 突破至筑基期，灵界大门已开启！」 |
| **渡劫成功** | 全服通报 + 特效 | 全服世界频道 + 区域频道 | 5 秒 | 「[玩家名] 渡劫成功，晋升为元婴修士！」 |
| **稀有宝物获取** | 全服通报 + 情报入口 | 全服世界频道 | 5 秒 | 「[玩家名] 获取了[宝物名]！」（附「情报购买」按钮，✅68） |
| **拍卖广播** | 频道内嵌卡片 | 世界频道 + 区域频道 | 持续至拍卖结束 | 「[物品名] 正在拍卖，当前出价 [价格]」（附「前往拍卖」按钮） |
| **世界事件** | 区域弹幕 + 小地图标记 | 区域频道 | 事件持续期间 | 「妖潮来袭！[区域名] 正在遭受妖兽入侵！」 |
| **帮派通知** | 帮派频道内嵌通知 | 帮派频道 | 持续至事件结束 | 「帮派领地竞标已开始，当前最高出价 [金额]」 |
| **祖地追杀令** | 种族频道高亮公告 | 种族频道（同层） | 24 游戏小时 | 「[入侵者名] 闯入[种族]祖地，追杀令已发布！」（✅61） |
| **维护公告** | 全服横幅 + 邮件 | 全服 | 持续至维护开始 | 「服务器将于 [时间] 进行维护，预计 [时长]」 |

### 7.2 系统消息样式规范

#### 7.2.1 天启广播

```
[系统] 天启降临！
[玩家名]（[种族]·[境界]）突破至[新境界]，[世界名称]的大门已向所有修士敞开！
—— 天道昭昭，大道无穷 ——
```

- 客户端渲染：金色渐变横幅，从屏幕顶部滑入，停留 10 秒后淡出
- 音效：钟鸣音效（低沉庄严）
- 频率限制：同一玩家 24 小时内仅触发 1 次天启广播

#### 7.2.2 渡劫成功通报

```
[系统] 天劫已渡！
[玩家名]（[种族]·[境界]）成功渡过[天劫名]，修为大涨，晋升[新境界]！
```

- 客户端渲染：雷电特效横幅，停留 5 秒
- 音效：雷鸣音效
- 频率限制：大境界突破触发，小境界突破不触发

#### 7.2.3 拍卖广播

```
[拍卖] [物品名]（[品阶]·[品质]）
当前出价：[价格] [货币类型]
剩余时间：[时长]
[前往竞拍]
```

- 客户端渲染：频道内嵌卡片，带「前往竞拍」按钮
- 频率限制：同一物品每 30 分钟广播 1 次

#### 7.2.4 祖地追杀令

```
[追杀令] [种族]祖地告急！
入侵者：[玩家名]（[种族]·[境界]）
位置：[区域名]·[坐标范围]
悬赏：[赏金金额] [货币类型]
[接取追杀令] （限 [N] 人）
```

- 客户端渲染：红色高亮公告，带「接取追杀令」按钮
- 限制：接取人数上限按区域承载动态调整

### 7.3 系统消息发送规则

| 规则 | 说明 |
|------|------|
| 不可屏蔽 | 系统消息不可被个人屏蔽（但可设置通知级别为「仅重要」） |
| 不可举报 | 系统消息不可被举报 |
| 不可回复 | 系统消息不可直接回复 |
| 带操作按钮 | 部分系统消息可携带操作按钮（情报购买、前往竞拍、接取追杀令等） |
| 多语言 | 系统消息根据客户端语言设置自动切换语言版本 |

---

## 第八章 聊天记录存储

### 8.1 存储架构

| 存储层 | 技术方案 | 保留时长 | 用途 |
|--------|----------|----------|------|
| **客户端本地** | SQLite / IndexedDB | 最近 200 条/频道 | 离线查看、快速加载 |
| **服务端缓存** | Valkey（Sorted Set） | 最近 1000 条/频道 | 实时消息分发、历史回溯 |
| **服务端持久化** | PostgreSQL（chat_messages 表） | 7 天 | 审计、举报复核、数据恢复 |

### 8.2 过期清理策略

| 维度 | 策略 |
|------|------|
| 客户端本地 | 超过 200 条自动清除最旧消息；频道 30 天无活动自动清除本地缓存 |
| Valkey 缓存 | 超过 1000 条自动淘汰最旧消息（LRU）；频道 7 天无活动自动清除 |
| PostgreSQL | 7 天前的消息由定时任务（pg_cron）批量归档到冷存储（可选），主表删除 |
| 特殊消息 | 系统广播消息保留 30 天（用于运营分析）；举报相关消息保留至举报处理完毕 |

### 8.3 数据库表设计（chat_messages）

| 字段 | 类型 | 约束 | 说明 |
|------|------|------|------|
| id | uuid | PK | 消息唯一 ID |
| channel_type | varchar(16) | IX | REGION / FACTION / WORLD / GUILD / SECT / FAMILY / TEAM / WHISPER / VOICE_SCROLL |
| channel_id | varchar(64) | IX | 频道标识（zone_id / guild_id / target_character_id 等） |
| world_tier | smallint | IX | 发送时的世界层级 |
| sender_id | uuid | FK → characters.id, IX | 发送者角色 ID |
| msg_type | varchar(16) | IX | TEXT / EMOJI / SYSTEM / BATTLE_REPORT / ITEM_LINK / LOCATION |
| content | text | | 消息文本内容 |
| extra_data | jsonb | | 扩展数据（物品链接属性、战报 ID、位置坐标等） |
| is_muted | boolean | | 是否被过滤/折叠 |
| created_at | timestamptz | IX | 发送时间 |

**索引策略**：
- `(channel_type, channel_id, created_at DESC)` — 频道历史查询
- `(sender_id, created_at DESC)` — 玩家发言记录
- `created_at` — 过期清理（BRIN 索引）

**分区策略**：按 `created_at` 使用 pg_partman 按周分区，自动清理 7 周前的分区。

### 8.4 Valkey 缓存结构

```
# 频道消息缓存（Sorted Set）
chat:{channel_type}:{channel_id} → Sorted Set<timestamp, msg_json>

# 玩家未读消息计数
chat:unread:{character_id} → Hash<channel_key, unread_count>

# 玩家屏蔽列表
chat:blocklist:{character_id} → Set<blocked_character_id>
```

---

## 第九章 聊天与社交的联动

### 9.1 从聊天发起社交操作

聊天消息支持携带操作元数据，玩家点击消息中的操作按钮可直接发起社交交互：

| 操作 | 触发方式 | 前置条件 | 效果 |
|------|----------|----------|------|
| **组队邀请** | 点击消息中的「邀请组队」按钮 | 发送者有队伍且未满员；目标未在其他队伍 | 向目标发送组队邀请弹窗 |
| **交易请求** | 点击消息中的「发起交易」按钮 | 双方在同一区域；双方均非战斗状态 | 向目标发送交易请求弹窗 |
| **好友申请** | 点击消息中的「加为好友」按钮 | 双方不在对方屏蔽列表 | 向目标发送好友申请 |
| **师徒邀请** | 点击消息中的「收徒/拜师」按钮 | 满足师徒系统条件（GDD-16 §1.2） | 向目标发送师徒邀请 |
| **位置导航** | 点击位置分享中的「前往」按钮 | 双方在同一世界层级 | 在小地图标记目标位置 |

### 9.2 社交操作消息格式

```
# 组队邀请消息
[队伍] [玩家名] 邀请你加入队伍
队伍人数：3/5
目标：[副本名 / 游历]
[接受] [拒绝]

# 交易请求消息
[交易] [玩家名] 请求与你交易
[接受] [拒绝]

# 好友申请消息
[社交] [玩家名] 请求加你为好友
[同意] [拒绝]

# 师徒邀请消息
[师徒] [玩家名]（[境界]）邀请你成为其弟子
[同意] [拒绝]
```

### 9.3 社交操作频率限制

| 操作 | 频率限制 | 说明 |
|------|----------|------|
| 组队邀请 | 同一目标每 5 分钟 1 次 | 防骚扰 |
| 交易请求 | 同一目标每 10 分钟 1 次 | 防骚扰 |
| 好友申请 | 每日最多 20 个 | 防刷好友 |
| 师徒邀请 | 每日最多 5 个 | 精准收徒 |

### 9.4 聊天与声望系统联动

| 联动点 | 说明 |
|--------|------|
| 交易好评 | 通过聊天发起的交易完成后，双方可互评（接 GDD-16 ✅S05 声望系统） |
| 师徒评价 | 师徒关系解除后，双方可互评师父/徒弟质量 |
| 举报扣分 | 恶意举报被驳回，举报者声望 -5 |
| 帮派贡献 | 帮派频道内的活跃发言可累计微量帮派贡献（每日上限 10 点） |

---

## 第十章 数据模型与接口

### 10.1 数据库表总览

| 表名 | 用途 | 关联 |
|------|------|------|
| `chat_messages` | 聊天消息持久化 | §8.3 |
| `chat_channels` | 频道配置（帮派/门派/家族频道的创建与管理） | 自动创建 |
| `chat_block_list` | 玩家屏蔽列表 | FK → characters.id |
| `chat_mute_records` | 禁言记录 | FK → characters.id |
| `chat_report_records` | 举报记录 | FK → characters.id |
| `chat_voice_scroll_usage` | 传音符使用记录 | FK → characters.id + items.id |

### 10.2 chat_channels 表

| 字段 | 类型 | 约束 | 说明 |
|------|------|------|------|
| id | uuid | PK | 频道 ID |
| channel_type | varchar(16) | IX | GUILD / SECT / FAMILY / TEAM |
| owner_id | uuid | IX | 所属组织 ID（guild_id / sect_id / family_id） |
| name | varchar(64) | | 频道名称 |
| config | jsonb | | 频道配置（禁言列表、发言权限等） |
| created_at | timestamptz | | |
| dissolved_at | timestamptz | | 组织解散时标记 |

### 10.3 chat_block_list 表

| 字段 | 类型 | 约束 | 说明 |
|------|------|------|------|
| id | uuid | PK | |
| character_id | uuid | FK → characters.id, IX | 屏蔽者 |
| blocked_id | uuid | FK → characters.id, IX | 被屏蔽者 |
| reason | varchar(64) | | 屏蔽原因（可选） |
| created_at | timestamptz | | |

**唯一约束**：`(character_id, blocked_id)`

### 10.4 chat_mute_records 表

| 字段 | 类型 | 约束 | 说明 |
|------|------|------|------|
| id | uuid | PK | |
| character_id | uuid | FK → characters.id, IX | 被禁言者 |
| channel_type | varchar(16) | | 禁言频道类型（NULL = 全频道禁言） |
| reason | varchar(128) | | 禁言原因 |
| mute_type | varchar(16) | | AUTO（自动禁言）/ GM（管理员禁言）/ REPORT（举报禁言） |
| mute_until | timestamptz | IX | 禁言截止时间 |
| created_at | timestamptz | | |

### 10.5 chat_report_records 表

| 字段 | 类型 | 约束 | 说明 |
|------|------|------|------|
| id | uuid | PK | |
| reporter_id | uuid | FK → characters.id, IX | 举报者 |
| target_id | uuid | FK → characters.id, IX | 被举报者 |
| message_id | uuid | FK → chat_messages.id | 被举报消息 ID |
| reason | varchar(32) | | ABUSE / SPAM / FRAUD / HARASSMENT / OTHER |
| status | varchar(16) | IX | PENDING / APPROVED / REJECTED |
| resolved_at | timestamptz | | 处理时间 |
| created_at | timestamptz | | |

### 10.6 核心接口（TDD-05 扩展）

| 接口 | 方法 | 路径 | 说明 |
|------|------|------|------|
| 发送消息 | WebSocket | `nakama.rt.chat.send` | 通过 Nakama 实时连接发送 |
| 接收消息 | WebSocket | `nakama.rt.chat.receive` | 通过 Nakama 实时连接接收 |
| 获取历史消息 | GET | `/api/v1/chat/history` | 分页获取频道历史消息 |
| 屏蔽玩家 | POST | `/api/v1/chat/block` | 添加屏蔽 |
| 解除屏蔽 | DELETE | `/api/v1/chat/block/{id}` | 解除屏蔽 |
| 举报消息 | POST | `/api/v1/chat/report` | 举报消息 |
| 获取屏蔽列表 | GET | `/api/v1/chat/blocklist` | 获取个人屏蔽列表 |
| 频道配置 | PUT | `/api/v1/chat/channel/{id}/config` | 修改频道配置（帮主/族长） |

### 10.7 Nakama 实时消息协议

基于 Nakama 3.x 的实时消息系统（WebSocket）：

```protobuf
// 聊天消息（客户端 → 服务端）
message ChatSend {
  string channel_type = 1;  // REGION / WHISPER / ...
  string channel_id = 2;    // zone_id / target_character_id
  string msg_type = 3;      // TEXT / EMOJI / ...
  string content = 4;
  bytes extra_data = 5;     // Protobuf serialized extra data
}

// 聊天消息（服务端 → 客户端）
message ChatReceive {
  string msg_id = 1;
  string channel_type = 2;
  string channel_id = 3;
  ChatSender sender = 4;
  string msg_type = 5;
  string content = 6;
  bytes extra_data = 7;
  int64 timestamp = 8;
}

message ChatSender {
  string character_id = 1;
  string name = 2;
  string race_id = 3;
  int32 realm_tier = 4;
  string title = 5;
  string guild_name = 6;
}
```

---

## 第十A章 邮件/信件系统

> **定位**：邮件系统是聊天系统的补充，提供**异步通信**能力。离线玩家可通过邮件接收物品、货币、系统通知等。

### 10A.1 邮件类型

| 类型 | 来源 | 说明 |
|------|------|------|
| **系统邮件** | 系统自动发送 | 活动奖励、补偿、公告、拍卖成交通知 |
| **玩家邮件** | 玩家手动发送 | 问候、交易、邀请（需消耗邮票道具） |
| **帮派/门派邮件** | 组织管理发送 | 帮派公告、门派通知 |
| **交易邮件** | 交易系统自动发送 | 交易行售出物品、拍卖获得物品 |

### 10A.2 邮件功能

| 功能 | 说明 |
|------|------|
| **发送邮件** | 玩家可向其他玩家发送邮件，需消耗「邮票」道具 |
| **接收邮件** | 离线期间的邮件在上线时统一展示 |
| **附件系统** | 邮件可附带物品和货币（最多6格附件） |
| **领取附件** | 收件人可领取附件中的物品和货币 |
| **批量操作** | 支持批量删除、批量领取附件 |
| **过期清理** | 邮件保留30天，过期自动删除（附件一并删除） |

### 10A.3 邮件限制

| 限制 | 说明 |
|------|------|
| **发送冷却** | 每日最多发送20封玩家邮件 |
| **附件限制** | 每封邮件最多6格附件（物品或货币） |
| **邮票消耗** | 发送玩家邮件需消耗「邮票」道具（生活技能制作或商店购买） |
| **系统邮件** | 系统邮件无需邮票，自动发送 |
| **防滥用** | 新角色24小时内不可发送邮件（防工作室） |

### 10A.4 邮件数据模型

```sql
CREATE TABLE mails (
    id              uuid PRIMARY KEY DEFAULT gen_random_uuid(),
    sender_id       uuid REFERENCES characters(id),      -- 发送者（系统邮件为NULL）
    receiver_id     uuid NOT NULL REFERENCES characters(id), -- 接收者
    mail_type       varchar(16) NOT NULL,                -- SYSTEM/PLAYER/GUILD/TRADE
    subject         varchar(128) NOT NULL,               -- 主题
    content         text,                                -- 内容
    attachments     jsonb DEFAULT '[]',                  -- 附件（物品/货币）
    is_read         boolean DEFAULT false,               -- 已读状态
    is_collected    boolean DEFAULT false,               -- 附件已领取
    expires_at      timestamptz NOT NULL,                -- 过期时间
    created_at      timestamptz DEFAULT now()
);

CREATE INDEX idx_mails_receiver ON mails(receiver_id, is_read, created_at DESC);
CREATE INDEX idx_mails_expires ON mails(expires_at) WHERE NOT is_collected;
```

### 10A.5 邮件与各系统的联动

| 系统 | 联动方式 |
|------|----------|
| **交易行** | 售出物品后，系统邮件发送货币收入 |
| **拍卖行** | 拍得物品后，系统邮件发送物品 |
| **佣兵系统** | 委托完成后，系统邮件发送报酬 |
| **帮派系统** | 帮派公告通过帮派邮件发送 |
| **活动系统** | 活动奖励通过系统邮件发放 |
| **补偿系统** | 维护补偿、BUG修复补偿通过系统邮件发放 |

---

## 第十一章 已确认决策记录表

| 编号 | 决策 | 关联 |
|------|------|------|
| ✅C01 | 频道七层架构（9 类通信通道） | GDD-02 ✅46、GDD-16 ✅S09 |
| ✅C02 | 世界层级与频道映射（区域频道按 world_tier 隔离） | GDD-08 ✅D07 |
| ✅C03 | 消息类型六类（文字/表情/系统广播/战报分享/物品链接/位置分享） | — |
| ✅C04 | 敏感词三级过滤（L1 实时拦截 + L2 延迟审核 + L3 人工复核） | — |
| ✅C05 | 刷屏防护四件套（频率限制 + 自动禁言 + 举报机制 + 新人静默期） | — |
| ✅C06 | 屏蔽/黑名单双轨（个人屏蔽 + 帮派/组织黑名单） | — |
| ✅C07 | 系统消息差异化呈现（天启金光横幅/拍卖卡片/区域弹幕/渡劫特效） | GDD-02 ✅46、GDD-14 ✅68 |
| ✅C08 | 聊天记录存储（本地 200 条 + Valkey 1000 条 + PG 7 天） | TDD-04 |
| ✅C09 | 聊天社交联动（从消息发起组队/交易/好友/师徒邀请） | GDD-16 社交关系链 |
| ✅C10 | 表情系统（基础免费 + 高阶成就/商城获取） | GDD-16 ✅S09 |
| ✅C11 | 称号展示（消息携带称号前缀，可切换/隐藏） | GDD-16 ✅S09 |
| ✅C12 | 传音符跨层规则（消耗随层级差距递增：1/3/5/8 张） | GDD-08 ✅D15 |

---

## 第十二章 验收标准

### 12.1 功能验收

| 编号 | 验收项 | 验收标准 |
|------|--------|----------|
| AC-01 | 频道创建 | 帮派/门派/家族创建时自动创建对应频道；队伍创建时自动创建队伍频道 |
| AC-02 | 频道消息发送 | 所有 9 类频道均可正常发送和接收文字消息 |
| AC-03 | 频道隔离 | 区域频道仅同层同区域可见；种族频道仅同族同层可见 |
| AC-04 | 跨层传音 | 使用传音符可跨层发送私聊消息，消耗数量按层级差距递增 |
| AC-05 | 消息类型 | 6 种消息类型均可正常发送、接收、展示 |
| AC-06 | 敏感词过滤 | L1 敏感词实时拦截，L2 异步审核标记折叠 |
| AC-07 | 频率限制 | 超过频率限制时提示「发言过快」并阻止发送 |
| AC-08 | 自动禁言 | 连续刷屏触发自动禁言，禁言期间不可发言 |
| AC-09 | 举报 | 举报消息正常提交，处理结果通过邮件通知 |
| AC-10 | 个人屏蔽 | 屏蔽后对方消息不可见，对方无感 |
| AC-11 | 系统广播 | 天启/渡劫/拍卖/世界事件等系统消息差异化呈现 |
| AC-12 | 聊天记录 | 本地缓存 + 服务端历史正常工作，7 天后自动清理 |
| AC-13 | 社交联动 | 从聊天消息可直接发起组队/交易/好友/师徒邀请 |
| AC-14 | 表情发送 | 基础表情正常发送和展示 |
| AC-15 | 称号展示 | 聊天消息携带称号前缀，可切换/隐藏 |

### 12.2 性能验收

| 编号 | 验收项 | 验收标准 |
|------|--------|----------|
| PERF-01 | 消息延迟 | 同层消息端到端延迟 ≤ 200ms（P99） |
| PERF-02 | 跨层消息延迟 | 传音符跨层消息延迟 ≤ 500ms（P99） |
| PERF-03 | 并发消息 | 单频道支持 1000+ 并发消息/秒 |
| PERF-04 | 历史消息加载 | 加载最近 200 条历史消息 ≤ 1 秒 |
| PERF-05 | 敏感词过滤 | L1 过滤延迟 ≤ 50ms（P99） |

### 12.3 安全验收

| 编号 | 验收项 | 验收标准 |
|------|--------|----------|
| SEC-01 | XSS 防护 | 所有消息内容在客户端渲染时转义，不执行脚本 |
| SEC-02 | 消息伪造 | 消息发送必须经过服务端鉴权，不可客户端伪造 |
| SEC-03 | 频率绕过 | 频率限制在服务端执行，客户端不可绕过 |
| SEC-04 | 屏蔽绕过 | 屏蔽列表在服务端校验，被屏蔽者消息不推送到屏蔽者 |
| SEC-05 | 数据脱敏 | 举报记录中的消息内容脱敏存储（仅保留前后各 20 字符） |

---

## 第十三章 与核心系统的接口

| 系统 | 接口点 |
|------|--------|
| GDD-02 ✅46 | 本文是「区域聊天与广播系统」的完整落地 |
| GDD-02 ✅97 | 聊天系统是「玩家互动优先」的基础设施 |
| GDD-07 四组织 | 帮派/门派/家族频道直接对接组织系统 |
| GDD-08 ✅D07 | 区域频道按世界层级隔离 |
| GDD-08 ✅D17 | 「附近的人」在区域频道中展示 |
| GDD-09 ✅60-62 | 祖地追杀令/入侵通报通过种族频道广播 |
| GDD-13 佣兵悬赏 | 帮派频道播报佣兵委托状态 |
| GDD-14 拍卖/✅68 | 拍卖广播 + 情报购买入口通过世界频道推送 |
| GDD-16 ✅S09 | 本文在 ✅S09 基础上扩展深化 |
| GDD-16 社交关系链 | 聊天社交联动（师徒/道侣/结义邀请） |
| GDD-23 能量体系 | 传音符消耗不影响能量（纯道具消耗） |
| TDD-04 数据库 | chat_messages / chat_channels / chat_block_list 等表 |
| TDD-05 API | 聊天相关 RESTful + WebSocket 接口 |

---

## 第十四章 待设计内容

- [ ] 表情包完整列表（基础 30 个 + 种族专属表情各 3-5 个）
- [ ] 敏感词库初始版本（与运营团队协作）
- [ ] 举报审核后台界面设计（运营工具）
- [ ] 聊天频道 UI/UX 原型（客户端设计）
- [ ] 传音符道具详细数值（制作材料/商城价格/掉落概率，接 GDD-06 经济联调）
- [ ] 跨服聊天方案（若后续支持多服，需评估跨服频道架构）

---

*GDD-29 v1.0 | 2026-07-02 | 初始版本：基于 GDD-16 ✅S09 扩展深化聊天与信息传递系统，覆盖频道层级、消息类型、安全防护、存储策略、社交联动五大模块 | 前序：GDD-16 v1.6 社交系统*