solon-ai 发行版

v3.10.6

2026-05-13 17:04

* 添加 solon-ai-agent AgentTrace.getAgentName, getBeginTimeMs 方法
* 添加 solon-ai-agent 使用 autoRethink 替代 maxStepsAutoExtensible（后者标为弃用）
* 添加 solon-ai-harness command 接口管理
* 添加 solon-ai-harness HarnessEngine.getAgentOrMain 方法
* 添加 solon-ai-core CmdUtil 辅助工具（主要解析参数）
* 添加 solon-ai-core ChatMessage.getCreatedAt 方法
* 添加 solon-ai-core ChatSession.removeLatestMessage 方法（对话回退支持）
* 添加 solon-ai-core Repository.promptAugment 快捷方法
* 添加 solon-ai-core AiConfig.enabled 配置属性
* 添加 solon-ai-skill-cli TerminalSkill.edit old_str 预检处理（llm 可能会传空）
* 优化 solon-ai-agent ReasonTask Missing traceKey 处理
* 优化 solon-ai-core AiConfig.proxy 配置兼容（减少反序列化反射）
* 优化 solon-ai-core ChatModel llm- 日志打印，添加 agentName
* 优化 solon-ai-core EmbeddingModel、RerankingModel、GenerateModel llm- 日志打印，添加 modelName
* 优化 solon-ai-dialect apiUrl 自动补全的#号处理
* 优化 solon-ai-dialect OpenaiChatDialect 添加自动补地址处理
* 优化 solon-ai-harness CodeSkill 拆解语言支持
* 优化 solon-ai-harness taskDo 多层子代理嵌套时的容错处理
* 优化 solon-ai-skill-cli ExpertSkill 引导词
* 优化 solon-ai-skill-cli read 引导词（优先一次读完）
* 优化 solon-ai-skill-cli 关于 py 和 nodejs 环境识别
* 优化 solon-ai-skill-memory 添加 markdown 轻量实现方案（默认不启用会话隔离）
* 调整 solon-ai-core ChatOptions.name 更名为 agentName
* 调整 solon-ai-core ChatDialect.buildRequestJson 返回类型（String 改为 ONode，方便日志定制）
* 调整 solon-ai-harness TaskSkill 只输出 ThoughtChunk（不输出 ReasonChunk）
* 调整 solon-ai-agent 移除 ReActOptions.maxStepsLimit 属性 (没什么必要)
* 修复 solon-ai-skill-web WebfetchTool 超时转换错位问题
* acp-sdk 升为 0.11.0
* roguemap 升为 1.1.5

最后提交信息为： Merge branch 'main' of https://github.com/opensolon/solon-ai

v3.10.4

df670f7

2026-04-26 09:07

Solon AI v3.10.4

* 添加 solon-ai-agent 动态切换 llm 支持（支持不同会话，在各自请求时切换）
* 添加 solon-ai-harness 重试次数配置支持
* 添加 solon-ai-harness lsp 功能
* 添加 solon-ai-harness HarnessProperties.disallowedTools 配置支持（全局禁用工具配置）
* 添加 solon-ai-harness HarnessProperties.agentPools（子代理池） 配置支持
* 添加 solon-ai-harness HarnessProperties.systemPrompt 配置支持（替代之前的 AGENT.md 预设处理，由外部定制）
* 优化 solon-ai-core embedding 配置默认选项的能力（之前只能在请求时添加）
* 优化 solon-ai-core ChatRequestDesc.internalStream 添加流接收超时处理（避免因 llm 服务原因一直卡着）
* 优化 solon-ai-dialect-anthropic anthropic 方言的异常兼容处理
* 优化 solon-ai-dialect-openai openai-response 方言的异常兼容处理
* 优化 solon-ai-agent 中断传递处理
* 优化 solon-ai-agent ActionTask onAction 日志
* 优化 solon-ai-agent retrying 中断处理（这前的 task 内部的 stream 可能会中断传递）
* 优化 solon-ai-agent AgentSession.updateSnapshot 添加锁机制
* 优化 solon-ai-skill-lsp 重构 LspSkill 实现（之前名为 LspTool）
* 优化 solon-ai-skill-cli ExpertSkill 引导词
* 优化 solon-ai-skill-cli TerminalSkill 安全引导词
* 优化 solon-ai-skill-sys 从 cli 同步 ProcessExecutor
* 优化 solon-ai-harness HarnessEngine 扩展机制（支持为子代理扩展，通过名字识别）
* 调整 solon-ai-harness ReActAgentExtension 更名为 ReActAgentExtension
* 调整 solon-ai-harness 切换 llm 的机制，并取消 switchMainModel 方法（有自由的机制了）
* 调整 solon-ai-harness TerminalSkillProxy 转到 solon-ai-skill-cli
* 修复 solon-ai-skill-toolgateway ToolGatewaySkill call_tool 不能传递 toolContext 的问题
* 修复 solon-ai-core AbstractChatDialect reasoning_field_name 可能传递中断的问题

