DSH Java 从0到1，视频 + 文档，开始啦！

作者：小傅哥
博客：https://bugstack.cn

❝

沉淀、分享、成长，让自己和他人都能有所收获！

❞

大家好，我是技术UP主小傅哥。

这事可是不小 ；先是用 Java + DDD 架构，1:1 复刻 Deepseek Harness 项目，干了1个来月（这里有大量的架构分析和领域结构设计），并以 ClassLoader 热插拔的方式设计 SPI 的 Plugin 插件机制。以及提供了 plugin skills 技能，可以快速开发各类场景的智能体应用。 快速，有多快呢！一周干了100+个场景案例。

地址：https://github.com/deepseek-harness-java - 就是说你脑子没啥想法，那这100多个案例，你可劲玩吧！

DSH Java 可不是呆毛（Demo）项目，它是一套正儿八经的企业级解决方案（已有企业里的伙伴，拿过去开始使用）。为了能让这套东西更加成熟稳定，小傅哥连着迭代了8个版本（并且持续跟进 DeepSeek Harness 马具工程 ）。

为了让 DSH Java 运行时 Agent 更加全面的达到企业级诉求，也对应实现了 Web 版本，桌面版本 + 数字人（A2A）。并且于 2026年10月14日，AppImage 收入了 DSH Java Desktop 桌面版。https://github.com/AppImage/appimage.github.io/pull/9999 - 这个成绩还不错！

那么，现在 DSH Java 这套项目的核心能力都已经做完了。所以，小傅哥开始提供手把手学习的课程，帮助小白伙伴从0到1的完成智能体开发的学习。

接下来，小傅哥就带着大家看下在这套 DSH Java 项目下；Web/桌面端都是什么效果、Plugin Skills 怎么用，100个场景都是啥，课程有什么章节要怎么讲等等。好的，那开始发车！

一、项目介绍

官网：https://dsh-java.xiaofuge.cn/

DSH Java 是一个以「稳定内核 + 统一插槽 + 插件化扩展」为核心的 AI Agent 运行时框架（Java 版），采用 Spring Boot DDD 多模块结构 / case / domain / infrastructure / trigger / types）。核心能力包括：ReAct 推理循环、统一工具注册（ToolRegistry，fs / shell / web / mcp / lsp / terminal 等）、Hook 拦截链、Java 插件热插拔（ClassLoader + SPI）、进程外扩展（MCP / sidecar / 子代理）等，配套 web 版本、桌面版（DSH-Java-Desktop）、插件开发技能以及插件脚手架 archetype，共 100 个实战插件开发案例。

之后我们来演示下，项目是如何启动的。分为 Web 版本和 桌面版版本。如果你暂时只是想体验，还不需要源码构建。可以直接用官网下载桌面版或者部署web体验。

1. 体验 web

1.1 IntelliJ IDEA 启动

• 注意，本地启动

application.yml

•  走的是 mysql 数据库。工程里提供的

deepseek_harness_java.sql

•  要提前执行好，之后在

application.yml

 文件中进行配置。

1.2 访问 web

默认地址：http://localhost:8090/使用说明：启动后可以在设置里，添加上你的模型。之后就可以对话使用了。

2. 启动 桌面端

桌面版（DSH-Java-Desktop）基于 Tauri 构建，其核心思路是：把后端 Agent 的 SpringBoot 可执行 Jar 作为资源文件"复制"进客户端安装包，并内置一份精简 JRE，用户安装后无需配置 Java 环境即可直接运行。整个"打包 Jar → 桌面端启动"的完成过程如下。

下面是前端的打包构建阶段，没咋操作过前端的伙伴，可以用 AI 工具完成先分析2个项目，之后让构建服务端的jar，放到客户端启动桌面版。

2.1 对话效果

整套 ui 界面，类似 XxxBuddy 类产品，和星球「码农会锁」另外一套 WaLiCode 主要面向编码的，在 UI 设计上是有所不同的。可以整体感受下，这两个 UI 也是 25年 ~ 26年 逐步成型的两个分类。

2.2 设置界面

设置界面有完整的模型配置，简单数字人（A2A）、Skills、MCP、CLI，以及插件的安装。整套东西还是蛮好玩的，这个桌面端，「星球里的伙伴」你可以拿去进行二开，做自己的 AI 产品。

二、技能使用

