首页 产品 为什么选 OCTO 解决方案 文档 关于
文档中心 / 产品指南 / 模块联动关系总览
← 返回文档中心

模块联动关系总览

OCTO 文档中心 · 产品指南

  • 02-architecture/OCTO全组件服务清单.md
  • 01-product/模块说明/ 各模块v0.1文档
  • source-repos-internal/octo-deployment/docker/docker-compose.yaml
  • source-repos-internal/octo-deployment/docker/nginx/web/default.conf.template

OCTO模块间联动关系总览 v0.1

本文档用ASCII图+文字说明,系统梳理OCTO各模块之间的数据流向、调用关系和联动机制。图中实线表示已确认的硬事实(基于部署配置/源码/产品管家回答),虚线表示推断待确认的关系。


一、全局架构总览图

                          ┌──────────────┐
                          │   客户端层    │
                          │ Web/iOS/Andr │
                          └──────┬───────┘
                                 │ HTTPS/WSS (:28080/:28443)
                                 ▼
                ┌────────────────────────────────┐
                │   nginx (薄网关层 :80/:443)     │
                │  TLS终结 / WS升级 / MinIO直反代 │
                └───────┬───────────────┬────────┘
                        │               │
          ┌─────────────┘               └──────────────┐
          ▼                                            ▼
   ┌─────────────┐                          ┌───────────────────┐
   │   wukongim  │◄────WS/TCP长连接─────────┤  /ws (WebSocket)  │
   │  :5200(WS)  │                          └───────────────────┘
   │  :5100(TCP) │
   └──────┬──────┘
          │ gRPC webhook (:6979)
          ▼
   ┌──────────────────────────────────────────────────────┐
   │                  octo-server :8090                    │
   │  (核心业务: IM逻辑/Bot API/认证/Presigned URL/搜索查询)  │
   └──┬───────┬────────┬─────────┬─────────┬──────────────┘
      │       │        │         │         │
      │       │        │         │         │
      ▼       ▼        ▼         ▼         ▼
  ┌──────┐┌──────┐┌───────┐┌────────┐┌──────────────────────┐
  │mysql ││redis ││ minio ││ speech ││ 各内部模块(经nginx路由)│
  │:3306 ││:6379 ││ :9000 ││ :8780  ││                      │
  └──────┘└──────┘└───┬──┘└────────┘│  ┌──────────────┐    │
                      │            │  │ summary-api  │    │
                      │            │  │ marketplace  │    │
                      │            │  │ drive        │    │
                      │            │  │ docs-backend │    │
                      │            │  │ fleet        │    │
                      │            │  └──────┬───────┘    │
                      │            │         │            │
                      │            └─────────┘            │
                      │                                    │
                      ▼                                    │
              ┌──────────────┐                             │
              │ Kafka :9092  │◄── search管道事件 ──────────┘
              │ (事件总线)    │     (octo-server/docs/drive)
              └──────┬───────┘
                     │
         ┌───────────┼───────────┐
         ▼           ▼           ▼
   ┌───────────┐┌──────────┐┌──────────────┐
   │es-indexer ││doc-indexer││drive-indexer │
   │ (消息索引) ││(文档索引) ││ (网盘索引+Tika)│
   └─────┬─────┘└─────┬────┘└──────┬───────┘
         │           │            │
         └───────────┼────────────┘
                     ▼
             ┌──────────────┐
             │ OpenSearch   │
             │   :9200      │
             │ (全文搜索引擎) │
             └──────────────┘
  • 实线箭头 = 已确认的硬事实调用/数据流
  • 本图只画主要数据流,省略初始化/preflight/migrate等一次性组件

二、核心消息流(硬事实)

2.1 消息发送/接收链路

客户端(WS/TCP)
    │
    │ WebSocket/TCP长连接
    ▼
wukongim :5200/:5100          ◄── 消息路由/投递/离线存储
    │
    │ gRPC webhook (新消息/消息投递回执)
    │ port: 6979
    ▼
