海狸IM 2.0 功能详细介绍：六端能力说明书

文档性质：海狸 IM 2.0 产品能力说明，供选型、团队对齐、对外介绍使用。
版本基线：beaver-server 2.0.1 / beaver-flutter 2.0.1 / beaver-desktop 2.0.0 / beaver-manager 2.0.1 / beaver-open & beaver-oauth 2.0。
说明：✅ 表示 2.0 已具备；🔶 表示部分端或需配置；❌ 表示 2.0 未做（可能在 2.1+ 规划）。

---

写在前面：这篇文档解决什么问题

发版文章讲「变了什么」，技术文章讲「怎么实现」。但很多人只需要一份答案：

「海狸 IM 到底有哪些功能？能不能满足我们？」

本文按 用户能感知的能力 展开，尽量写细：每个模块下列 子功能、双端支持情况、典型用法。
技术实现见 46 / 47 号文；OAuth 与群推送边界见 45 号文。

---

一、产品是什么：六个工程，一套 IM

海狸 IM（Beaver IM）是 可私有化部署的开源即时通讯系统，不是官方运营的 SaaS。你可以把完整链路部署在自己的服务器上。

工程	版本	谁用	核心能力
beaver-server	2.0.1	运维 / 开发	聊天、同步、文件、通话、OAuth、运营 RPC
beaver-flutter	2.0.1	终端用户	移动端：聊天、通话、动态、离线
beaver-desktop	2.0.0	终端用户	PC 端：聊天、群助手、设置中心、多窗口
beaver-manager	2.0.1	运营 / 管理员	用户管控、审核、监控、发版、表情运营
beaver-open	2.0	开发者	OAuth2 应用创建、密钥、Scope
beaver-oauth	2.0	终端用户	授权确认页、扫码登录 UI

移动端主线为 Flutter（2.0 起）；早期 Uniapp 版本 不再维护。

产品定位（一句话）：好友 + 群聊 + PC/移动双端 + 运营后台 + OAuth 开放接入；不做 企业通讯录 / 官方 SaaS / 飞书式 OA 全家桶。

---

二、账号、注册与登录

2.1 注册与登录方式

能力	PC	Flutter	说明
邮箱注册	✅	✅	验证码注册流程
手机注册	✅	✅	短信验证码（依赖服务端短信配置）
邮箱 + 密码登录	✅	✅
手机 + 密码登录	✅	✅
邮箱验证码登录	✅	✅	免密登录
找回 / 重置密码	✅	✅	邮箱或手机验证

2.2 扫码登录（OAuth / PC 登录场景）

能力	说明
生成登录二维码	第三方 Web 或 PC 展示
移动端扫码确认	海狸 App 扫二维码完成授权
二维码状态轮询	待扫 / 已扫 / 已确认 / 过期

用于 OAuth2 第三方接入 或 PC 端快捷登录，与 45 号文 OAuth 流程配合。

2.3 账号安全与设备管理

能力	PC	Flutter	说明
修改登录密码	✅ 设置中心	🔶	移动端 2.0 设置弱于 PC，2.1 对齐
已登录设备列表	✅	🔶	展示 UA、在线状态
远程踢设备下线	✅	🔶	踢掉其他端登录
退出登录	✅	✅

---

三、个人资料与用户设置

3.1 资料展示与编辑

能力	PC	Flutter
头像	✅	✅
昵称	✅	✅
个性签名 / 简介	✅	✅
查看他人资料（好友 / 群成员）	✅	✅
编辑个人资料页	✅	✅

3.2 用户设置（跨端同步）

能力	PC	Flutter	说明
用户设置 JSON 存服务端	✅	🔶	PC 快捷键等写入服务端
快捷键自定义	✅	—	换电脑登录可恢复
通用设置（通知、缓存等）	✅	✅

---

四、好友与通讯录

4.1 好友关系

