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

4.3 KiB

Raw Blame History

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 我是运维人员

阅读部署概览
参考具体服务器的部署指南（如 t480 部署指南）
了解日常运维和故障排查

3.4 我要集成 OpenClaw

阅读架构设计文档的 OpenClaw 集成章节
参考 CLI 命令参考的 OpenClaw 集成示例
查看 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 更新流程

修改文档内容
更新版本号和日期（如有必要）
更新本文档索引（如有新增文档）
提交代码审查

六、反馈与支持

如有文档问题或建议：

提交 Issue
联系 AgentEval Team

最后更新: 2026-07-15

4.3 KiB Raw Blame History Unescape Escape