# 智能体平台功能完善清单

> 基于《智能体平台功能清单》需求文档，对比项目当前实现状态制定
>
> 最后更新：2026-05-19

---

## 一、需求 vs 现状对照

| 序号 | 模块 | 功能点 | 状态 | 优先级 | 备注 |
|:----:|------|--------|:----:|:------:|------|
| 1 | 基础配置 | 模型接入（公域/私域） | ✅ | - | 24家Provider + OpenAI Compatible |
| 2 | 基础配置 | 工具配置（三方工具/API Key） | ✅ | - | 6种工具类型 + MCP集成 |
| 3 | 基础配置 | （需求文档空项） | - | - | - |
| 4 | 系统管理 | 用户管理 | ✅ | - | 完整CRUD + 多种认证方式 |
| 5 | 系统管理 | 角色管理 | ✅ | - | 3种角色 + 细粒度权限 |
| 6 | 系统管理 | 资源授权（智能体/工具/模型） | ✅ | - | 工作空间级资源授权 |
| 7 | 系统管理 | （需求文档空项） | - | - | - |
| 8 | 知识库管理 | 通用知识库 | ✅ | - | 文档/表格/QA/向量检索 |
| 9 | 知识库管理 | 工作流知识库 | ✅ | - | 工作流编排 + 数据入库 |
| 10 | 知识库管理 | 知识库检索 | ✅ | - | 语义检索 + 相似度阈值 |
| 11 | 知识库管理 | 专业知识库 | ✅ | P0 | 样本中心API对接 + 前端UI已完成 |
| 12 | 智能体管理 | 简单智能体 | ✅ | - | SIMPLE模式对话 |
| 13 | 智能体管理 | 高级智能体 | ✅ | P0 | 工作流 + 智能体记忆已完成 |
| 14 | 智能体管理 | 智能体管理 | ✅ | - | 全生命周期 + 版本管理 |
| 15 | 智能体管理 | 工作流管理 | ✅ | - | 可视化画布 + 30+节点 |
| 16 | 智能体管理 | 智能体发布 | ✅ | P0 | 白名单 + 嵌入 + 访问控制已完成 |
| 17 | 智能体管理 | Skills技能 | ✅ | - | SKILL工具类型已支持 |
| 18 | 插件管理 | 插件注册封装 | ✅ | P1 | 独立插件模块已实现 |
| 19 | 插件管理 | 插件日常管理 | ✅ | P1 | 启用/禁用/卸载/重装已实现 |
| 20 | 插件管理 | 插件测试验证与版本控制 | ✅ | P1 | 标准错误码 + 异常分类已实现 |

**统计**：✅ 已完成 17 项 | ⬜ 空项 2 项 | 🔧 新增增强 3 项（知识库统计、应用限流、用户组授权）

---

## 二、优先级定义

- **P0（核心）**：必须完成，直接影响核心业务流程
- **P1（重要）**：应该完成，提升平台完整性和可维护性
- **P2（增强）**：可以完成，锦上添花的功能

---

## 三、详细任务清单

### P0 - 核心功能

#### 任务 1：专业知识库打通样本中心
- [x] 后端：新增专业知识库类型枚举（`apps/knowledge/models/`）— `SAMPLE_CENTER = 5`
- [x] 后端：新增样本中心 API 客户端（`apps/knowledge/services/sample_center_client.py`）
- [x] 后端：新增样本中心对接视图（`apps/knowledge/views/sample_center.py`）
- [x] 后端：新增样本中心路由（`apps/knowledge/urls.py`）
- [x] 前端：新增样本中心 API 调用（`ui/src/api/knowledge/sample-center.ts`）
- [x] 前端：新增样本中心知识库创建对话框（`ui/src/views/knowledge/create-component/CreateSampleCenterKnowledgeDialog.vue`）
- [x] 验证：枚举导入 ✅ | 模块导入 ✅ | 路由注册 ✅ | API 端点响应 ✅

