Snail AI 1.0 正式发布：面向开源落地的 Java AI Agent 平台。

核心表达：

• 从智能体创建、配置、对话、工具调用到外部集成形成闭环。
• 从文档上传、切片、向量化、检索、问答到智能体调用形成 RAG 闭环。
• 模型、资源、用户、技能、MCP、OpenAPI、数据库适配进入稳定可用阶段。
• 开源版文档、SQL、Docker、截图和源码保持一致，降低部署和二次开发成本。

版本演进概览

1.0 功能全景

智能体管理

• AI 辅助流式创建智能体，支持基于自然语言描述自动生成配置。
• 支持手动创建和模板快速创建。
• 支持智能体详情页，包括配置编辑、数据分析等标签页。
• 支持系统提示词、预设问题、问候语配置。
• 支持智能体市场、发布与订阅机制。
• 支持企业精选推荐。
• 支持创建智能体前选择执行应用。
• 支持智能体绑定多个 RAG 知识库。
• 支持工具调用模式选择，包括强制调用和智能调用。

智能体对话

• 新增独立前端 snail-ai-chat。
• 新增后端模块 snail-ai-agent-chat。
• 支持 /snail-chat 独立访问路径，避免与业务路径冲突。
• 支持会话 Token、认证和凭证校验。
• 前端构建产物可嵌入 Starter 静态资源目录。
• 支持嵌入模式配置，可控制顶部栏、用户侧栏、智能体市场、紧凑输入框和智能体锁定。
• 支持流式对话输出。
• 支持思考过程展示。
• 支持对话历史管理和多轮上下文保持。
• 支持对话记录 Token 用量采集与持久化，包括输入 Token、输出 Token 和缓存命中 Token。
• OpenAPI 支持清空指定智能体下的全部会话记录。

Agent 运行架构

• 提供完整 Agent 责任链流水线：

Init -> ModelResolve -> SystemPrompt -> Conversation -> Mcp -> Rag -> Skill -> WebSearch -> ContextCollector -> LlmCall

• 责任链 Handler 可独立扩展和替换。
• 支持 gRPC 双向流 Server-Agent 分布式架构。
• 支持 SnailAiInterceptor SPI 拦截器机制。
• 支持 Advisor 处理流水线。
• 支持本地工具执行，包括 Shell、HTTP、MCP。
• 支持 @EnableSnailAiAgent 一键启用。
• 支持在线日志实时查看。
• 支持 gRPC 流式分发处理器。
• 支持一致性哈希等客户端路由策略。
• 支持滑动窗口限流和活跃对话计数。

模型管理

• 支持模型提供商管理，包括 OpenAI、Claude、Ollama、Gemini、火山引擎等。
• 支持五种模型类型统一管理：
  • CHAT
  • EMBEDDING
  • RERANKER
• 支持默认模型设置。
• 支持模型使用统计。
• Spring AI 升级至 2.0.0 系列并适配新版 API。
• 新增 ServerModelSpecFactory，统一服务端模型配置到模型构建规格的适配逻辑。
• 支持 Chat、Embedding、Rerank 三类模型规格。
• OpenAI 兼容模型流式合并保留 reasoning_content 等扩展字段。
• Rerank 模型模块调整为 snail-ai-model-rerank-provider-qwen。

RAG 知识库

• 支持 10+ 文档格式，包括 PDF、Word、Excel、PPT、Markdown、TXT、HTML、CSV 等。
• 支持多种分片策略：
  • 固定长度
  • 递归字符
  • Token 级别
  • 语义分片
• 支持混合检索：
  • 向量检索
  • BM25
  • RRF 融合
  • 加权融合
• 支持 Reranker 重排序。
• 支持文档智能去重。
• 支持存储实例管理，包括 PgVector、Milvus、Elasticsearch。
• 支持向量维度约束服务，用于知识库向量维度校验和管理。
• 支持 RAG 搜索工具，智能体对话中可自动调用知识检索。
• 支持 RAG 文档预览和下载。
• 支持 RAG 批量删除。
• 支持 RAG 文档、切片、检索、问答等页面链路。
• 优化向量存储缓存刷新逻辑，缓存判断同时考虑模型配置和向量库存储实例更新时间。

MCP、Tool 与 Skill

• 支持 MCP 工具集成。
• 支持工具发现与注册。
• 支持 MCP 一键连接测试。
• MCP 连接测试在 1.0 中作为实时结果返回，不再把连接状态作为持久状态维护。
• 支持多种认证方式，包括 API Key、Bearer Token、OAuth 2.0、无认证。
• 支持客户端自定义 Tool。
• 提供 CustomToolCallbackProvider 扩展点。
• 提供 QueryDbTool 示例，演示客户端自定义数据库查询工具。
• 支持自定义 ChatClient 扩展点示例，演示工具调用上下文透传。
• 支持 Skill ZIP 包上传。
• 支持 SKILL.md 技能定义文件。
• 支持技能绑定与管理。
• 新增 GitNexus 代码智能规范与相关 Skill 文档，用于代码影响分析、调试、重构和索引维护。