octo-server :8090              ◄── 业务逻辑处理
    │                           ├─ 消息持久化(MySQL)
    │                           ├─ 触发Bot事件(bot_task → Redis)
    │                           ├─ 搜索producer(→Kafka, 当TS_KAFKA_ON)
    │                           └─ 通知推送
    │
    ├──► redis :6379           ◄── bot_task事件队列
    │         │
    │         │ BRPOP长轮询
    │         ▼
    │     Bot进程              ◄── Bot接收消息事件
    │         │
    │         │ Bot调用WuKongIM Manager API
    │         │ (发送回复消息)
    │         ▼
    │     wukongim (Manager API :5001)
    │         │
    └─────────┴──► 消息投递回客户端
  • ✅硬事实:客户端经nginx /ws反代连接wukongim:5200(WebSocket)或:5100(TCP);wukongim通过gRPC webhook回调octo-server:6979;octo-server将Bot事件写入Redis bot_task队列;Bot通过长轮询消费队列,调WuKongIM Manager API发消息
  • 数据流方向:上行:客户端→wukongim→gRPC→octo-server→MySQL/Redis/Kafka;下行:Bot→WuKongIM API→wukongim→客户端
  • 认证:wukongim配置tokenAuthOn: true,token由octo-server签发/验证

2.2 消息搜索链路

新消息到达octo-server
    │
    ├─[TS_KAFKA_ON=true]─► Kafka octo.message.v1
    │                           │
    │                           ▼
    │                      es-indexer (批量消费)
    │                           │
    │                           ▼
    │                      OpenSearch octo-message
    │
    │   用户搜索请求
    │       │
    │       ▼
    │   octo-server /v1/messages/_search
    │       │
    │       ├─► OpenSearch查询(routing=channelId, alias=wukongim-messages-read)
    │       ├─► MySQL可见性post-filter(撤回/删除/清空)
    │       ├─► JOIN user/group_member(sender名称/头像, LRU缓存)
    │       └─► 返回结果(highlight+cursor分页)
    │
    └─[TS_KAFKA_ON=false]─► 搜索不可用(OCTO_SEARCH_BACKEND=disabled)

三、文件流(硬事实)

3.1 文件上传/下载链路(Presigned URL直传)

客户端                          octo-server            MinIO
   │                                │                    │
   │ 1.请求上传(文件名/类型/大小)     │                    │
   ├───────────────────────────────►│                    │
   │                                │                    │
   │ 2.返回Presigned URL            │                    │
   │◄───────────────────────────────┤                    │
   │  (含签名policy/X-Amz-*)         │                    │
   │                                │                    │
   │ 3.直传文件到MinIO               │                    │
   ├───────────────────────────────────────────────────►│
   │  (PUT presigned URL, 不经过octo-server)             │
   │                                │                    │
   │ 4.上传完成回调(确认)            │                    │
   ├───────────────────────────────►│                    │
   │                                │                    │
   │ 5.下载时同样签发Presigned URL   │                    │
   ├───────────────────────────────►│                    │
   │◄───────────────────────────────┤                    │
   │ 6.GET presigned URL直接下载    │                    │
   ├───────────────────────────────────────────────────►│
   │                                                     │
  • ✅硬事实:OCTO采用Presigned URL直传模式,文件不经octo-server中转,客户端直接与MinIO通信,减轻服务端带宽压力
  • nginx配置中/{bucket}/{key}?X-Amz-*路径直接反代到minio:9000(保SigV4签名,不rewrite)
  • bucket白名单:file/chat/moment/sticker/report/chatbg/common/download/group/avatar/octo-docs-attachments/marketplace/octo-drive
  • 各模块文件存储在独立bucket:消息附件→chat/file,文档附件→octo-docs-attachments,网盘→octo-drive,市场资源→marketplace,头像→avatar

3.2 各模块文件存储映射