最后提交信息为： 3.10.4

v3.10.2

4ad0b60

2026-04-14 20:59

Solon AI v3.10.2

* 新增 solon-ai-repo-dashvector-official 插件
* 添加 solon-ai-core ChatModel.getModel 方法
* 添加 solon-ai-core ChatModel.getProvider 方法
* 添加 solon-ai-core ChatOptions.name 方便 agent 传递 name（打印日志）
* 添加 solon-ai-core 基于语义的分割器 SemanticSplitter
* 添加 solon-ai-core AiConfig.name, description 配置属性（用于管理显示）
* 添加 solon-ai-agent AgentRequest.callAsync 异步调用方法
* 添加 solon-ai-agent AgentResponse.getTrace 方法
* 添加 solon-ai-agent SummarizationInterceptor.copyWith 方法（方便复制实例并调整限制）
* 添加 solon-ai-harness HarnessProperties.models 配置属性（替代 chatModel）
* 添加 solon-ai-harness 子代理切换模型的能力
* 添加 solon-ai-harness HarnessProperties.removeModel 方法
* 优化 solon-ai-core RepositoryTool 增加重排支持
* 优化 solon-ai-core OllamaEmbeddingDialect.matched 添加 endsWith 匹配
* 优化 solon-ai-core MethodToolProvider 允许是否使用自身的 ToolProvider 内容（同时优化 AbsSkill，AbsToolProvider）
* 优化 solon-ai-agent ReActAgent 流块输出
* 优化 solon-ai-cli TodoSkill 提示词
* 调整 solon-ai-cli 取消 TerminalSkill.undo 工具（几乎用不到，由 git 控制）
* 调整 solon-ai-harness 取消 SESSION_DEFAULT（由应用侧处理）
* 调整 solon-ai-harness 去除 getVersion 方法（由应用侧定义）
* 调整 solon-ai-harness CLAUDE.md 更名为 CODE.md（内部自动生成）
* 修复 solon-ai-core MethodExecuteHandler 当 llm.args 嵌套非规范 json 时出错的问题（比如，非规范控制符）
* 修复 solon-ai-core ChatResponseDefault.isEmpty 可能识别失败的问题（不同 llm 情况较多）
* 调整 solon-ai-harness HarnessProperties.restApis 更名为 apiServers；取消 chatModel（由 models 替代）
* 修复 solon-ai-agent FileAgentSession.getSessionId 可能为空的问题
* 修复 solon-ai-skill-web CodeSearchTool 失效的问题（mcp.exa.ai 变了地址）
* 修复 solon-ai-harness TaskOp jsonSchema 问题（可能造成 multitask 调度失败）

最后提交信息为： 3.10.2

2026-04-03 15:31

最后提交信息为： 3.10.1

2026-03-24 06:37

最后提交信息为： 3.10.0

2026-03-24 06:36

最后提交信息为： 3.9.7

2026-03-22 08:52

* 添加 solon-ai-core ChatModel.outputSchema 配置支持（且与 Agent 统一基于方言实现，各方言可定制）
* 添加 solon-ai-core ChatModel.contextLength 配置支持（为 Agent 方便自动计算限制数）
* 添加 solon-ai-core AssistantMessage.getJsonContent 方法
* 添加 solon-ai-core MarkdownUtil 工具类
* 添加 solon-ai-dialect-gemini tool-call 的思考签名支持
* 添加 solon-ai-agent ReActChunk.getMetrics 方法
* 优化 solon-ai-core AbstractChatDialect 解析 tool 参数的兼容性
* 优化 solon-ai-dialect-dashscope 方言 支持流式传输与百炼联网搜索
* 优化 solon-ai-dialect-anthropic tool.args 不规范时的兼容性（比如 json 不完整）
* 优化 solon-ai-dialect-gemini 特定 provider 结束时返回 content 为空的消息才设置finishReason 导致结束标志被提前过滤
* 优化 solon-ai-agent ReActAgent onThought 事件，优先使用 getReasoning 获取 <think> 思考内容
* 优化 solon-ai-agent ReActAgent SummarizationInterceptor 添加 maxContextLength 控制参数（很重要）
* 优化 solon-ai-agent ActionChunk 分为 ActionEndChunk 和 ActionStartChunk（并保留 ActionChunk 标为弃用）
* 优化 solon-ai-agent 流式处理 `catch (Exception`，换成 `catch (Throwable`
* 优化 solon-ai-skill-restapi 每个 api 可以添加独立的验证机制
* 优化 solon-ai-skill-cli 避免 bash 把当前进程给删掉了
* 调整 solon-ai-agent 临时挂起操作，由 XxxTrace 转到 AgentSession（更统一）
* 调整 solon-ai-core Skill 的激活逻辑，如果 getInstruction 为空，则不进入 SystemPrompt（之前还要 description 为空）
* 修复 solon-ai-agent ReActAgent 思考事件触发逻辑，确保在所有情况下都被调用

