ForcePilot/docs/changelog/roadmap.md

# 开发路线图

路线图可能会经常变更，如果有强烈的建议，可以在 [issue](https://github.com/xerrors/Yuxi-Know/issues) 中提。

- **[2025/10/13]** v0.3 进入 beta 测试环节，不会再封装新的特性，仅作 bug 层面的修复


## Bugs

- [ ] upload 接口会阻塞主进程
- [ ] LightRAG 知识库查看不了解析后的文本，偶然出现，未复现

## Next

- [ ] 新建 DeepAgents 智能体
- [ ] 添加对于上传文件的支持
- [ ] LightRAG 知识库应该可以支持修改 LLM
- [ ] 统一图谱数据结构，优化可视化方式 [#298](https://github.com/xerrors/Yuxi-Know/issues/298) <Badge type="info" text="0.4" />
- [ ] 集成智能体评估，首先使用命令行来实现，然后考虑放在 UI 里面展示
- [ ] 开发与生产环境隔离，构建生产镜像 <Badge type="info" text="0.4" />


## Later

下面的功能**可能**会放在后续版本实现，暂时未定

- [ ] 集成 LangFuse (观望) 添加用户日志与用户反馈模块，可以在 AgentView 中查看信息

## Done


- [x] 添加测试脚本，覆盖最常见的功能（已覆盖API）
- [x] 新建 tasker 模块，用来管理所有的后台任务，UI 上使用侧边栏管理。
- [x] 优化对文档信息的检索展示（检索结果页、详情页）
- [x] 当前 ReAct 智能体有消息顺序错乱的 bug，且不会默认调用工具
- [x] 优化全局配置的管理模型，优化配置管理
- [x] 支持 MinerU 2.5 的解析方法 <Badge type="info" text="0.3.5" />
- [x] 文件管理：（1）文件选择的时候会跨数据库；（2）文件校验会算上失败的文件；
- [x] Tasker 中获取历史任务的时候，仅获取 top100 个 task。
- [x] 修改现有的智能体Demo，并尽量将默认助手的特性兼容到 LangGraph 的 [`create_agent`](https://docs.langchain.com/oss/python/langchain/agents) 中
- [x] 基于 create_agent 创建 SQL Viewer 智能体 <Badge type="info" text="0.3.5" />
- [x] 优化 MCP 逻辑，支持 common + special 创建方式 <Badge type="info" text="0.3.5" />
- [x] 修复本地知识库的 metadata 和 向量数据库中不一致的情况。
- [x] v1 版本的 LangGraph 的工具渲染有问题
-												docs: 更新文档，添加智能体开发、品牌自定义、文档解析等新内容，并优化快速开始指南

											
										
										
											2025-10-10 10:49:51 +08:00
+								# 开发路线图
-												refactor(database): 重构知识库信息页面组件化实现

- 将DataBaseInfoView.vue拆分为多个独立组件：
  * DatabaseHeader.vue: 数据库头部信息展示和编辑功能
  * FileTable.vue: 文件列表展示和操作功能
  * FileDetailModal.vue: 文件详情弹窗展示
  * FileUploadModal.vue: 文件上传和URL添加功能
  * KnowledgeGraphSection.vue: 知识图谱展示区域
  * QuerySection.vue: 查询功能区域
- 优化database.js store，增加完整的状态管理和业务逻辑
- 更新AppLayout.vue中数据库信息获取方法
- 添加工具函数文件file_utils.js和kb_utils.js
- 更新KnowledgeGraphViewer.vue组件配置

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

											
										
										
											2025-08-05 18:00:45 +08:00
-												docs: 更新文档，添加智能体开发、品牌自定义、文档解析等新内容，并优化快速开始指南

											
										
										
											2025-10-10 10:49:51 +08:00
+								路线图可能会经常变更，如果有强烈的建议，可以在 [issue](https://github.com/xerrors/Yuxi-Know/issues) 中提。
-												docs: 更新 README 和开发路线图，添加版本信息和最新动态

											
										
										
											2025-10-14 02:37:02 +08:00
+								- **[2025/10/13]** v0.3 进入 beta 测试环节，不会再封装新的特性，仅作 bug 层面的修复
-												fix(security): 增强文件路径验证，防止路径遍历攻击

- 在知识库路由中添加文件路径安全检查，确保上传和下载的文件路径在允许的目录内
- 新增 validate_file_path 函数，规范化并验证文件路径，抛出相应的异常信息
- 更新文档，修复部分已知BUG，提升系统稳定性

											
										
										
											2025-09-23 04:42:04 +08:00
-												Update roadmap.md
											
										
										
											2025-10-15 02:07:45 +08:00
+								## Bugs
-												docs: 更新 README 和开发路线图，添加版本信息和最新动态

											
										
										
											2025-10-14 02:37:02 +08:00
-												feat: 优化批量上传脚本，支持多种文件格式上传并添加任务状态检查功能

											
										
										
											2025-10-26 21:10:42 +08:00
+								- [ ] upload 接口会阻塞主进程
-												chore: gitignore

											
										
										
											2025-10-30 22:29:38 +08:00
+								- [ ] LightRAG 知识库查看不了解析后的文本，偶然出现，未复现
-												fix(security): 增强文件路径验证，防止路径遍历攻击

- 在知识库路由中添加文件路径安全检查，确保上传和下载的文件路径在允许的目录内
- 新增 validate_file_path 函数，规范化并验证文件路径，抛出相应的异常信息
- 更新文档，修复部分已知BUG，提升系统稳定性

											
										
										
											2025-09-23 04:42:04 +08:00
-												Update roadmap.md
											
										
										
											2025-10-15 02:07:45 +08:00
+								## Next
-												fix: 修复消息中断时带来的消息显示问题

											
										
										
											2025-10-12 23:45:17 +08:00
-												feat: 优化批量上传脚本，支持多种文件格式上传并添加任务状态检查功能

											
										
										
											2025-10-26 21:10:42 +08:00
+								- [ ] 新建 DeepAgents 智能体
-												fix: 修复Dashboard中的数据加载问题，添加对话的更新时间

											
										
										
											2025-10-13 12:37:06 +08:00
+								- [ ] 添加对于上传文件的支持
-												chore: gitignore

											
										
										
											2025-10-30 22:29:38 +08:00
+								- [ ] LightRAG 知识库应该可以支持修改 LLM
-												Update roadmap.md
											
										
										
											2025-10-15 02:07:45 +08:00
+								- [ ] 统一图谱数据结构，优化可视化方式 [#298](https://github.com/xerrors/Yuxi-Know/issues/298) <Badge type="info" text="0.4" />
-												refactor(ui): 优化调试模式实现并改进界面样式

- 将调试模式状态管理移至 infoStore 实现全局统一控制
- 移除各组件中分散的调试模式状态管理代码
- 调整侧边栏和头部组件的边框和背景颜色
- 优化按钮和交互元素的悬停效果
- 更新文档中的 changelog 记录待办事项

											
										
										
											2025-09-11 03:09:17 +08:00
+								- [ ] 集成智能体评估，首先使用命令行来实现，然后考虑放在 UI 里面展示
-												refactor(time): 重构应用程序中的日期时间处理

- 新增工具模块 `datetime_utils.py`，用于统一处理UTC和上海时区
- 在 `manager.py`、`models.py` 等后端文件中，将直接操作日期时间的代码替换为工具函数
- 更新前端组件，使用 `dayjs` 进行时区感知的日期格式化和解析
- 移除冗余的日期格式化逻辑，将其集中到工具函数中
- 通过确保所有时间戳均以亚洲/上海时区显示，提升用户体验

											
										
										
											2025-10-13 15:08:54 +08:00
+								- [ ] 开发与生产环境隔离，构建生产镜像 <Badge type="info" text="0.4" />
-												feat: MinerU 升级到 2.5 版本，同时优化整体的 OCR 体验。

											
										
										
											2025-10-25 14:26:47 +08:00
-												refactor: 重构配置/知识库模块，拆分为独立app.py文件

											
										
										
											2025-09-18 15:20:39 +08:00
-												Update roadmap.md
											
										
										
											2025-10-15 02:07:45 +08:00
+								## Later
-												refactor: 重构配置/知识库模块，拆分为独立app.py文件

											
										
										
											2025-09-18 15:20:39 +08:00
-												refactor(time): 重构应用程序中的日期时间处理

- 新增工具模块 `datetime_utils.py`，用于统一处理UTC和上海时区
- 在 `manager.py`、`models.py` 等后端文件中，将直接操作日期时间的代码替换为工具函数
- 更新前端组件，使用 `dayjs` 进行时区感知的日期格式化和解析
- 移除冗余的日期格式化逻辑，将其集中到工具函数中
- 通过确保所有时间戳均以亚洲/上海时区显示，提升用户体验

											
										
										
											2025-10-13 15:08:54 +08:00
+								下面的功能**可能**会放在后续版本实现，暂时未定
-												refactor: 重构配置/知识库模块，拆分为独立app.py文件

											
										
										
											2025-09-18 15:20:39 +08:00
-												refactor(time): 重构应用程序中的日期时间处理

- 新增工具模块 `datetime_utils.py`，用于统一处理UTC和上海时区
- 在 `manager.py`、`models.py` 等后端文件中，将直接操作日期时间的代码替换为工具函数
- 更新前端组件，使用 `dayjs` 进行时区感知的日期格式化和解析
- 移除冗余的日期格式化逻辑，将其集中到工具函数中
- 通过确保所有时间戳均以亚洲/上海时区显示，提升用户体验

											
										
										
											2025-10-13 15:08:54 +08:00
+								- [ ] 集成 LangFuse (观望) 添加用户日志与用户反馈模块，可以在 AgentView 中查看信息
-												Update roadmap.md
											
										
										
											2025-10-15 02:07:45 +08:00
+								## Done
-												refactor(database): 重构知识库信息页面组件化实现

- 将DataBaseInfoView.vue拆分为多个独立组件：
  * DatabaseHeader.vue: 数据库头部信息展示和编辑功能
  * FileTable.vue: 文件列表展示和操作功能
  * FileDetailModal.vue: 文件详情弹窗展示
  * FileUploadModal.vue: 文件上传和URL添加功能
  * KnowledgeGraphSection.vue: 知识图谱展示区域
  * QuerySection.vue: 查询功能区域
- 优化database.js store，增加完整的状态管理和业务逻辑
- 更新AppLayout.vue中数据库信息获取方法
- 添加工具函数文件file_utils.js和kb_utils.js
- 更新KnowledgeGraphViewer.vue组件配置

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

											
										
										
											2025-08-05 18:00:45 +08:00
-												feat: 更新聊天代理和任务管理器，支持通过线程ID管理消息，优化日志记录和敏感内容检查

											
										
										
											2025-10-12 13:09:29 +08:00
+								- [x] 添加测试脚本，覆盖最常见的功能（已覆盖API）
-												refactor(time): 重构应用程序中的日期时间处理

- 新增工具模块 `datetime_utils.py`，用于统一处理UTC和上海时区
- 在 `manager.py`、`models.py` 等后端文件中，将直接操作日期时间的代码替换为工具函数
- 更新前端组件，使用 `dayjs` 进行时区感知的日期格式化和解析
- 移除冗余的日期格式化逻辑，将其集中到工具函数中
- 通过确保所有时间戳均以亚洲/上海时区显示，提升用户体验

											
										
										
											2025-10-13 15:08:54 +08:00
+								- [x] 新建 tasker 模块，用来管理所有的后台任务，UI 上使用侧边栏管理。
-												Update roadmap.md
											
										
										
											2025-10-14 06:16:36 +08:00
+								- [x] 优化对文档信息的检索展示（检索结果页、详情页）
-												refactor: 重构 config 模块

											
										
										
											2025-10-22 11:51:32 +08:00
+								- [x] 当前 ReAct 智能体有消息顺序错乱的 bug，且不会默认调用工具
 								- [x] 优化全局配置的管理模型，优化配置管理
-												feat: 使用 create_agent 接口替换老版本的 create_react_agent

											
										
										
											2025-10-25 20:01:23 +08:00
+								- [x] 支持 MinerU 2.5 的解析方法 <Badge type="info" text="0.3.5" />
 								- [x] 文件管理：（1）文件选择的时候会跨数据库；（2）文件校验会算上失败的文件；
 								- [x] Tasker 中获取历史任务的时候，仅获取 top100 个 task。
-												feat: 优化批量上传脚本，支持多种文件格式上传并添加任务状态检查功能

											
										
										
											2025-10-26 21:10:42 +08:00
+								- [x] 修改现有的智能体Demo，并尽量将默认助手的特性兼容到 LangGraph 的 [`create_agent`](https://docs.langchain.com/oss/python/langchain/agents) 中
 								- [x] 基于 create_agent 创建 SQL Viewer 智能体 <Badge type="info" text="0.3.5" />
 								- [x] 优化 MCP 逻辑，支持 common + special 创建方式 <Badge type="info" text="0.3.5" />
-												feat: 极大的提升 SQL 工具调用的稳定性，移除 LIMINT 并将默认超时时间修改为 60s，添加MySQL连接管理器和安全检查功能，优化查询执行和错误处理逻辑

  - 重构 MySQLConnectionManager，在使用前验证游标，向使用者提供辅助函数，并使用基于线程池的超时机制替代 SIGALRM，使查询可运行长达 600 秒，同时安全地失效不良连接（src/agents/common/toolkits/mysql/connection.py）
  - 扩大安全防护中的允许超时窗口，移除未使用的限制验证器，并更新查询模型默认值（src/agents/common/toolkits/mysql/security.py，src/agents/common/toolkits/mysql/tools.py）
  - 使 mysql_query 依赖 execute_query_with_timeout，移除隐式 LIMIT 注入，确保失败时连接保持健康，扩展结果格式化和故障排除提示；记录 list-table 调用，并在避免按表 COUNT 扫描的同时，丰富 mysql_describe_table 的列注释（src/agents/common/toolkits/mysql/tools.py）
  - 将高级代理指南重命名为 agents-config，更新 VitePress 导航，并在文档中增加 LangGraph/MCP/MySQL 配置指导（docs/.vitepress/config.mts，docs/advanced/agents-config.md）
  - 调整路线图错误列表，将 LangGraph 工具问题标记为已解决，并跟踪 LightRAG 查看器的缺失功能（docs/changelog/roadmap.md）
  - 添加 CLAUDE.md，引导贡献者参阅 AGENTS.md 获取更多信息

											
										
										
											2025-10-27 23:41:40 +08:00
+								- [x] 修复本地知识库的 metadata 和 向量数据库中不一致的情况。
 								- [x] v1 版本的 LangGraph 的工具渲染有问题