秀秀3.0 对象与架构分析

第一步：名词解释表

先把对象和模块的边界说清楚，避免把“人、账号、Bot、服务器、权限”混在一起。

对象定义

名称	类型	解释	例子	归属	主要能力
秀秀平台	系统	整套通信基础设施，不等于某一个公司客户端。	秀秀3.0	平台方/主控	授权、部署、互联、公域索引、版本管理。
主控服务器	服务器对象	平台方控制的主节点，当前也承担三机原型的主控角色。	本机主控 main-host	平台方	总控、同步、授权、全局配置、测试验证。
子服务器	服务器对象	客户公司独立部署的一套秀秀服务。	公司A南安、公司B守一	客户公司	本公司聊天、群组、Bot、朋友圈、私有数据。
公司	组织对象	一个客户组织，是员工、Bot、群组、数据和权限的归属边界。	南安公司、守一公司	公司老板	品牌定制、员工管理、Bot管理、对外审批。
公司账号	租户对象	公司在秀秀平台里的租户身份，绑定授权码、域名和服务器。	company-a-nanan	公司	激活授权、配置公司信息、连接公域。
秀秀账号	登录账号	用户登录秀秀客户端使用的统一账号概念，可以对应真人或管理员。	u1、u2	某个服务器/公司	登录、会话、发消息、发朋友圈。
真人账号	用户对象	真实员工或C端真人在系统中的身份。	主控老板、南安员工、守一员工	公司或个人	聊天、加好友、入群、发真人秀、调用Bot。
管理员账号	权限对象	拥有管理权限的秀秀账号，不一定是超级管理员。	公司老板、主控管理员	平台方或公司	员工管理、群管理、Bot管理、审批、审计。
超级管理员	角色对象	平台方最高管理角色，管理所有客户部署和授权状态。	我们自己的主控管理员	平台方	授权码、服务器启停、版本、全局监控。
公司老板	角色对象	客户公司的最高管理角色。	南安老板、守一老板	客户公司	本公司员工、Bot、群组、外联审批。
员工	角色对象	公司内部普通使用者。	南安员工A	客户公司	聊天、群聊、朋友圈、调用允许的Bot。
Bot	智能体对象	可被私聊、入群、@调用、发Bot秀的虚拟成员。	南安001配置员、守一执行BOT	公司或个人	回复消息、执行任务、调用模型、发动态。
Bot账号	账号对象	Bot在IM系统里的账号身份，和Bot能力配置分开。	lobster-config-001	公司/服务器	入群、收消息、发消息、被授权开放。
龙虾	模型/Agent对象	Bot背后的执行大脑，可以是OpenClaw本地Agent或外部模型。	001、002、009、010	主控或服务器运行时	理解指令、生成回复、执行任务。
替身BOT	调度Bot	代表用户或公司进行Bot调度和任务分发的入口。	主控替身BOT、南安替身BOT	公司/用户	调用其他Bot、转交任务、创建Bot流程。
执行BOT	任务Bot	负责检查、测试、执行类动作。	主控执行BOT、守一执行BOT	公司/用户	跑验证、查状态、反馈结果。
好友关系	关系对象	两个真人账号之间的双向或单向联系。	u1 添加 u2	服务器数据库	私聊入口、可见范围、通讯录。
群组	关系容器	真人和Bot共同参与的会话空间。	南安公司内部群	公司/群主	群聊、@Bot、成员管理、群内任务。
群成员	关系对象	群组与真人/Bot之间的加入关系。	南安001配置员在g1	群组	决定谁能收到群消息和被@。
会话	通信对象	客户端看到的聊天入口，可能是单聊、Bot聊或群聊。	与龙虾001的会话	用户视图	消息列表、发送框、引用、@。
消息	数据对象	一次聊天内容，包含发送者、目标、内容、引用和时间。	@南安001配置员检查服务器	服务器数据库	发送、存储、触发Bot、同步状态。
朋友圈	动态模块	人和Bot都能发布的动态流。	真人秀、Bot秀	公司/公域	发布、点赞、评论、跨公司可见。
可见范围	权限对象	决定朋友圈或内容可以被谁看到。	公开、仅本公司、授权公司、指定群	发布者/管理员	控制内容传播边界。
授权关系	权限对象	服务器、Bot、群组或动态之间的跨边界访问许可。	A授权B查看某Bot秀	管理员	跨公司聊天、朋友圈同步、公域开放。
公域Bot市场	平台模块	开放Bot的搜索和添加入口，远期支持付费。	高考志愿填报Bot	平台方/开放公司	搜索、添加、付费、评价。
审计日志	安全模块	记录管理动作、授权动作和关键通信事件。	group.member.add	服务器	追踪问题、合规、老板查看。
授权码	商业对象	客户服务器激活和商业收费的凭证。	15万授权码、年授权码	平台方	绑定公司、域名、服务器指纹、有效期。
品牌定制	交付模块	客户可把秀秀改成自己的软件名、Logo、域名和客户端名称。	正平、合众、南安内部通信	客户公司	名称、Logo、主题、域名、APP显示名。
公域搜索	平台模块	跨公司搜索开放的真人、Bot、群组和服务。	搜索“高考Bot”	平台方/公域	索引、筛选、添加、授权跳转。
开放Bot	公域对象	公司选择性开放给外部用户使用的Bot。	南安开放客服Bot	开放公司	外部搜索、外部会话、收费服务。
付费Bot	商业对象	超过免费额度或使用时长后收费的Bot服务。	咨询超过30分钟付费	Bot拥有方/平台	计费、套餐、权限续期。
C端真人用户	远期用户对象	非公司员工的普通实名用户。	个人用户王某	个人	注册、实名、搜索、公域沟通。
个人Bot	远期Bot对象	C端真人自己创建和管理的Bot。	每人10个Bot	个人用户	个人助理、内容发布、付费扩展。
真人秀	朋友圈子模块	真人账号发布的朋友圈动态。	员工今天发一条工作动态	真人账号	低频发布、实名约束、点赞评论。
Bot秀	朋友圈子模块	Bot账号发布的朋友圈动态。	Bot发布产品说明	Bot账号	高频发布、商业推广、内容分发。
文件对象	数据对象	聊天或朋友圈里的附件、图片、语音文件。	合同PDF、图片、语音消息	服务器文件服务	上传、下载、预览、权限校验。
语音消息	消息类型	用户发出的语音内容，可转文字交给Bot处理。	发语音给龙虾安排任务	聊天会话	录音、上传、转写、触发Bot。
语音电话/会议	远期通信模块	实时语音或会议能力，后续让用户和Bot通话。	和龙虾开语音会议	通信底座	呼叫、会议、实时语音模型接入。
OpenApp	插件模块	现有秀秀中的应用/插件能力入口。	任务大厅、工具插件	平台/公司	扩展功能、嵌入页面、Bot工具调用。
替身工作大厅	业务模块	现有秀秀里的替身任务、调度和汇报入口。	替身接任务并分发给执行Bot	公司/用户	任务创建、任务分发、进度汇报。
任务对象	业务对象	Bot或替身承接的一项工作。	检查A/B服务器朋友圈同步	发起人/执行Bot	创建、执行、状态、结果、失败重试。
收件箱	消息模块	系统通知、任务通知、审批通知的集中入口。	Bot创建审批通知	用户账号	通知、未读、处理入口。
适配器	技术模块	连接不同IM或外部系统的协议层。	local、OpenIM、Matrix、Mattermost	服务器	消息转换、用户映射、外部系统接入。
API Key	机器凭证	服务器间调用和同步使用的密钥。	X-Xiuxiu-Key	服务器	鉴权、同步、阻断未授权调用。
Bot Token	Bot凭证	Bot调用平台接口或模型工具的凭证。	bot_xxx_token	Bot账号	限制Bot能力和接口范围。
客户端	访问端	用户进入系统的入口。	Web端、APP端、桌面端	用户/公司	聊天、通讯录、朋友圈、管理入口。
Web端	客户端	浏览器访问的完整工作台。	/web/	服务器	聊天、通讯录、朋友圈、管理。
APP端	客户端	手机浏览器/PWA先行版。	/app/	服务器	移动聊天、通讯录、朋友圈、群管理。
桌面端	客户端	后续用Electron/Tauri封装的电脑版软件。	秀秀3.0桌面版	公司/平台	本地通知、托盘、文件拖拽、长连接。
缓存	客户端模块	本地保留历史消息，避免上翻时反复重新加载和跳动。	消息列表缓存	客户端	分页、增量同步、减少闪屏。
未读/已读	消息状态	消息送达、已读、未读数量的状态对象。	群未读12条	会话/用户	提醒、同步、排序。
风控	安全模块	限制刷屏、滥用Bot、敏感行为和实名风险。	真人每天限发一条朋友圈	平台/公司	限频、审核、封禁、合规。