#### 任务 2：智能体记忆功能
- [x] 后端：新增 ApplicationMemory 模型（`apps/application/models/`）
- [x] 后端：新增记忆 CRUD API（`apps/application/views/`）
- [x] 后端：新增记忆服务（`apps/application/services/`）
- [x] 后端：新增数据库迁移并应用
- [x] 前端：新增记忆 API（`ui/src/api/application/memory.ts`）
- [x] 前端：新增记忆配置组件（`ui/src/views/application/component/MemorySettingDialog.vue`）
- [x] 验证：模块导入 ✅ | 路由注册 ✅ | 数据库迁移 ✅ | API 端点响应 ✅

#### 任务 3：智能体发布权限控制增强
- [x] 后端：发布权限配置字段已存在于 ApplicationAccessToken 模型（white_active, white_list, authentication）
- [x] 后端：发布 API 已支持白名单（通过 AccessToken 管理）
- [x] 前端：发布设置 UI 已实现（LimitDialog.vue + XPackLimitDrawer.vue）
- [x] 验证：白名单功能已实现 ✅ | 嵌入功能已实现（EmbedDialog.vue）✅ | 访问控制已实现 ✅

---

### P1 - 重要功能

#### 任务 4：插件管理模块 - 注册封装
- [x] 后端：新建 Plugin 模型（`apps/plugin/models/plugin.py`）
- [x] 后端：新建 PluginVersion 模型（`apps/plugin/models/plugin_version.py`）
- [x] 后端：实现插件注册服务（`apps/plugin/services/plugin_registry.py`）
- [x] 后端：实现插件 CRUD API（`apps/plugin/views/plugin_view.py`）
- [x] 后端：新增数据库迁移并应用
- [x] 前端：新增插件 API（`ui/src/api/plugin/plugin.ts`）
- [x] 前端：新建插件列表页（`ui/src/views/plugin/index.vue`）
- [x] 前端：新建插件卡片组件（`ui/src/views/plugin/component/PluginCard.vue`）
- [x] 前端：新建创建插件对话框（`ui/src/views/plugin/component/CreatePluginDialog.vue`）
- [x] 前端：新增插件路由（`ui/src/router/modules/plugin.ts`）
- [x] 验证：模块导入 ✅ | 路由注册 ✅ | 数据库迁移 ✅ | API 端点响应 ✅

#### 任务 5：插件管理模块 - 生命周期管理
- [x] 后端：实现插件启用/禁用 API（`apps/plugin/views/plugin_view.py`）
- [x] 后端：实现插件卸载/重装 API（`apps/plugin/views/plugin_view.py`）
- [x] 前端：实现插件状态切换 UI（`ui/src/views/plugin/component/PluginCard.vue`）
- [x] 前端：实现插件卸载确认弹窗（`ui/src/views/plugin/index.vue`）
- [x] 验证：所有生命周期 API 端点返回 401（需认证），路由正确

#### 任务 6：插件测试验证与版本控制
- [x] 后端：新增 PluginTest 模型（`apps/plugin/models/plugin_test.py`）
- [x] 后端：实现插件测试服务（`apps/plugin/services/plugin_validator.py`）
- [x] 后端：定义标准化错误码体系（`apps/plugin/services/error_codes.py`）
- [x] 后端：实现适配异常分类（`apps/plugin/services/exception_handler.py`）
- [x] 后端：实现版本管理 API（`apps/plugin/views/plugin_test_view.py`）
- [x] 前端：新建插件测试抽屉（`ui/src/views/plugin/component/PluginTestDrawer.vue`）
- [x] 前端：新建版本历史组件（`ui/src/views/plugin/component/VersionHistory.vue`）
- [x] 验证：所有测试和版本管理 API 端点返回 401（需认证），路由正确

#### 任务 7：模型批量操作 API
- [x] 后端：实现批量删除端点（`apps/models_provider/views/model.py`）
- [x] 后端：实现批量启用/禁用端点（`apps/models_provider/views/model.py`）
- [x] 前端：模型列表页添加批量操作按钮
- [x] 验证：批量删除模型 → 批量禁用模型

