13 KiB
13 KiB
开发路线图
路线图可能会经常变更，如果有强烈的建议，可以在 issue 中提。
日志添加规范（For Agent）:
- 同一版本的多次功能更新时，应以功能为单位进行更新，比如之前添加了 A 功能的更新，在后续的更新中修复了因 A 功能引入的 bug，那么这个修复说明应该和 A 功能描述放在一起，而不是新增一条修复记录，功能更新同理。
看板
- Langfuse 增加 self-host 模式支持，补齐私有化部署与配置说明（已支持 cloud，待调试）
- 检索测试中，添加问答
- 集成 Memory，基于 deepagents 的文件后端实现，需要考虑定位
- Yuxi-cli 相关的功能，放在后续版本中实现（不是类似于编程助手，而是管理平台的工，等各个 router 接口优化之后）
- 完善测试基准自动生成功能，目前的实现过于简单，无法覆盖实际需求
- 完善 Skills 的环境变量注入
- 拓宽检索的知识源，统一多知识源（channel），目前已知知识库/知识图谱/网页，可拓展：个人知识库、数据库、历史对话等
- 前置任务，多知识库并行检索（扩展 query_kb）
- 新增 query_keywords 工具，专门用于基于关键词命中的排序，也结合词频（和 BM25 的区别？）
- 调研将当前知识库映射为虚拟文件系统工具的可行性，先明确文件树映射、权限边界、内容读取与 Agent 工具调用形态，再决定是否实现
- 参考 AgenticRAG 方案扩展当前 Search 工具：基于知识库工具返回的 resource_id/file_id 改进 Search 返回递增文件序列 ID，完善 Find 与 Open 能力；Summary 暂缓
- 评估，基于 Agent 的评估，这里应该是结合 Langfuse 实现
Bugs
- 目前的知识库的图片存在公开访问风险
BREAKING CHANGE（不兼容变更，0.7 版本）
- Provider 与模型配置收敛：移除旧版 v1 模型配置与 Ollama 支持，运行时模型统一使用
provider_id:model_id与独立 provider 模块；自定义 provider 实现逻辑从文件移动到数据库，并从 config 文件迁移到 provider 模块。 - 智能体运行时语义收敛：用户可见的
AgentConfig收敛为数据库持久化的一级Agent，内置 Python Agent 改为智能体后端；聊天、运行任务、恢复审批和文件预览均从线程绑定的 Agent 解析运行时上下文，前端只提交agent_id。 - 知识库能力边界收敛：移除 Upload 与 LightRAG 知识库/图谱能力，知识库类型收敛为 Milvus 与只读连接器；知识库 API 统一使用
/{db_id}/xxx形式，并整合 mindmap / eval 等子接口。 - Agent 资源默认选择与权限过滤：未显式配置工具、知识库、MCP、Skills、SubAgent 时默认启用当前用户可访问/可用的全部资源，显式保存空列表仍表示不启用对应资源；Agent 创建前统一完成最终资源权限过滤、知识库
db_id可见范围派生和 Skill prompt/readable 依赖闭包派生。 - Skill 安装与权限模型收敛：Skill 元数据使用
source_type/share_config/enabled表达来源、生效范围与启用状态；内置 Skill 启动或同步时自动写入数据库并默认全局启用，上传和远程添加统一改为解析草稿后确认安装，不保留旧直接安装兼容路径。 - 历史兼容层精简：移除 sandbox provisioner
local后端别名、ask_user_question 单问题旧协议、JWT 历史默认密钥特殊判断、内置 SkillSKILLS.md文件名回退、运行事件数字 seq 兼容和前端旧字段回退。 - 用户身份命名收敛：原业务登录标识统一改为
uid，Agent/LangGraph runtime、conversation、agent_run、sandbox 路径和前端用户态均使用字符串uid；user_id仅保留给外部响应中的数值users.id或真实外键场景。
版本记录
0.7.0 开发记录
- 降低知识库路由与工具模块复杂度：示例问题生成迁移到知识库 utils，文件上传统一 100 MB 限制，URL 预处理入库路径与旧
content_type=url行为收敛，并修复 uid、导出 MIME 与异常透传等路由问题。 - 重构智能体配置语义：用户可见的
AgentConfig收敛为数据库持久化的一级Agent，内置 Python Agent 改为智能体后端；新增/api/agent管理与运行接口，聊天、运行任务、恢复审批和文件预览均从线程绑定的 Agent 解析运行时上下文，前端只提交agent_id，并在模型配置页新增“智能体”管理页签。 - 删除 Upload 与 LightRAG 图谱/知识库能力：知识库类型收敛为 Milvus 与 Dify，只保留 Milvus 知识库内图谱构建/展示/检索，移除独立
/graph页面和默认上传图谱工具。 - 收敛只读知识源连接器：新增
ReadOnlyConnectors基类，Dify 改为声明自身创建参数与校验规则，新增 Notion Data Source 只读知识库并支持 Search/Find/Open；知识库类型接口返回创建参数 schema，前端新建表单按类型动态渲染非 Milvus 配置并统一保存到additional_params。 - 新增知识库 Chunk 持久化：Milvus 知识库索引/更新流程会将 chunks 双写到 PostgreSQL
knowledge_chunks表与 Milvus，文件内容查看优先查询 PostgreSQL，并为位置信息、图谱实体关联、标签和抽取结果预留结构化字段。 - 完善 Milvus 知识库图谱构建：修复 Chunk 图谱写入返回值、Neo4j 同步写入阻塞事件循环、重复构建任务竞态、图谱查询提前终止、Neo4j 连接复用、LLM 抽取超时重试和前端错误详情展示等问题；图谱构建会将 entity/triple 本体与 chunk 引用写入 PostgreSQL，并为唯一 entity/triple 建立 Milvus 语义索引，单文件删除时同步清理图谱引用和孤儿向量。
- 优化图谱抽取器配置：未配置时在图谱中心展示配置入口，抽取方案收敛为 LLM，前端仅保留“更多拓展中”占位；LLM 抽取器使用固定 Prompt + 自定义 Schema，并支持模型参数与并发队列数；已配置后允许修改参数并提示重置重抽风险。修复上传并入库新文件时旧内存 metadata 覆盖数据库图谱配置的问题。
- 新增 Milvus 图谱检索链路：Query 可召回图谱实体和三元组，结合 Chunk 命中实体构造 seed entity，读取 Neo4j 2-hop 子图后用 igraph 执行 PPR，最终以 Chunk 为产物并通过 RRF 与原 Chunk 召回融合；检索配置改为 dataclass 元数据生成，支持
depend_on控制重排序和图检索参数展示。 - 收紧用户管理部门隔离：普通管理员创建用户时固定归属本部门，用户列表、访问选项、详情、更新和删除接口均限制在本部门范围内。
- 调整 Agent 资源默认选择与运行时上下文：未显式配置工具、知识库、MCP、Skills、SubAgent 时默认启用当前用户可访问/可用的全部资源，显式保存空列表仍表示不启用对应资源；Agent 创建前统一完成最终资源权限过滤、知识库
db_id可见范围派生和 Skill prompt/readable 依赖闭包派生，聊天运行时与文件系统预览复用同一结果。 - 重构 Skills 权限与安装流程：Skill 增加
source_type/share_config/enabled，内置 Skill 作为启动同步入库的全局资源，不再保留前端安装/更新状态，支持启停但不允许删除；上传和远程添加统一为解析草稿后确认生效范围，管理端支持编辑生效范围与启停；Agent 运行时按当前用户可访问 Skills 派生 prompt/readable 依赖闭包并限制挂载/激活。 - 精简历史兼容层：移除 sandbox provisioner
local后端别名、ask_user_question 单问题旧协议、JWT 历史默认密钥特殊判断、内置 SkillSKILLS.md文件名回退、运行事件数字 seq 兼容和前端若干旧字段回退。 - 重构知识库共享权限：
share_config改为全局共享、部门共享、指定人可访问三档，部门共享必须包含当前用户部门，指定人可访问必须包含当前用户，并补充权限过滤测试。 - 移除知识库沙盒文件系统映射：不再通过
/home/gem/kbs暴露知识库文件树，Agent 继续使用query_kb与open_kb_document访问知识库内容。 - 规范 Agent 知识库 Search/Find/Open 工具协议：
resource_id统一表示知识库kb_id，Search 返回结构化resource_id/file_id/chunk结果，新增find_kb_document在已知文件内做关键词或正则定位，Open 默认窗口扩大到 1800 行。 - 收敛知识库分块配置：分块预设仅表达策略选择，通用分块参数统一通过
chunk_parser_config传递；移除chunk_size、chunk_overlap、qa_separator等旧 root 字段兼容。 - 收敛知识库文件解析参数：文件级
processing_params统一保存ocr_engine与ocr_engine_config，解析阶段直接使用该结构并保留分块参数快照。 - 修复知识库文件大小显示为 0 的问题：文件上传时
file_sizes参数未正确传播或历史数据缺失导致 DB 中file_size为None；新增MinIOClient.stat_file/astat_file获取文件大小方法，add_file_record在size缺失时从 MinIO 回补，_load_metadata加载元数据后自动为缺少size的文件从 MinIO 补全并持久化。 - 优化评估基准自动生成：生成任务支持配置队列并发数，默认 10，范围 1-20。
- 重梳理知识库评估存储：评估数据集、题目、评估运行和逐题结果统一入库，JSONL 仅作为导入/导出格式；后端和前端 API 统一使用 dataset/run 语义。
- 扩展知识库上传来源：添加“从工作区上传”模式，后端将当前用户工作区文件预处理上传到 MinIO，前端沿用现有
addDocuments入库链路提交 MinIO URL、内容哈希和文件大小。 - 重构知识库详情页布局：
DatabaseInfo改为顶部详情 header + 左侧功能 tab 侧边栏 + 右侧内容区，Milvus 默认进入文件管理，并将检索测试、知识图谱、知识导图、检索配置、RAG 评估和评估基准统一纳入侧边栏导航；只读连接器保留检索测试与检索配置。 - 整合知识导图接口：移除独立 mindmap router 与前端 API 模块，思维导图生成、查询和文件列表接口统一收敛到知识库 API 下。
- 收敛独立模型配置模块运行时：运行时 chat / embedding / rerank 均统一从 provider 模块与模型缓存读取
provider_id:model_id；旧版静态模型配置、v1 slash spec、旧模型列表接口和 Ollama 适配已移除。 - 调整智能体配置归属与字段权限：
AgentConfig从部门共享改为按uid隔离，所有登录用户可管理自己的配置；BaseContext支持字段级auth元数据，后端按用户角色过滤可见与可保存的配置项。 - 新增用户级沙盒环境变量：增加
agent_envs表与/api/user/agent-env接口，设置面板支持当前用户维护 Agent 沙盒环境变量；创建新沙盒时与全局sandbox.env合并注入，用户变量优先。 - 收敛用户身份命名：原业务登录标识统一改为
uid，Agent/LangGraph runtime、conversation、agent_run、sandbox 路径和前端用户态均使用字符串uid；user_id仅保留给外部响应中的数值users.id或真实外键场景。 - 工作区知识库分类显示：知识库侧边栏按创建者分组为“我的知识库”和“共享知识库”，自己创建的知识库显示在“我的知识库”下，非自己创建的显示在“共享知识库”下；
knowledge_bases表新增created_by字段记录创建者 uid。 - 聊天附件新增 MinIO tmp 临时上传、可选 PDF/图片解析、确认后加入线程附件的流程；前端改为弹窗内上传、解析与确认。
- 标准化 Agent run/SSE 执行链路：run 创建时持久化输入消息并提交后入队，worker 统一写入 Redis Stream envelope，SSE 输出
event/data/id、心跳注释、Last-Event-ID回放和终止end事件；前端强制使用 run API 并支持 ask_user_question 中断后以 resume run 恢复。 - 收敛后端模块边界：文档解析从
plugins.parser移动到knowledge.parser，内容审查从plugins.guard移动到services.guard。 - 收敛文件服务边界：文件预览判断抽为独立服务，Viewer 文件系统的 workspace 分支复用用户 workspace 服务，线程运行时上下文解析从泛化
filesystem_service拆出为 agent runtime helper。 - 优化聊天输入 @ 文件提及：未创建 Thread 时可搜索用户 workspace，创建 Thread 后按当前对话文件优先、workspace 兜底的来源顺序搜索，并拆分 workspace/thread 缓存避免假 thread 与跨用户缓存污染。
历史版本发布记录已迁移到 版本变更记录。
维护说明：
- roadmap 仅保留未来规划（看板/Bugs/里程碑方向）。
- 具体版本发布内容统一维护在 changelog。