能力	PC	Flutter	说明
好友列表	✅	✅	通讯录 Tab
搜索用户（加好友）	✅	✅	按用户名等搜索
发起好友申请	✅	✅	可附验证消息
收到的好友申请列表	✅	✅	同意 / 拒绝
发出的申请历史	✅	✅
好友详情	✅	✅	资料、发消息入口
删除好友	✅	✅
修改好友备注	✅	✅

4.2 黑名单

能力	PC	Flutter
拉黑用户	✅	✅
取消拉黑	✅	✅
黑名单列表	✅	✅

拉黑后 无法互发私聊消息（服务端 IsBlocked 校验）。

4.3 数据同步

好友列表、好友申请均支持 datasync 增量同步（getSyncFriends、getSyncFriendVerifies），换设备登录后关系不丢。

---

五、群聊与群管理

5.1 群基础

能力	PC	Flutter	说明
创建群聊	✅	✅	选好友建群
我的群聊列表	✅	✅
群名称 / 头像	✅	✅	管理员可改
群公告	✅	✅
群成员列表	✅	✅
邀请成员入群	✅	✅
移除群成员	✅	✅	需权限
主动退群	✅	✅
解散群	✅	✅	群主
搜索群	✅	🔶	服务端 searchGroups

5.2 群角色与权限

能力	说明
群主	最高权限：转让群主、解散、管理成员
管理员	管理成员、公告等（以群设置为准）
普通成员	发言、邀请（视群设置）
修改成员角色	✅ 群主可操作
转让群主	✅

5.3 入群方式

能力	PC	Flutter
邀请入群	✅	✅
申请入群	✅	✅
入群申请列表（管理员审批）	✅	✅
同意 / 拒绝入群申请	✅	✅

5.4 群禁言

能力	说明
全员禁言	管理员开启后普通成员不可发言
单人禁言	指定成员禁言
发言前校验	服务端 CanSendGroupMessage，禁言用户发消息会被拒

5.5 群助手 — 通知机器人（2.0 开放能力之一）

能力	PC	Flutter	说明
创建通知机器人	✅ 群详情→群助手	—	2.0 配置入口在 PC
机器人类型	通知机器人 / 自定义机器人
设置名称、头像、描述	✅
获取 Webhook 推送 URL	✅		带 Token
重置密钥	✅
删除 / 停用机器人	✅
群内展示机器人消息	✅	✅	外部 POST 后双端可见

用法：CI、监控、定时任务向 Webhook POST，群聊里出现一条机器人通知。
边界：2.0 为 单向推送，不支持群内 @机器人 自动回复（2.1 规划）。详见 45 号文。

5.6 群系统通知消息

群内自动插入 通知类消息（非用户手写），例如：

类型码	含义
2	创建群
3	成员加入群
4	成员退出群
5	成员被踢
6	转让群主
7	添加群机器人
8	移除群机器人

---

六、会话与聊天列表

6.1 会话列表

能力	PC	Flutter
最近会话列表	✅	✅
会话预览（最后一条消息摘要）	✅	✅
未读数展示	✅	✅
删除会话（从列表移除）	✅	✅
隐藏会话	✅	✅
置顶会话	✅	✅
会话免打扰	✅	✅
按会话 ID 批量拉会话信息	✅	✅

6.2 会话类型

类型	说明	2.0
私聊（单聊）	一对一好友会话	✅
群聊	多人群组会话	✅
AI 会话	协议层预留 chatType=3	🔶 内置 AI 未产品化

---

七、消息能力（核心）

7.1 支持的消息类型

服务端 Msg.type 定义（双端按类型渲染）：

类型码	名称	PC	Flutter	说明
1	文本	✅	✅	plain text
2	图片	✅	✅	fileUrl，可带宽高
3	视频	✅	✅	fileUrl + 封面 thumbnailUrl
4	文件	✅	✅	Office/PDF 等，fileName、mimeType
5	语音	✅	✅	按住说话，duration
6	表情	✅	✅	系统表情 / 收藏表情 / 表情包
7	通知	✅	✅	入群、加好友等系统通知
8	音频文件	✅	🔶	音频附件，非按住语音
9	通话	✅	✅	音视频通话记录卡片
10	撤回	✅	✅	撤回原消息
11	回复	✅	✅	引用回复，带原消息快照
12	转发	✅	✅	逐条 / 合并转发
13	Markdown	✅	✅	富文本、代码块等
14	链接卡片	✅	🔶	标题、描述、预览图
15	云文档卡片	🔶	🔶	协议已定义，视部署启用

