DSH JAVA · 小傅哥出品 · JAVA 17 · SPRING BOOT 3.3

DSH Java
一切皆可插件的 Agent 运行时

以「一切皆可插件」为设计思想：ReAct 循环、工具系统、审批治理与事件溯源构成运行时内核；能力边界由插件无限扩展——Java Native 基于 ClassLoader 隔离加载、动态插拔，Node Bridge 与 MCP 生态即装即用。

⬇ 下载桌面端 一键启动体验 探索运行时 →
1
条命令启动完整运行时
3
插件模式 · Java / Node / MCP
50步
单 Turn ReAct 循环上限
100%
会话事件可回放审计
Harness 六层架构 · DDD 六边形
Trigger REST + SSE 控制台 ① API / Case CQRS + 责任链策略 ② Domain（核心） ReactLoopAgent · SessionLog ③ Types (SPI) 端口与可插拔接口 ④ Plugins Java JAR · Node Sidecar · MCP ⑤ Infrastructure MyBatis · LLM · Shell ⑥
依赖方向永远指向 Domain 核心 · 插件只依赖轻量 Types 契约
Desktop App

DSH Java Desktop
开箱即用的桌面工作台

一款开箱即用的「数字人」AI 智能体桌面端：内置 Java 17 运行时与 DSH Java Agent Runtime 服务端，无需安装 JDK 与数据库，装完即用。单个数字人胜任编码、绘图、文档等多场景工作，多个数字人经 dsh.v1 / A2A 跨端组建协作团队。

下载桌面端安装包
  • macOS Apple Silicon
  • macOS Intel
  • Windows x64
  • Linux x64

安装后应用自动拉起内置智能体服务，在「设置 → 模型设置」配置模型即可开始对话；新版本支持应用内一键自动更新。

零依赖开箱即用

内置 Temurin JRE 17 与 Spring Boot 服务端，不要求安装 JDK、MySQL，数据落在本地应用目录。

数字人协作团队

单数字人多场景工作；多数字人经 dsh.v1 / A2A 双协议接入，Planner 自动分工编排任务。

五类资源插件

Word / Excel / Markdown / ECharts / draw.io 产物生成，消息内直接预览、编辑与另存。

扩展与自动更新

Skills、MCP Servers、CLI 命令随需扩展；发现新版本可在应用内一键下载安装并重启。

Quickstart

最简便的部署与体验路径

「一键使用」单容器拉起 Harness 运行时；「本地 JAR」下载运行包后在 JDK 17 中直接启动；「插件安装」用标准部署脚本启动 Harness 与 2D Weekend Mall，再从 GitHub 下载商城 JAR 并在插件管理中安装。详细步骤与 MySQL 库表导入见 使用教程 · 部署与安全。

1一键使用 · 启动运行时

单容器最小体验，打开 http://localhost:8090 即可进入控制台。

docker run -d \
  --name dsh-java-web \
  -p 8090:8090 \
  registry.cn-hangzhou.aliyuncs.com/xfg-studio/deepseek-harness-java:0.1.6.4

适合最快体验；需要持久化数据、插件与配套案例时，请切换到「插件安装 · 标准部署包」。

部署后配置模型：打开 Harness，进入「设置 → 模型设置 → 添加模型」，填写模型服务地址、模型名称和 API Key，保存后即可开始对话。

查看部署与安全（含 MySQL 库表导入） 下载标准部署脚本 前往 GitHub 下载 dsh-java-deploy ↗
Runtime

单实例可运行，扩展即插即用

面向本地智能体工作台、企业内部扩展平台与任务自动化系统。当前定位是单实例运行时，而非分布式多租户 SaaS。

ReAct 循环

ReactLoopAgent 驱动模型输出、工具调用、结果回填与续步，单 turn 上限 50 步。

真实工具系统

内置文件、Shell、Web 搜索/抓取和用户提问工具；统一 ToolCallExecutor，并支持 PRE/POST Hook。

双模式插件