模块 Bucket 内容 状态
IM消息附件 chat, file 消息中的图片/文件/视频/语音 ✅硬事实
头像 avatar 用户/群头像 ✅硬事实
文档(Docs) octo-docs-attachments 文档附件+docs/路径HTML正文 ✅硬事实
网盘(Drive) octo-drive 网盘文件 ✅硬事实
市场(Marketplace) marketplace 技能/Bot/MCP资源包/图标/截图 ✅硬事实
贴纸/表情 sticker 贴纸包 ✅硬事实
朋友圈/动态 moment, report, chatbg 动态/报表/聊天背景 ✅硬事实
公共/下载 common, download, group 公共资源/下载文件/群共享 ✅硬事实

四、搜索管道全景(硬事实+推断)

                      ┌───────── Kafka :9092 (事件总线) ─────────┐
                      │                                           │
    消息变更          │  文档变更            网盘文件变更           │
  (octo-server   ──►  │  (docs-backend ──►   (octo-drive    ──►   │
   内置searchetl)     │   KAFKA_BROKERS)      DRIVE_KAFKA)        │
                      │                                           │
   octo.message.v1    │  octo.docindex.v1   octo.driveindex.v1    │
         │            │         │                   │            │
         ▼            │         ▼                   ▼            │
   es-indexer ────────┼──► doc-indexer        drive-indexer       │
   (批量BATCH=500)    │    (octo-doc-indexer)  (octo-drive-indexer)│
         │            │         │                   │            │
         │            │         │                   ├──► tika:9998│
         │            │         │                   │   (文本提取)│
         ▼            │         ▼                   ▼            │
   OpenSearch         │    OpenSearch           OpenSearch        │
   octo-message       │    octo-doc             octo-drive        │
   alias:             │    alias:               (alias待确认)     │
   wukongim-messages- │    octo-doc-read                          │
   read               │                                           │
         │            └───────────────────────────────────────────┘
         │
         ▼
   octo-server查询
   ├── 消息搜索(/v1/messages/_search*) [✅已确认]
   ├── 文档搜索 [⚠️待确认端点]
   ├── 网盘搜索 [⚠️待确认端点]
   └── 全局聚合搜索 [⚠️待确认]
  • ✅ 每个topic都有.dlq死信队列(消息索引和文档索引还有.retry重试队列)
  • ✅ KAFKA_AUTO_CREATE_TOPICS_ENABLE=false,所有topic由init job预创建
  • ✅ search-producer-guard双向互斥,防止双写Kafka
  • ✅ cursor-seed+backfill工具保证首次初始化/索引重建的正确性
  • ✅ es-indexer有search-dlq-spill卷持久化DLQ(crash-resumable)

五、文档Bot链路(产品管家确认+硬事实)

用户在文档中@Bot
    │
    │ (评论/mention事件)
    ▼
docs-backend :3000
    │
    │ 内部API调用
    │ POST /v1/internal/bot-mentions
    ▼
octo-server :8090
    │
    │ 写入bot_task(Redis)
    ▼
Redis :6379 (bot_task队列)
    │
    │ BRPOP长轮询
    ▼
Bot进程(octo-cli/SDK)
    │
    │ 1.识别文档mention事件
    │ 2.读取文档上下文(通过docs API)
    │ 3.执行AI逻辑/生成内容
    │ 4.调用octo-server API编辑文档正文
    │ 5.回复评论
    │
    │ (通过docs API回写)
    ▼
docs-backend :3000
    │
    │ 协同编辑(Hocuspocus WS :1234)
    ▼
其他在线用户实时看到文档更新+评论回复
  • ✅硬事实:docs-backend通过/v1/internal/bot-mentions调用octo-server(内部接口,需鉴权);bot_task走Redis队列;Bot通过长轮询获取事件
  • ✅产品管家确认:Bot通过文档评论区@Mention链路操作文档(非Bot API直接调用),仅User Bot有权限在权限范围内编辑正文(MVP阶段,灰度门控)
  • ⚠️待确认:Bot编辑文档的具体API端点、权限范围、是否能创建/删除文档(非仅编辑正文和回复评论)
  • Hocuspocus协同:文档编辑通过WebSocket :1234进行Yjs CRDT同步,Bot写入后其他协作者实时看到更新