2.0 统一媒体字段 fileUrl，避免 PC 和手机各用一套 URL 字段导致展示不一致。

7.2 消息操作

操作	PC	Flutter	说明
发送消息	✅ WS 上行	✅ WS 上行	乐观 UI，本地先显示「发送中」
回复（引用）	✅ ReplyBar	✅ ReplyBar
转发	✅	✅	逐条转发 或 合并转发
查看合并转发详情	✅	✅	按 recordId 拉快照列表
撤回	✅	✅	限时撤回
编辑已发文本	✅ EditBar	✅ EditBar	双端 UI 已接；服务端 edit 路由在版本对齐中完善
批量删除消息	✅	✅	最多 100 条/次
@ 指定用户	✅	✅	群聊 @ 成员，msg 带 atUserIds
消息已读 seq	✅	✅	单聊已读状态同步
语音「未听 / 已听」	✅	✅	独立媒体态，跨端 sync

7.3 消息搜索

能力	PC	Flutter
全局搜索（跨会话）	✅ 较完整	🔶 基础
指定会话内搜索	✅	✅
关键词高亮 / 跳转	✅	✅

7.4 消息同步机制（用户可感知）

场景	行为
在线收消息	WebSocket 通知 → 自动拉取新 seq 消息
离线后再上线	datasync 摘要 → 按 seq 区间补消息
弱网	本地 SQLite / Drift 可看历史，恢复网络后增量同步
换设备登录	同账号拉云端 seq，本地库追平

---

八、表情系统

8.1 客户端

能力	PC	Flutter
系统默认表情	✅	✅
表情面板	✅	✅
收藏单个表情	✅	✅
收藏整套表情包	✅	✅
表情商店（浏览 / 添加）	✅	✅
发送表情消息	✅	✅
分享表情包	✅	🔶

8.2 运营侧（beaver-manager）

能力	说明
表情 CRUD	上传、编辑、删除单个表情
表情包 CRUD	创建包、往包里加表情
用户收藏数据查看	运营统计

---

九、动态（Moment）— 轻社交

能力	PC	Flutter
发布图文动态	✅	✅
动态列表（好友流）	✅	✅
动态详情	✅	✅
点赞	✅	✅
点赞列表	✅	✅
评论	✅	✅
评论列表	✅	✅
删除自己的动态	✅	✅
动态相关通知	✅	✅

---

十、通知中心

能力	PC	Flutter	说明
通知事件 inbox	✅	✅	好友、群、动态等
按事件已读	✅	✅
按分类已读	✅	✅
未读摘要	✅	✅
删除通知	✅	✅
推送 Token 注册	🔶	🔶	服务端 API 已有，Flutter 离线推送在 2.1 完善

datasync 支持：getSyncNotificationEvents、getSyncNotificationInboxes、getSyncNotificationReadCursors。

---

十一、音视频通话（LiveKit）

能力	PC	Flutter
发起语音通话	✅	✅
发起视频通话	✅	✅
私聊通话	✅	✅
群聊通话 / 邀人入会	✅	✅
获取 LiveKit Token	✅	✅
挂断	✅	✅
来电横幅 IncomingCallBanner	—	✅
通话时长记录	✅	✅
屏幕共享	🔶	—

---

十二、文件与媒体

12.1 上传与存储

能力	说明
图片上传	聊天发图、头像等
语音上传	语音消息
视频上传	视频消息、动态
文件上传	文档附件
存储后端	MinIO / 本地 / 七牛等（按部署配置）
文件预览	管理后台与 API 支持 preview

12.2 客户端体验

能力	PC	Flutter
聊天内发图 / 视频 / 文件	✅	✅
拍照发送	—	✅
相册选择	✅	✅
图片预览 / 视频播放	✅	✅
文件下载	✅	✅

