From a8e210cd9611044efbe5f7452ebb45a6d6a1f84b Mon Sep 17 00:00:00 2001 From: Blizzard Date: Wed, 10 Jun 2026 14:51:03 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=A1=8C=E9=9D=A2=E7=AB=AF=20UI=20?= =?UTF-8?q?=E8=A7=84=E5=88=92=EF=BC=88=E9=A9=BE=E9=A9=B6=E8=88=B1=20+=20RA?= =?UTF-8?q?G/=E6=8A=A5=E5=91=8A/=E5=9E=82=E7=9B=B4=E5=A4=8D=E5=88=B6=20+?= =?UTF-8?q?=20MVP=E2=86=92=E5=B9=B3=E5=8F=B0=E7=BA=A7=E4=BC=98=E5=85=88?= =?UTF-8?q?=E7=BA=A7=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.8 --- desktop-ui-plan.md | 133 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 133 insertions(+) create mode 100644 desktop-ui-plan.md diff --git a/desktop-ui-plan.md b/desktop-ui-plan.md new file mode 100644 index 0000000..6753ca5 --- /dev/null +++ b/desktop-ui-plan.md @@ -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。）*