更新日志

2026-01-08 - 百炼 SDK 方案升级

主要变更

替换 LangChain4J 为百炼官方 SDK
- 移除 LangChain4J 相关依赖
- 添加阿里云百炼 SDK 2.16.3
- 使用 MultiModalConversation 类直接调用百炼 API
优化身份证识别服务
- 使用本地文件路径传递图片（而非 Base64）
- 优化提示词设计，提高识别准确率
- 增强响应解析逻辑，支持多种格式
- 添加临时文件自动清理机制
简化配置
- 配置文件只需 api-key 和 model 两个参数
- 移除不必要的 base-url、temperature 等配置
- 删除 BailianConfig.java 配置类
改进异常处理
- 使用百炼 SDK 专门的异常类型（NoApiKeyException、ApiException、UploadFileException）
- 提供更详细的错误信息和日志

技术优势

性能提升：直接使用官方 SDK，减少中间层开销
准确性提升：优化的提示词和多层解析策略
代码简化：移除不必要的配置和依赖
可维护性：使用官方 SDK，后续升级更容易

文件变更

删除的文件：

src/main/java/com/medical/demo/config/BailianConfig.java

修改的文件：

pom.xml - 替换依赖
src/main/resources/application.yml - 简化配置
src/main/java/com/medical/demo/service/IdCardRecognitionService.java - 重写实现

新增的文件：

TECHNICAL_NOTES.md - 技术实现说明文档
CHANGELOG.md - 本文件

升级指南

如果你已经使用了之前的 LangChain4J 版本，需要：

更新 pom.xml，替换依赖
修改 application.yml，简化配置
代码无需修改，Controller 接口保持不变

兼容性

✅ 前端代码无需修改
✅ API 接口保持不变
✅ 数据格式保持不变
✅ 配置文件向后兼容（旧的配置项会被忽略）

初始版本 - 2026-01-08

功能列表

✅ 患者建档完整流程
✅ 摄像头拍照识别身份证
✅ AI 识别 + 手动输入双重保障
✅ CSV 文件本地存储
✅ 响应式前端界面
✅ Vue.js + Element Plus
✅ 完善的文档和启动脚本