首页 产品 为什么选 OCTO 解决方案 文档 关于
文档中心 / 模块详解 / 即时通讯
← 返回文档中心

即时通讯

OCTO 文档中心 · 模块详解
  • 01-product/OCTO是什么.md v1.x
  • 02-architecture/OCTO总体架构.md v1.x（消息链路、Bot事件模型）
  • 02-architecture/OCTO全组件服务清单.md v0.1（全组件硬事实）
  • 01-product/模块说明/ 各模块v0.3文档（docs/drive/fleet-loop/marketplace/speech/summary/search/我的）
  • 01-product/模块说明/模块间联动关系总览.md v0.1
  • 06-api-integration/Bot-API概览.md v0.3
  • octo-server README.zh.md
  • source-repos-internal/octo-deployment（docker-compose.yaml, helm values, nginx配置）

OCTO 核心能力概览 v2.0

用途：售前/新人1分钟快速扫读OCTO各核心能力"能做什么、边界在哪"。每节1-3句话，末尾链到深度文档。

本版本（v2.0）基于P0扩展阶段二全部8个模块v0.3文档，完整覆盖开源版已有与内部版独有能力，标注profile开关、端侧支持与确认状态。

能力总览

  • 开源版能力（GitHub开源仓库可获取，Apache 2.0）：核心IM + Bot/开放API + AI Agent集成 + 卡片消息 + 基础文件
  • 内部版独有能力（内部部署仓库，需明略商业授权）：文档协同、企业网盘、回路Loop/Fleet、市场Marketplace、智能语音、智能摘要、全文搜索、我的/个人中心

1. 核心即时消息（IM）

属性 值
版本归属 ✅ 开源已有
Profile开关 默认启动（无profile）
端侧支持 Web / iOS / Android / PC-Electron 全端

2. 群组（Group）

属性 值
版本归属 ✅ 开源已有
Profile开关 默认启动
端侧支持 Web / iOS / Android / PC 全端

3. 子区/话题（Thread）

属性 值
版本归属 ✅ 开源已有
Profile开关 默认启动
端侧支持 Web / iOS / Android / PC 全端

4. 文件与附件

属性 值
版本归属 ✅ 开源已有
Profile开关 默认启动
端侧支持 Web / iOS / Android / PC 全端

⚠️ 注意：此处"文件"指IM消息附件（chat/file bucket），不等同于「企业网盘Drive」（见第9项）。

5. Bot与开放API

属性 值
版本归属 ✅ 开源已有
Profile开关 默认启动
端侧支持 服务端API

6. 卡片消息（Interactive Card）

属性 值
版本归属 ✅ 开源已有
Profile开关 默认启动
端侧支持 Web / iOS / Android / PC 全端（按客户端profile降级）

7. OIDC SSO与权限安全

属性 值
版本归属 ✅ 开源已有
Profile开关 默认启动
端侧支持 Web / PC（SSO登录）

8. AI Agent（龙虾/Lobster）集成

属性 值
版本归属 ✅ 开源已有（Agent一等公民架构）
Profile开关 默认启动
端侧支持 Web / iOS / Android / PC（在会话中@Agent）

⚠️ 开源版的Agent能力限于"消息→Bot→回复"基础链路；回路Loop/Fleet（项目管理+多Agent协作编排）为内部版独有，见第10项。

9. 文档协同（Docs）

属性 值
版本归属 ❌ 内部版独有
Profile开关 docs（docs-backend）+ docs-html（HTML文档，依赖docs）
端侧支持 Web端左侧导航「文档」独立空间（/docs）；iOS/Android支持待确认
功能门控 docs_on / docs.enabled appconfig flag
  • docs-backend（:3000 REST + :1234 Hocuspocus WS）：5类文档表面——富文本文档、表格Sheet、白板Board（Excalidraw）、PPT演示文稿；docx/Markdown双向导入导出；评论分级（reader/commenter/writer）；版本历史（快照+两版本对比+恢复）
  • docs-html（:8080）：独立HTML文档服务（非"发布只读页"），具备完整文档生命周期（发布/版本/草稿/分享/权限/评论/元素编辑），Bot可创建HTML文档转发到聊天（典型场景：Bot生成HTML报告）

