ErisPulse-DashChat

跨平台实时消息收发模块，提供一个类即时通讯的聊天界面

通过 DashChat，你可以在 Dashboard 中统一查看和管理所有平台（OneBot、云湖、Telegram、QQ、Ideaura 等）的消息、通知、请求和元事件，并直接回复。

功能

• 实时消息收发 — 通过 WebSocket 推送 + 轮询兜底，消息即时到达
• 全事件类型支持 — 消息（message）、通知（notice）、请求（request）、元事件（meta）全部展示
• OneBot 12 富消息渲染 — 图片、音频、视频、文件、@提及、回复、表情、位置、转发等
• SQLite 持久化 — 通过 sdk.storage 存储会话和消息记录，重启不丢失
• 多 Bot 账号 — 按 平台 / Bot ID 分组展示会话，支持指定 Bot 发送消息
• i18n — 跟随 Dashboard 语言设置，支持中文、英文、繁体中文、日语、俄语

安装

epsdk install DashChat

前置依赖：ErisPulse >= 2.4.3，以及 ErisPulse-Dashboard 模块。

配置

无需额外配置。DashChat 作为 Dashboard 的视图自动注册，安装后刷新 Dashboard 页面即可在侧边栏看到 "DashChat" 入口。

使用

查看消息

打开 Dashboard → 点击侧边栏 "DashChat"，左侧按平台和 Bot 分组展示所有会话，点击会话查看消息记录。

发送消息

在会话输入框中输入文字，按 Enter 或点击发送按钮即可通过 SendDSL 发送消息。

处理请求

加好友、加群等请求事件会显示 "同意" / "拒绝" 按钮，点击即可处理。

查看原始事件

每条消息可展开 "原始事件" 查看完整的 JSON 数据。

支持的消息段类型

昵称解析

DashChat 会按优先级从多个来源提取用户昵称/群名片：

1. event.sender.nickname（OB12 标准格式）
2. event.user_nickname（SDK base_event 格式）
3. {platform}_raw.sender.card（QQ 群名片）
4. {platform}_raw.sender.nickname（原始平台昵称）
5. {platform}_raw.sender.senderNickname（云湖格式）
6. {platform}_raw.sender.name（Telegram / 云湖 User）

头像 URL 同样从 sender.avatar 或 sender.senderAvatar 中提取。

API

DashChat 注册以下 HTTP API 端点（需要 Dashboard Token 认证）：

数据存储

使用三张 SQLite 表：

• dashchat_sessions — 会话列表（平台、类型、目标、未读数、最后消息）
• dashchat_messages — 消息记录（事件类型、方向、发送者、内容、原始数据）
• dashchat_platform_notices — 平台级通知（notice/request/meta 事件）

每个会话最多保留 100 条消息，自动清理旧记录。