v0.3.0 发布说明

v0.3.0 聚焦于模型供应商底层架构升级与模型管理体验优化。 该版本重点解决“供应商能力可扩展性、默认模型解析一致性、多模态基础 URL 支持、前端模型配置可用性”问题。

Highlights

• 重构 LLM 供应商注册与解析链路，提升扩展性与可维护性。
• 新增系统支持供应商能力相关 API，前后端可动态发现能力边界。
• 增强供应商模型，支持图像/视频类别基础 URL。
• 迁移默认模型策略（由显式默认标记向模型设置收敛）。
• 优化模型与供应商管理页交互，补齐操作按钮样式与行为一致性。

Added

• 供应商能力发现接口
  • 新增“系统支持供应商能力”与“支持供应商列表”相关 API，减少前端硬编码能力判断。
• 多模态供应商能力支持
  • 在供应商模型与任务链路中补齐图像、视频能力及基础 URL 支持。
• 阿里百炼供应商支持
  • 新增供应商接入并扩展能力清单，补齐文本类支持。
• 集成适配层能力补强
  • 为 OpenAI、火山引擎相关图像/视频适配路径补齐实现与测试覆盖。

Changed

• LLM 依赖注入与默认文本模型构建逻辑重构，解析链路更清晰。
• 生成准备架构进一步统一，任务中心相关交互同步优化。
• 前端模型/供应商管理页（包括操作列）交互与可视反馈增强。
• OpenAPI 与 generated client 已按本版本接口同步更新。

Breaking Changes

• 模型默认策略发生调整：is_default 语义被迁移/收敛到模型设置结构；调用方需按新模型结构处理默认逻辑。
• 供应商能力判定建议改用后端能力发现 API；依赖前端静态枚举/硬编码能力的实现需要同步迁移。
• 若未同步最新 OpenAPI 与 generated client，模型与供应商相关字段可能出现类型不匹配。

Deprecations

• 在前端硬编码“供应商支持能力集合”的做法进入弃用路径。
• 以旧默认标记字段直接驱动模型默认选择的路径进入弃用路径。

Fixed

• 修复生成服务残留导出与提交上下文取值问题。
• 修复模型/供应商操作列交互细节与样式一致性问题。
• 修复部分任务与服务在能力路由上的边界行为问题。

Security

本版本未包含已公开披露的安全漏洞修复项。 如发现潜在安全问题，请通过维护渠道私下反馈，避免公开披露可利用细节。

Known Issues

• 个别历史页面若仍使用旧默认模型字段语义，可能在边界场景下出现展示或选择不一致。
• 若部署顺序错误（先上代码后迁移），模型默认策略相关流程可能出现运行异常。

Migration Guide

本版本包含数据库与接口契约变更，建议按以下顺序升级：

1. 执行 backend/sql 下本版本相关迁移（重点关注 005、006）。
2. 部署后端服务与任务执行组件。
3. 执行 pnpm run openapi:update 并部署前端 generated client 产物。

Rollback Notes

如需紧急回滚，请保持前后端与数据库版本一致：

1. 先回滚前端到旧 OpenAPI 对齐版本。
2. 再回滚后端到目标稳定版本。
3. 若已执行不可逆迁移，优先采用兼容读写策略，不直接回退表结构。

Compatibility Matrix

Validation Commands

# 更新并同步 OpenAPI 产物
pnpm run openapi:update

# 前端类型检查
pnpm exec tsc --noEmit

# 后端关键测试
uv run pytest backend/tests -q

Upgrade Checklist

• 数据库迁移执行完成并验证通过（含 005、006）。
• 后端服务与任务执行组件已升级到 v0.3.0。
• 前端 generated client 已与最新 OpenAPI 对齐。
• 供应商能力发现接口与模型默认策略链路验证通过。
• 模型/供应商管理页操作链路端到端验证通过。

References

• Tag: v0.3.0
• 关键目录：backend/app/services/llm、backend/app/core/integrations、backend/sql、front/src/pages/aiStudio/models、front/src/services/generated
• 关键接口：backend/app/api/v1/routes/llm.py

Notes for Contributors

• 后端 LLM 契约变更后，请同步 OpenAPI 与前端 generated client，避免模型配置页出现类型漂移。
• 新增供应商能力时，必须同步能力发现 API、provider registry、集成适配层与测试用例。

Acknowledgements

感谢所有参与 LLM 供应商架构重构、多模态能力接入与模型管理体验优化的贡献者。