10. 企业网盘（Drive）

属性 值
版本归属 ❌ 内部版独有
Profile开关 drive
端侧支持 ⚠️ 仅Web端，iOS/Android未实现
功能门控 drive_on（默认false）
  • 两级空间：个人空间 + 共享空间（成员管理/角色/邀请链接）
  • 文件操作：上传/下载/浏览/删除/重命名/移动/复制/新建文件夹
  • 分享：支持组织外访问（外部成员可打开分享链接）
  • 聊天转存：聊天中收到的文件一键转存到网盘（Web v2026.08.10+）
  • 云文档挂载：网盘目录可挂载已挂载的云文档（listMountedDocs API）
  • 全文搜索：对接drive-indexer+Tika+OpenSearch实现文件正文搜索（Web v2026.08.24+，drive-index profile）

11. 回路Loop与运行时管理Fleet

属性 值
版本归属 ❌ 内部版独有
Profile开关 fleet + fleet-db（内置PostgreSQL）
端侧支持 ⚠️ 仅Web端（移动端确认无回路，dmloop_on未实现）
功能门控 dmloop.enabled（管理员控制开启）
  • 自动检测本地AI Agent CLI（Claude Code / Codex / OpenClaw / Hermes）
  • space-scoped API key认证（私聊BotFather发/daemon获取安装命令+server URL+API key，写入~/.octo-daemon/config.json）
  • 上报本地Agent状态供Web「Runtimes」查看
  • 支持一键远程升级插件
  • 待daemon在线后才能三步建Bot

12. 市场Marketplace（技能/插件/专家市场）

属性 值
版本归属 ❌ 内部版独有
Profile开关 docker-compose默认启动（无profile gating）；helm values.yaml默认enabled=false（待确认）
端侧支持 Web端（两个承载面）
  • Web「回路」→「专家市场」（v2026.08.17+）：浏览/安装专家(Expert)/专家团(Expert Team)/技能包(Skill)，展示使用量/安装量
  • Web「插件市场」（v2026.09.14升级）：插件/技能发布、管理、浏览，支持插件评分、Space管理员配置自动审核策略
  • MCP以「连接器」形态在"应用市场"出现（v2026.08.10中文化）
  • 平台发布标「官方发布」；安装技能包=写入安装策略+自动去重+失败重试（v2026.08.24），安装后在回路工作区给专家使用，不创建Bot实例
  • OctoPush客户端有独立"龙虾专家市场"

13. 智能语音Speech（ASR）

属性 值
版本归属 ❌ 内部版独有
Profile开关 speech
端侧支持 全端支持（Web/iOS/Android）
用户开关 首次使用需opt-in（设置→语音设置确认协议）
  • 触发：Web长按左Shift 300ms/500ms或麦克风图标；移动端按住说话
  • 两种子模式：插入光标位置 / Web语音编辑（选中文本录音替换选中内容，Web端独有）
  • 全端支持
  • @mention识别、口语化书面语优化、情感emoji标注（VOICE_EMOTION_EMOJI=true默认开）
  • 转写结果对能看到消息的人可见
  • Bot收到语音消息自动转写为文字；Bot有语音纠错API（/v1/bot/voice/context管理人名/专有名词/术语）

14. 智能摘要Summary

属性 值
版本归属 ❌ 内部版独有
Profile开关 summary
端侧支持 全端（Web功能最全；iOS v1.0.0+；Android v1.3.3+）
  • summary-api（:8080 外部API + :8081 内部回调）：前端请求、SSE流式返回总结结果、总结CRUD
  • summary-worker（:8082）：跑定时总结任务（日/周/月周期），异步处理；2026-07-06起map-reduce+意图识别处理长会话
  • 手动：Web左侧导航「智能总结」/ ✨一键总结（来源30条消息，v2026.06.06）/ iOS-Android底部「上下文」
  • 定时：日/周/月周期自动总结（Web v2026.06.13），可选归档线程
  • Agent驱动：Agent可触发/执行总结（PR#850），总结结果可供Agent引用（v2026.08.17）

