Blizzard
7.9 KiB
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。）