[Feature]: 批量基于原始文件 ID 映射到当前文件 ID

[chlsmile]

Feature Type

New API endpoint

Problem Description

• 部分依赖 bella-knowledge 的系统目前仍使用原始文件 ID 进行引用，但在 bella-knowledge 中，这些文件可能已经分配了新的文件 ID。

• 目前缺少一种便捷的方式，能够让外部系统根据原始文件 ID 获取对应的当前文件 ID，这给系统间的集成与后续维护带来了困难。

Proposed Solution

• 在 bella-knowledge 中新增一个 API 接口，支持批量根据原始文件 ID 查询对应的当前文件 ID，以便依赖系统能够方便地获取所需的最新标识。

Alternatives Considered

No response

Priority

High - Blocking my use case

Implementation

• I'm willing to submit a PR for this feature
• I can help with testing
• I can help with documentation

Additional Context

No response

[Jiakaic]

看一下FileController的/v1/files/list接口能符合需求不

[chlsmile]

如果用/v1/files/list在实现层面需要做改造

[Jiakaic]

支持一下file_mapping吧

[chlsmile]

OK

[chlsmile]

方案一：在当前的 v1/files/list接口基础上进行扩展（目前接口未查询 file_mapping 表，默认所有 ID 均为新 ID 直接查 file 表）。
改造思路：

1. 对入参中的 ID 进行判断：

   • 若为旧 ID，则批量查询 file_mapping 表，将其转换为对应的新 ID；
   • 若为新 ID，则直接使用。

2. 基于新 ID 查询 file 表，生成 OpenAIFile 对象。

3. 对于映射自旧 ID 的文件，在返回结果中保留旧 ID 作为 OpenAIFile.id 的值。

方案二：新增一个接口用于旧文件 ID 的批量查询。
调用与返回结构：

• 调用方批量传入旧 file_id；

• bella-knowledge 返回结果为 Map<String, OpenAIFile>：

  • key：旧 file_id
  • value：OpenAIFile 对象，其 id 字段为对应的新 ID。

[Jiakaic]

我会偏向于，对于批量的查询接口，都联查一下mapping表，若存在，响应老id

[chlsmile]

好的，那按照【对于批量的查询接口，都联查一下mapping表】我来实现一下