DSH（Java） + A2A，我构建了桌面版「数字人」！

来啦，死鬼！ 👻 一款基于  DSH Java Agent Runtime 构建的 AI 智能体桌面端整好了；具备编码、绘图、文档、图表等多场景工作能力！

但，它还不只局限于此！

以 A2A（+dsh.v1） 的开放协议设计（把大腿🦵接上啦），我让这款智能体具备了跨端协作能力，通过多 Agent 协作会话，把单应用智能体升级为数字人 👬🏻 协同（开了个微信聊天群）；云服务器的 Agent、产品库 PRD Agent、舆情监测和故障巡检 Agent、开发机 Agent、大数据数仓 Agent、离职同事蒸馏 Agent等。

现在他们就像你的同事，都在一个聊天群里进行对话协作办公。再结合，插件、Skills、MCP、CLI，让你可以无限连接🔗。—— 老板，看数据，可以对接各个数字人，协同✍🏻工作！

⏬ 下载：https://drive.weixin.qq.com/s?k=ACMA4AfQABUCptZVB3

DSH Java Desktop 是 deepseek-harness-java（Agent Runtime 服务端）的桌面工作台：使用 TypeScript + React 构建界面，通过 Tauri 2 负责窗口、进程与本机能力；智能体能力依赖于 DSH Java 服务，通过桌面壳启动 deepseek-harness-java 的 Spring Boot JAR，并通过本机 HTTP/SSE API 调用完成会话。这套东西设计的流程性蛮不错的，核心 Agent 运行时升级迭代方便。

在使用中，通过对话可以直接完成 draw.io 流程图制作、也能搞定 excel、word、md 多种类型文件，还能把一群人（跨端 Agent）拉倒一个群里对话协议做。咋样，是不挺帅的。接下来，小傅哥就给大家介绍这套软件；怎么运行体验、了解架构设计、如何二次开发。

下文，有详细的安装、使用，以及源码获取说明。

💐 文末（结尾）提供了 DSH-Java 项目服务端源码，以及 WaLiSSH、WaLiAPI、WaLIOffice、AI MCP Gateway 等各项编程项目的工程源码源码。

一、我的思路

我用过 Spring AI，也跟过 Google ADK，在早期也基于 OpenAI 协议文档，手搓 SDK 包。我想做各类场景的智能体实现，但不想每个场景都从头实现。MCP 可以连接服务、Skills 可以做规约限制，但仍然需要，找到一个更好的架构方式，在各场景快速完成智能体实现。所以，我干了现在的事，让底层提供一套干净的运行时 Agent。后面有其他小公司找我做场景应用智能体，我基本可以一天内就完成初步的对接。

有人提到，为啥不用 Codex、Claude Claude 直接作为公司的商城的智能客服（配置个 skill 就可以），先说不人家会扒你裤衩🩲，上传你代码不。而是这样的软件本身就有一套庞大的提示词（起步60k）来支撑特定场景使用。所以，即使你的 Skills 约束再多，也免不了提供的商城客服，可能反手就帮用户做其他的去了，比如画个猫和老鼠，给我写个 Hello World！

第一阶段是 Dify、Coze 方案，通过拖拉拽编排场景智能体。第二阶段是 AI Agent 脚手架，把 Spring AI + Google ADK 做成通用智能体开发框架，快速搭建通用工程实现。现在是第三阶段 Harness 🐴 马具，以 DSH 为参考，设计实现 Java 版本，通过 ClassLoader 热加载机制，对用户实现的插件进行装配使用。

所以，一个多月时间，我分了三步走 👣

• 第1步；基于 Java + DDD，1:1 复刻 DeepSeek Harness 项目。
• 第2步；上线 dsh-java.xiaofuge.cn 官网，通过商城智能客服、MySQL 运维平台，教大家如何通过插件开发快速构建智能体。
• 第3步；就是现在，我还要给你一个桌面版（虽然当前阶段他还没有那么完善，但更为重要的是这整套的架构方案，以及你可以拿去二开），为大家提供跨端Agent 协同办公。这是企业里非常重要的数字人设计。—— 你也可以学习后，承接各类小企业的活，构建数字人智能体。

二、产品介绍

1. 下载安装