记忆系统

• 支持短期记忆滑动窗口。
• 支持 memory 和 db 两种存储模式。
• 新增 ConversationMemory 相关 Mapper 和 PO。
• 支持记忆注入 Advisor。
• 修复短期记忆上下文未生效问题。
• 优化短期记忆查询顺序，修复上下文窗口取数后顺序不正确的问题。

OpenAPI 与外部集成

• 新增 snail-ai-agent-openapi 模块。
• 提供 Agent 客户端接口。
• 提供 Embed 客户端接口。
• 提供智能体对话 Token 请求和响应 DTO。
• 提供 OpenAPI 认证拦截器与会话管理。
• OpenAPI 外部集成使用 Snail-Ai-App-Id 与 Snail-Ai-Token。
• Snail-Ai-Auth 用于 Admin API 或智能体对话会话。
• 智能体对话 Starter 复用 OpenAPI 客户端能力自动装配。

资源、用户与文件存储

• 新增统一资源访问入口 /files/**。
• 支持本地和 MinIO 资源在线预览与下载。
• 资源访问改为基于 storageKey 的公开访问 URL，减少对资源自增 ID 的直接暴露。
• RAG 文档预览和下载返回结构新增 previewUrl 与 downloadUrl。
• 用户体系新增昵称和头像资源绑定能力。
• OpenAPI 用户注册支持外部头像 URL。
• 管理端资源管理页支持 Markdown、Word、Excel 文件抽屉预览。
• 管理端资源管理页支持直接下载。
• 新增鉴权图片和头像组件，提升头像与资源图片在鉴权 URL 下的显示稳定性。
• 系统用户管理支持头像展示、头像选择和恢复默认头像。
• 首页智能体排行、最近会话、全局头部头像等位置统一使用资源头像展示。

应用与分布式能力

• 支持应用管理和多 Client 节点编排。
• 支持随机、轮询、指定节点等路由策略。
• 支持客户端节点状态监控。
• 支持心跳检测与自动故障转移。
• 新增初始化测试应用和测试 OpenID，方便开箱即用。

联网搜索

• 支持 Web Search 集成。
• 支持实时互联网信息检索。

数据库与向量存储

• 支持业务库 MySQL。
• 支持业务库 PostgreSQL。
• 新增 snail-ai-postgres-storage 模块与 PostgreSQL 全量建表脚本。
• 支持达梦数据库。
• 新增 snail-ai-dm-storage 存储模块。
• 新增 docs/sql/snail_ai_schema_dameng.sql 初始化脚本。
• 支持向量存储：
  • PgVector
  • Milvus
  • Elasticsearch
• 优化 Elasticsearch HTTPS 模式支持。

部署与文档

• 新增 VitePress 文档站点。
• 新增文档打包脚本。
• 文档源码、Docker、SQL、部署说明统一迁移到 docs/ 目录。
• 优化 Docker Compose 一键启动配置。
• 统一依赖服务、初始化脚本和示例应用构建路径。
• 新增文档维护智能体规范，要求开源版文档以当前源码、配置、SQL 和脚本为准。
• 新增并校验 Admin API、OpenAPI、部署、架构、RAG、智能体、模型、MCP、Skill、资源、用户、记忆等文档页面。
• 新增智能体对话、技能管理、智能体列表/配置、模型管理、RAG 列表/创建/文档/切片/检索/问答等截图。
• 移除开源版未实现功能的完成态描述，包括独立 Admin Memory API、全局 Dashboard、Trace/Score/Langfuse 风格观测、独立 OpenAPI RAG 端点等。
• 「客户端 Chat 模式」更名为「智能体对话」，并移动到智能体菜单下。

安全与稳定性

• 资源预览和下载接口增加登录校验。
• 普通用户只能访问自己的资源，管理员可访问全部资源。
• 用户密码摘要从固定盐 SHA-256 升级为 PBKDF2WithHmacSHA256。
• 登录时自动迁移老密码。
• ShellTool 限制工作目录只能位于技能目录内。
• ShellTool 修正命令超时处理。
• HttpTool 禁止访问本机和内网地址。
• HttpTool 禁止覆盖 Host 头。
• HttpTool 移除请求体日志。
• 本地资源存储增加根目录约束，防止 storageKey 路径穿越。
• URL 导入禁止内网和 localhost 地址。
• URL 导入限制下载文件大小。
• OpenAPI / gRPC 认证使用常量时间比较校验 app token。
• RAG 文档处理使用条件状态更新抢占待处理文档，避免多实例重复处理。
• 向量库写入成功后再回写 chunk vectorId。
• Agent 用量统计改为原子自增，降低并发计数丢失风险。
• 全面启用虚拟线程。
• 优化 gRPC keepAlive，减少长连接空闲断开。

详情查看：https://gitee.com/aizuda/snail-ai/releases/v1.0.0