commit

2026-05-31 21:45:14 +08:00
parent d4b5015beb
commit ac08345369
67 changed files with 11120 additions and 387 deletions
@@ -0,0 +1,19 @@
+# Evidence
+
+## Evidence-driven 结论
+
+| 结论 | 证据来源 | 验证方式 |
+|---|---|---|
+| `ReactAgent.builder().model()` 接受 `ChatModel` 接口 | javap 反编译 Agent Framework | 静态验证 |
+| `ChatModel` 应通过 Spring Boot 自动注入 | DashScope/DeepSeek/OpenAI starter 均自动注册 Bean | 脚本验证：`ChatAndEmbeddingSmokeTest` |
+| `RagService` 可用 `ChatModel.stream()` 替代 `Generation` | Spring AI `stream(Prompt)` 返回 `Flux<ChatResponse>` | 代码审查 |
+| `EmbeddingModel` 支持批量调用 | `EmbeddingModel.embed(List<String>)` 返回 `List<float[]>` | 脚本验证：`FullPipelineSmokeTest#embeddingBatchWorks` |
+| `DeepSeekChatModel` 兼容 DeepSeek V4 Flash | Spring AI 1.1.7 原生 `spring-ai-starter-model-deepseek` | 脚本验证：`FullPipelineSmokeTest#chatDeepSeekWorks` |
+| BGE-M3 via SiliconFlow 返回 1024 维向量 | `OpenAiEmbeddingModel.embed()` → 1024-dim `float[]` | 脚本验证：`FullPipelineSmokeTest#embeddingBgeM3Works` |
+| `OpenAiChatModel` 不兼容 DeepSeek V4 | curl 200, Spring AI 400 `Model does not exist` | 实验对比：curl vs Java, 3 次重试均失败 |
+
+## 技术决策依据
+
+- **用原生 DeepSeek starter 而非 OpenAI 兼容模式**：Spring AI 1.1.0 `OpenAiChatModel` 的请求体含 DeepSeek V4 不识别的字段，原生 `DeepSeekChatModel` 直接适配
+- **SiliconFlow Embedding 独立配置**：Chat 和 Embedding 不同厂商、不同 base-url，Spring AI auto-config 不支持单前缀拆两地址，需手动 `OpenAiApi`
+- **yml 驱动路由**：`model-routing.chat/embedding` 关键字 → Bean 名/类名匹配 → @Primary，比硬编码 @Qualifier 更灵活