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 契约

最简便的部署与体验路径

「一键使用」单容器拉起 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,保存后即可开始对话。

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

面向本地智能体工作台、企业内部扩展平台与任务自动化系统。当前定位是单实例运行时,而非分布式多租户 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 净化,无前端构建链。

真实界面,开箱即用

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

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

两个已验证的接入案例

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

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 仓库 →

想深入源码与实现?

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

学习教程(18 章) 使用教程

开发插件,发布到社区

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

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

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

在 Bilibili 打开原视频

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

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