AgentEvalTool/docs
sinohqb a77cd83e6a v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复
## 新增功能
- 文件管理模块:分类树 + 文件上传/下载/删除
- 文件上传支持拖拽(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>
2026-07-16 15:25:22 +08:00
..
api-reference v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00
deployment v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00
external-references/tutu-api v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00
guides v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00
architecture-v1.0.md v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00
data-models-v1.0.md v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00
dev-log-20260715.md v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00
evaluation-workflow.md v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00
README.md v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00
release-notes-v0.2.md v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00
release-notes-v1.1.md v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00
requirements-v1.0.md v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00

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 我是新用户

  1. 阅读 快速开始指南
  2. 安装并配置项目
  3. 完成首次评测
  4. 阅读 用户使用指南 了解更多功能

3.2 我是开发者

  1. 阅读 架构设计文档 了解系统设计
  2. 阅读 数据模型文档 了解数据结构
  3. 参考 CLI 命令参考 和 Web API 参考
  4. 查看源代码和测试用例

3.3 我是运维人员

  1. 阅读 部署概览
  2. 参考具体服务器的部署指南(如 t480 部署指南)
  3. 了解日常运维和故障排查

3.4 我要集成 OpenClaw

  1. 阅读 架构设计文档 的 OpenClaw 集成章节
  2. 参考 CLI 命令参考 的 OpenClaw 集成示例
  3. 查看 backend/plugins/openclaw/ 目录的插件示例

四、版本说明

  • 当前版本: v0.2.0-dev
  • 发布日期: 2026-07-14
  • 状态: 开发中(t480 开发线运行)

所有文档均标注版本号,便于追踪和管理。版本发布说明见 release-notes-v1.1.md。

五、文档规范

5.1 版本管理

  • 文件名包含版本号(如 architecture-v1.0.md)
  • 文档头部包含版本元数据
  • 重大变更时更新版本号

5.2 文档结构

每个文档包含:

  • 版本元数据(版本、日期、状态、作者)
  • 清晰的章节结构
  • 代码示例和配置说明
  • 故障排查和最佳实践

5.3 更新流程

  1. 修改文档内容
  2. 更新版本号和日期(如有必要)
  3. 更新本文档索引(如有新增文档)
  4. 提交代码审查

六、反馈与支持

如有文档问题或建议:

  • 提交 Issue
  • 联系 AgentEval Team

最后更新: 2026-07-15