admin/aiagent
1
0
Fork 0
Code Issues 23 Pull Requests Actions Packages Projects Releases Wiki Activity

chore: 保存笔记本本地未提交改动(源码+新增文件，排除构建缓存/大文件)

Browse Source
This commit is contained in:
renjianbo
2026-07-11 08:58:10 +08:00
parent ad2b899c17
commit 541a08628c
832 changed files with 102878 additions and 1517 deletions
Download Patch File Download Diff File Expand all files Collapse all files

205
docs/天工平台能力评估报告.md
View File

@@ -1,32 +1,32 @@
# 天工智能体平台 能力评估报告
> 评估日期：2026-06-14 | 版本：v1.0
> 评估日期：2026-06-21 | 版本：v1.1
---
## 一、总体评分
| 项目 | 分数 |
|------|:----:|
| **综合评分** | **8.5 / 10** |
| 评级 | 企业级 AI Agent 平台，能力全面且深入 |
| 项目 | 分数 | 变化 |
|------|:----:|:----:|
| **综合评分** | **8.5 / 10** | → |
| 评级 | 企业级 AI Agent 平台，能力全面且深入 | — |
---
## 二、核心能力矩阵
| 维度 | 评分 | 说明 |
|------|:----:|------|
| 记忆系统 | 9.5 | 13/13 能力全覆盖，向量检索+自主学习+全局知识池三项超越 Claude Code |
| 多Agent编排 | 9.0 | 5 种协作模式 + Swarm 蜂群，Graph DAG 双引擎 |
| 工具体系 | 8.5 | 56 个内置工具，11 个类别，支持 HTTP/代码/工作流三种扩展 |
| 工作流引擎 | 8.5 | 15+ 节点类型，可视化拖拽，WebSocket 实时推送 |
| 知识库 | 8.5 | 文档 RAG + 知识图谱双引擎，6 种实体类型 |
| API 完整度 | 8.0 | 37 个路由模块，~241 个端点 |
| 前端成熟度 | 7.5 | 28 个页面，覆盖全生命周期，部分页面深度待加强 |
| 架构与基础设施 | 9.0 | Nginx + FastAPI + Celery + MySQL + Redis + Docker |
| 认证与安全 | 8.0 | JWT 双 Token、CORS、bcrypt、Pydantic 校验、SQLAlchemy 参数化 |
| 扩展性 | 8.5 | 水平扩展、模块化、Alembic 迁移、插件机制 |
| 维度 | 评分 | 变化 | 说明 |
|------|:----:|:----:|------|
| 记忆系统 | 9.5 | — | 13/13 能力全覆盖，向量检索+自主学习+全局知识池 |
| 多Agent编排 | 9.0 | — | 5 种协作模式 + Swarm 蜂群，Graph DAG 双引擎 |
| 工具体系 | 8.5 | — | 56 个内置工具，11 个类别，三种扩展方式 |
| 工作流引擎 | 8.5 | — | 15+ 节点类型，可视化拖拽，WebSocket 实时推送 |
| 知识库 | 8.5 | — | 文档 RAG + 知识图谱双引擎，6 种实体类型 |
| API 完整度 | 8.0 | — | 37 个路由模块，~241 个端点 |
| **前端用户体验** | **8.5** | **+1.0** | 导航重构、暗色模式、反馈闭环、骨架屏、全局搜索 |
| 架构与基础设施 | **9.0** | **+0.5** | 数据库已迁移至本地，双向切换+增量同步方案完备 |
| 认证与安全 | 8.0 | — | JWT 双 Token、CORS、bcrypt、Pydantic 校验 |
| 扩展性 | 8.5 | — | 水平扩展、模块化、Alembic 迁移、插件机制 |
---
@@ -40,38 +40,62 @@
| 前端构建 | Vite | 5+ |
| 状态管理 | Pinia | 2+ |
| 路由 | Vue Router | 4+ |
| HTTP 客户端 | Axios | 1+ |
| UI 组件库 | Element Plus | - |
| 组件库 | Element Plus | 2.4.4 |
| 后端框架 | FastAPI | 0.110+ |
| ORM | SQLAlchemy | 2.0+ |
| 数据验证 | Pydantic | 2+ |
| 数据库 | MySQL (腾讯云) | 8.0+ |
| 数据库 | MySQL 5.7 (本地) | — |
| 缓存/队列 | Redis | 7+ |
| 任务队列 | Celery | 5.3+ |
| 认证 | JWT (Access + Refresh) | - |
| 容器化 | Docker + Docker Compose | - |
| 认证 | JWT (Access + Refresh) | — |
| 容器化 | Docker + Docker Compose | — |
### 架构分层
### 当前部署状态
```
客户端层 (Browser / Mobile)
│
接入层 (Nginx 反向代理, SSL, 静态资源)
│
前端应用层 (Vue 3 SPA, Pinia, Vue Router, Axios)
│
后端服务层 (FastAPI, 中间件, 路由, Service, Model, Schema)
│
┌──────────┴──────────┐
│ │
MySQL 8.0 (腾讯云) Redis 7 (缓存/队列)
持久化存储 │
Celery Worker (异步任务)
本地开发环境 (Windows 11)
├── 前端: localhost:3001 (Vite dev server)
├── API: 127.0.0.1:8037 (Uvicorn)
├── Celery: 后台 worker (线程池, 8 并发)
├── MySQL: localhost:3306 (已从腾讯云 CynosDB 离线迁移)
├── Redis: localhost:6379
└── 数据源: 5 个本地 MySQL 业务库 (food_db/music/pro_db/prompt_db/tishici)
```
---
## 四、记忆系统 (P0-P7)
## 四、前端用户体验 (v1.1 新增)
### 本次更新：2026-06-21
| 类别 | 新增/改进 | 文件 |
|------|----------|------|
| 导航重构 | 5 组下拉菜单替换 22 项水平溢出菜单 | MainLayout.vue |
| 面包屑 | 自动路径追溯、溢出折叠、无障碍 ARIA | BreadcrumbNav.vue |
| 全局搜索 | Ctrl+K 命令面板、模糊搜索、最近记录持久化 | GlobalSearch.vue |
| 暗色模式 | light/dark/auto 三种模式、系统跟随即切换 | stores/theme.ts, styles/dark.css |
| 通知中心 | Bell 图标+未读计数、下拉面板、自动缩略时间 | NotificationCenter.vue |
| 反馈组件 | 浮动 FAB 按钮、4 种反馈类型、API 上报 | FeedbackWidget.vue |
| 骨架屏 | 表格首次加载骨架 (Agents/Home/Executions) | SkeletonTable.vue |
| 空/错误状态 | 可复用占位组件，支持图标/描述/操作按钮 | EmptyState.vue, ErrorState.vue |
| 未保存保护 | onBeforeRouteLeave + beforeunload 双重拦截 | useUnsavedChanges.ts |
| 登录优化 | 渐进式提示 (3 次引导重置密码 / 5 次缩短冷却) | Login.vue |
| 监控统一 | 系统监控 + Agent 监控合并为 Tab 页 | Monitoring.vue |
| 功能精简 | 移除 Agent协作（与虚拟团队功能重合） | router/index.ts, MainLayout.vue |
| 数据库管理 | 数据源接入页面+API，支持 MySQL/PG/API/JSON | DataSources.vue |
### 前端组件清单
| 类型 | 数量 | 明细 |
|------|:----:|------|
| 页面视图 | 28 | — |
| 公共组件 | 9 | BreadcrumbNav, GlobalSearch, NotificationCenter, FeedbackWidget, SkeletonTable, EmptyState, ErrorState, PromptTemplatePicker, AgentChatPreview |
| Composables | 6 | useUnsavedChanges, useCollaboration, useWebSocket, usePWA, useSpeechRecognition, useTTS |
| Pinia Stores | 6 | user, agent, workflow, execution, theme, modelConfig |
---
## 五、记忆系统 (P0-P7)
### 记忆栈架构
@@ -98,16 +122,16 @@ MySQL 8.0 (腾讯云) Redis 7 (缓存/队列)
### 7 项改进详情
| 编号 | 改进 | 文件 | 说明 |
|:----:|------|------|------|
| P0 | 记忆分类 | memory.py, schemas.py | user / feedback / project / reference 四类自动分类 |
| P1 | 压缩摘要向量化 | memory.py | LLM 压缩结果向量化写入，可被语义检索 |
| P2 | LLM Rerank | memory.py | 向量粗筛 → LLM 精选 (DeepSeek-V4)，提升检索精度 |
| P3 | 后台异步提取 | memory.py | fire-and-forget 异步压缩，不阻塞对话响应 |
| P4 | Auto Dream | auto_dream_service.py | 凌晨 3:00 触发，合并相似记忆 (>85%)，生成每日摘要 |
| P5 | 离线关键词兜底 | embedding_service.py, memory.py | Embedding API 不可用时降级为 Jaccard 关键词匹配 |
| P6 | 团队共享记忆 | memory.py, schemas.py, core.py | team_id 机制，记忆自动发布到团队池 |
| P7 | 文件式记忆 | file_memory_service.py, memory.py | MEMORY.md + YAML frontmatter，完全离线可用 |
| 编号 | 改进 | 说明 |
|:----:|------|------|
| P0 | 记忆分类 | user / feedback / project / reference 四类自动分类 |
| P1 | 压缩摘要向量化 | LLM 压缩结果向量化写入，可被语义检索 |
| P2 | LLM Rerank | 向量粗筛 → LLM 精选 (DeepSeek-V4)，提升检索精度 |
| P3 | 后台异步提取 | fire-and-forget 异步压缩，不阻塞对话响应 |
| P4 | Auto Dream | 凌晨 3:00 触发，合并相似记忆 (>85%)，生成每日摘要 |
| P5 | 离线关键词兜底 | Embedding API 不可用时降级为 Jaccard 关键词匹配 |
| P6 | 团队共享记忆 | team_id 机制，记忆自动发布到团队池 |
| P7 | 文件式记忆 | MEMORY.md + YAML frontmatter，完全离线可用 |
### vs Claude Code 记忆对比
@@ -119,7 +143,7 @@ MySQL 8.0 (腾讯云) Redis 7 (缓存/队列)
| LLM Rerank | DeepSeek-V4 精选 | 无 | **天工** |
| 后台异步压缩 | fire-and-forget | 有 | 持平 |
| Auto Dream 每日整合 | 有 | 无 | **天工** |
| 离线兜底 | 关键词匹配 | 无 (不可离线) | **天工** |
| 离线兜底 | 关键词匹配 | 无 | **天工** |
| 团队共享 | team_id 机制 | 无 | **天工** |
| 文件式记忆 | MEMORY.md | MEMORY.md | 持平 |
| 自主学习模式 | 工具调用模式学习 | 无 | **天工** |
@@ -129,7 +153,7 @@ MySQL 8.0 (腾讯云) Redis 7 (缓存/队列)
---
## 五、多 Agent 编排能力
## 六、多 Agent 编排能力
### 5 种协作模式 (AgentOrchestrator)
@@ -156,7 +180,7 @@ MySQL 8.0 (腾讯云) Redis 7 (缓存/队列)
---
## 六、工具体系
## 七、工具体系
### 56 个内置工具，11 个类别
@@ -179,10 +203,11 @@ MySQL 8.0 (腾讯云) Redis 7 (缓存/队列)
- HTTP 工具：动态注册外部 API
- 代码工具：沙箱执行（禁用 `__builtins__`）
- 工作流工具：封装为可调用工具
- 自定义工具：20 个已注册（数据库加载）
---
## 七、工作流引擎
## 八、工作流引擎
### 节点类型 (15+)
@@ -192,6 +217,7 @@ start, input, output, end, llm, template, agent, condition, loop, transform, dat
- 可视化拖拽设计器（Vue Flow）
- 条件分支、循环节点
- 未保存变更保护（beforeunload + route guard）
- 模板导入/导出
- WebSocket 实时推送执行进度
- 节点级测试功能
@@ -201,7 +227,7 @@ start, input, output, end, llm, template, agent, condition, loop, transform, dat
---
## 八、知识库能力
## 九、知识库能力
| 能力 | 实现 |
|------|------|
@@ -218,22 +244,22 @@ start, input, output, end, llm, template, agent, condition, loop, transform, dat
---
## 九、前端页面 (28个)
## 十、前端页面 (28页)
| 模块 | 页面 |
|------|------|
| 主控台 | MainConsole, Home |
| Agent 管理 | Agents, AgentConfig, AgentChat, AgentDashboard, AgentOrchestration, AgentMarket, AgentSchedules |
| Agent 管理 | Agents, AgentConfig, AgentChat, AgentDashboard, AgentMarket, AgentSchedules |
| 工作流 | WorkflowDesigner, Executions, ExecutionDetail, ExecutionBoard |
| 知识/工具 | KnowledgeDashboard, Tools, DataSources |
| 模板/插件 | TemplateMarket, PluginMarket, NodeTemplates |
| 监控/日志 | Monitoring, AlertRules, SystemLogs |
| 监控/日志 | Monitoring (系统+Agent合并), AlertRules, SystemLogs |
| 用户/权限 | Login, PermissionManagement, ModelConfigs |
| 创新功能 | DigitalEmployeeFactory, DigitalTwin, GoalDetail |
---
## 十、API 端点
## 十一、API 端点
### 37 个路由模块，~241 个端点
@@ -241,54 +267,65 @@ start, input, output, end, llm, template, agent, condition, loop, transform, dat
---
## 十一、代码规模
## 十二、代码规模
| 层级 | 数量 |
|------|------|
|------|:----:|
| 后端 Service 模块 | ~70 个 |
| Agent 运行时模块 | 12 个 |
| 核心基础设施模块 | 22 个 |
| 前端源文件 | 50 个 |
| 前端代码量 | ~31,742 行 |
| 前端页面 | 28 个 |
| 前端公共组件 | 9 个 |
| 前端 Composables | 6 个 |
| Pinia Stores | 6 个 |
| API 路由模块 | 37 个 |
| API 端点 | ~241 个 |
| 内置工具 | 56 个 |
| 自定义工具 | 20 个 |
| 数据源 | 5 个 (本地 MySQL) |
---
## 十二、亮点与优势
## 十三、数据规模
1. **记忆系统行业领先**：7 轮改进 (P0-P7)，13/13 能力全覆盖，向量检索+自主学习+全局知识池三项超越 Claude Code
| 实体 | 数量 |
|------|:----:|
| 用户 | 45 |
| Agent | 44 |
| 工作流 | 20 |
| 团队 | 67 |
| 执行记录 | 672 |
| 工作区 | 1 (默认) |
| 数据库体积 | ~210 MB |
---
## 十四、亮点与优势
1. **记忆系统行业领先**：7 轮改进 (P0-P7)，13/13 能力全覆盖，向量检索+自主学习+全局知识池
2. **多 Agent 编排业界领先**：5+4 种协作模式，Graph DAG + Swarm 蜂群双引擎
3. **工具体系完整**：56 个内置工具覆盖 11 个领域，支持三种扩展方式
4. **生产级架构**：JWT 双 Token、Celery 异步、WebSocket 实时推送、Docker 一键部署
5. **飞书深度集成**：7 个飞书工具（文档/审批/通讯录/通知等）
6. **知识库双引擎**：文档 RAG + 知识图谱融合检索
7. **全面测试覆盖**：99 个记忆系统测试用例，覆盖 P0-P7 所有改进
3. **工具体系完整**：56 内置 + 20 自定义工具，覆盖 11 个领域
4. **前端体验成熟**：暗色模式、全局搜索、通知中心、反馈闭环、骨架屏、未保存保护
5. **生产级架构**：JWT 双 Token、Celery 异步、WebSocket 实时推送
6. **飞书深度集成**：7 个飞书工具 + 6 个独立飞书机器人
7. **知识库双引擎**：文档 RAG + 知识图谱融合检索
8. **离线自托管**：数据库完全本地化，不依赖云服务
9. **全面测试覆盖**：99 个记忆系统测试用例，100% 通过
---
## 十三、待提升领域
## 十五、待提升领域
| 领域 | 当前状态 | 建议 |
|------|---------|------|
| 团队记忆跨服务器同步 | 仅本地共享 | 实现 push/pull 远程同步 |
| 子 Agent 记忆提取 | fire-and-forget | 深层结构化提取 |
| 前端部分页面深度 | 28页，部分较薄 | 增强数据分析和可视化 |
| 文档完整度 | 约 55% | 补充 API 文档和使用手册 |
| 移动端适配 | 仅 PC Web | 开发移动端 App 或 PWA 增强 |
| 国际化 | 仅中文 | 引入 vue-i18n，支持中英文 |
| 数据可视化 | 基础图表 | 增加 Agent 分析仪表盘 |
| 文档完整度 | ~60% | 补充 API 文档和使用手册 |
| 离线语义理解 | 关键词匹配 | 考虑本地小模型 embedding |
| CI/CD | 手动部署 | 引入 GitHub Actions 自动化 |
| 单元测试 | 仅记忆系统 | 扩展至 API 和工作流引擎 |
---
## 十四、测试验证
| 测试套件 | 用例数 | 通过率 |
|----------|:------:|:------:|
| 基础功能测试 (test_memory_system.py) | 18 | 100% |
| 高级边界测试 (test_memory_advanced.py) | 43 | 100% |
| pytest 单元测试 (agent_memory + embedding) | 38 | 100% |
| **合计** | **99** | **100%** |
---
> 最后更新：2026-06-14 | 由天工 Agent 自动评估生成
> 最后更新：2026-06-21 | 基于实际项目文件与数据库统计自动生成