feat: add local model gateway and console tabs
This commit is contained in:
@@ -16,8 +16,14 @@ ShareServer 是独立 Web 产品,不直接复用 Electron 页面壳层实现
|
||||
|
||||
## 1. 使用对象
|
||||
|
||||
当前本地首期在 `/capabilities?view=local` 提供“本地服务目录”页签,读取真实设备和发布数据。
|
||||
其余四个共享中心页签保留组织演示。真实页不使用示例组织、用户归属或在线状态解释本地记录。
|
||||
当前控制台移除模拟数据与操作。`/capabilities` 直接读取本地服务的设备和发布数据,原
|
||||
`/capabilities?view=local` 地址仍可访问。共享中心不再提供组织示例页签,不使用示例组织、
|
||||
用户归属或在线状态解释本地记录。
|
||||
|
||||
概览只提供已接入服务的入口,不显示预设指标和活动。导航保留规划模块;未接入的页面显示
|
||||
待实现说明,不提供虚假的保存、审批或健康检查。模型网关、共享目录分别加载自己的 API,
|
||||
控制台不再依赖原型快照。移除预设身份、组织切换、角色切换、通知数量和未实现的全局搜索。
|
||||
下文中的组织身份、文档协作及其他管理流程属于目标设计,尚未实现的部分不作为当前可用功能展示。
|
||||
|
||||
GoodBuddy 从应用菜单或应用中心进入“设备共享”,完成地址与名称保存、注册、发布、撤销和刷新。
|
||||
Web 提供设备、类型、状态、关键词筛选,显示注册时间、来源声明及独立知识权限;提供加载、空目录、
|
||||
@@ -56,6 +62,34 @@ GoodBuddy 接入
|
||||
当前组织始终显示。切换组织会重新加载整个数据范围,不保留上一组织的选择、筛选或详情。
|
||||
系统管理使用“实例范围”标识,不能伪装成某个组织。
|
||||
|
||||
### 2.1 页面 Tab 结构
|
||||
|
||||
每个管理页面围绕一个业务对象组织,页面内通过 Tab 切换查看范围或操作阶段。列表、详情和
|
||||
编辑表单属于当前 Tab 的交互,不单独增加一级导航。未接入的页面保留 Tab 结构,但每个 Tab
|
||||
只显示对应的待接入说明,不生成示例数据。
|
||||
|
||||
| 页面 | Tab |
|
||||
| --- | --- |
|
||||
| 运行概览 | 服务状态、待处理事项、最近活动 |
|
||||
| 模型网关 | 概览、上游服务、模型目录、访问密钥、请求测试、调用审计、客户端接入 |
|
||||
| 文档与协作 | 文档库、编辑会话、Office 服务、保存记录 |
|
||||
| 配置下发 | 配置草稿、设备生效、发布记录、回滚记录 |
|
||||
| GoodBuddy 接入 | 设备列表、设备详情、连接记录、撤销记录 |
|
||||
| 共享中心 | 能力目录、共享知识库、按成员查看、按设备查看 |
|
||||
| 数字人 | 数字人目录、我的数字人、调用权限、发布记录 |
|
||||
| 组织与成员 | 成员、用户组、角色、服务账号 |
|
||||
| 权限策略 | 强制策略、Grant、策略模拟、变更记录 |
|
||||
| 审批 | 待处理、已处理、我的申请、审批规则 |
|
||||
| 发布与更新 | 能力包、发布通道、更新策略、撤销记录 |
|
||||
| 网关联邦 | 合作组织、待确认、开放范围、事件记录 |
|
||||
| 任务与中继 | 任务列表、活动任务、中继连接、运行统计 |
|
||||
| 审计 | 事件查询、调用链、导出任务、保留策略 |
|
||||
| 系统设置 | 实例信息、身份与登录、基础设施、中继与联邦、通知、保留与审计 |
|
||||
| 我的设备与授权 | 我的设备、我的授权、我的申请、我的数字人 |
|
||||
|
||||
Tab 的状态和功能范围以[产品功能列表](./feature-list.md)为准。当前原型已经为组织与成员
|
||||
提供通用 Tab 组件;模型网关使用独立的真实 API 页面,其余尚未接入服务的页面显示占位说明。
|
||||
|
||||
## 3. 概览
|
||||
|
||||
概览只显示需要行动和运行事实:
|
||||
@@ -192,7 +226,7 @@ GPU-Worker-02 AI Team Linux 离线 8 2 小时前
|
||||
## 13. Office 编辑目标设计
|
||||
|
||||
Office 编辑管理归入“文档与协作”,属于系统管理员的服务配置和组织管理员的策略管理,不提供
|
||||
文档正文浏览器。以下是生产目标,当前实例配置与预设检查演示见第 16.1 节。
|
||||
文档正文浏览器。以下是生产目标,当前待接入页面见第 16.1 节。
|
||||
|
||||
日常文档操作在 GoodBuddy 中完成。文档以 ShareServer 为主存储;显式选择本地来源导入/回写
|
||||
时,另行显示检查点与源文件回写状态。关闭会话不表示删除主文档,检查点可用不表示本地源文件已保存。
|
||||
@@ -217,7 +251,7 @@ Office 编辑管理归入“文档与协作”,属于系统管理员的服务
|
||||
|
||||
### 13.1 私有部署第一阶段入口(待实现)
|
||||
|
||||
在 `/documents` 提供明确区分于现有演示的“私有文档试验”入口,展示无用户授权的使用范围。
|
||||
后续在 `/documents` 提供“私有文档试验”入口,展示无用户授权的使用范围。
|
||||
提供 DOCX 上传、真实文档列表、打开编辑器、保存状态与关闭后重新打开;不使用模拟个人/组织
|
||||
归属或角色开关解释真实文件。列表显示名称、大小、最近持久化版本与保存时间,不显示服务器路径。
|
||||
|
||||
@@ -250,34 +284,56 @@ Office 编辑管理归入“文档与协作”,属于系统管理员的服务
|
||||
shadcn/ui 的本地组件模式和 Radix 可访问 primitives,布局参考成熟后台的侧栏、顶栏、数据
|
||||
表格和详情对话框,但不复制第三方示例业务页面。
|
||||
|
||||
原型已覆盖数字人需求加入前的一级栏目、管理员与成员自助视图切换、组织范围、搜索筛选、
|
||||
页签、详情、创建表单、危险确认和 390px 窄屏导航。动态发光、网格和网络脉冲只用于运行状态
|
||||
与品牌氛围;业务表格仍保持克制,状态继续同时使用图标与文字。既有 fixture 页面操作会调用无持久化确认
|
||||
API,并持续标明不会写入生产数据,不能据此宣称真实审批、撤销、策略或任务操作已实现。
|
||||
早期原型覆盖一级栏目、角色切换、搜索筛选、详情、创建表单与窄屏导航。
|
||||
2026-10-02 起,控制台移除示例业务页面及其操作入口,保留侧栏、主题和窄屏导航。
|
||||
`FR-13` 新增的数字人目录、“我的数字人”和 `@` 选择器尚未进入当前原型。
|
||||
“文档与协作”已提供 OnlyOffice 实例配置和预设健康检查模拟;真实 Office 编辑与会话管理尚未实现。
|
||||
“文档与协作”显示待接入状态;Office 编辑与会话管理尚未实现。
|
||||
|
||||
### 16.1 GoodBuddy 服务演示
|
||||
### 16.1 GoodBuddy 服务入口
|
||||
|
||||
侧栏“GoodBuddy 服务”分组提供三个管理员路由。页首持续标注模拟边界:三页共享当前会话
|
||||
内存,导航保留状态、刷新重置;操作不调用网络或写本地存储。角色选择仅用于评审,不构成
|
||||
真实授权;未接入模型推理、网关转发、OnlyOffice 编辑保存或设备交付。
|
||||
本节记录已实现的 [B1 网关界面](./backend-foundation-design.md#4-b1正常模型网关接入),本轮未完成浏览器验收。
|
||||
|
||||
工作台顶部显示服务拓扑,按真实 API 汇总已登记 GoodBuddy 设备、ShareServer 发布目录和模型网关上游。拓扑表达服务职责和配置关系,登记设备不显示为在线,发布目录不显示为可执行内容;没有数据时显示零接入状态。
|
||||
页面按 Tab 组织为“概览”“上游服务”“模型目录”“访问密钥”“请求测试”“调用审计”“客户端接入”。概览只展示网关地址、资源数量和最近状态;
|
||||
上游服务管理外部连接,模型目录管理客户端可见的映射,访问密钥管理客户端授权,请求测试验证真实转发,调用审计查看有界元数据,客户端接入展示
|
||||
GoodBuddy 所需的地址和模型配置。不同 Tab 不混合配置表单、运行结果和审计记录。上游表单输入 API 地址和密钥,移除前缀与变量名;
|
||||
接入区展示完整 Base URL、协议、模型 ID,并支持创建与撤销访问 Key。凭据只显示配置状态,
|
||||
编辑上游时,凭据输入框留空表示保留当前值,填写新值表示覆盖;页面不要求用户选择额外的凭据操作。新建访问 Key 仅当次显示完整值,离开后只保留名称及状态。
|
||||
获取模型失败仍可手动添加,空状态引导接入,不填示例。访问 Key 的授权绑定模型记录 ID,修改别名不改变授权。
|
||||
|
||||
侧栏按业务流程分为“工作台”“GoodBuddy 服务”“共享资源”“组织管理”“运营与审计”“系统”和“成员自助”。
|
||||
其中“GoodBuddy 服务”分组保留模型网关、文档与协作、配置下发三个管理路由;“共享资源”集中设备接入和共享中心。
|
||||
各页分别说明实现范围。网关是无组织认证、
|
||||
组织隔离和配额的本地技术预览,已实现客户端 Key 认证及模型授权;文档与配置下发显示待接入说明。
|
||||
|
||||
| 路由 | 交互与结果 |
|
||||
| --- | --- |
|
||||
| `/model-gateway` 模型网关 | “上游服务”“模型映射 / 访问策略”“调用审计”页签;可添加和启停上游,切换映射上游、允许组及启停状态,选择调用组模拟允许/拒绝。最近 50 条审计仅含路由与策略结果,可查看详情,不含请求/响应正文 |
|
||||
| `/documents` 文档与协作 | “组织文档”“归属元数据”“OnlyOffice 服务器”“回收站”页签;展示名称与归属,无个人正文预览。OnlyOffice 可添加实例、预设健康/失败并累计模拟检查次数,不访问实例或建立编辑会话 |
|
||||
| `/distribution` 配置下发 | 创建一个配置草稿,选择目标组、当前可用默认模型和三段数字版本;发布前再次检查模型与组策略。按组展示当前/上一版本、设备已应用/目标版本,并可回退到上一条发布记录 |
|
||||
| `/model-gateway` 模型网关 | 按“概览/上游服务/模型目录/访问密钥/请求测试/调用审计/客户端接入”组织;配置保存到服务器,可添加、编辑、启停上游与映射,发现模型、创建和撤销访问 Key、测试及刷新审计,无用户组策略控件 |
|
||||
| `/documents` 文档与协作 | 显示尚未接入服务,无示例文档、实例或操作按钮 |
|
||||
| `/distribution` 配置下发 | 显示“尚无配置下发服务”及模型网关链接;无草稿、设备生效回执或发布回滚记录,保存网关模型不会自动下发到 GoodBuddy |
|
||||
|
||||
“打开模拟 GoodBuddy 客户端”仅打开对话框,个人创建者可删除自己的示例文档或确认转移给
|
||||
当前组织,不启动真实客户端或上传文件。转移后从个人列表移除,原个人删除权失效;显式
|
||||
勾选模拟“组织文档管理员”才可删除/恢复组织文档。其他成员个人文档不可操作,恢复保留
|
||||
原归属,演示不提供永久删除。
|
||||
网关初始展示空上游、空映射、空访问 Key 与空审计。上游表单填写名称、Base URL、协议、认证
|
||||
方式和启用状态;API Key 留空时保留已有凭据,填写真实 API Key 时覆盖旧值,提交后清空密钥输入。保存失败保留
|
||||
普通字段,密钥重试需重新输入。编辑默认保留;无需认证不会自动清除已有凭据。界面仅显示
|
||||
凭据配置状态,不返回旧值或密文。旧环境引用保留存储兼容,当前界面没有导入入口。
|
||||
|
||||
配置发布与回退仅更新目标组在线示例设备;离线设备保持原已应用版本并标记待下发,无重连
|
||||
交付模拟。回退同时恢复版本和默认模型;历史模型停用或当前组策略不允许时禁止回退,不能
|
||||
仅改版本标签。上游及 OnlyOffice 地址表单只接受不含账号、密码、查询参数或片段的 HTTPS
|
||||
地址,不提供密钥字段,也不验证连接。
|
||||
“发现模型”访问真实上游并列出结果,选择结果打开映射表单,也可手动填写。测试只列出上游、
|
||||
映射均启用且无需认证或已配置凭据的别名,用户填写提示词后通过本机管理 `/test` 发送非流式请求;发送前提示数据去向及
|
||||
可能费用。测试支持取消、清除结果,提示词与结果仅在组件内存中,离开页面清除。页面显示客户端
|
||||
Base URL 来自 `SHARESERVER_GATEWAY_BASE_URL`,本机示例为 `http://127.0.0.1:8787/api/v1/gateway/v1`;
|
||||
未配置时提示管理员设置,不从 Vite 端口或浏览器 Host 推断。客户端使用访问 Key,不使用上游 API Key。
|
||||
|
||||
配置加载失败可重试;已有快照时保留并标注上次数据。保存失败保留普通字段,错误显示 HTTP
|
||||
状态、错误码及请求 ID。取消测试后提示审计可能稍后更新。审计显示服务器保留的最新 200 条
|
||||
调用元数据:时间、编号、模型、上游、访问 Key ID、流式方式、结果、HTTP 状态、耗时、Token 用量与错误码;
|
||||
不展示正文,缺失用量显示“未知”。窄屏审计表可横向滚动。
|
||||
|
||||
文档页已移除“打开模拟 GoodBuddy 客户端”、示例文档、模拟角色和回收操作;归属操作待后端实现。
|
||||
|
||||
网关上游接受 HTTP/HTTPS,包括可信内网 HTTP,不允许账号、密码、查询参数或片段;保存不验证连接,
|
||||
发现与测试才发真实请求。OnlyOffice 实例表单与预设检查已退出当前界面。
|
||||
管理 API 与 Vite `/api` 均限制实际 socket 来源为回环;容器/反向代理管理待 B2 登录后支持。
|
||||
既有网关策略与配置发布演示记录属于历史交互证据,不作为当前真实网关或设备交付的测试结论。
|
||||
|
||||
## 17. Desktop 工作空间协作目标交互
|
||||
|
||||
|
||||
Reference in New Issue
Block a user