feat: add local sharing and containerized web/server layout
This commit is contained in:
lofyer
@@ -5,8 +5,8 @@
|
||||
| 项目 | 内容 |
|
||||
| --- | --- |
|
||||
| 状态 | 设计中 |
|
||||
| 版本 | 0.6 |
|
||||
| 日期 | 2026-09-28 |
|
||||
| 版本 | 0.7 |
|
||||
| 日期 | 2026-09-30 |
|
||||
| 适用产品 | 独立部署的 ShareServer 与 Web 管理控制台 |
|
||||
| 关联架构 | [共享网络总体设计](../../../../goodbuddy/docs/architecture/share-network-architecture.md) |
|
||||
| 关联文档 | [功能逻辑](./logic-design.md)、[管理界面](./ui-design.md)、[技术设计](./technical-design.md) |
|
||||
@@ -21,7 +21,7 @@
|
||||
|
||||
1. 组织可在自有网络、私有云或公网独立部署 ShareServer。
|
||||
2. 管理员可统一管理用户、组、设备、能力、权限、更新和审计。
|
||||
3. 成员通过桌面端使用获准能力，无需日常进入管理控制台。
|
||||
3. 成员在 GoodBuddy 中完成日常操作；ShareServer 提供组织后台，无需日常进入管理控制台。
|
||||
4. 设备离线、用户撤销或策略变化能准确影响新任务，不破坏历史证据。
|
||||
5. 两个组织可经双边确认建立有限范围的联邦协作。
|
||||
6. ShareServer 可以只运行控制面，也可按部署策略提供数据中继和包存储。
|
||||
@@ -31,6 +31,16 @@
|
||||
|
||||
## 3. 产品范围
|
||||
|
||||
### 本地首期交付
|
||||
|
||||
先验证 GoodBuddy 应用中心中的设备共享与 ShareServer 目录互通：用户保存本地服务地址、
|
||||
注册本机，显式发布能力或知识的名称、描述、来源及权限声明，再撤销发布。Web 共享中心能查询
|
||||
相同记录，服务重启后记录仍保留。此阶段不自动枚举本地能力或上传知识文件。
|
||||
|
||||
验收要求：注册不自动发布，撤销后刷新仍为已撤销，网络失败有可重试反馈，知识权限独立保存；
|
||||
真实目录与组织样例分别展示。API、状态和验证证据分别由技术设计、逻辑设计和实施进度维护。
|
||||
身份认证、组织授权、内容同步与远程调用仍按以下完整产品范围继续实现。
|
||||
|
||||
### 3.1 包含
|
||||
|
||||
- 本地账号及可配置 OIDC 身份源。
|
||||
@@ -46,12 +56,14 @@
|
||||
- Web 管理控制台和成员自助页面。
|
||||
- 工作空间的组织共享关联、成员访问、实时普通消息与线程、提及通知、处理请求和资料同步。
|
||||
- 选定知识与监督回顾的共享授权，及数字分身对这些来源的复用。
|
||||
- 模型网关接入其他模型服务，管理模型映射、访问策略和调用审计，以及按用户组分配网关模型配置。
|
||||
- 以 ShareServer 为主存储的文档、个人与组织归属管理；本地来源导入／回写为显式选择的独立模式。
|
||||
|
||||
### 3.2 不包含
|
||||
|
||||
- 远程管理设备桌面、任意 Shell 或任意文件系统。
|
||||
- 发现未注册的局域网设备。
|
||||
- 保存或分发用户 API Key、Cookie 和桌面登录状态。
|
||||
- 收集或分发用户个人 API Key、Cookie 和桌面登录状态。模型网关所需的组织上游凭据由管理员单独配置、服务端保管，不下发给客户端；当前原型不接收凭据。
|
||||
- 默认查看任务正文、附件和模型输出。
|
||||
- 自动上传、同步或浏览数字人所有者的本地个人、项目、会话和原始 Agent 记忆；用户明确发布的知识与选定回顾按 FR-18 单独管理。
|
||||
- 因为成员加入组织而自动开放其数字人、记忆、Runtime、工作区或工具。
|
||||
@@ -60,7 +72,8 @@
|
||||
- 公共开放市场、计费结算或匿名能力调用。
|
||||
- 替代 GoodBuddy 官方客户端、模型和 Agent 发布源。
|
||||
- 自行实现 Office 渲染器，或把 ONLYOFFICE Document Server 打进 Desktop 安装包。
|
||||
- 默认永久保存用户文档、选区、提示词或模型输出。
|
||||
- 模型托管与推理运行。
|
||||
- 在普通日志或审计中保存文档正文、选区、提示词或模型输出；服务端主文档按归属、删除和保留规则管理。
|
||||
- 首期不含私聊、语音视频、已读回执、正在输入及分身输出逐字广播；空间协作按轻量 IM 范围实现。
|
||||
|
||||
## 4. 功能需求
|
||||
@@ -144,6 +157,15 @@
|
||||
- 普通成员只看到自己的设备、授权和待办；管理员栏目按权限隐藏并在 API 再次校验。
|
||||
- 普通成员可以管理自己发布的数字人，并发现和 `@` 当前组织内获准调用的数字人。
|
||||
- 所有高影响操作说明对象、范围和后果。
|
||||
- 共享中心扩展既有共享能力入口，保留 `/capabilities`；提供能力目录、共享知识库、按用户查看、
|
||||
按设备查看四个页签。内容展示发布者、提供设备、版本、在线与发布状态、共享对象；用户和
|
||||
设备视图列出关联内容并可进入详情，既有设备详情提供对应共享视图入口。
|
||||
|
||||
当前“GoodBuddy 服务”原型提供 `/model-gateway`、`/documents`、`/distribution` 三页，覆盖
|
||||
网关策略判断、文档归属与回收站、OnlyOffice 实例检查、配置发布和回退。操作仅修改会话内存，
|
||||
跨页保留、刷新重置，不发送服务请求或写入本地存储；模拟角色不构成授权，模拟成功不构成
|
||||
推理、转发、Office 保存或设备交付的验收。离线设备保持待下发与原已应用版本；发布和回退
|
||||
都检查目标组当前可用模型，回退同时恢复版本及默认模型。细节见 UI 设计第 16.1 节。
|
||||
|
||||
### FR-12 可部署性
|
||||
|
||||
@@ -190,6 +212,13 @@
|
||||
|
||||
### FR-14 Office 编辑服务
|
||||
|
||||
- 日常文档使用在 GoodBuddy 中完成，ShareServer 主存文档与临时编辑会话分别管理。个人创建者
|
||||
可删除自己的文档或确认转移给组织；转移后按组织权限删除，原创建者的个人删除权失效。
|
||||
管理后台展示归属元数据不授予个人正文访问权。原型以显式“组织文档管理员”角色模拟组织
|
||||
文档删除／恢复，恢复保持归属，不提供永久删除。
|
||||
- 本节既有工作副本上传、检查点下载和源文件回写流程适用于显式选择的本地来源导入／回写
|
||||
模式，保留 Desktop／SSH 源文件基准校验与冲突契约。服务端主存模式不以本地回写作为保存
|
||||
完成条件；关闭编辑会话不删除主文档，也不改变归属。
|
||||
- Office 编辑是可选服务能力。未配置或健康检查失败时，ShareServer 仍可运行其他控制面功能，
|
||||
并向 Desktop 返回明确不可用原因。
|
||||
- 首选 ONLYOFFICE Docs Developer Edition，目标支持 DOCX、XLSX 和 PPTX。正式采用前必须完成
|
||||
@@ -202,11 +231,11 @@
|
||||
修改定位与高亮、撤销重做；源文件回写仍以检查点为依据。客户端需求与选型验证以
|
||||
[Office PRD](../../../../goodbuddy/docs/features/office-document-editing/prd.md) 的 `FR-6`、
|
||||
`FR-13`、`FR-14` 为准。
|
||||
- Desktop 使用设备身份创建 `DocumentEditSession`，上传经过大小、格式和 SHA-256 声明的工作
|
||||
- 本地来源模式下，Desktop 使用设备身份创建 `DocumentEditSession`，上传经过大小、格式和 SHA-256 声明的工作
|
||||
副本。ShareServer 不接收本机或 SSH 绝对路径，也不允许文件名决定对象存储路径。
|
||||
- ShareServer 为编辑器签发一次性启动授权，为 ONLYOFFICE 签发独立的短期文件和 callback
|
||||
凭据；设备、编辑器和 callback audience 不能互换。
|
||||
- ONLYOFFICE 保存先形成不可变 `DocumentCheckpoint`。ShareServer 只宣称检查点可用，不宣称
|
||||
- 本地来源模式下，ONLYOFFICE 保存先形成不可变 `DocumentCheckpoint`。ShareServer 只宣称检查点可用，不宣称
|
||||
Desktop 本地或 SSH 源文件已经回写成功。
|
||||
- 服务端保存组织、主体、会话、文档类型、大小、策略、编辑器版本、checkpoint 和清理审计；
|
||||
默认不保存文档正文、选区正文、提示词或模型输出到普通日志和审计表。
|
||||
@@ -217,7 +246,7 @@
|
||||
- Ask 只能取得 AI 修改建议；只有 Desktop 确认的 Execute 请求可以取得绑定单会话、revision
|
||||
和选区的短期编辑授权。
|
||||
- 会话关闭、撤销或到期后停止新读取、保存和 AI 操作，并按组织保留策略清理工作副本、
|
||||
checkpoint、Cookie 和对象令牌。
|
||||
checkpoint、Cookie 和对象令牌；服务端主文档不随临时会话清理。
|
||||
|
||||
### FR-15 工作空间与共享属性
|
||||
|
||||
@@ -263,6 +292,8 @@
|
||||
|
||||
### FR-18 共享知识与个人分身来源
|
||||
|
||||
- 知识库明确区分服务器同步副本与远程设备取用，分别展示来源可用性。搜索、读取原文、下载
|
||||
独立授权；管理员的元数据可见性不产生内容权限。当前 Web 原型仅展示示例规则，不接入内容操作。
|
||||
- 知识库可独立共享，也可被空间和分身引用。复用来源身份与版本，各入口按来源授权、受众、
|
||||
使用动作及组织策略求交集；关联资料不自动扩大权限。
|
||||
- 用户可设置分身身份、表达提示词和选定知识来源。提示词不授予权限，开启分身不共享全部
|
||||
|
||||
Reference in New Issue
Block a user