docs: README 运行指引补真实桌面端（make desktop / desktop-build + Wails 前置）

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

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
+**前置**：Docker、Go ≥1.24、Node ≥20、Python ≥3.11。
-> （NATS:4222 / PG sundynix\@5432 / Redis:6379 / Milvus:19530 / Neo4j neo4j-sundynix\@7687），
+跑**真实桌面端**还需：Wails CLI（`go install github.com/wailsapp/wails/v2/cmd/wails@latest`）；macOS 再装 Xcode 命令行工具（`xcode-select --install`，webkit 编译用）。
-> **clone 后无需改任何配置**即可连上。
+
+> 各服务默认配置已对齐 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        # 3) 运维控制台 (Vite :5174)
-make admin        #    运维控制台 (Vite :5174)
 ```
 
 4) 打开运维控制台(`:5174`)，在「模型 / 数据源」登记并激活：**对话模型(chat)** 与 **Embedding 模型**
    （开发期填第三方在线 API：base_url + api_key + model，OpenAI 兼容）。激活后经 NATS 热更新到各服务。
    — 这是唯一需要自己填的配置（API key），其余零配置。
 
-完成后即可在桌面端(`:5173`)：编排 Agent 图 → 运行（注入画像/历史，真实流式）；
+5) 启动客户端（任选其一）：
-知识库入库(docx/xlsx/pdf) → 三路混合检索(向量+全文+图谱)。
 
-> Go 多模块用 `go.work` 串联后端 4 模块；`sundynix-shared` 经各 go.mod `replace` 指向本地。
+```bash
-> 桌面端 Wails 封装(`make desktop` / `wails dev`)需先 `npm run build` 生成 `frontend/dist`，单独构建。
+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 约定