产品官网；https://dsh-java.xiaofuge.cn - mac\windows\linux，产品初期可能会存在一些小 Bug（但不会把你的代码搬走），可以拿到源码后，陆续迭代使用。授权；所有小傅哥社群用户，可以修改软件名称，发布成自己的作品，让用户安装使用。

如果你想体验数字人的多 Agent 协作，可以把在其他地方部署 DSH-Java 服务（下文有数字人方式），在桌面端配置数字人管理起来。嘿，估计用不了多久，很多桌面端程序也都会陆续引入数字人场景。

2. 源码启动

桌面版应用由两套东西组成，一个是后端 DSH-Java 运行时服务，另外一个是前端 DSH-Java-Desktop。整个应用的过程，是把 DSH-Java 构建的 Jar 放到前端工程中，并加入 JVM 最小依赖用于启动 Jar 包。

这样我们就把整个东西链接起来了，正因为如此，我们把运行时智能体做成了服务，那么这套服务，既可以是桌面直接启动的本地的，也可以是远程服务器上的。那么，Agent 协同办公的数字人就随之而来了。

• 桌面；https://gitcode.net/KnowledgePlanet/dsh-java-desktop

• 后端；https://gitcode.net/KnowledgePlanet/deepseek-harness-java

• 插件；https://gitcode.net/KnowledgePlanet/dsh-java-mysql

目前这2套工程源码，开放在小傅哥的社群「码农会锁」，项目地址；https://t.zsxq.com/kYcVt - 下载源码后，可以用ai工具打开两套项目，帮你分析，这样可以快速了解。

2.1 环境要求

平台额外依赖：

• macOS：Xcode Command Line Tools（xcode-select --install）。
• Windows：已自带 WebView2（Win10/11 一般无需操作）；需 Visual Studio C++ Build Tools。
• Linux：webkit2gtk-4.1、libappindicator 等系统库（参考 Tauri 官方 prerequisites）。

2.2 获取代码

桌面端与配套服务端必须同级放置（服务端路径被开发模式回退逻辑引用）：

mkdir -p ~/coding/github/deepseek-harness && cd ~/coding/github/deepseek-harness
git clone :KnowledgePlanet/deepseek-harness-java.git deepseek-harness-java
git clone :KnowledgePlanet/dsh-java-desktop.git DSH-Java-Desktop

目录结构应为：

deepseek-harness/
├── deepseek-harness-java/    # 服务端（Spring Boot，产出内置 JAR）
└── DSH-Java-Desktop/         # 桌面端（本工程）

2.3 构建内置服务端 JAR（一次性）

桌面端启动时会拉起一个内置的 Spring Boot JAR（resources/agent/deepseek-harness-java-app.jar，不入 Git），首次准备需要构建它：

cd DSH-Java-Desktop
npm run agent:prepare

这一条命令会依次完成：

1. agent:build —— 到 ../deepseek-harness-java 执行 mvn -DskipTests package；
2. agent:copy —— 把产出的 JAR 复制为 resources/agent/deepseek-harness-java-app.jar；
3. agent:runtime —— 按当前平台下载 Temurin JRE 17 到 resources/agent/runtime（可选，下载失败也不影响开发运行，见第 4 步说明）。

如果不想下载内置 JRE，可跳过第 3 步：开发模式下 Java 运行时按 DSH_AGENT_JAVA 环境变量 → 内置 Runtime → 系统 java 的顺序选择，只要系统装有 JDK 17+ 即可。

2.4 安装依赖并启动

cd DSH-Java-Desktop
npm install         # 换机器 / 拉新代码后如报 Failed to resolve import，先执行这步
npm run tauri dev

首次执行会编译 Rust 壳，耗时较长（几分钟），后续启动很快。成功后会弹出桌面窗口，窗口内即 React 界面。

启动过程中 Tauri Rust 层会自动：

1. 选择一个空闲的本机端口；
2. 用内置 Runtime（或系统 Java）拉起服务端 JAR 子进程；
3. 把端口、运行状态写入 （macOS 为 ~/Library/Application Support/cn.xiaofuge.desktop/）。

综上，如果你之前没怎么折腾过这块内容，可以在 AI Agent 工具里，让帮你完成工程的初始化和启动。

3. 功能简述

DSH-Java Desktop 桌面版，基本与市面 Codex 类型的产品是类似的。差一点主要在于数字人功能，创建数字人，把数字人加入到项目上，之后对话的时候就可以自动的使用数字人了。