补充：全模块清单

这里把架构里提到的所有模块统一归档，后续开发验收可以按这个清单逐项检查。

模块全集

账号与组织

公司账号
服务器账号
秀秀账号
真人账号
管理员账号
员工账号
C端实名用户

IM核心

单聊
群聊
好友
群成员
@Bot
引用回复
未读/已读
消息搜索和分页

Bot/龙虾

Bot账号
Bot能力配置
OpenClaw接入
替身BOT
执行BOT
Bot创建顾问
Bot互调
任务对象

朋友圈

真人秀
Bot秀
混合流
点赞
评论
可见范围
跨公司公开同步
发布频次控制

多服务器互联

主控服务器
子服务器
服务器注册
API Key
授权关系
中转事件
公开内容同步
冲突处理

公域与商业

授权码
品牌定制
公域搜索
公域Bot市场
开放Bot
付费Bot
套餐计费
客户部署记录

文件与语音

图片消息
文件消息
语音消息
语音转文字
语音电话
会议
实时语音模型
文件权限

安全与运维

登录注册
Token刷新
踢下线策略
审计日志
风控
服务健康
部署脚本
数据迁移

客户端

Web端
APP/PWA端
桌面端
普通员工视图
老板管理视图
超级管理员视图
本地缓存
通知推送

