docs: 桌面端 UI 规划（驾驶舱 + RAG/报告/垂直复制 + MVP→平台级优先级）
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Blizzard
@@ -0,0 +1,133 @@
|
|||||||
|
# sundynix-agentix · 桌面端 UI 规划
|
||||||
|
|
||||||
|
> 第 1 层 Client（`sundynix-desktop`，Wails + React 19 + React Flow）的产品级 UI 规划。
|
||||||
|
> 目标：不止是连 Gateway 的 UI，而是承载 **RAG 知识库 / 报告生成 / 垂直行业平台级复制** 的驾驶舱。
|
||||||
|
> 定位已定：**真 Desktop** —— 用上 Wails 本地能力（文件 I/O、TS/Go 强绑定、本地配置、离线嵌入）。
|
||||||
|
|
||||||
|
## 0 · 设计原则 & 角色
|
||||||
|
|
||||||
|
- **三类用户，一个壳**：**构建者**（搭 Agent 图、建知识库）/ **操作者**（跑工作流、看报告）/ **管理员**（开垂直、管租户）。UI 按 BUILD / RUN / MANAGE 分组，按角色露不同模块。
|
||||||
|
- **专业工具范式**：IDE / 节点编辑器布局——左导航 + 主区 + 右检查器 + 底部抽屉。信息密度高。
|
||||||
|
- **可信优先**：RAG 必带**引用**；记忆**可看可改**；生成**有评测门**。透明是平台级底线。
|
||||||
|
- **垂直白标**：整个壳由当前垂直 Pack 的配置驱动（名称/主题/启用模块/术语/默认模板）。换行业 = 换配置，不改 UI。
|
||||||
|
|
||||||
|
## 1 · 信息架构（左导航）
|
||||||
|
|
||||||
|
```
|
||||||
|
■ 工作台 首页：概览 / 最近 / 快捷
|
||||||
|
─ BUILD ─
|
||||||
|
◆ 编排 Studio React Flow Agent 图构建器（核心）
|
||||||
|
▣ 知识库 (RAG) KB 管理 / 入库 / 检索调试 / 图谱
|
||||||
|
▤ 报告 模板 / 生成 / 产出库
|
||||||
|
─ RUN ─
|
||||||
|
▸ 运行 · 观测 实时执行 / 轨迹 / 历史
|
||||||
|
─ MANAGE ─
|
||||||
|
◇ 记忆 画像 / 会话历史
|
||||||
|
⌧ 市场 · Packs 垂直包 / Agent 模板 / 开通
|
||||||
|
⚙ 管理 租户 / 用户计费 / 护栏 / 模型 / 设置
|
||||||
|
```
|
||||||
|
|
||||||
|
## 2 · 全局外壳
|
||||||
|
|
||||||
|
```
|
||||||
|
┌──────────────────────────────────────────────────────────────────┐
|
||||||
|
│ [垂直▾ 法律版] · 搜索/命令(⌘K) · ●GW ●NATS ●Milvus ●Neo4j · 用户▾ │ 顶栏
|
||||||
|
├────┬──────────────────────────────────────────┬───────────────────┤
|
||||||
|
│ 左 │ 主区(随模块切换) │ 右:检查器/详情 │
|
||||||
|
│ 导 ├──────────────────────────────────────────┴───────────────────┤
|
||||||
|
│ 航 │ 底部抽屉:输出 / 轨迹 / 工具调用 / 引用 / 评测 ▴展开▾收起 │
|
||||||
|
└────┴──────────────────────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
- **垂直切换器**：切租户上下文 + 白标。
|
||||||
|
- **⌘K 命令面板**：跳转 / 跑模板 / 开库 / 查文档。
|
||||||
|
- **健康灯**：GW/NATS/Milvus/Neo4j/LLM 在线状态（可观测性）。
|
||||||
|
- **底部抽屉全局常驻**：任何模块跑任务，流式/轨迹/引用都在此看。
|
||||||
|
|
||||||
|
## 3 · 各模块详规
|
||||||
|
|
||||||
|
### ① 工作台
|
||||||
|
概览卡（KB 数 / 文档数 / 近期运行 / 待办报告 / 配额计费）· 快捷区（跑模板 / 新建图 / 入库）· 最近列表。
|
||||||
|
|
||||||
|
### ② 编排 Studio（核心）
|
||||||
|
左节点面板 · 中画布 · 右检查器 · 顶工具栏。
|
||||||
|
|
||||||
|
节点类型（按颜色分类，沿用架构图配色）：
|
||||||
|
|
||||||
|
| 节点 | 干什么 | 配置（检查器） |
|
||||||
|
|---|---|---|
|
||||||
|
| 输入 | 用户提问 / 文件 / 变量 | 来源、占位符 |
|
||||||
|
| 检索(RAG) | 绑定某 KB 混合检索 | 选 KB、topK、融合权重、rerank、元数据过滤 |
|
||||||
|
| Agent/LLM | 调模型生成 | 模型、系统提示词、温度、可用工具 |
|
||||||
|
| 工具 | 绑定 MCP 工具 | parse_document/render_doc/外部API… + 参数 |
|
||||||
|
| 记忆 | 注入画像/历史/语义 | 勾选注入项 |
|
||||||
|
| 分支 | 条件路由 | 条件表达式 |
|
||||||
|
| 并行/Map | fan-out（逐章节） | 拆分依据 |
|
||||||
|
| 汇聚 | reduce/合并 | 合并策略 |
|
||||||
|
| 渲染 | UniOffice 出 docx/pdf | 模板、样式 |
|
||||||
|
| 输出 | 展示/导出/落盘 | 目标（屏/文件） |
|
||||||
|
| 子图 | 嵌套可复用模板 | 选模板 |
|
||||||
|
|
||||||
|
顶工具栏：加节点 · ▶运行 · ■停止 · 保存/打开 `.dsl.json`(Wails 落盘) · **校验**(按后端 DSL schema 标红) · 版本。
|
||||||
|
运行时：节点逐个点亮 + 状态徽标(待/跑/流/完/错/降级) + token 数/耗时。
|
||||||
|
|
||||||
|
### ③ 知识库（RAG）—— 流水线，每段都露出
|
||||||
|
左 KB 列表 · 中主区(Tab) · 右文档/块详情。
|
||||||
|
- **入库监控**：拖文件/文件夹 → 流水线进度（解析→切块→向量化→三路建索引）、队列深度、失败重试。
|
||||||
|
- **检索调试台**：query → 三路召回 + 融合 + rerank 中间结果，每条带来源徽标(Bleve/Milvus/Neo4j)+ 分数。
|
||||||
|
- **文档/块浏览**：切块、向量邻居、引用回链。
|
||||||
|
- **知识图谱**：Neo4j 实体-关系可视化（GraphRAG 的脸）。
|
||||||
|
- **检索评测**：跑 golden 集，召回质量/忠实度（接 harness eval）。
|
||||||
|
|
||||||
|
### ④ 报告 —— 长程多节点编排的成品界面
|
||||||
|
左大纲树 · 中预览 · 右章节检查器；顶部进度。
|
||||||
|
- 模板库（尽调/行业分析/合规，预制 Eino 子图）· 大纲编辑（增删改/拖排序/指定 KB）。
|
||||||
|
- 生成中：各章节独立进度（检索/撰写/复核），并行 fan-out 可见。
|
||||||
|
- 中预览：实时拼装（目录/图表/表格/内联引用）。
|
||||||
|
- 导出条：→ docx/pdf(UniOffice) → Wails 原生保存落盘。产出库：历史/重跑/版本对比。
|
||||||
|
|
||||||
|
### ⑤ 运行 · 观测
|
||||||
|
实时回 Studio 看节点点亮 + 抽屉五 Tab：输出(SSE) / 轨迹(节点时间线) / 工具调用 / 引用 / 评测。运行历史可复盘。
|
||||||
|
|
||||||
|
### ⑥ 记忆（透明可控）
|
||||||
|
"模型记得我什么"（画像逐条，改/删，来源）· 会话 & 历史（多轮，可清空）· 注入开关。
|
||||||
|
|
||||||
|
### ⑦ 市场 · Packs（垂直复制入口）
|
||||||
|
垂直包市场（法律/医疗/金融包）· Agent 模板市场（拉进 Studio 当子图）· 开通向导（选包→配置→建租户→入库→注册模板→应用配置）。
|
||||||
|
|
||||||
|
### ⑧ 管理
|
||||||
|
租户/工作区（多租户隔离/配额）· 用户 & 计费 · 护栏（脱敏/免责/强制引用）· 模型 & 连接（LLM 池/embedding/后端地址/健康）· 设置（本地目录/主题/离线）。
|
||||||
|
|
||||||
|
## 4 · 跨模块复用组件（设计系统）
|
||||||
|
|
||||||
|
引用 chip `[1]`（悬浮:源文档+块+分数+来源徽标）· 来源徽标(三色) · 节点卡(统一状态机) · 流式 token 视图 · KB/模型/工具选择器 · 运行时间线(甘特) · 评测徽章。
|
||||||
|
|
||||||
|
## 5 · 垂直白标
|
||||||
|
顶栏切垂直 → 壳按 Pack 的 `branding` 重渲染：名称/Logo、主色、启用模块、术语标签、默认模板、护栏横幅。同一引擎，不同皮 + 内容。
|
||||||
|
|
||||||
|
## 6 · 状态设计
|
||||||
|
空态(引导) · 加载/流式(骨架+token+进度) · 降级(横幅:"语义检索降级，已用全文兜底") · 错误/重试。
|
||||||
|
|
||||||
|
## 7 · 落地优先级
|
||||||
|
|
||||||
|
| 层级 | 做什么 | 价值 |
|
||||||
|
|---|---|---|
|
||||||
|
| **MVP** | 外壳(顶栏+导航+健康灯+⌘K) · ② Studio 类型化节点+检查器+校验 · 运行抽屉(输出+轨迹) | 搭图→跑→看 闭环 |
|
||||||
|
| **平台核心** | ③ 知识库(入库+检索台+引用) · ④ 报告(模板+大纲+预览+导出) · ⑥ 记忆做厚 | RAG/报告 成形 |
|
||||||
|
| **平台级** | ⑦ 市场+开通向导 · ⑧ 多租户/护栏 · ⑤ 白标 · 图谱/评测台 | 垂直复制 |
|
||||||
|
|
||||||
|
> UI 的"平台核心/平台级"依赖后端先就绪：③④依赖 RAG 核心链（embedding + 入库 worker + 真实混合检索），⑦依赖多租户 + Pack 格式。UI 与后端并行排，在"知识库/报告"界面会合。
|
||||||
|
|
||||||
|
## 8 · 后端依赖链（提醒）
|
||||||
|
|
||||||
|
```
|
||||||
|
Embedding + 真实 LLM ← 命门（现为桩）
|
||||||
|
↓
|
||||||
|
RAG 核心(入库worker + 真Hybrid检索 + rerank) ← 拱心石
|
||||||
|
↓
|
||||||
|
报告生成(多节点 Eino 图 + UniOffice 渲染)
|
||||||
|
↓
|
||||||
|
多租户 + Pack 格式 + Provisioning ← 垂直复制
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
*（本规划随实现推进更新。当前进度见 git log 与 memory。）*
|
||||||
Reference in New Issue
Block a user