3.1 基础功能

3.2 数字人（多Agent协作）

下载 DSH Java 服务的 Jar 地址；https://drive.weixin.qq.com/s?k=ACMA4AfQABUnIBrQ39

curl -fsSLO https://dsh-java.xiaofuge.cn/scripts/start-local-jar.sh
chmod +x start-local-jar.sh
./start-local-jar.sh

• 如果是云服务器，注意⚠️在安全组，开放端口 8090
• 之后，云服务器IP:8090 访问，设置里配置模型，之后验证对话。

三、架构设计（DSH Java Desktop）

这里是《DSH Java Desktop》项目的架构设计相关的简要介绍，面向有一定工程背景的读者，重点讲清三个问题：为什么桌面端要"只做壳"、一个 Java 实现的 Agent Runtime 如何驱动 ReAct 循环、以及多数字人协作如何在不失控的前提下并行。

1. 顶层设计决策：桌面端只做壳，能力由服务端承载

大多数 AI 桌面应用的路径是把 Agent 逻辑写进前端或 Node 侧，遇到复杂编排就会把 UI 项目拖成大杂烩。DSH Java Desktop 做了相反的选择——智能体能力内嵌而非重写：

• deepseek-harness-java-app.jar（Spring Boot 3.3，DDD 六边形架构）作为 Tauri bundle resource 直接打进安装包（resources/agent/）。ReactLoopAgent 主循环、会话事件溯源、工具注册与执行、任务队列、权限审批、模型渠道管理、数字人协作域，全部由服务端实现，桌面端只做 UI 投影。
• 服务端以 standalone profile 运行，存储使用本地 H2，数据落在应用数据目录——桌面场景做到零外部依赖，不要求用户先部署 MySQL。
• 发布版内置 Temurin JRE 17（resources/agent/runtime，由 scripts/prepare-runtime.mjs 按平台下载），用户无需安装或配置 JDK，应用也不污染 JAVA_HOME / PATH。

这个决策带来两个直接收益：桌面端与服务端可以独立演进（服务端改动只需重打 JAR 覆盖 resource）；同一套 Runtime 既能内嵌在桌面端，也能部署在远端服务器，为后面的"数字人协作"铺平了道路——本地数字人和远端数字人本质上是同一种东西。

2、 三层结构：Rust 壳、React UI、内嵌 Java Runtime

┌─────────────────────────────────────────────────┐
│  桌面端（Tauri 2 + React 19 + TypeScript）        │
│                                                 │
│  React UI ──invoke(22个自定义命令)──► Tauri Rust 壳 │
│      │                                │         │
│      │ HTTP/SSE (127.0.0.1)           │ spawn   │
│      ▼                                ▼         │
│  ┌───────────────────────────────────────────┐  │
│  │  deepseek-harness-java-app.jar (Spring Boot)│ │
│  │  trigger 协议接入层 / domain 核心服务层       │  │
│  │  infrastructure 基础设施层                  │  │
│  └───────────────────────────────────────────┘  │
│              ▲ 内置 Java 17 Runtime              │
└─────────────────────────────────────────────────┘

Tauri Rust 壳承担的是"操作系统代理"职责，共 22 个自定义命令：选择空闲端口、拉起/停止 JAR 子进程、捕获日志、记录运行状态到 ，以及本地文件读写、凭据安全存储、系统通知、Git 分支查看与切换、自动更新。一个值得注意的细节是崩溃恢复：上次异常退出时，下次启动会先清理遗留 JAR 进程，避免 H2 文件锁冲突导致服务起不来。前端不暴露任何执行命令的安全面，UI 与 Rust 之间的边界是明确的命令契约。

服务端是标准的 DDD 六边形架构，按 Maven 多模块拆分：

• trigger（协议接入层）：Agent SSE 流、DSH 网关、A2A/AgentCard 端点、数字人协作 API、扩展管理 API；
• domain（核心服务层）：ReactLoopAgent、会话事件、任务/审批、模型渠道、协作编排——不依赖任何框架细节；
• infrastructure（基础设施层）：工具注册、MCP、Skills、CLI、H2/MySQL 持久化、远端网关实现。