现有秀秀对标

用户
好友
群组
消息
文件
收件箱
OpenApp
替身工作大厅
Bot调度和任务汇报

第三方底座

OpenIM适配
Matrix适配
Mattermost适配
LiveKit/Jitsi会议
对象存储
模型API
Webhook
本地adapter

数据对象

用户表
Bot表
群组表
群成员表
消息表
朋友圈表
评论点赞表
授权表
审计表

已确认标准：授权模块、公域Hub、58000/158000两档B端方案，后续设计以 B端授权与Hub方案和 docs/B2B_CONFIRMED_STANDARD.md 为准；C端暂时保留，不进入当前B端交付。

第二步：梳理关系并作图

这里分清层级关系、归属关系、逻辑关系和链路关系。

关系图

平台方
超级管理员

管理

主控服务器

授权/部署

公司服务器

承载

公司

拥有

真人账号
员工/老板

Bot账号
龙虾/替身/执行

群组

朋友圈

权限/审计

真人账号

创建/管理

个人或公司Bot

加入

群组

@调用

龙虾Agent

朋友圈

区分

真人秀

Bot秀

受控于

可见范围

跨公司授权

层级关系

平台方 > 主控服务器 > 公司服务器 > 公司对象。
公司 > 老板/员工/Bot/群组/朋友圈。

归属关系

员工、Bot、群组、聊天数据默认归本公司服务器。
Bot账号归属服务器，Bot能力可连接龙虾模型。

逻辑关系

真人和Bot都是可通信主体。
群组是人和Bot共同参与的容器。

链路关系

内部消息只在本公司闭环。
跨公司必须通过授权、公域或指定外部联系。

第三步：绘制整体架构图

整体平台由客户端、私有服务器、Bot运行时、公域互联和授权中心组成。

整体架构

公司A南安私有服务器

员工/老板账号

南安Bot账号

南安群组

南安朋友圈

公司权限审批

南安私有数据库

主控/公域层
授权码
服务器注册
公域Bot索引
跨公司同步规则

公司B守一私有服务器

员工/老板账号

守一Bot账号

守一群组

守一朋友圈

公司权限审批

守一私有数据库

客户端层

Web端、APP/PWA端、后续桌面端。
普通员工进入后默认是聊天、通讯录、朋友圈。
老板或管理员额外看到管理入口。

服务层

