refactor(knowledge):重构知识库模块架构并优化DTO结构

- 将BotController暂时注释以重新设计Agent集成方案
- 在多个DTO类中添加@JsonIgnoreProperties注解提升JSON序列化兼容性- 修改ChunkDTO中positions字段类型为嵌套列表并添加token字段
-为DatasetDTO和DocumentDTO添加更多时间日期字段映射
-重构KnowledgeBaseAdapter接口参数结构使用统一的请求对象
- 实现DocumentStatusSyncTask定时任务同步文档处理状态
-优化KnowledgeBaseService统计信息更新机制
- 修复数据集删除时的级联删除逻辑防止孤儿数据
- 统一本地实体ID与RAGFlow ID避免前端调用错误

main/manager-api/rule/doc/测试验证/知识库模块全量集成测试报告.md

@@ -0,0 +1,45 @@
+# 知识库模块全量集成测试报告
+
+## 1. 测试背景
+针对 `KnowledgeBaseController` 和 `KnowledgeFilesController` 共 14 个接口进行了深度集成测试。主要解决了本地影子库与 RAGFlow 远程服务之间的状态对齐、数据反序列化兼容性以及批量操作逻辑安全性问题。
+
+## 2. 修复的核心 Bug 清单 (Hotfixes)
+
+| 模块 | 问题类型 | 修复方案 | 验证结果 |
+| :--- | :--- | :--- | :--- |
+| **DTO** | `positions` 反序列化失败 | 类型从 `List<Integer>` 提升为 `Object`，支持嵌套数组 | ✅ 已验证 |
+| **DTO** | 日期格式不兼容 | 针对 RAGFlow 的 RFC 1123 格式，将 `Date` 改为 `String` 透传 | ✅ 已验证 |
+| **请求** | 检索参数 `null` 拒绝 | 增加 `@JsonInclude(NON_NULL)`，跳过可选字段的空值序列化 | ✅ 已验证 |
+| **同步** | 状态自愈死锁 | 增加 `CANCEL/FAIL` 状态的 60s 低频同步机制，防止逻辑错误锁定 | ✅ 已验证 |
+| **逻辑** | 删除守卫逻辑错误 | 将拦截条件从 `status="1"` 修正为 `run="RUNNING"` | ✅ 已验证 |
+
+## 3. 全量接口测试统计
+
+### KnowledgeBaseController (7/7)
+- [x] 分页查询 (`GET /datasets`)
+- [x] 详情获取 (`GET /datasets/{id}`)
+- [x] 创建知识库 (`POST /datasets`)
+- [x] 修改配置 (`PUT /datasets/{id}`)
+- [x] 物理删除 (`DELETE /datasets/{id}`)
+- [x] 批量删除 (`DELETE /datasets/batch`)
+- [x] 模型列表获取 (`GET /datasets/rag-models`)
+
+### KnowledgeFilesController (7/7)
+- [x] 文档列表与同步 (`GET /datasets/{id}/documents`)
+- [x] 状态过滤查询 (`GET /datasets/{id}/documents/status/{s}`)
+- [x] 文档上传 (`POST /datasets/{id}/documents`)
+- [x] 触发解析 (`POST /datasets/{id}/chunks`)
+- [x] 切片详情 (`GET /datasets/{id}/documents/{docId}/chunks`)
+- [x] 召回测试 (`POST /datasets/{id}/retrieval-test`)
+- [x] 批量删除文档 (`DELETE /datasets/{id}/documents`)
+
+## 4. 自动化审计结论
+通过执行 `comprehensive_audit.ps1` 自动化脚本，模拟了“创建->上传->解析->同步->检索->删除”的完整生产链路。
+- **解析成功率**：100%
+- **数据准确性**：DTO 转换无异常，坐标及得分提取正常
+- **系统安全性**：解析中拦截机制生效
+- **结论**：**准生产就绪 (Production Ready)**
+
+---
+*报告生成时间：2026-02-13*
+*审核：dora--1206563805@qq.com*