---

十三、PC 端（beaver-desktop）专有能力

能力	说明
独立设置中心	账号、快捷键、关于、更新
系统托盘	最小化到托盘、消息提醒
多窗口	搜索、图片、视频等独立窗口
群助手配置	创建 Webhook 通知机器人
全局搜索窗口	独立搜索 UI
快捷键云端同步	写入服务端 user settings
应用自动更新	关于页检查更新

---

十四、移动端（beaver-flutter）专有能力

能力	说明
Drift 本地库	离线看历史、增量 sync
来电横幅	音视频来电全屏/横幅
多媒体采集	拍照、录像
意见与反馈	应用内提交反馈到 platform 服务
数据库状态页	开发 / 调试向同步状态展示

---

十五、开放能力（OAuth2 + 群 Webhook）

15.1 OAuth2 第三方登录 — ✅ 2.0 已支持

能力	说明
开发者门户 beaver-open	创建 OAuth2 应用
AppId / AppSecret	应用凭证
redirect_uri 配置	回调白名单
Scope 权限范围	限制可读用户信息
Secret 轮换 / Token 吊销	门户管理
授权页 beaver-oauth	用户确认授权 UI
扫码登录	PC 展示码，App 扫
Authorization Code	标准 Web 后端接入
H5 授权码	移动浏览器
OAuth Code 登录	2.0.1 服务端补充

入口：beaver-open + beaver-oauth + beaver-server open/auth 模块。
不是：在 open 门户里配 IM 事件 Webhook（2.1 规划）。

15.2 群推送机器人 — ✅ 2.0 已支持

见 第五章 5.5。配置在 PC 群助手，不在 open 门户。

15.3 2.0 尚未产品化的开放能力

能力	状态
开放平台 @ 智能机器人	❌ → 2.1
门户订阅 IM 事件 Webhook	❌ → 2.1
开发者 Robot 双向对话	❌ → 2.1
Robot 流式回复（SSE）	🔶 文档与 scaffold 有，产品化 2.1

---

十六、运营后台（beaver-manager）

面向管理员，普通用户不登录。

16.1 总览与监控

能力	说明
仪表盘概览	核心指标大盘
趋势图	用户 / 活跃趋势
待办 inbox	审核待办汇总
在线统计	当前在线人数
在线用户列表	谁在线
用户在线设备详情	UA、连接信息

16.2 用户管理

能力	说明
用户列表 / 搜索
用户 360 视图	基本信息、好友、群、会话、操作记录
创建用户	运营代建账号
编辑用户资料
删除用户
批量删除
批量改状态（启用 / 禁用）
重置用户密码

16.3 聊天与内容管理

能力	说明
会话列表查询	运营审计
消息列表查询
消息详情
删除消息
批量删除消息
恢复已删消息
清空会话
按类型删除消息

16.4 内容与安全（Moderation）

能力	说明
用户举报列表
举报升级 / 驳回
审核案件（Case）	创建、处理、详情
案件上下文查看	关联消息等内容
用户管控执行	封禁等
操作日志
敏感词库	增删改查

16.5 开放应用审核

能力	说明
开发者入驻审核
开放应用审核	通过 / 拒绝
应用列表

16.6 表情运营

见第八章运营侧。

16.7 文件管理

能力	说明
文件列表
文件详情 / 预览
删除 / 批量删除
本地上传 / 七牛上传

16.8 客户端发版管理

能力	说明
应用管理（desktop / flutter 等）
架构管理（win / mac / android…）
版本发布	版本号、下载地址
发版策略	强制更新、灰度等
客户端上报版本	公共 API

16.9 其他

能力	说明
用户反馈处理	移动端提交的意见反馈
动态管理	运营侧 moment 管理
群组 / 好友关系查询	运营排查

---

十七、服务端基础能力（beaver-server 2.0.1）

用户不直接感知，但选型时常问：