最后提交信息为： README

2026-03-09 10:23

最后提交信息为： 3.9.5

2026-02-24 21:50

最后提交信息为： 3.9.4

2026-02-13 12:09

* 重构 solon-ai-agent Plan-ReAct 模式（相对之前，新设计智能、态动、按需）
* 新增 solon-ai-acp 插件（可以对接支持 acp 协议的 IDE）
* 添加 solon-ai-core ChatSessionProvider
* 添加 solon-ai-core FunctionTool:call 方法
* 添加 solon-ai-mcp FunctionPrompt:get 方法
* 添加 solon-ai-mcp FunctionResource:read 方法
* 添加 solon-ai-core ToolSchemaUtil.resultConvert 方法（将 tool 转换从内部，转到外部）
* 添加 solon-ai-agent ReActAgent maxStepsExtensible 配置，允许通过 HITL 扩容步数
* 优化 solon-ai-core ChatModel 与 DeepSeek-R1 兼容性
* 优化 solon-ai-agent ReActAgent 与 DeepSeek-R1 兼容性（手造的 AssistantMessage 需要自动补字段）
* 优化 solon-ai-agent FunctionTool 增加 tool 多模态与单模态兼容处理
* 优化 solon-ai-skill-cli CliSkill 进一步与 Claude Code 规范对齐（接近 100%）
* 优化 solon-ai-skill-cli CodeCLI exit 改为进程退出
* 优化 solon-ai-mcp 无心跳时，支持自动复位尝试
* 调整 solon-ai-mcp McpClientProvider 接口，优化多模态适配
* 调整 solon-ai-core 多模态体系（AiMedia 更名为 ContentBlock，）
* 调整 solon-ai-core UserMessage medias 更名为 blocks，hasMedias 更名为 isMultiModal
* 调整 solon-ai-core ToolMessage 添加 blocks，isMultiModal（工具支持多模态）
* 调整 solon-ai-core ChatDialect 接口，对多模态和 R1 更友好
* 移除 solon-ai-core 移除 ImageModel 体系，由 GenerateModel 体系接替（v3.5 时增加)
* 修复 solon-ai-agent ReActAgent 重试时会消息倍增的问题 
* 修复 solon-ai-agent ReActAgent，TeamAgent 在恢复执行时，会重置 Options 的问题

变更说明：

| 旧名（强调多媒体）                                     | 新名（强调多模态内容块）                                          |
|-----------------------------------------------|-------------------------------------------------------|
| AiMedia                                       | ContentBlock                                          |
| Text                                          | TextBlock                                             |
| Image                                         | ImageBlock                                            |
| Audio                                         | AudioBlock                                            |
| Video                                         | VideoBlock                                            |
|                                               |                                                       |
| UserMessage.getMedias()                       | getBlocks()                                           |
| UserMessage.hasMedias()                       | isMultiModal()                                        |
| /                                             | ToolMessage.getBlocks()                               |
| /                                             | ToolMessage.isMultiModal()                            |
|                                               |                                                       |
| McpClientProvider.callTool()                  | callToolRequest()                                     |
| McpClientProvider.callToolAsText()            | callTool()                                            |
| McpClientProvider.callToolAsImage()           | /                                                     |
| McpClientProvider.callToolAsAudio()           | /                                                     |
| McpClientProvider.readResource()              | readResourceRequest()                                 |
| McpClientProvider.readResourceAsText()        | readResource()                                        |
| McpClientProvider.getPrompt()                 | getPromptRequest()                                    |
| McpClientProvider.getPromptAsMessage()        | getPrompt()                                           |
| `org.noear.solon.ai.mcp.server.prompt.*`      | `org.noear.solon.ai.chat.prompt.*` （prompt 是公用元素）     | 
| `org.noear.solon.ai.mcp.server.resource.*`    | `org.noear.solon.ai.chat.resource.*` （resource 是公用元素） |