IM核心负责聊天、好友、群组。
朋友圈服务负责动态、点赞、评论、同步。
Bot运行时负责连接龙虾/OpenClaw。

互联层

公开朋友圈可跨公司同步。
外部聊天和外部Bot调用必须授权。
公司内部消息不能广播给其他公司。

架构层	包含对象/模块	当前原型状态	生产版需要补齐
访问层	Web端、APP端、桌面端、浏览器/PWA、后续移动原生客户端。	已有 Web端和APP/PWA先行版。	桌面封装、正式登录、多端互斥/多端策略、通知推送。
账号层	秀秀账号、真人账号、管理员账号、员工账号、C端实名账号。	基础已有当前用用户切换模拟登录。	注册、登录、密码、Token、实名、角色绑定。
组织层	公司、公司账号、主控服务器、子服务器、客户部署记录。	已有 main-host、南安A、守一B三节点。	部署向导、服务器指纹、授权码激活、品牌定制后台。
IM层	好友、会话、消息、单聊、群聊、群成员、引用、@Bot。	已有基础聊天和群管理。	未读已读、分页缓存、搜索、撤回、禁言、群公告。
Bot层	Bot账号、龙虾Agent、替身BOT、执行BOT、Bot创建顾问、Bot Token。	部分已有 openclaw和echo两类Bot。	Bot创建后台、能力配置、工具权限、异步任务队列。
朋友圈层	真人秀、Bot秀、公开、本公司、授权公司、指定人/Bot/群可见。	已有发布、点赞、评论、跨公司公开同步。	真人秀/Bot秀独立入口、频次、图片文件、审核风控。
互联层	授权关系、中转事件、API Key、适配器、公域搜索、公域Bot市场。	基础已有服务器记录、授权表、公开动态同步。	实时跨公司聊天、外部Bot搜索、付费Bot、公域索引服务。
媒体层	图片、文件、语音消息、语音转文字、语音电话、会议。	待补仅有文件元数据概念。	真实上传、对象存储、语音识别、LiveKit/Jitsi等会议底座。
安全层	权限、审计、风控、踢下线、Token刷新、授权码、加密商业模块。	基础已有 API Key和审计动作。	完整RBAC、操作审批、合规风控、授权码商业控制。
扩展层	OpenApp、替身工作大厅、任务对象、收件箱、Webhook、第三方IM适配。	概念已有 Bot任务和调度方向明确。	OpenApp插件体系、任务状态机、通知中心、adapter SDK。

第四步：确认对接情况与沟通链路

当前三台服务器已经部署，Bot对象存在；龙虾接入状态按Bot类型区分。

当前部署

服务器	访问地址	关键任务	龙虾/Bot接入状态	注意事项
主控 main-host	Web：`http://192.168.18.12:18303/web/` APP：`http://192.168.18.12:18303/app/`	总控测试、服务器配置、朋友圈拉取同步、主控Bot验证、架构展示。	已接入主控001配置员、主控002创建顾问、主控替身BOT、主控执行BOT、龙虾001等为 openclaw 类型。	本机没有公网入口，所以A/B到主控公开朋友圈采用主控定时拉取。
公司A南安	Web：`http://45.153.129.198:18303/web/` APP：`http://45.153.129.198:18303/app/`	南安公司私有聊天、南安群组、南安Bot、南安朋友圈、对外公开内容同步。	部分已接入南安001配置员、南安002创建顾问、南安替身BOT、南安执行BOT为 openclaw 类型；南安龙虾001当前是 echo 类型。	如果要求“南安龙虾001”也像配置员一样调用大模型，需要把该Bot从 echo 改成 openclaw。
公司B守一	Web：`http://45.153.129.162:18303/web/` APP：`http://45.153.129.162:18303/app/`	守一公司私有聊天、守一群组、守一Bot、守一朋友圈、与南安公开动态互通。	部分已接入守一001配置员、守一002创建顾问、守一替身BOT、守一执行BOT为 openclaw 类型；守一龙虾001当前是 echo 类型。	同样需要按需把守一龙虾001切换成 openclaw，避免只做固定回声回复。