Java Native 使用 URLClassLoader 隔离，Node Bridge 使用 sidecar JSON-RPC，另支持 MCP stdio 工具。

权限与审批

提交期权限矩阵评估，高风险 Shell、写文件、插件和子进程默认进入人工审批。

事件溯源

会话、任务、目标、审批与模型设置落库；默认 MySQL，standalone profile 可切换 H2 文件库。

原生控制台

原生 JS 实现，本地化 Markdown、代码高亮与 XSS 净化，无前端构建链。

查看运行时详细设计
Console

真实界面，开箱即用

打开控制台即可管理会话、工作区、模型、插件与审批，不需要额外构建前端。

localhost:8090 · 对话
DSH Java Web 控制台对话界面
插件会话
DSH Java 插件工具会话界面
轨迹视图 · 会话事件回放与审计
轨迹
DSH Java 轨迹视图界面
插件案例 · 商城智能客服
MySQL Studio
dsh-java-mysql AI 数据库助手界面
插件案例 · MySQL 运维助手
Use Cases

两个已验证的接入案例

它们不是演示草图，而是可以直接构建、安装插件并跑通工具调用的项目。

DATABASE

dsh-java-mysql

MySQL 管理后台 + AI 数据库助手。连接配置、表浏览、只读查询、执行计划、性能快照和 SQL 风险审计都可在本地闭环。

  • AI 链路全程只读，不提供写 SQL 工具
  • 注册 5 个 MySQL 查询与审计工具
  • 默认 15 秒超时，最多返回 500 行
  • 写操作必须控制台人工确认
查看 GitHub 仓库 →
MALL

2D Weekend Mall

PC 虚拟商城与智能客服插件。商品搜索、购物车、下单、支付、订单和物流跟踪在浏览器闭环，客服能力由 Harness 插件提供。

  • Spring Boot 提供商城 REST API
  • 注册商品、订单、物流查询插件工具
  • 通过服务凭证隔离用户订单查询
  • POST_TOOL_USE 发出客服审计事件
查看 GitHub 仓库 →
Documentation

想深入源码与实现？

配套 18 章学习教程与上手指引，从十分钟跑起来，到 ReAct 循环、事件溯源、插件机制、MCP 与审批治理。

学习教程（18 章） 使用教程
Community Plugins

开发插件，发布到社区

DSH Java 的能力边界由插件决定。为自己开发插件，或发布到 GitHub 与社区共享——只需一个标签，就会被社区收录。

1

开发插件

实现 SPI 契约并注册工具，支持 Java Native、Node Bridge 与 MCP stdio 三种模式。

2

本地验证

打包 JAR 后通过 /api/harness/plugins/install 安装激活，在控制台跑通工具调用。

3

发布到 GitHub

把插件源码推送到公开仓库，写好 README 与安装说明。

4

添加收录标签

给仓库添加 dsh-plugin-java 标签（topic），即会被社区插件列表自动收录。

# dsh-plugin-java

一个标签，进入社区插件生态

GitHub topic 是社区插件的统一收录入口。任何人为仓库添加 dsh-plugin-java 标签后，插件就会出现在社区主题页，被其他开发者发现、安装和使用。

浏览社区插件 插件开发教程
add-topic
# 方式一：仓库主页 About → Topics 添加 dsh-plugin-java

# 方式二：GitHub CLI 一行搞定
gh repo edit --add-topic dsh-plugin-java
Video

插件的开发与使用 · 视频讲解

跟着视频走一遍插件开发、安装与工具调用的完整流程，配合上方文档教程食用更佳。

在 Bilibili 打开原视频
Community

小傅哥社群 · 学习教程与辅助使用

deepseek-harness-java 源码目前通过社群提供。社群包含学习教程、插件开发实践、部署答疑和使用辅助，帮助你更快完成企业内落地。

源码入口 先看教程 部署教程
github.com/fuzhengwei/2d-weekend-mall github.com/fuzhengwei/dsh-java-mysql github.com/topics/dsh-plugin-java