#### 任务 8：工具使用统计分析
- [x] 后端：新增统计 API（`apps/tools/views/tool.py`）
- [x] 后端：实现调用次数、成功率、耗时统计
- [x] 前端：新增统计面板（`ui/src/views/tool/`）
- [x] 验证：调用工具 → 查看统计面板

---

### P2 - 增强功能

#### 任务 8.5：SSO 统一认证接入
- [x] 后端：新建 SSO 客户端（`apps/sso/services/sso_client.py`）
- [x] 后端：新建 SSO 视图（`apps/sso/views/sso_view.py`）
- [x] 后端：新增 SSO 路由（`apps/sso/urls.py`）
- [x] 前端：新增 SSO API（`ui/src/api/sso.ts`）
- [x] 前端：新增 SSO 回调页面（`ui/src/views/sso/SSOCallback.vue`）
- [x] 前端：新增 SSO 回调路由（`/auth/callback`）
- [x] 验证：模块导入 ✅ | 路由注册 ✅ | API 端点响应 ✅ | 待配置真实 SSO 服务端联调

#### 任务 9：知识库用量统计 API
- [x] 后端：新增知识库统计端点（`apps/knowledge/views/knowledge.py`）
- [x] 前端：知识库 API 添加统计接口（`ui/src/api/knowledge/knowledge.ts`）
- [x] 验证：API 端点响应 401（未认证），路由注册正确

#### 任务 10：应用 API 调用限流
- [x] 后端：新增限流配置模型（`apps/application/models/rate_limit.py`）
- [x] 后端：实现限流中间件（`apps/application/middleware/rate_limit.py`）
- [x] 前端：新增限流配置 API（`ui/src/api/application/rate_limit.ts`）
- [x] 验证：所有限流 API 端点返回 401（需认证），路由正确

#### 任务 11：用户组批量授权增强
- [x] 后端：基于已有 system_manage.UserGroup 模型扩展批量授权功能
- [x] 后端：实现批量授权 API（`apps/users/views/user_group_view.py`）
- [x] 前端：新增用户组 API（`ui/src/api/users/user_group.ts`）
- [x] 验证：所有用户组 API 端点返回 401（需认证），路由正确

---

## 四、验收标准

### 功能验收
- [ ] 专业知识库能从样本中心导入数据并检索
- [ ] 智能体记忆能持久化存储和读取
- [ ] 智能体发布支持白名单和嵌入控制
- [ ] 插件能注册、启用、禁用、卸载、重装
- [ ] 插件测试能覆盖异常场景并返回标准错误码
- [ ] 模型能批量删除和批量禁用
- [ ] 工具使用统计能展示调用次数和成功率

### 技术验收
- [x] `python manage.py migrate` 成功
- [x] `npm run build:admin` 构建成功
- [x] `docker-compose up --build` 所有服务正常
- [x] 所有新 API 端点返回正确响应（401 需认证）
- [ ] 所有新页面 UI 渲染正常（待浏览器测试）

---

## 五、开发顺序建议

```
Phase 1（1-2天）：P0 任务 1-3（专业知识库、智能体记忆、发布权限）
    ↓
Phase 2（3-5天）：P1 任务 4-6（插件管理模块核心）
    ↓
Phase 3（1-2天）：P1 任务 7-8（模型批量操作、工具统计）
    ↓
Phase 4（按需）：P2 任务 9-11（增强功能）
```

---

## 六、技术栈参考

| 层次 | 技术 |
|------|------|
| 前端 | Vue 3 + TypeScript + Element Plus + Vite |
| 后端 | Django 5.2 + DRF + drf-spectacular |
| 数据库 | PostgreSQL 16 + pgvector |
| 缓存/消息 | Redis 7 |
| 任务队列 | Celery 5.5 + django-celery-beat |
| AI 框架 | LangChain + LangGraph |
| 部署 | Docker Compose + Nginx |

---

*本文档由 Claude 自动生成，基于需求文档分析和项目现状评估*