六、Drive-Docs联动(硬事实+产品管家确认)

┌─────────────────────┐              ┌─────────────────────┐
│     Docs(云文档)     │              │     Drive(网盘)      │
│                     │              │                     │
│  MySQL: octo_docs   │◄────独立───►│  MySQL: octo_drive   │
│  Bucket:            │   空间/数据库 │  Bucket: octo-drive  │
│  octo-docs-attach-   │   互不重叠   │                     │
│  ments              │              │  仅Web端            │
│                     │              │  (iOS/Android未做)  │
│  Web入口: /docs     │              │  Web入口: /v1/drive │
└─────────┬───────────┘              └─────────┬───────────┘
          │                                    │
          │    listMountedDocs API             │
          │◄──────────────────────────────────►│
          │   (网盘可"挂载"云文档到目录中)        │
          │                                    │
          │  ⚠️待确认联动:                      │
          │  - Drive文件作为消息附件发送?        │
          │  - Drive文件插入到文档?              │
          │  - 文档附件存到Drive?               │
          └────────────────────────────────────┘
  • ✅硬事实+产品管家确认:Drive和Docs是两个独立模块/空间,文档不是网盘里的一种文件类型;各有独立MySQL库和MinIO bucket
  • ✅已确认联动:Drive可通过listMountedDocs API挂载云文档,在网盘目录中看到并访问已挂载的云文档(文档本体仍归docs管理)
  • ✅已确认联动:聊天文件可转存到网盘(Web v2026.08.10+)
  • ⚠️待确认:Drive文件能否反向作为消息附件发送、能否插入文档、能否作为Bot知识源

七、Summary模块链路(硬事实)

