CVAT项目中如何强制在标注视图中显示原始质量的图像

在计算机视觉标注工具CVAT的使用过程中，图像质量对于标注精度至关重要。本文将详细介绍如何在CVAT中配置系统，使其始终使用原始质量的图像进行标注工作，而不使用压缩版本。

问题背景

CVAT默认会为标注视图提供压缩版本的图像，以提高加载速度和减少带宽消耗。然而，在某些专业场景下，特别是在本地网络部署时，用户可能需要查看原始质量的图像以确保标注精度。虽然CVAT提供了质量切换功能，但某些用户希望系统始终使用原始质量。

技术实现方案

要实现这一需求，需要修改CVAT的源代码并重新构建Docker镜像。以下是具体步骤：

1. 修改服务器中间件代码

找到并编辑server-proxy.ts文件，将图像获取请求的quality参数固定为'original'：

async function getData(jid: number, chunk: number, quality: ChunkQuality, retry = 0): Promise<ArrayBuffer> {
    const { backendAPI } = config;

    try {
        const response = await (workerAxios as any).get(`${backendAPI}/jobs/${jid}/data`, {
            params: {
                ...enableOrganization(),
                quality: 'original', // 固定为原始质量
                type: 'chunk',
                number: chunk,
            },
            responseType: 'arraybuffer',
        });
        // ...其余代码保持不变
    }
    // ...其余代码保持不变
}

2. 重新构建Docker镜像

修改代码后，必须重新构建Docker镜像才能使更改生效。使用以下命令：

docker compose -f docker-compose.yml -f docker-compose.dev.yml build

3. 重启CVAT服务

构建完成后，重启服务以应用更改：

docker compose down
docker compose up -d

验证更改

完成上述步骤后，可以通过以下方式验证更改是否生效：

1. 登录CVAT并打开一个标注任务
2. 使用浏览器开发者工具检查网络请求
3. 确认图像数据请求的URL中quality参数为"original"

注意事项

1. 此修改将使系统始终请求原始质量图像，不再提供质量切换功能
2. 在带宽有限的网络环境中，这可能导致加载时间增加
3. 对于大型数据集，可能需要考虑服务器的性能影响
4. 此修改仅影响标注视图中的图像显示，不影响实际存储的图像质量

技术原理

CVAT的图像处理系统采用分层架构设计。前端通过中间件服务请求图像数据，后端根据quality参数决定返回原始图像还是压缩版本。通过修改中间件服务的默认参数，我们绕过了前端的质量选择逻辑，直接请求原始图像。这种修改方式保持了系统的其他功能不变，仅改变了图像质量获取策略。

对于需要在本地网络环境中追求最高标注精度的用户，此方案提供了一种简单有效的配置方法。