最后提交信息为： 3.9.3

v3.9.1

5c55fe0

2026-02-06 13:52

Solon AI v3.9.1

* 新增 solon-ai-dialect-claude 插件
* 新增 solon-ai-dialect-openai OpenaiResponses 方言适配
* 新增 solon-ai-repo-weaviate 插件
* 新增 solon-ai-skill-cli 插件（含 CliSkill 和 SolonCodeCLI）
* 新增 solon-ai-skill-data 插件（含 RedisSkill）
* 新增 solon-ai-skill-file 插件（含 FileReadWriteSkill，ZipSkill）
* 新增 solon-ai-skill-generation 插件（含 ImageGenerationSkill， VideoGenerationSkill）
* 新增 solon-ai-skill-mail 插件（含 MailSkill）
* 新增 solon-ai-skill-pdf 插件（含 PdfSkill）
* 新增 solon-ai-skill-restapi 插件（含 RestApiSkill），内置 OpenApi3 和 swagger2 兼容适配（可扩展定制）
* 新增 solon-ai-skill-social 插件（含 DingTalkSkill，FeishuSkill，WeComSkill）
* 新增 solon-ai-skill-sys 插件（含 NodejsSkill，PythonSkill， ShellSkill，SystemClockSkill）
* 新增 solon-ai-skill-text2sql 插件（含 Text2SqlSkill）
* 新增 solon-ai-skill-web 插件（含 WebCrawlerSkill，WebSearchSkill）
* 添加 solon-ai-core ChatModel role 和 instruction 支持（提供类似 SimpleAgent 效果）
* 添加 solon-ai-core ChatModel.stream 背压流控支持
* 添加 solon-ai-core FileChatSession，RedisChatSession 聊天会话实现
* 添加 solon-ai-core ChatInterceptor.onPrepare 事件（勾子）
* 添加 solon-ai-core Prompt.removeLastMessage, removeLastAssistantMessage 方法
* 添加 solon-ai-agent FileAgentSession 智能体会话实现
* 添加 solon-ai-agent ReActTrace, TeamTrace pending 机制（方便按需拦截挂机）
* 添加 solon-ai-agent feedbackMode 模式（默认为 false）
* 添加 solon-ai-agent ReActInterceptor.onObservation toolName 参数
* 添加 solon-ai-agent HITL 专属接口，进一步优化人工机制（同意，拒绝，跳过）
* 添加 solon-ai-agent stream 流式输出机制
* 优化 solon-ai-agent ReActAgent 添加主动挂机的能力（处理无法完成的任务时，可避免幻觉轮询）
* 优化 solon-ai-agent description + systemPrompt 标为弃用，改由 role + instruction 替代（简化了）
* 优化 solon-ai-agent 内置的 Team 协议（如 ReActProtocol，SwarmProtocol 等）
* 优化 solon-ai-agent 内置的 ToolRetryInterceptor，ToolSanitizerInterceptor 等
* 优化 solon-ai-agent AgentSession 接口 updateSnapshot 取消入参
* 优化 solon-ai-agent ActionTask 取消正则匹配 json 方式，改用 json 流式读取方式
* 调整 solon-ai-core InMemoryChatSession systemMessages 标为弃用（不建议放到会话里，不方便做结构化的管理）
* 调整 solon-ai-agent 取消 title（减少迷惑），systemMessage 标为弃用。改用 role 和 instruction
* 调整 solon-ai-core ChatModel.stream 返回由 Publisher 改为 Flux
* 调整 solon-ai-agent enablePlanning 更名为 planningMode （前者标为弃用）
* 修复 solon-ai-agent ReActAgent 新话题开始时， ReActTrace 没有重置干净的问题
* 修复 solon-ai-agent SimpleAgent 没有接入协作协议 prepareAgentPrompt 勾子
* qdrant 升为 1.16.2

最后提交信息为： UPDATE

2026-01-26 09:23

最后提交信息为： 3.9.0

2026-01-14 12:47

Solon AI v3.8.3（从 chat 进入 agent 时代）

* 新增 `solon-ai-agent` 插件
* 新增 `solon-ai-dialect-gemini` 插件
* 添加 `solon-ai-core` autoToolCall 聊天模型选项（默认为 true）
* 添加 `solon-ai-core` ChatResponse:getResultContent
* 添加 `solon-ai-core` AssistantMessage.toBean 方法。
* 优化 `solon-ai-core` AssistantMessage.getResultContent 处理
* 调整 `solon-ai-croe` ChatSession 不再扩展 ChatPrompt（打断两者关系，后者定位偏固定数据