用户触发摘要
    │
    │ /summary/api/v1/* (经nginx)
    ▼
summary-api :8080
    │
    │ 触发异步任务
    │ POST /internal/worker-trigger (HMAC鉴权)
    ▼
summary-worker :8082
    │
    │ ⚠️ 不依赖搜索服务!
    │ MESSAGE_FETCH_BACKEND=mysql
    │
    ├──► MySQL octo (summary_reader只读)
    │    直接读取消息内容
    │
    ├──► LLM_API_URL/KEY/MODEL
    │    调外部LLM(默认claude-sonnet-4-6)
    │    生成摘要
    │
    │ 完成回调(HMAC鉴权)
    │ POST /internal/task-event
    ▼
summary-api :8081(内部端口)
    │
    │ SSE推送/返回结果
    │ (NOTIFY_INTERNAL_TOKEN回传octo-server)
    ▼
前端(SUMMARY_API_URL) / octo-server
  • ✅硬事实:Summary直接读IM MySQL(summary_reader只读账号),不经过搜索/OpenSearch,因此summary可独立于search profile部署
  • ✅硬事实:API/Worker分离架构,SSE流式对话端点/summary/api/v1/agent/chat/stream(3600s超时,proxy_buffering off)
  • ✅硬事实:内部接口通过NOTIFY_INTERNAL_TOKEN做HMAC鉴权
  • ⚠️待确认:摘要触发方式(手动/自动/@Bot)、摘要范围(仅聊天?也支持文档/会议?)、SSE对话的定位

八、Speech语音链路(硬事实)

用户发送语音消息
    │
    │ octo-server API
    │ POST /api/v1/voice/transcribe
    ▼
octo-server :8090
    │
    │ 内部HTTP调用(SPEECH_SERVICE_URL)
    │ 含SPEECH_API_KEY鉴权
    ▼
octo-speech :8780
    │
    │ 调用语音引擎API
    │ (默认VOICE_ENGINE=qwen 通义千问)
    │
    │ 音频限制: max 60s / 3MB
    │
    ├──► MySQL octo_speech (可选存储)
    │
    └──► 返回转写文字
    │
    ▼
octo-server → wukongim → 客户端展示转写结果

--- 管理功能 ---
管理员
    │
    │ SSH隧道(loopback:28088)
    │ /speech-admin/ (nginx路由)
    ▼
octo-speech-admin :8781
    (独立账号体系ADMIN_USERNAME/PASSWORD/JWT)
    ⚠️具体功能待确认(用量统计?引擎配置?)
  • ✅硬事实:octo-server的/api/v1/voice/transcribe端点代理到octo-speech:8780;默认集成通义千问ASR;音频限制60s/3MB
  • ✅硬事实:speech-admin有独立认证体系,与octo-server分离,仅通过loopback+SSH隧道访问
  • ⚠️待确认:是否支持TTS(语音合成/播报)、支持的引擎范围、管理控制台具体功能

九、Marketplace链路(硬事实+推断)

┌─────────────────────────────────────────────────┐
│                Marketplace :8092                 │
│                                                 │
│  MySQL: octo_marketplace                         │
│  Redis: DB 0 (缓存)                              │
│  MinIO: marketplace bucket (签名URL下载)          │
│  AUTH_ENABLED=true ──委托octo-server认证          │
│  MAX_UPLOAD_MB=20                                │
│                                                 │
│  ⚠️ 资源类型待确认: Skill/Bot/MCP三类              │
└───────┬─────────────────────────────────────────┘
        │
        │ OCTO_API_URL=http://octo-server:8090
        │ (认证委托/集成)
        ▼
  octo-server :8090
        ▲
        │ /market/api/* (nginx厚路由rewrite)
        │
   前端Web(MARKET_API_URL)

  ⚠️ 待确认链路:
  - 用户从市场安装Skill → 安装到哪里(个人/Skills?)
  - 开发者上传资源 → 审核流程 → 上架
  - MCP插件安装后如何生效
  - Bot市场安装后是否自动创建Bot实例
  - 付费/评级/评论机制
  • ✅硬事实:marketplace默认启动(docker-compose无profile gating),认证委托octo-server,资源存MinIO marketplace bucket(签名URL下载),上传限制20MB
  • ⚠️硬事实差异:helm values.yaml中marketplace.enabled默认false,与docker-compose默认启动不一致,待确认哪个是正确默认
  • ⚠️待确认:上架/安装流程、MCP支持、付费审核机制、Skills与Marketplace的关系

十、Fleet回路链路(硬事实+待确认)

     ┌─────────────── 待确认区域 ───────────────┐
     │                                          │
     │   用户本地电脑                            │
     │   ┌──────────────┐                       │
     │   │ daemon/runtime│                      │
     │   │ (待确认:是     │                       │
     │   │  OpenClaw     │                       │
     │   │  Runtime/独立  │                       │
     │   │  程序?)       │                       │
     │   └──────┬───────┘                       │
     │          │ WebSocket长连接                │
     │          │ /fleet/api/daemon/ws           │
     │          │ 或 /fleet/ws                    │
     │          │ (Loop凭证HMAC认证?)             │
     └──────────┼───────────────────────────────┘
                │
                ▼
     ┌──────────────────────┐
     │    octo-fleet :8080   │
     │                      │
     │  PostgreSQL 16 (独立) │
     │  Redis DB 1          │
     │  JWT_SECRET          │
     │  LOOP_CREDENTIAL_HMAC_KEY │
     │  ALLOW_SIGNUP=false   │
     │                      │
     │  REST API:           │
     │  /fleet/api/v1/*     │
     │  /fleet/uploads/*    │
     │  /fleet/auth/*       │
     │                      │
     │  Outbound Webhook    │
     │  (DM_OUTBOUND_WEBHOOK│
     │   _ALLOW_PRIVATE=    │
     │   true, SSL cert信任) │
     └──────────┬───────────┘
                │
                │ OCTO_APP_SERVER_URL
                │ (与octo-server集成)
                ▼
         octo-server :8090

  ⚠️ 大量待确认:
  - "回路/Loop"的产品含义
  - Daemon具体运行环境和功能
  - Loop凭证签发/生命周期
  - Outbound Webhook向何处发回调
  - 文件上传(/fleet/uploads/)用途
  - 前端Multica App的功能定位
  - 与「我的→运行时→添加电脑」的精确关系
  - 为什么独立使用PostgreSQL而不是MySQL
  - Bot是否通过Fleet调度本地daemon执行任务

十一、基础设施共享关系(硬事实)

┌─────────────────────────────────────────────────────────┐
│                    共享基础设施层                         │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  mysql:8.0 (主数据库)                                    │
│  ├── octo (核心IM: 用户/消息/群组/Thread/Bot/bot_task)   │
│  ├── octo_summary (summary: 摘要任务/结果)               │
│  ├── octo_speech (speech: 转写记录,可选)                 │
│  ├── octo_docs (docs: 文档/协作者/评论)                  │
│  ├── octo_marketplace (marketplace: 资源/元数据)         │
│  └── octo_drive (drive: 文件/目录/权限)                  │
│                                                         │
│  redis:7-alpine (缓存+队列)                              │
│  ├── DB 0: 核心缓存/会话/bot_task/分布式锁               │
│  │         (含marketplace缓存)                          │
│  └── DB 1: Fleet专用                                    │
│                                                         │
│  minio (对象存储)                                        │
│  └── 13个bucket (见第三节文件流)                          │
│                                                         │
│  wukongim (IM长连接)                                     │
│  └── 所有模块的消息推送基础设施                           │
│                                                         │
│  nginx (两层路由)                                        │
│  ├── 薄网关(nginx容器:80/443): TLS/WS/MinIO直反代        │
│  └── 厚路由(web容器:80): 所有应用层API路由+SPA fallback  │
│                                                         │
│  search-kafka (搜索事件总线, opt-in profile)             │
│  └── search/doc-index/drive-index共用                    │
│                                                         │
│  fleet-postgres:16-alpine (Fleet专用, opt-in)           │
│  └── Fleet独立使用,其他模块不共享                       │
│                                                         │
└─────────────────────────────────────────────────────────┘

十二、内部认证/鉴权机制汇总

认证场景 机制 密钥/Token
客户端↔wukongim Token Auth wukongim tokenAuthOn
wukongim↔octo-server gRPC Manager Token OCTO_WUKONGIM_MANAGER_TOKEN
octo-server内部回调 HMAC NOTIFY_INTERNAL_TOKEN / OCTO_NOTIFY_INTERNAL_TOKEN
Drive↔octo-server Internal Token DRIVE_OCTO_SERVER_INTERNAL_TOKEN
Summary API↔Worker HMAC NOTIFY_INTERNAL_TOKEN
Fleet JWT JWT FLEET_JWT_SECRET (≥32hex)
Fleet Loop凭证 HMAC FLEET_LOOP_CREDENTIAL_HMAC_KEY (≥32hex)
Marketplace↔octo-server 委托认证 AUTH_ENABLED=true + OCTO_API_URL
Speech Admin 独立用户名密码+JWT ADMIN_USERNAME/PASSWORD/JWT_SECRET
Bot→WuKongIM API Manager Token WuKongIM Manager Token
octo-server→Speech API Key SPEECH_API_KEY
MinIO应用用户 IAM octo-app用户(所有模块共用)
Kafka PLAINTEXT(内网) 无额外认证(本地简化模式)
OpenSearch DISABLE_SECURITY=true 无认证(本地简化模式)
Fleet→私有网络Webhook SSL CA Bundle SSL_CERT_FILE (自签证书信任)

十三、Profile依赖关系图

                    ┌──────────┐
                    │  默认启动  │
                    │(无profile)│
                    └─────┬────┘
                          │
         ┌────────────────┼────────────────┐
         │                │                │
         ▼                ▼                ▼
   ┌──────────┐    ┌──────────┐    ┌──────────┐
   │ 核心IM   │    │market-   │    │botfather │
   │server/web│    │place     │    │(一次性)  │
   │admin/nginx│   │(⚠️helm  │    └──────────┘
   │mysql/redis│   │ disabled)│
   │minio/wk  │    └──────────┘
   └────┬─────┘
        │
   ┌────┴──────────────────────────────────────────┐
   │           opt-in profiles                     │
   │                                               │
   │  ┌─────────┐  ┌─────────┐  ┌─────────┐       │
   │  │ summary │  │ speech  │  │  docs   │       │
   │  │(api+    │  │(speech+ │  │(backend │       │
   │  │ worker) │  │ admin)  │  │ +preflt)│       │
   │  └─────────┘  └─────────┘  └────┬────┘       │
   │                                  │            │
   │  ┌─────────┐  ┌─────────┐       │            │
   │  │  drive  │  │  fleet  │  ┌────▼────┐       │
   │  │(+config │  │(+preflt │  │docs-html│       │
   │  │+preflt │  │+postgres│  │(依赖docs)│       │
   │  │+migrate)│  │ 可选)   │  └─────────┘       │
   │  └────┬────┘  └─────────┘                    │
   │       │                                       │
   │  ┌────┴────────────────────────────────┐     │
   │  │           search (基础设施)          │     │
   │  │  kafka + opensearch + es-indexer    │     │
   │  │  +init/ensure/guard                 │     │
   │  └────┬───────────────┬────────────────┘     │
   │       │               │                      │
   │  ┌────▼────┐    ┌─────▼─────┐               │
   │  │doc-index│    │drive-index│               │
   │  │(依赖docs │    │(依赖drive │               │
   │  │ +search)│    │ +search)  │               │
   │  │+tika?   │    │+tika      │               │
   │  └─────────┘    └───────────┘               │
   │                                               │
   │  ┌──────────────┐  ┌──────────────┐          │
   │  │search-producer│ │ search-tools │          │
   │  │(独立producer,│  │(cursor-seed  │          │
   │  │ K8s用)       │  │ +backfill)   │          │
   │  └──────────────┘  └──────────────┘          │
   └───────────────────────────────────────────────┘

十四、待确认项汇总

编号 待确认项 涉及模块 优先级
L-01 全局跨模块搜索是否存在(同时搜消息/文档/文件) Search/全局 P0
L-02 Fleet"回路"产品定位、Daemon功能、Loop凭证含义、与运行时关系 Fleet/我的 P0
L-03 Marketplace上架/安装流程、MCP含义、Skills关系、付费审核 Marketplace/我的 P0
L-04 文档Bot链路除评论@Mention外的能力边界(能否创建/删除文档) Docs/Bot P1
L-05 Drive-Docs反向联动(Drive文件→消息/文档) Drive/Docs/IM P1
L-06 Summary摘要范围(仅消息?文档/会议?)和触发方式 Summary P1
L-07 Speech是否支持TTS、多引擎、语音通话场景 Speech P1
L-08 doc-indexer/drive-indexer的producer侧实现位置 Search/Docs/Drive P1
L-09 搜索权限控制粒度(OS filter vs server post-filter) Search P1
L-10 端侧形态:iOS/Android各模块功能范围(哪些模块仅Web端) 全部 P1
L-11 BotFather完整流程、slash命令注册机制 BotFather/Bot P1
L-12 admin管理台具体功能范围 admin P2
L-13 marketplace compose默认启动但helm默认disabled Marketplace P2
L-14 OpenSearch/Kafka生产部署HA建议 Search P2
L-15 各模块Bot API能力清单(drive/docs/summary等哪些有bot路由) Bot/全部 P2

十五、版本记录

  • v0.1(2026-09-21):基于内部部署仓库硬事实 + 各模块v0.1文档 + 产品管家已回答内容新建;14条数据流/链路图;严格区分硬事实和待确认项;标注L-01到L-15共15个待确认项