海狸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 批量拉会话信息 | ✅ | ✅ | 服务端 API 支持 |
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 | — | ✅ | |
| 通话时长记录 | ✅ | ✅ | 以 CallMsg 形式进聊天记录 |
| 屏幕共享 | 🔶 | — | PC UI 占位，未完全启用 |
十二、文件与媒体
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 用户能感知的主升级
- 六端工程拆分：聊天、运营、OAuth 独立仓库，版本清晰
- Flutter 替代 Uniapp：性能、离线、通话体验提升
- 消息能力补全：回复、转发（含合并）、撤回、Markdown、语音、多媒体统一 fileUrl
- PC 独立设置中心：设备管理、快捷键云端同步
- OAuth2 可接入：自有系统「海狸账号登录」
- 群 Webhook 机器人：告警 / CI 进群
- 运营后台增强：360 视图、Moderation、在线监控、发版策略
- 语音未听跨端同步、消息媒体态 独立同步
二一、小结
本文是海狸 IM 2.0 功能说明书：从账号、好友、群、消息类型、会话、表情、动态、通话、双端差异、开放能力到运营后台，按 「有什么、谁能用、用到哪」 展开。
若你正在对比开源 IM 或向团队介绍海狸，建议 收藏本篇作能力索引；具体接口与部署以在线文档为准，2.1 的智能机器人、工作台等以 PRD / CHANGELOG 更新为准。
相关链接
项目源码：
学习资源：
核心教学视频：