类别	能力
架构	go-zero 微服务、API + RPC、gRPC 内部调用
网关	统一 REST 入口、JWT 鉴权
实时	WebSocket；RocketMQ 解耦推送
同步	datasync 全模块增量摘要（见下表）
消息	seq 递增、tableUpdates 推送、chatSync 区间拉
鉴权锁	authlock 多实例并发安全
日志	统一日志模块
API 规范	REST v1 路径

datasync 已覆盖的同步模块

接口	同步对象
getSyncChatMessages	各会话消息 seq 摘要
getSyncDeletedMessages	已删消息
getSyncMessageMedias	语音未听等媒体态
getSyncChatConversations	会话信息
getSyncChatUserConversations	用户-会话关系（置顶、免打扰等）
getSyncFriends	好友
getSyncFriendVerifies	好友申请
getSyncAllUsers	用户资料变更
getSyncGroupInfo	群资料
getSyncGroupMembers	群成员
getSyncGroupRequests	入群申请
getSyncEmojis / getSyncEmojiCollects	表情
getSyncNotification*	通知中心

---

十八、双端差异一览（选型用）

维度	PC 更强	Flutter 更强
群 Webhook 机器人 配置	✅	仅接收
设置中心（改密、设备、快捷键）	✅	2.1 对齐中
全局搜索	✅	基础
来电横幅	—	✅
离线本地库	✅	✅ Drift
意见反馈	—	✅
系统托盘 / 多窗口	✅	—

同一账号、同一套 seq 与 fileUrl 协议，是 一个 IM 的两个端，不是两个产品拼盘。

---

十九、2.0 明确不做 / 未做（避免误判）

项	说明
企业通讯录 / 组织架构树	❌ 不做
官方 SaaS 公共服务器	❌ 不做，仅私有化
工作台 H5 应用宫格	❌ 2.1 规划
App 内置 AI 助手 Tab	❌ 后续版本
小程序运行时	❌ 不做
飞书 / 钉钉级 OA（文档、日历、审批）	❌ 不对标
群内 @ 智能机器人自动回复	❌ 2.1
正在输入 typing UI	🔶 服务端有，双端 UI 完善中

---

二十、和 1.x 比：2.0 用户能感知的主升级

1. 六端工程拆分：聊天、运营、OAuth 独立仓库，版本清晰
2. Flutter 替代 Uniapp：性能、离线、通话体验提升
3. 消息能力补全：回复、转发（含合并）、撤回、Markdown、语音、多媒体统一 fileUrl
4. PC 独立设置中心：设备管理、快捷键云端同步
5. OAuth2 可接入：自有系统「海狸账号登录」
6. 群 Webhook 机器人：告警 / CI 进群
7. 运营后台增强：360 视图、Moderation、在线监控、发版策略
8. 语音未听跨端同步、消息媒体态 独立同步

---

二一、小结

本文是海狸 IM 2.0 功能说明书：从账号、好友、群、消息类型、会话、表情、动态、通话、双端差异、开放能力到运营后台，按 「有什么、谁能用、用到哪」 展开。

若你正在对比开源 IM 或向团队介绍海狸，建议 收藏本篇作能力索引；具体接口与部署以在线文档为准，2.1 的智能机器人、工作台等以 PRD / CHANGELOG 更新为准。

---

相关链接

项目源码：

• 后端源码：https://github.com/wsrh8888/beaver-server
• 移动端Flutter源码：https://github.com/wsrh8888/beaver-flutter
• PC端源码：https://github.com/wsrh8888/beaver-desktop.git
• 后台管理系统源码：https://github.com/wsrh8888/beaver-manager
• 开放平台门户源码：https://github.com/wsrh8888/beaver-open
• OAuth 授权登录页源码：https://github.com/wsrh8888/beaver-oauth

学习资源：

• 在线文档：https://wsrh8888.github.io/beaver-docs/

核心教学视频：

• 本地搭建教程合集：https://space.bilibili.com/269553626/lists/6075764?type=season
• 服务器部署教程合集：https://space.bilibili.com/269553626/lists/6075828?type=season

---