⚠️ 注意区分「智能总结」与「AI速览」（v2026.09.14新上线，可速览并一键转文档，属不同功能）。

15. 全文搜索Search

属性 值
版本归属 ❌ 内部版独有（开源版有搜索代码框架但需Kafka+OpenSearch基础设施）
Profile开关 search（核心Kafka+OS+es-indexer）+ doc-index（依赖docs+search）+ drive-index（依赖drive+search）+ search-producer（K8s独立producer）+ search-tools（初始化工具）
端侧支持 消息搜索全端；文档/网盘搜索端侧支持待确认 
Producers → Kafka（事件总线）→ Indexers → OpenSearch（全文引擎，IK中文分词）
索引 内容 Web上线
octo-message 即时消息全文（文本/图片caption/文件名/合并转发内容） 初始版本
octo-doc 云文档正文内容 v2026.08.03
octo-drive 网盘文件正文（经Tika提取文本，不只文件名） v2026.08.24
  • IK中文分词（索引用ik_max_word细粒度，查询用ik_smart智能）
  • 消息搜索尊重权限（解散状态authz校验，撤回/删除MySQL post-filter兜底fail-closed）
  • 高亮（标签）、cursor分页（HMAC防篡改）、routing按channelId分片
  • Bot搜索：POST /v1/botfather/messages/search 以Bot主人身份搜索（OBO模式，权限等同主人），octo-cli使用
  • DLQ死信队列保证消费失败不丢失；search-producer-guard双向互斥防双写；cursor-seed+backfill工具支持首次初始化/索引重建
  • 5 QPS/用户限流

⚠️ 开源版octo-server中包含messages_search模块代码，但Kafka+OpenSearch索引管道基础设施为内部版完整提供。

16. 我的/个人中心

属性 值
版本归属 ❌ 内部版独有（回路相关部分）
Profile开关 归dmloop.enabled门控（与Loop一致）
端侧支持 ⚠️ 仅Web端（移动端确认无回路）
  • 运行时/设备管理（"添加电脑"=Loop Runtime）：管理AI队友/专家运行的机器，通过octo-daemon将本地电脑接入作为专家执行环境
  • Skills管理：Loop里可复用的技能包，分配给专家(Expert)使用；支持从URL/运行时导入（「从运行时复制技能」=本地skill→云端工作区）；从Marketplace「专家市场」安装技能包到我的（写入安装策略+自动去重+失败重试）
  • 专家/专家团：回路里的AI协作体（跑在runtime/daemon上），原称"AI队友"/"AI小队"
  • 自动化（归Loop）

⚠️ "我的"还包含哪些功能（设置/个人资料/通知等）待源码确认。移动端dmloop_on未实现，确认无回路相关功能。

能力状态一览表

