feat: add price information support to model listing API

[XinyuZhang132]

#261
Introduces an option to the model listing API to include detailed price information for each model.

[szl97]

@claude 检查提交的代码，使用中文回复

[szl97]

Claude finished @szl97's task —— View job

---

代码审查反馈

我已经完成了对提交代码的分析，以下是详细的审查反馈：

任务清单:

• 分析修改的文件内容
• 检查 MetadataController.java 的变更
• 检查 EndpointService.java 的变更
• 检查 ModelService.java 的变更
• 提供代码质量和安全性评估

代码变更总结

此次PR为模型列表API添加了价格信息支持，主要变更如下：

📋 变更详情

1. MetadataController.java (api/server/src/main/java/com/ke/bella/openapi/endpoints/MetadataController.java:90-93)

• 在 /model/list 接口中添加了 includePrice 参数
• 调用新的 listModelDBsWithPermissionAndPrice 方法

2. EndpointService.java (api/server/src/main/java/com/ke/bella/openapi/service/EndpointService.java:298-311)

• 新增 enrichModelsWithPriceInfo 方法，为模型列表批量添加价格信息
• 通过 channelService.getPriceInfo 获取价格详情并设置到模型对象中

3. ModelService.java (api/server/src/main/java/com/ke/bella/openapi/service/ModelService.java:386-497)

• 新增 listModelDBsWithPermissionAndPrice 方法，支持带价格信息的模型查询
• 新增内部类 ModelDBWithPrice 扩展原有 ModelDB
• 新增 enrichModelDBsWithPriceInfo 私有方法处理价格信息填充
• 新增 groupModelDBsByEndpoint 方法按端点分组模型

✅ 代码质量评估

优点：

1. 向后兼容性良好 - 通过可选参数 includePrice (默认false) 保持API向后兼容
2. 错误处理恰当 - 在 enrichModelDBsWithPriceInfo 中使用 try-catch，价格获取失败不影响基础模型信息返回
3. 性能考虑 - 只在需要时才获取价格信息，避免不必要的性能开销
4. 代码复用 - 复用了现有的 endpointService.enrichModelsWithPriceInfo 方法
5. 数据结构设计合理 - ModelDBWithPrice 扩展设计清晰，使用 @JsonInclude(JsonInclude.Include.NON_NULL) 优化JSON输出

潜在改进点：

1. 异常处理过于宽泛 (ModelService.java:441-443)

   } catch (Exception e) {
       // 价格信息获取失败不影响基础模型信息返回，保持priceDetails为null
   }

   建议记录异常日志以便排查问题：

   } catch (Exception e) {
       log.warn("Failed to enrich models with price info: {}", e.getMessage());
   }

2. 方法返回类型不一致 (ModelService.java:400)

   return new ArrayList<ModelDB>(modelDBsWithPrice);

   这里将 List<ModelDBWithPrice> 转换为 List<ModelDB>，可能会丢失价格信息的类型安全性。

🔍 安全性评估

安全方面良好：

• 沿用了现有的权限检查机制 (apikeyFirst 参数)
• 价格信息获取通过现有的安全校验流程
• 没有引入新的安全风险点

📈 性能影响

• 正面影响： 按需加载价格信息，默认不影响现有性能
• 潜在影响： 当 includePrice=true 时会增加数据库查询和网络调用，但通过缓存机制可以缓解

🎯 总体评价

这是一个高质量的功能实现，代码结构清晰，向后兼容性好，错误处理恰当。主要建议是加强异常日志记录以便问题排查。功能实现符合系统架构设计，是一个很好的特性增强。

---