端口依赖全部内向：domain 定义 ILlmRuntimePort、ISkillProviderPort、IExtensionManagementPort 等出站端口，infrastructure 提供适配器。这使得 LLM 供应商、扩展存储、协作协议都可以替换而不触碰核心逻辑。

通信模型刻意收敛为两条通道：UI → Rust 走 Tauri invoke（能力调用），UI → Java 走 127.0.0.1 上的 HTTP/SSE（数据流）。本地端口不进入主对话区，只在设置页展示诊断信息。

3. 核心：ReactLoopAgent 与事件溯源

Agent 运行时的心脏是 ReactLoopAgent，一个线程安全的 ReAct 驱动器：

1. 收到 Inbox 输入后唤醒，在虚拟线程中异步执行；
2. 打开 turn，流式调用 LLM（Reason）→ 执行工具（Act）→ 结果作为观察值回填下一轮输入（Observe）；
3. 直到模型不再请求工具后关闭 turn，循环处理直到 Inbox 为空。

几个实现细节体现了工程考量：

• 阶段状态机：phase 用 volatile 维护，所有阶段切换在同步控制下完成；activityDone 用 AtomicReference 追踪当前活动，保证并发唤醒时不会出现两个 turn 交叉执行。
• 流式sink按次设置：streamDeltaSink / streamToolCallSink / streamFinishSink 等由 SSE 请求按次注入，把"模型增量输出"实时推给前端分段渲染，同时不与长驻的 Agent 生命周期耦合。
• 上下文压缩：CompactionEngine 在会话变长时压缩历史，避免长对话撑爆上下文窗口。
• 事件溯源：每一步（模型输出、工具调用、结果回填）都通过 SessionEventFactory 写入会话事件日志（SessionLog / SessionEvent）。配套有 SessionWriteLeaseService（写租约防并发写坏）、SessionRebuilderService（从事件重建会话状态）和 InMemorySessionProjectionCache（读投影缓存）。事件日志是唯一事实源，UI 只是投影——这个原则贯穿整个系统。

4. 数字人协作域：房间、任务 DAG 与开放协议

"数字人"在 DSH 里不是带头像的聊天入口，而是可被发现、被授权、可执行任务、可参与协作的 Agent 身份。身份（名称、头像、用途、权限）与执行体（模型、工具、会话）解耦：同一个数字人身份可以指向本地 Runtime，也可以指向远端服务。

协作采用"房间承载上下文，任务承载分工，事件日志承载审计"的模式，刻意回避了自由群聊式多 Agent 协作常见的重复劳动与上下文膨胀：

1. 用户在房间描述目标，或 @成员名 定向派发；
2. Planner 生成计划，展开为任务 DAG——无依赖任务并行执行，有依赖的任务等上游产物就绪后自动续跑；
3. 成员执行中可通过 ASK 协议定向提问，答复自动注入指令续跑；
4. 失败恢复有明确预算：每任务 1 次恢复机会，优先改派（按能力标签匹配），无候选则同员重试，耗尽才级联终止下游；
5. 取消语义完整：任务注册表 + FutureTask 取消 + 状态不被覆盖 + 下游级联置 FAILED。

所有协作事件归一化为 RoomEvent 落库，前端通过 SSE 订阅 + REST 轮询对账消费——聊天消息、工具卡、任务状态、产物、审批都只是事件流的投影。

协议层是双栈设计。服务端同时实现 DSH v1 Agent Card（/.well-known/dsh-agent-card）与标准 A2A 0.3.x 协议（/.well-known/agent-card.json + JSON-RPC /a2a 端点，支持 message/send、message/stream SSE、tasks/get、tasks/cancel）。客户端侧做双协议探测发现——添加数字人时填入 Base URL，应用自动探测 Agent Card 并预填能力信息。这意味着远端任何符合 A2A 标准的第三方 Agent 都能接入房间，与本地数字人同场协作，不需要对方也跑 DSH。

DSH Java Desktop 的架构可以用一句话收束：桌面端是投影，服务端是事实，协议是边界。桌面端做壳换取部署简单与服务端复用；事件溯源换取断流可恢复与协作可审计；DSH/A2A 双协议换取本地与远端、自有与第三方的互通。这三个选择互为支撑，构成了一个既能单机开箱即用、又能跨端组建数字人团队的完整体系。