# 能力域 版本归属 Profile开关 端侧支持 状态 备注
1 即时消息IM ✅ 开源已有 默认 全端 ✅ 已确认 撤回Bot端点待确认
2 群组Group ✅ 开源已有 默认 全端 ✅ 已确认 解散/改角色不开放给Bot
3 子区Thread ✅ 开源已有 默认 全端 ✅ 已确认 全套9端点
4 文件与附件 ✅ 开源已有 默认 全端 ✅ 已确认 S3兼容可替换；注意≠Drive网盘
5 Bot/开放API ✅ 开源已有 默认 服务端 ✅ 已确认 8套API分类清晰
6 卡片消息 ✅ 开源已有 默认 全端(降级) ✅ 已确认 展示/交互/进度/模板
7 OIDC SSO/权限安全 ✅ 开源已有 默认 Web/PC ✅ 已确认 RBAC+ACL+HMAC+opaque token
8 AI Agent集成 ✅ 开源已有(基础) 默认 全端 ✅ 已确认 OpenClaw插件一等公民；Loop协作层内部独有
9 文档协同Docs ❌ 内部独有 docs+docs-html Web（移动端待确认） ✅ 已确认 Tiptap+Yjs，5类表面，评论@Bot链路
10 企业网盘Drive ❌ 内部独有 drive ⚠️ 仅Web ✅ 已确认 个人+共享空间，聊天转存，文档挂载
11 回路Loop/Fleet ❌ 内部独有 fleet+fleet-db ⚠️ 仅Web ⚠️ 部分确认 Daemon能力边界/调度链路待源码验证
12 市场Marketplace ❌ 内部独有 默认(docker)/helm待确认 Web ⚠️ 部分确认 上架权限/付费私有市场/资源签名校验待确认
13 智能语音Speech ❌ 内部独有 speech 全端 ⚠️ 部分确认 TTS待验证(P1)；speech-admin功能全无证据；数据保留策略P0
14 智能摘要Summary ❌ 内部独有 summary 全端 ⚠️ 部分确认 结果存储结构/AI速览归属/summary_reader权限范围待确认
15 全文搜索Search ❌ 内部独有(完整管道) search+doc-index+drive-index 消息全端；文档网盘待确认 ⚠️ 部分确认 延迟数值P0；Tika格式/OCR；文档网盘权限模型待确认
16 我的/个人中心 ❌ 内部独有(回路部分) dmloop.enabled ⚠️ 仅Web ⚠️ 部分确认 个人中心完整功能范围待确认；移动端无回路已确认
— 第三方集成Adapters ✅ 开源已有(部分) 默认 服务端 ⚠️ 部分确认 agentmail/incoming webhook已有；adapter覆盖范围待确认
— 管理后台Admin ✅ 开源已有 默认 Web ⚠️ 部分确认 具体功能范围待确认
  • ✅ 已确认：有部署硬事实+产品管家代码验证双重确认
  • ⚠️ 部分确认：核心功能已确认，但存在P0/P1待源码验证项（各模块文档中已列出具体待确认项编号）
  • 待源码验证：功能存在但核心机制/边界需源码级确认

开源版 vs 内部版对比

维度 开源版（GitHub, Apache 2.0） 内部版（明略商业授权）
核心IM ✅ 消息/群组/Thread/文件/Bot/卡片/OIDC SSO ✅ 同左
AI Agent基础 ✅ Agent一等公民架构/Bot API/OpenClaw接入 ✅ 同左
文档协同 ❌ 仅群/Thread MD公告 ✅ Tiptap+Yjs实时协同，5类表面，评论@Bot，版本历史
企业网盘 ❌ 仅IM消息附件 ✅ 个人+共享空间，分享，聊天转存，文档挂载，全文搜索
回路Loop/Fleet ❌ ✅ 项目管理+AI协作平台，Bot编排，daemon本地运行时
市场Marketplace ❌ ✅ 技能/专家/专家团/插件分发市场
智能语音 ❌（仅语音消息type=4基础） ✅ ASR双链路（语音输入+语音消息转写），4种引擎，全端
智能摘要 ⚠️ octo-smart-summary旁路服务存在但能力有限 ✅ 完整消息/会话总结，手动/定时/Agent触发，日周月模式，map-reduce
全文搜索 ⚠️ messages_search模块代码存在 ✅ 完整Kafka→OpenSearch三层管道，消息+文档+网盘三类索引，权限控制，Bot OBO搜索
我的/个人中心 ❌（基础设置） ✅ Loop运行时+Skills管理（仅Web端）
最小生产部署 7件套：server+web+admin+WuKongIM+MySQL+Redis+MinIO 7件套基础上按需启用各profile
客户端 Web/Android/iOS 同左（部分内部版模块仅Web端）

⚠️ 售前注意：开源版已包含完整企业IM+Bot+Agent基础能力，可独立用于企业内部IM+AI Bot场景；内部版扩展模块（文档/网盘/回路/市场/语音/摘要/搜索/我的）需明略商业授权。

状态水印：v2.0 draft | 更新 2026-09-21 | confidence: high | 基于P0扩展阶段二8个模块v0.3文档 + 全组件服务清单v0.1 + 模块联动总览v0.1 | 不含客户专属方案/不承诺性能SLA

← 返回文档中心