DSH Java 最核心的一个价值，其实是 DSH Plugin 能力。它的目的就是让你的N多个业务系统，有任何智能体场景诉求的时候，都可以非常方便的接入 AI Agent 智能体。比如；电商 + 导购客服、旅游 + 路线规划、信贷 + 资质预审、MySQL + 智能运维、Git + 代码审查 ... 等等，在能提高用户体验，节省等待时耗的场景，都可以引入智能体，增强整个产品的功能能力。

安装技能（把这段内容发给 AI Agent 工具）；请帮我安装 dsh-java-plugin-skills 技能，地址：https://github.com/deepseek-harness-java/dsh-java-plugin-skills 并告诉我它的实际用途以及如何使用
以下产品，你可以通过仓库地址进入，需要哪个案例，就验证测试哪个。地址；https://github.com/deepseek-harness-java

1. 🧩 27 个独立 AI 产品

工具优先——每个产品解决一类真实工作流（开发/数据/运维/写作），AI 能组合多工具完成"一句话任务"；数据本地优先（~/.dsh-java-<name>/），无外部 SaaS 依赖。

开发者工具

数据与效率

️ 安全与运维

2. 74 个行业场景案例

每个案例 = 「业务应用 + 内嵌 AI 助手 + Java Native 插件」的完整可运行仓库，覆盖零售、出行、生活服务、教育、工作协作等行业。

商城零售与生活电商

金融与个人事务

出行 · 物流 · 酒旅 · 文旅

生活服务与门店经营

工作协作与内容

️ 产研测运维工作台

教育学习

角色工作台

基于这套 skills 技能，在玩1-2个场景后，你也可以熟练的把你需要的场景快速对接上 Agent，也可以开发一个新的场景。

三、架构设计

1. 整体结构

总体定位：DSH Java 是一个以「稳定内核 + 统一插槽 + 插件化扩展」为核心的 AI Agent 运行时框架，采用 Spring Boot DDD 多模块单体结构，既可以独立部署为 Web 服务（MySQL），也可以以打包好的 jar 形态被桌面端内嵌拉起（standalone 模式 + H2 文件库），"一套代码、两种交付形态"。

1.1 DDD 模块划分

工程按照 DDD 四层架构拆分，各模块职责边界清晰、依赖方向自外向内：

1.2 内核与插槽

整套架构的主线是「一切能力皆工具，一切扩展皆插槽」：

稳定内核

• ：契约层、LLM 适配、ReAct 推理循环（

ReactLoopAgent

• ，Phase 状态机 + inbox 消息驱动 + SessionEventLog 事件溯源）、内置工具，是框架的心脏，不随场景变化。

统一插槽

• ：

ToolRegistry

• • ：fs / shell / web / mcp / lsp / terminal / skill 等工具的统一注册与选择（

CompositeToolRegistry

• •  /

AgentToolCatalog

• • ），内核能力与插件能力在这里汇流。

Hook 链

• • ：拦截工具调用前后，插件可注入切面逻辑（审计、脱敏、风控）。

端口适配

• • ：仓储、事件等以端口方式暴露，infrastructure 可替换实现。

插件化扩展：Java 插件经 ClassLoader + SPI 热插拔加载，与内核同 JVM——工具直接调用零序列化开销，能注册 Hook 拦截工具调用、走事件总线与内核深度协作（区别于进程外 MCP 与纯提示词 Skills）。插件契约即 AbstractHarnessPlugin / PluginContext / PluginHook，启动时由 PresetPluginLoader 装载 plugins/ 目录预置插件。

2. 流程设计

2.1 启动流程

桌面端（standalone 模式）：Tauri 壳负责进程托管，以如下命令拉起 jar 子进程：

流程说明：

进程托管

1. ：桌面端壳层分配、随机 Key 生成与子进程生命周期管理，后端进程随桌面端退出而关闭，不留孤儿进程。

参数即架构声明

1. ：一条启动命令把"远程服务端"切换为"本地自治进程"——H2 文件库替换 MySQL、动态端口避开冲突、随机 Key 保证本机安全，服务端代码零改动。

健康握手

1. ：壳层轮询 HTTP 可用性，服务就绪后才加载前端主界面，保证用户看到界面时服务一定可用。

插件随启动装载

1. ：

PresetPluginLoader

1.  在启动链末段装载

plugins/

 预置插件，扩展能力在服务挂载完成。

2.2 对话流程

入口与调用链：HTTP 入口位于 trigger 层 AgentController（/api/agent）：

流程说明：

双层结构

1. ：case 层责任链只做"解析→意图→投递→收集"的编排外壳，ReAct 循环下沉到 domain 层

ReactLoopAgent

1. （Phase 状态机 + inbox 消息驱动 + SessionEventLog 事件溯源），编排与推理解耦。

