🌐 英文 |中文

铸造 AI 灵魂 —— 基于 SpringBoot 4.1 + Spring AI 2.0 + DDD 六边形架构的 AI Agent 开发脚手架

📖 项目简介

铸灵（ZhuLing）帮助 Java 开发者零代码启动 Agent 应用。只需编写一份 YAML 配置文件，即可获得：

• ✅ 多 Agent 独立注册与运行时隔离
• ✅ 统一对话目标选择（Agent / Workflow）
• ✅ 同步 & SSE 流式对话接口
• ✅ 多轮会话记忆与历史消息持久化
• ✅ MCP 工具调用（Local / SSE / Stdio 三种模式）
• ✅ 技能 脚本包加载与执行
• ✅ 完整的可观测性（Token 统计、工具遥测、Trace ID、上下文占用比）
• ✅ 版本化 SSE 事件信封（turn / message / reasoning / tool 生命周期事件）
• ✅ 单 Agent ReAct 执行内核（多步 thought → act → observe、过程级观测、实时步骤轨迹）
• ✅ 节点生命周期拦截器（观测、错误归一化、安全策略扩展点）
• ✅ 内置可观测对话工作台 UI

🖼️ 界面预览

登录

对话目标选择

可观测对话工作台

🏗️ 技术栈

📁 工程结构

依赖规则：Trigger → API → Case → Domain ← Infrastructure，所有依赖向内指向 Domain。

🚀 快速开始

环境要求

• JDK 21+
• Maven 3.8+
• MySQL 8.0+（或 PostgreSQL 15+）

1.克隆项目

2.初始化数据库

创建数据库后，执行以下建表 SQL：

3.修改配置

铸灵 ZhuLing

🌐 English | 中文

铸造 AI 灵魂 —— 基于 SpringBoot 4.1 + Spring AI 2.0 + DDD 六边形架构的 AI Agent 开发脚手架

📖 项目简介

铸灵（ZhuLing）帮助 Java 开发者零代码启动 Agent 应用。只需编写一份 YAML 配置文件，即可获得：

• ✅ 多 Agent 独立注册与运行时隔离
• ✅ 统一对话目标选择（Agent / Workflow）
• ✅ 同步 & SSE 流式对话接口
• ✅ 多轮会话记忆与历史消息持久化
• ✅ MCP 工具调用（Local / SSE / Stdio 三种模式）
• ✅ Skills 脚本包加载与执行
• ✅ 完整的可观测性（Token 统计、工具遥测、Trace ID、上下文占用比）
• ✅ 版本化 SSE 事件信封（turn / message / reasoning / tool 生命周期事件）
• ✅ 单 Agent ReAct 执行内核（多步 thought → act → observe、过程级观测、实时步骤轨迹）
• ✅ 节点生命周期拦截器（观测、错误归一化、安全策略扩展点）
• ✅ 内置可观测对话工作台 UI

🖼️ 界面预览

登录

对话目标选择

可观测对话工作台

🏗️ 技术栈

📁 工程结构

zhuling/
├── zhuling-types/            # 公共类型（枚举、异常、通用常量）
├── zhuling-api/              # 接口 DTO / VO 定义
├── zhuling-domain/           # 领域层（核心业务、Port/Repository 接口）
├── zhuling-case/             # 编排层（用例编排、聊天流程）
├── zhuling-infrastructure/   # 基础设施层（DAO、Gateway、Redis、可观测性实现）
├── zhuling-trigger/          # 触发层（HTTP Controller）
├── zhuling-app/              # 启动模块（配置文件、Agent YAML、Skills）
├── zhuling-ui/                    # 可观测对话工作台（纯静态前端）
└── docs/                         # 设计文档、SQL 脚本

依赖规则：Trigger → API → Case → Domain ← Infrastructure，所有依赖向内指向 Domain。

🚀 快速开始

环境要求

• JDK 21+
• Maven 3.8+
• MySQL 8.0+（或 PostgreSQL 15+）

1. 克隆项目

git clone https://github.com/vinist123/zhuling.git
cd zhuling

2. 初始化数据库

创建数据库后，执行以下建表 SQL：

-- Agent 会话表
CREATE TABLE agent_session (
    id VARCHAR(36) PRIMARY KEY,
    target_id VARCHAR(128) NOT NULL,
    target_type VARCHAR(20) NOT NULL DEFAULT 'AGENT',
    user_id VARCHAR(64),
    title VARCHAR(256),
    status VARCHAR(20) DEFAULT 'active',
    message_count INT DEFAULT 0,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- Agent 消息表
CREATE TABLE agent_message (
    id VARCHAR(36) PRIMARY KEY,
    session_id VARCHAR(36) NOT NULL,
    role VARCHAR(20) NOT NULL,
    content TEXT,
    metadata JSON,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (session_id) REFERENCES agent_session(id)
);

3. 修改配置

编辑 zhuling-app/src/main/resources/application-dev.yml：

spring:
  datasource: