## 新增功能 - 文件管理模块:分类树 + 文件上传/下载/删除 - 文件上传支持拖拽(Dragger)+ 手动上传(customRequest 模式) ## 页面布局统一(参照评测执行页) - 仪表盘/评测对象/评测场景/评测报告 全部改为全高 flex 布局 - 统一内联页头样式(h2 + 竖线分隔 + 描述) - 表格撑满高度、overflow 处理 - 每页添加刷新按钮 ## Bug 修复 - 分类树操作按钮 hover 不可见(CSS 规则缺失) - 文件上传失败(multipart boundary 缺失) - LLM API 响应 content blocks 数组格式支持(_extract_content_from_api_response) - response_time_max_ms 被静默忽略(隐式规则传空 params) - 空 messages 导致 IndexError 崩溃 - poll_reply 异常中止整个 run(缺 try/catch) - engine finally 未关闭 session - 3 个页面 UTC 时间戳解析偏差 8 小时 ## 后端 - EvalEngine: poll_reply 异常保护、空 dialog 保护、session 关闭 - LLM API 响应解析支持 content-block-array 格式 - 隐式 response_time 规则正确传递 max_ms 参数 ## 前端 - api.ts: 移除手动 Content-Type(让浏览器自动添加 boundary) - Files.tsx: customRequest 替代 beforeUpload、布局优化 - index.css: 分类树 hover 规则 - Targets/Scenarios/Home/Reports: 全高布局改造 - 3 个页面时间戳改用 formatDateTime()(修复 UTC 偏差) Co-Authored-By: Claude <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| api-reference | ||
| deployment | ||
| external-references/tutu-api | ||
| guides | ||
| architecture-v1.0.md | ||
| data-models-v1.0.md | ||
| dev-log-20260715.md | ||
| evaluation-workflow.md | ||
| README.md | ||
| release-notes-v0.2.md | ||
| release-notes-v1.1.md | ||
| requirements-v1.0.md | ||
AgentEvalTool 文档索引
版本: v1.0
日期: 2026-07-09
状态: 已发布
作者: AgentEval Team
一、简介
AgentEvalTool 是一个智能体质量评估工具集平台,用于评估 AI 数字员工(大模型 + RAG)和 AI 助手(OpenClaw)的服务质量、效率与安全性。
本文档集提供完整的项目文档,包括需求分析、架构设计、API 参考、部署指南和使用指南。
二、文档目录
2.1 核心文档
| 文档 | 说明 | 链接 |
|---|---|---|
| 需求分析 | 项目背景、功能需求、验证标准 | requirements-v1.0.md |
| 架构设计 | 系统架构、核心抽象、项目结构 | architecture-v1.0.md |
| 数据模型 | 数据库表结构、模型关系 | data-models-v1.0.md |
2.2 API 参考
| 文档 | 说明 | 链接 |
|---|---|---|
| CLI 命令参考 | 所有 CLI 命令的详细用法 | api-reference/cli-v1.0.md |
| Web API 参考 | REST API 接口文档 | api-reference/web-api-v1.0.md |
2.3 部署文档
| 文档 | 说明 | 链接 |
|---|---|---|
| 部署概览 | 部署方式、环境要求、运维指南 | deployment/README.md |
| t480 部署指南 | t480 测试服务器具体部署步骤 | deployment/t480-v1.0.md |
2.4 使用指南
| 文档 | 说明 | 链接 |
|---|---|---|
| 快速开始 | 5 分钟完成首次评测 | guides/quick-start-v1.0.md |
| 用户使用指南 | 详细功能说明和最佳实践 | guides/user-guide-v1.0.md |
2.5 版本发布说明
| 文档 | 说明 | 链接 |
|---|---|---|
| V1.1 发布说明 | 前端重构、后端增强、关键 Bug 修复 | release-notes-v1.1.md |
| V0.2 发布说明 | async 引擎、安全基线、测试基线、部署规范化 | release-notes-v0.2.md |
2.6 开发日志
| 文档 | 说明 | 链接 |
|---|---|---|
| 2026-07-15 评测执行页改版 | 布局修复、Tab 滚动、时区 Bug、时间过滤、UI 全面改版 | dev-log-20260715.md |
2.6 外部参考
| 文档 | 说明 | 位置 |
|---|---|---|
| tutu-api 参考 | tutu-api 接口文档 | docs/external-references/tutu-api/ |
三、快速导航
3.1 我是新用户
3.2 我是开发者
- 阅读 架构设计文档 了解系统设计
- 阅读 数据模型文档 了解数据结构
- 参考 CLI 命令参考 和 Web API 参考
- 查看源代码和测试用例
3.3 我是运维人员
3.4 我要集成 OpenClaw
四、版本说明
- 当前版本: v0.2.0-dev
- 发布日期: 2026-07-14
- 状态: 开发中(t480 开发线运行)
所有文档均标注版本号,便于追踪和管理。版本发布说明见 release-notes-v1.1.md。
五、文档规范
5.1 版本管理
- 文件名包含版本号(如
architecture-v1.0.md) - 文档头部包含版本元数据
- 重大变更时更新版本号
5.2 文档结构
每个文档包含:
- 版本元数据(版本、日期、状态、作者)
- 清晰的章节结构
- 代码示例和配置说明
- 故障排查和最佳实践
5.3 更新流程
- 修改文档内容
- 更新版本号和日期(如有必要)
- 更新本文档索引(如有新增文档)
- 提交代码审查
六、反馈与支持
如有文档问题或建议:
- 提交 Issue
- 联系 AgentEval Team
最后更新: 2026-07-15