三重防护

1. ：单 turn 最多 50 step、token 续接最多 4 次、取消信号即时中止，保证循环不会失控。

人机协同

1. ：危险操作以"审批挂起/唤醒"机制实现——Agent 挂起等待用户决议，而不是静默执行或直接拒绝。

可恢复性

：全量事件溯源落库，进程重启或会话中断后可从断点恢复上下文，而不是从头再来。

四、课程计划

按照 v0.1.8 版本分支，小傅哥做了一份课程计划。接下来，我们会按照这个节奏推进。

整体节奏是"先把内核立起来，再把插槽做成产品"，共 12 个 Part、五个阶段，从 v0.1.8 冻结基线的 7 模块骨架出发，最终交付一个与基线全量一致、零依赖可启动、可打包分发的完整 Agent 运行时。

阶段一 · 基础处理：契约先行，模型可换。Part 01 建立契约层（types + api），定义 Message / ToolCallBlock 消息与工具模型、插件 SPI 契约，沉淀 api 23 接口 + 55 DTO——这是 Agent 世界的通用语言；Part 02 做 LLM 适配（DeepSeek 适配器、OpenAI 兼容 / Anthropic 路由工厂）并顺手长出最小 HTTP/SSE 壳，支持阻塞式 message、SSE stream 与模型设置热切换。此阶段达成 M1 能答：curl 问答、流式逐字，此后每节验证都走真实协议入口。

阶段二 · 智能结构：Part 03 是全课程核心——ReAct 循环（ReactLoopAgent、工具调用解析与结果回填、循环控制（步数/取消/超时）、SSE 事件协议、系统提示词装配、CompactionEngine 会话压缩）；Part 04 装上"手"——工具系统（ToolRegistry、ToolCallExecutor、fs 工具族、shell + 危险命令守卫、web 搜索抓取、ask_user_question 运行时提问、PRE/POST Hook 链）。从一问一答升级为自主多步循环，且可控（循环控制）、可见（事件流）、不失控（压缩），达成 M2 会思考（自主多步推理）与 M3 会干活（查资料→写文件一条龙）。

阶段三 · 记忆约束：Part 05 持久化与事件溯源——MyBatis 地基、SessionEventFactory、双事件存储（JSONL 文件 + JDBC）、Rebuilder/Projector 会话重建，达成 M4 有记忆（重启不丢会话、事件可回放）；Part 06 任务与审批主线——任务队列落库、权限矩阵评估、审批命令/查询、运行时审批网关（Shell 挂起）、Goal/Plan 与 Todo/Jobs，达成 M5 受治理（高危操作挂起等审批）。内存版进化为落库版是反复出现的演进叙事；能力越强缰绳越紧，危险必审批。

阶段四 · 成品迭代：先直连后抽象的演进叙事，把最小壳长成产品形态。Part 07 用例编排层（CasePipeline 策略树、终端五节点、任务链重构、Agent 消息编排四节点）；Part 08 触发层与控制台（Controller 分层、统一响应、SSE 批处理、API Key 鉴权），达成 M6 工程化（浏览器控制台）；Part 09 Java 插件体系（加载器、SpringPluginContext、生命周期、事件总线、Hook、配置热更新、archetype 脚手架）；Part 10 进程外扩展（MCP stdio/http、Node sidecar JSON-RPC 桥、子代理 Provider——Claude Code/Codex/ACP）。装插件即长能力，能力挂载从进程内延伸到进程外。

阶段五 · 收尾阶段：扩展篇，做一些收尾的处理。Part 11 平台能力进阶（选修，5 节）：沙箱与执行边界、凭证管理与技能加载、计划任务与终端、工作流引擎、数字人与 A2A 协议（AgentCard 可发现）；Part 12 完结：standalone 零依赖、Docker Compose、差量合入与全量对账（终态 = v0.1.8 冻结基线），达成 M8 可交付：package-local.sh 产物新机器跑通。

四条横向主线贯穿全课程：① 契约（消息模型→对外接口→SSE 事件协议→子代理契约）、② 安全（危险命令守卫→权限矩阵→审批网关→沙箱边界→API Key）、③ 数据（设置内存版→建表→双事件存储→落库恢复→任务/插件落库）、④ 验证（最小 HTTP/SSE 壳→分层统一响应→Web 控制台→打包分发）。

综上，内容还是比较大的，毕竟这是一套完整的企业级解决方案。不过，也不用担心学不会，因为全程小傅哥都会带着你走。还为你提供了配套的基础教程，可以在上手之前进行补充学习。