From 8469cfc0dbbdc909e2dc89ec5da4ad64e54f753b Mon Sep 17 00:00:00 2001 From: Blizzard Date: Thu, 11 Jun 2026 17:36:00 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20README=20=E8=BF=90=E8=A1=8C=E6=8C=87?= =?UTF-8?q?=E5=BC=95=E8=A1=A5=E7=9C=9F=E5=AE=9E=E6=A1=8C=E9=9D=A2=E7=AB=AF?= =?UTF-8?q?=EF=BC=88make=20desktop=20/=20desktop-build=20+=20Wails=20?= =?UTF-8?q?=E5=89=8D=E7=BD=AE=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 --- README.md | 33 ++++++++++++++++++++++++--------- 1 file changed, 24 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 8c15b6b..673eda5 100644 --- a/README.md +++ b/README.md @@ -42,9 +42,11 @@ SSE 客户端: event:token data:已 event:token data:编 ... event:done ← ### 完整环境（git clone 后零配置直跑） -> 前置：Docker、Go ≥1.24、Node ≥20、Python ≥3.11。各服务默认配置已对齐 docker-compose -> （NATS:4222 / PG sundynix\@5432 / Redis:6379 / Milvus:19530 / Neo4j neo4j-sundynix\@7687）， -> **clone 后无需改任何配置**即可连上。 +**前置**：Docker、Go ≥1.24、Node ≥20、Python ≥3.11。 +跑**真实桌面端**还需：Wails CLI（`go install github.com/wailsapp/wails/v2/cmd/wails@latest`）；macOS 再装 Xcode 命令行工具（`xcode-select --install`，webkit 编译用）。 + +> 各服务默认配置已对齐 docker-compose（NATS:4222 / PG sundynix\@5432 / Redis:6379 / +> Milvus:19530 / Neo4j neo4j-sundynix\@7687），**clone 后无需改任何配置**即可连上。 ```bash make infra # 1) 启动 NATS / Postgres / Redis / Milvus / Neo4j (docker-compose) @@ -52,19 +54,32 @@ make gateway # 2) 各开一个终端运行后端 make dispatcher make mcp-go make mcp-py # 首次自动建 venv + 装解析依赖 -make web # 3) 桌面端前端 (Vite :5173，首次自动 npm install) -make admin # 运维控制台 (Vite :5174) +make admin # 3) 运维控制台 (Vite :5174) ``` 4) 打开运维控制台(`:5174`)，在「模型 / 数据源」登记并激活：**对话模型(chat)** 与 **Embedding 模型** （开发期填第三方在线 API：base_url + api_key + model，OpenAI 兼容）。激活后经 NATS 热更新到各服务。 — 这是唯一需要自己填的配置（API key），其余零配置。 -完成后即可在桌面端(`:5173`)：编排 Agent 图 → 运行（注入画像/历史，真实流式）； -知识库入库(docx/xlsx/pdf) → 三路混合检索(向量+全文+图谱)。 +5) 启动客户端（任选其一）： -> Go 多模块用 `go.work` 串联后端 4 模块；`sundynix-shared` 经各 go.mod `replace` 指向本地。 -> 桌面端 Wails 封装(`make desktop` / `wails dev`)需先 `npm run build` 生成 `frontend/dist`，单独构建。 +```bash +make desktop # ★ 真实桌面端：Wails 原生窗口（热重载）——独立 App，非浏览器 +# 或 +make web # 浏览器预览版（Vite :5173，前端代码同上） +``` + +打包桌面端为可双击的原生应用： + +```bash +make desktop-build # → sundynix-desktop/build/bin/sundynix_desktop.app +``` + +完成后即可：编排 Agent 图 → 运行（注入画像/历史，真实流式）；知识库入库(docx/xlsx/pdf) → +三路混合检索(向量+全文+图谱)。桌面端是客户端，经 HTTP 连 Gateway:8080，需先起后端。 + +> 后端 4 模块用根 `go.work` 串联；`sundynix-shared` 经各 go.mod `replace` 指向本地。 +> 桌面端是自包含模块，`make desktop`/`desktop-build` 用 `GOWORK=off` 独立构建（不入 go.work）。 ## NATS Subject 约定