新增三种模式的智能体：

| 智能体          | 模式描述                                      |
|--------------|-------------------------------------------|
| SimpleAgent  | 简单模式                                      | 
| ReActAgent   | 自省模式，思考+行动。                               | 
| TeamAgent    | 协作模式，分工+编排。多智能体系统（multi-agent system，MAS） |

新特性示例：ReActAgent

```java
public class DemoApp {
  public static void main(String[] args) throws Throwable {
    ChatModel chatModel = LlmUtil.getChatModel();

SimpleAgent robot = SimpleAgent.of(chatModel)
            .toolAdd(new MethodToolProvider(new TimeTool()))
            .build();

String answer = robot.prompt("现在几点了？").call().getContent();

System.out.println("Robot 答复: " + answer);
  }

public static class TimeTool {
    @ToolMapping(description = "获取当前系统时间")
    public String getTime() {
      return LocalDateTime.now().toString();
    }
  }
}
```

最后提交信息为： 3.8.3

v3.8.0

59b8edc

2025-12-24 00:19

Solon AI & MCP v3.8.0

重要变化：

* mcp-java-sdk 升为 v0.17 （支持 2025-06-18 版本协议）
* 添加 mcp-server McpChannel.STREAMABLE_STATELESS 通道支持（集群友好）
* 添加 mcp-server 异步支持

具体更新：

* 添加 solon-ai FunctionPrompt:handleAsync（用于 mcp-server 异步支持）
* 添加 solon-ai FunctionResource:handleAsync（用于 mcp-server 异步支持）
* 添加 solon-ai FunctionTool:handleAsync（用于 mcp-server 异步支持）
* 添加 solon-ai-core ChatMessage:toNdjson,fromNdjson 方法（替代 ChatSession:toNdjson, loadNdjson），新方法机制上更自由
* 添加 solon-ai-core ToolSchemaUtil.jsonSchema Publisher 泛型支持
* 添加 solon-ai-core ToolSchemaUtil.isIgnoreOutputSchema Publisher 泛型支持
* 添加 solon-ai-mcp mcp-java-sdk v0.17 适配（支持 2025-06-18 版本协议）
* 添加 solon-ai-mcp mcp-server 异步支持
* 添加 solon-ai-mcp mcp-server streamable_stateless 支持
* 添加 solon-ai-mcp Tool,Resource,Prompt 对 org.reactivestreams.Publisher<X> 异步返回支持
* 添加 solon-ai-mcp McpServerHost 服务宿主接口，用于隔离有状态与无状态服务
* 添加 solon-ai-mcp McpChannel.STREAMABLE_STATELESS （服务端）无状态会话
* 添加 solon-ai-mcp McpClientProvider:customize 方法（用于扩展 roots, sampling 等）
* 添加 solon-ai-mcp mcpServer McpAsyncServerExchange 注入支持（用于扩展 roots, sampling 等）
* 优化 solon-ai-dialect-openai claude 兼容性
* 优化 solon-ai-mcp mcp StreamableHttp 模式下 服务端正常返回时 客户端异常日志打印的情况
* 调整 solon-ai-mcp getResourceTemplates、getResources 不再共享注册
* 调整 solon-ai-mcp McpServerManager 内部接口更名为 McpPrimitivesRegistry （MCP 原语注册器）
* 调整 solon-ai-mcp McpClientProvider 默认不启用心跳机制（随着 mcp-sdk 的成熟，server 都有心跳机制了）
* mcp ToolCapabilities 添加 @JsonIgnoreProperties(ignoreUnknown = true)

新特性展示：1.MCP 无状态会话（STREAMABLE_STATELESS）和 2.CompletableFuture 异步MCP工具

```java
@McpServerEndpoint(channel = McpChannel.STREAMABLE_STATELESS, mcpEndpoint = "/mcp1")
public class McpServerTool {
    @ToolMapping(description = "查询天气预报", returnDirect = true)
    public CompletableFuture<String> getWeather(@Param(description = "城市位置") String location) {
        return CompletableFuture.completedFuture("晴，14度");
    }
}
```

传输方式对应表：（服务端与客户端，须使用对应的传输方式才可通讯）

| 服务端                   | 客户端         |  备注               |
|-----------------------|-------------|-----------------|
| STDIO                 | STDIO       |                 |
| SSE                   | SSE         |                 |
| STREAMABLE            | STREAMABLE  |                 |
| STREAMABLE_STATELESS  | STREAMABLE  | 对 server 集群很友好  |

* STREAMABLE_STATELESS 集群，不需要 ip_hash，但“原语”变化后无法通知 client

最后提交信息为： README