Snail AI

Appearance

更新日志 ​

本页记录 Snail AI 各版本的变更内容，遵循 Keep a Changelog 格式。

版本号遵循 语义化版本 规范：主版本号.次版本号.修订号

  • 主版本号 -- 包含不兼容的 API 变更
  • 次版本号 -- 新增功能（向下兼容）
  • 修订号 -- Bug 修复（向下兼容）

0.0.2 - 2026-05-24 ​

新增 ​

  • 客户端自定义 Tool 支持（CustomToolCallbackProvider），可通过配置注册自定义工具回调扩展智能体能力
  • RAG 搜索工具（RagSearchTool + RagSearchCallbackHandler），智能体对话中自动调用知识检索
  • 向量维度约束服务（VectorDimensionConstraintService），知识库向量维度校验和管理
  • QueryDbTool 示例，演示客户端如何自定义数据库查询工具

优化 ​

  • 向量数据库兼容性优化（VectorStoreFactory 逻辑调整）
  • ClientRagToolResolver 增强，支持更灵活的 RAG 工具解析
  • gRPC ChatDispatchStreamingHandler 流式调度逻辑优化
  • 前端 RAG 页面交互增强（向量维度约束展示、存储实例关联）
  • 前端模型配置面板优化（ConfigPanel.vue 重构）

升级说明 ​

  • 项目版本号从 0.0.1 升级至 0.0.2
  • 知识库相关接口新增 vectorDimension 字段，需同步更新数据库（参见 docs/sql/snail_ai_schema.sql）
  • 客户端如需自定义 Tool，参考 snail-ai-agent-example 中的 QueryDbTool 示例

0.0.1 - 2025-05-01 ​

新增 ​

智能体管理 ​

  • AI 辅助流式创建智能体（基于自然语言描述自动生成配置）
  • 手动创建和模板快速创建
  • 智能体详情页：编辑配置、数据分析、可观测性三个标签页
  • 系统提示词配置、预设问题设置、问候语自定义
  • 智能体市场：发布与订阅机制
  • 企业精选推荐功能

对话系统 ​

  • 流式对话输出（SSE）
  • 思维链（Chain of Thought）展示
  • 对话历史管理
  • 多轮上下文保持

Agent 责任链架构 ​

  • 10 个 Handler 的完整责任链流水线
  • Init -> ModelResolve -> SystemPrompt -> Conversation -> Mcp -> Rag -> Skill -> WebSearch -> ContextCollector -> LlmCall
  • 各 Handler 可独立扩展和替换

客户端模式（Agent Client） ​

  • gRPC 双向流 Server-Agent 分布式架构
  • 拦截器机制（SnailAiInterceptor SPI）
  • 5 级 Advisor 处理流水线
  • 本地工具执行（Shell / HTTP / MCP）
  • @EnableSnailAiAgent 一键启用注解
  • 在线日志实时查看

多模型支持 ​

  • 模型提供商管理（OpenAI、Claude、Ollama、Gemini、火山引擎）
  • 五种模型类型统一管理：CHAT / EMBEDDING / RERANKER / IMAGE / SPEECH
  • 模型作用域：GLOBAL（全局）/ PERSONAL（个人）
  • 默认模型设置
  • 使用统计

RAG 知识库 ​

  • 支持 10+ 文档格式（PDF、Word、Excel、PPT、Markdown、TXT、HTML、CSV 等）
  • 4 种分片策略：固定长度、递归字符、Token 级别、语义分片
  • 混合检索：向量检索 + BM25 + RRF / 加权融合
  • Reranker 重排序支持
  • 文档智能去重（基于内容哈希）
  • 存储实例管理（PgVector / Milvus / Elasticsearch）

MCP 工具集成 ​

  • 完整 MCP 协议实现
  • 三种传输方式：SSE、Streamable HTTP、Stdio
  • 四种认证方式：API Key、Bearer Token、OAuth 2.0、无认证
  • 一键连接测试
  • 工具发现与注册

技能系统 ​

  • ZIP 包方式上传技能
  • SKILL.md 技能定义文件
  • 技能绑定与管理

记忆系统 ​

  • 短期记忆（滑动窗口）
  • memory / db 两种存储模式

应用与分布式 ​

  • 应用管理（多 Client 节点编排）
  • 路由策略：随机、轮询、指定节点
  • 客户端节点状态监控
  • 心跳检测与自动故障转移

联网搜索 ​

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

多数据库支持 ​

  • MySQL(已实现)

向量存储 ​

  • PgVector
  • Milvus
  • Elasticsearch

文件存储 ​

  • 本地文件系统
  • MinIO 对象存储

其他 ​

  • 资源管理（图片库）
  • 用户管理与权限控制（基于 Sa-Token）
  • 仪表盘（统计卡片、雷达图、趋势图）
  • OpenAPI 外部集成接口（认证 + 对话 + RAG）

变更类型说明 ​

类型说明
新增 (Added)新功能
变更 (Changed)对现有功能的变更
废弃 (Deprecated)即将移除的功能
移除 (Removed)已移除的功能
修复 (Fixed)Bug 修复
安全 (Security)安全相关的修复
Breaking Change不兼容的变更，升级时需额外处理

Apache 2.0 Licensed

Copyright © 2024-present OpenSnail