Repository navigation
v2.3.0
Added - AI Agent 全面升级 🚀
核心架构重构
-
Agent 引擎全面重构(agentEngine.ts)
- 采用 ReAct 架构(Reason → Act → Observe → Reason...)
- 支持多轮推理和链式工具调用
- 智能意图识别与工具选择矩阵
- 视觉意图检测与自动链式调用
- 循环防护机制(调用签名去重 + 空转检测)
- 写操作确认机制(敏感操作需用户确认)
-
工具数量大幅扩展(95 个工具)
- 从 v2.2.0 的 4 个工具扩展到 95 个
- 分为 13 个功能模块:
- 🔍 搜索与发现(7 个):search_files, filter_files, search_by_tag, search_duplicates, smart_search, get_similar_files, get_file_details
- 📄 内容理解与分析(7 个):read_file_text, analyze_image, compare_files, extract_metadata, generate_summary, generate_tags, content_preview
- 📂 目录导航(7 个):navigate_path, list_folder, get_recent_files, get_starred_files, get_parent_chain, get_folder_tree, get_storage_overview
- 📊 统计与分析(5 个):get_storage_stats, get_activity_stats, get_user_quota_info, get_file_type_distribution, get_sharing_stats
- 📁 文件操作(15 个):create_text_file, create_code_file, create_file_from_template, edit_file_content, append_to_file, find_and_replace, rename_file, move_file, copy_file, delete_file, restore_file, create_folder, batch_rename, star_file, unstar_file
- 🏷️ 标签管理(7 个):add_tag, remove_tag, get_file_tags, list_all_tags_for_management, merge_tags, tag_folder, auto_tag_files
- 🔗 分享链接(8 个):create_share_link, list_shares, update_share_settings, revoke_share, get_share_stats, create_direct_link, revoke_direct_link, create_upload_link_for_folder
- 📜 版本管理(4 个):get_file_versions, restore_version, compare_versions, set_version_retention
- 📝 笔记备注(5 个):add_note, get_notes, update_note, delete_note, search_notes
- 🔐 权限管理(6 个):get_file_permissions, grant_permission, revoke_permission, set_folder_access_level, list_user_groups, manage_group_members
- 💾 存储桶管理(8 个):get_storage_usage, get_large_files, get_folder_sizes, get_cleanup_suggestions, list_buckets, get_bucket_info, set_default_bucket, migrate_file_to_bucket
- ⚙️ 系统管理(11 个):get_system_status, get_help, get_version_info, get_faq, get_user_profile, list_api_keys, create_api_key, revoke_api_key, list_webhooks, create_webhook, get_audit_logs
- 🤖 AI 增强(5 个):trigger_ai_summary, trigger_ai_tags, rebuild_vector_index, ask_rag_question, smart_rename_suggest
智能化提升
-
意图识别系统
- 自动识别搜索类、视觉类、内容理解类、统计类意图
- 根据意图精准选择工具
- 搜索关键词提取优化(2-5 个核心词)
-
链式推理规则
- 工具结果中的
_next_actions字段驱动下一步行动 - 图片搜索结果自动触发 analyze_image 链路
- 视觉意图检测模式匹配(中英文)
- 工具结果中的
-
循环防护机制
- 基于调用签名(工具名+参数哈希)去重
- 基于"有效信息轮"计数的空转检测
- 单次响应最大 20 次工具调用(可配置)
- 无上限次数限制替代死板的轮次限制
写操作确认机制
- 敏感操作(删除、移动、权限变更等)需用户确认
- 确认请求存储在
ai_confirm_requests表 - 5 分钟有效期,一次性使用
- 前端展示确认卡片,用户点击后执行
SSE 流式响应增强
- 新增
confirm_request事件类型 - 工具调用结果包含操作摘要
- 推理内容实时显示
前端改进
-
ToolCallCard 组件增强
- 支持确认请求卡片渲染
- 显示操作摘要和参数
- 确认/取消按钮
-
ChatMessageBubble 组件增强
- 支持 83 个工具的调用显示
- 工具结果格式化渲染
- 文件引用解析和渲染
后端改进
-
agentTools/index.ts
- 统一的工具注册和路由
- 工具名称相似度匹配
- 按类别获取工具列表
-
agentTools/types.ts
- 工具定义类型
- 写操作标记集合(WRITE_TOOLS)
- 文件记录类型
-
agentEngine.ts
- ReAct 循环实现
- Native Tool Calling 和 Prompt-Based 双模式
- 自动链式调用逻辑
- 历史消息裁剪
数据库变更
- 新增迁移文件
0011_ai_confirm_requests.sql- ai_confirm_requests 表:写操作确认请求存储
新文件
后端:
apps/api/src/lib/ai/agentTools/index.ts- 工具统一入口apps/api/src/lib/ai/agentTools/types.ts- 工具类型定义apps/api/src/lib/ai/agentTools/search.ts- 搜索工具模块apps/api/src/lib/ai/agentTools/content.ts- 内容理解工具模块apps/api/src/lib/ai/agentTools/navigation.ts- 导航工具模块apps/api/src/lib/ai/agentTools/stats.ts- 统计工具模块apps/api/src/lib/ai/agentTools/fileops.ts- 文件操作工具模块apps/api/src/lib/ai/agentTools/tags.ts- 标签管理工具模块apps/api/src/lib/ai/agentTools/share.ts- 分享链接工具模块apps/api/src/lib/ai/agentTools/version.ts- 版本管理工具模块apps/api/src/lib/ai/agentTools/notes.ts- 笔记备注工具模块apps/api/src/lib/ai/agentTools/permission.ts- 权限管理工具模块apps/api/src/lib/ai/agentTools/storage.ts- 存储桶管理工具模块apps/api/src/lib/ai/agentTools/system.ts- 系统管理工具模块apps/api/src/lib/ai/agentTools/ai-enhance.ts- AI 增强工具模块apps/api/src/lib/ai/agentTools/agentToolUtils.ts- 工具通用工具函数
Changed
- AI_FEATURES.md 文档更新至 v2.3.0
- API_AI.md 文档更新至 v2.3.0
- README.md 版本号更新至 v2.3.0
- architecture.md 架构文档更新
Fixed
- 修复 Agent 循环调用问题
- 修复视觉分析超时问题
- 优化工具调用去重逻辑
- 改进搜索无结果时的处理策略