对“跟龙虾连了吗”的结论：主控和A/B的配置员、创建顾问、替身BOT、执行BOT已经按 openclaw 类型接入；A/B 的普通“龙虾001”当前仍是 echo 类型，所以它能回复但不是完整大模型工作流。

1

用户发消息

用户在Web/APP选择Bot单聊，或在群里输入 @Bot 指令。

2

IM服务保存

服务器写入消息表，识别会话类型、发送者、目标和引用关系。

3

Bot匹配

单聊直接匹配Bot；群聊根据 @名称或成员列表匹配Bot。

4

调用龙虾

openclaw Bot 调用本地龙虾Agent；echo Bot 只返回固定模板。

5

生成回复

Bot回复写入同一会话，前端轮询或刷新后显示。

6

权限留痕

关键动作写审计；跨公司动作还要经过授权规则。

内部群消息链路

A公司内部群消息只在A服务器内保存和展示。
不会同步给B公司和主控聊天列表。
只有公开朋友圈或授权外联内容才跨服务器。

朋友圈同步链路

公开动态可跨公司同步。
指定公司可见只同步给被选中的服务器。
作者名称、评论者名称必须保留来源服务器身份。

外部Bot链路

用户搜索开放Bot。
管理员或规则确认授权。
消息通过中转/适配器发到目标服务器的Bot。

第五步：权限关系分析

权限上要区分“账号能不能登录”和“对象能不能操作/对外沟通”。

权限模型

角色/对象	能做什么	不能做什么	关键权限字段	和Bot的区别
超级管理员	管理所有服务器、授权码、版本、公域规则。	原则上不直接读取客户私有聊天数据。	platform_admin、server_admin、license_admin	是管理角色，不是会话成员。
公司老板/公司管理员	管理本公司员工、Bot、群组、审批外联、查看审计。	不能越权管理其他公司私有数据。	company_admin、bot_admin、group_admin、audit_read	可以给Bot授权或禁用Bot。
普通员工	聊天、加好友、入群、发真人秀、调用授权Bot。	不能创建无限Bot，不能审批跨公司开放。	chat_send、moment_post、bot_call	是真人主体，需要实名/员工身份。
Bot账号	收消息、回复、入群、发Bot秀、执行授权任务。	不能默认管理公司、不能越权读所有聊天。	bot_enabled、bot_scope、model_access、external_access	是虚拟主体，需要受真人或公司管理。
替身BOT	调度其他Bot、转交任务、发起创建Bot流程。	不能绕过管理员审批开放外部权限。	bot_dispatch、bot_create_request、bot_call_chain	比普通Bot多调度权限，但仍受授权约束。
执行BOT	执行检查、测试、部署验证类任务。	不能擅自修改授权、删除数据、越权访问服务器。	task_execute、test_run、deploy_check	偏执行，不负责最终审批。
服务器API Key	服务器间同步、上报、中转调用。	不能作为真人登录客户端。	server_id、api_key、enabled	是机器权限，不是聊天对象。
授权关系	允许服务器、Bot、群组或动态跨边界访问。	默认拒绝未授权访问。	source_server、target_type、target_id、enabled	是权限规则，不是账号。

Bot权限原则

Bot可以像人一样参与聊天。
Bot不能天然拥有管理员权限。
Bot调用其他Bot必须记录链路。

管理员权限原则

管理员负责审批和配置。
管理员账号应和普通聊天账号可区分。
高危操作需要审计和二次确认。

跨公司原则

内部消息默认不外传。
公开朋友圈按规则同步。
外部Bot和外部好友需要授权。

第六步：制作网页分析

本页就是可直接打开的网页分析结果，后续可以继续扩展成产品说明书和开发任务板。

已生成

当前页面用途

给开发人员统一对象名词。
给测试人员确认消息和朋友圈链路。
给管理人员理解公司、员工、Bot、权限的边界。
给后续融资或客户沟通沉淀产品架构。

下一步建议

把 echo 类型的普通龙虾001统一切换为 openclaw 类型。
补登录/注册/角色权限后台，把管理员和员工视图彻底分开。
补外部好友和外部Bot授权流程，不允许内部群消息跨公司广播。
把本页对象模型沉淀为数据库表结构和API权限清单。

秀秀3.0 不是单一聊天工具，而是一套对象驱动的通信系统