docs: add workspace collaboration design and client demos
Document shared workspaces, realtime messaging, member handling, and source permissions. Include local interaction demos and verification scripts, and update development startup for Electron Node mode. Production collaboration services remain unimplemented.
This commit is contained in:
lofyer
@@ -5,8 +5,8 @@
|
||||
| 项目 | 内容 |
|
||||
| --- | --- |
|
||||
| 状态 | 设计中 |
|
||||
| 版本 | 0.3 |
|
||||
| 日期 | 2026-09-09 |
|
||||
| 版本 | 0.6 |
|
||||
| 日期 | 2026-09-28 |
|
||||
| 适用产品 | 独立部署的 ShareServer 与 Web 管理控制台 |
|
||||
| 关联架构 | [共享网络总体设计](../../../../goodbuddy/docs/architecture/share-network-architecture.md) |
|
||||
| 关联文档 | [功能逻辑](./logic-design.md)、[管理界面](./ui-design.md)、[技术设计](./technical-design.md) |
|
||||
@@ -27,6 +27,7 @@
|
||||
6. ShareServer 可以只运行控制面，也可按部署策略提供数据中继和包存储。
|
||||
7. 成员可以显式开放自己的数字人，获准的组织成员可通过 `@数字人` 发起有界协作任务。
|
||||
8. 部署方可以启用 ONLYOFFICE Docs，使 Desktop 在多个文档 Tab 中编辑 DOCX、XLSX 和 PPTX。
|
||||
9. 用户的本地工作空间可开启组织共享，使用实时消息协作、按策略同步资料；明确的处理请求由本人或其授权分身处理。
|
||||
|
||||
## 3. 产品范围
|
||||
|
||||
@@ -43,6 +44,8 @@
|
||||
- 可选 Office 编辑服务、工作副本、保存检查点、编辑器启动和 ONLYOFFICE callback。
|
||||
- 审计、用量、保留和导出。
|
||||
- Web 管理控制台和成员自助页面。
|
||||
- 工作空间的组织共享关联、成员访问、实时普通消息与线程、提及通知、处理请求和资料同步。
|
||||
- 选定知识与监督回顾的共享授权，及数字分身对这些来源的复用。
|
||||
|
||||
### 3.2 不包含
|
||||
|
||||
@@ -50,7 +53,7 @@
|
||||
- 发现未注册的局域网设备。
|
||||
- 保存或分发用户 API Key、Cookie 和桌面登录状态。
|
||||
- 默认查看任务正文、附件和模型输出。
|
||||
- 上传、同步或浏览数字人所有者的本地个人、项目、会话和原始 Agent 记忆。
|
||||
- 自动上传、同步或浏览数字人所有者的本地个人、项目、会话和原始 Agent 记忆；用户明确发布的知识与选定回顾按 FR-18 单独管理。
|
||||
- 因为成员加入组织而自动开放其数字人、记忆、Runtime、工作区或工具。
|
||||
- 未经提供者发布自动盘点设备能力。
|
||||
- 自动信任同域邮箱、同一网络或其他 ShareServer。
|
||||
@@ -58,6 +61,7 @@
|
||||
- 替代 GoodBuddy 官方客户端、模型和 Agent 发布源。
|
||||
- 自行实现 Office 渲染器，或把 ONLYOFFICE Document Server 打进 Desktop 安装包。
|
||||
- 默认永久保存用户文档、选区、提示词或模型输出。
|
||||
- 首期不含私聊、语音视频、已读回执、正在输入及分身输出逐字广播；空间协作按轻量 IM 范围实现。
|
||||
|
||||
## 4. 功能需求
|
||||
|
||||
@@ -150,6 +154,9 @@
|
||||
|
||||
### FR-13 数字人发布与组织内 `@` 调用
|
||||
|
||||
本节的 `@数字人` 指直接调用已发布能力。工作空间中的 `@成员` 按 FR-17 提及并通知真实成员，
|
||||
不要求其发布数字人；只有显式处理请求且成员授权分身处理时才创建能力任务，两类选择器使用明确类型。
|
||||
|
||||
- “数字人”是运行在成员设备或组织服务节点上的可调用 Agent Publication。一个成员可以按
|
||||
不同用途发布零个或多个数字人，每个数字人独立配置 handle、能力、提供者和记忆来源；
|
||||
加入组织、注册设备或创建本地 Agent 都不会自动发布。
|
||||
@@ -168,7 +175,8 @@
|
||||
允许的记忆。
|
||||
- 记忆检索和上下文组装始终在 Provider 本地完成。ShareServer 只保存 Publication 的分区
|
||||
种类、经过验证的本地关联 ID 摘要和是否使用专属记忆等策略元数据；原始记忆、分区内容、
|
||||
来源正文和检索结果不上传 ShareServer，也不向调用者展示。
|
||||
来源正文和检索结果不通过此记忆授权上传 ShareServer，也不向调用者展示。用户另行发布的
|
||||
知识或选定回顾按 FR-18 授权，不能据此浏览原始记忆库。
|
||||
- 数字人输出可能受到其 Agent 记忆影响，因此发布页和调用确认必须显示“使用数字人专属记忆”
|
||||
这一事实及允许的数据敏感度。Restricted 记忆不得用于远端调用；暂停或撤销数字人后停止
|
||||
新调用，但保留历史任务和有界审计。
|
||||
@@ -211,8 +219,67 @@
|
||||
- 会话关闭、撤销或到期后停止新读取、保存和 AI 操作，并按组织保留策略清理工作副本、
|
||||
checkpoint、Cookie 和对象令牌。
|
||||
|
||||
### FR-15 工作空间与共享属性
|
||||
|
||||
- 本地工作空间由 Desktop 创建和管理，无需加入组织；可创建多个，默认共享关闭。
|
||||
- 开启共享保留本地空间身份，建立与一个组织的共享关联。操作者必须是有效组织成员并具备
|
||||
空间管理权限；明确选择成员、资料与已有历史的共享范围，组织成员不默认取得空间权限。
|
||||
- 成员读取、发送、同步、管理空间和分身处理分别授权，组织管理员不自动取得正文访问权限。
|
||||
- 共享生效和关闭以服务端确认结果为准；关闭不删除本地空间。服务端撤销后拒绝新访问，
|
||||
对已下载副本不作远程擦除承诺。重新开启创建新共享关联，不自动重放旧关联的待发送内容。
|
||||
- 成员被移除后停止其新访问和发布；所有者离开组织时关闭共享，首期不自动转移所有权。
|
||||
|
||||
### FR-16 实时消息与资料同步
|
||||
|
||||
- 共享开启且联网时，空间消息、公开回复和处理状态实时更新；支持断线补收和历史分页，
|
||||
不依赖资料同步周期。成员与权限变化在服务端立即生效，并及时通知在线客户端。
|
||||
- 知识库、共享文件及资料索引按空间选择定期或按需同步，不等同于本地目录或全部历史镜像。
|
||||
提供立即同步资料、暂停资料自动同步、最近成功时间、待同步数量和失败原因。
|
||||
- 暂停资料自动同步不影响消息收发、提及通知、状态更新和离线补收，也不撤销服务端已有访问。
|
||||
- 离线消息保留“待发送”。只有服务端持久接收后显示“已发送”，不能据此推断已读、已执行或本人已确认。
|
||||
消息明确附带的资料需准备完成并通过授权检查后才能接受，不等待整库同步。
|
||||
- 重试使用稳定操作身份；服务端重复接收不产生重复消息、回复或分身任务。部分成功逐项确认，
|
||||
冲突保留双方版本供处理，不以静默覆盖扩大权限或丢失修改。
|
||||
- 离线关闭共享先停止本端普通上传，显示“待关闭共享”；恢复连接先处理撤销，再处理其他队列。
|
||||
服务端权限收紧即时生效，不等待客户端下一次定期同步。
|
||||
|
||||
### FR-17 成员消息与处理方式
|
||||
|
||||
- 每个共享空间对应一个群会话，允许不带提及的普通消息和回复线程。`@成员` 绑定组织、空间
|
||||
和稳定成员身份，只产生提及通知，不能因为接收者开了分身自动处理就触发执行。
|
||||
- “请求处理”是独立的显式意图，首期每个请求选择一个处理人；提及列表不等同于处理人。
|
||||
自由文本姓名不能代替身份选择，也不因分身不可用而切换处理人。
|
||||
- 发送前展示提及成员、处理人（如有）、所选上下文及线程受众。首期线程对获准空间成员可见，发送者必须具备
|
||||
向该受众共享附带资料的权限；上下文冻结发送时的版本与内容。
|
||||
- 处理人按空间为显式处理请求选择本人处理、分身先回复或分身起草；默认本人处理。分身方式明确绑定一个
|
||||
已授权 Publication，其身份可复用，但空间授权与个人访客入口分别管理。
|
||||
- “需要本人确认”优先进入本人待处理，不自动发出分身回复。普通偏好变更影响后续接受的
|
||||
处理请求；撤销和权限收紧在任务执行与结果发布时重新检查。普通消息没有处理状态。
|
||||
- 草稿仅本人及获准执行该任务的分身可访问，本人可编辑并确认发送。AI 输出、本人直接回复和
|
||||
本人确认的草稿在作者标记中区分；政策审批不代替本人对草稿的确认。
|
||||
- 草稿正文不进入空间广播、公开历史或普通成员的离线补收；本人确认后的最终回复才进入实时消息流。
|
||||
- 本人可接手同一线程；保留已发布回复，接手生效后的迟到 AI 结果不得自动发布。重复确认只
|
||||
产生一条回复。分身离线或失败则保留给同一成员处理，并解释原因。
|
||||
|
||||
### FR-18 共享知识与个人分身来源
|
||||
|
||||
- 知识库可独立共享，也可被空间和分身引用。复用来源身份与版本，各入口按来源授权、受众、
|
||||
使用动作及组织策略求交集；关联资料不自动扩大权限。
|
||||
- 用户可设置分身身份、表达提示词和选定知识来源。提示词不授予权限，开启分身不共享全部
|
||||
信息流；既有本地 Agent 记忆仍遵循 FR-13 的执行边界。
|
||||
- 选定监督回顾以明确版本的共享内容管理，“用于回答”和“查看原文”分别授权，支持仅回答、
|
||||
仅阅读、两者均允许或均关闭。新回顾不自动加入已选范围。
|
||||
- 明确授权共享的正文副本可进入共享内容存储；这不授予访问底层个人记忆库的能力。
|
||||
关闭某一分身入口不撤销知识库其他有效授权；撤销来源授权阻止依赖该授权的新读取和回答，
|
||||
已发出的内容按历史保留规则处理。
|
||||
- 首期服务端范围为已登录组织成员。个人“持有链接”匿名访问仅为 demo 概念，真实匿名发布、
|
||||
身份及滥用控制需另行设计，不以该 demo 改变第 3.2 节的匿名能力调用排除项。
|
||||
|
||||
## 5. 产品验收
|
||||
|
||||
工作空间、同步、成员消息和资料共享按 [用户故事](./user-stories.md) 的 `US-WS-01` 至
|
||||
`US-AV-01` 验收，覆盖正常、离线、撤销、重复提交、受众限制和接手竞争场景。
|
||||
|
||||
- 新实例可完成初始化、登录、创建组织、邀请成员和注册真实桌面设备。
|
||||
- 两个不同组织不能通过 API、搜索、计数、错误或审计结果读取对方数据。
|
||||
- 设备只有发布能力后才进入获准目录，撤销后不能接收新任务。
|
||||
@@ -226,7 +293,8 @@
|
||||
provider。
|
||||
- 数字人调用可以使用所有者在发布时勾选的 Agent、Global、指定 Project 或指定 Automation
|
||||
分区，但不能开放 Conversation 和 Run；ShareServer 和调用者不能读取原始记忆、未选择的
|
||||
本地分区或记忆来源正文。
|
||||
本地分区或通过该记忆权限读取来源正文。FR-18 另行发布的共享副本按自身授权读取，不能由
|
||||
此取得底层记忆分区的浏览权限。
|
||||
- 启用 Office 服务后，Windows、macOS 和 Linux Desktop 可从同一 ShareServer 分别打开、编辑
|
||||
和保存 DOCX、XLSX、PPTX；多个会话不会串文件、选区、checkpoint 或权限。
|
||||
- 文件 URL、callback token 和编辑器启动授权过期或撤销后不可重用；保存失败、源文件冲突或
|
||||
|
||||
Reference in New Issue
Block a user