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

在计算机视觉标注工具CVAT的实际应用中，图像质量对于标注精度至关重要。许多开发者在使用CVAT进行本地部署时，希望直接使用原始质量的图像进行标注工作，而不需要压缩质量选项。本文将详细介绍如何通过修改CVAT源代码实现这一需求。

问题背景

CVAT默认提供了图像质量切换功能，允许用户在"原始质量"和"压缩质量"之间选择。然而，在某些专业场景下，特别是当CVAT部署在本地网络环境中时，网络带宽不再是限制因素，开发者可能希望始终使用原始质量的图像以获得最佳标注体验。

技术实现方案

要实现这一功能，我们需要修改CVAT的服务器代理代码，具体步骤如下：

1. 定位关键文件：找到server-proxy.ts文件，该文件负责处理图像数据的获取请求。

2. 修改请求参数：在文件中的getData函数内，将quality参数固定设置为'original'。这样无论前端如何请求，后端始终返回原始质量的图像数据。

3. 完整的修改示例：

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',
        });
        // ...其余代码保持不变

部署注意事项

完成代码修改后，必须重新构建Docker镜像才能使更改生效。这是许多开发者容易忽略的关键步骤。正确的构建命令为：

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

构建完成后，再使用常规命令启动服务：

docker compose up -d

验证方法

为确保修改已生效，可以通过以下方式验证：

1. 使用浏览器开发者工具检查图像请求的URL参数，确认quality参数已变为'original'
2. 观察标注视图中的图像质量是否明显提高
3. 检查网络请求的响应数据大小，原始质量的图像通常会有显著增大的数据量

技术原理

CVAT的图像传输机制采用了按需加载策略，通过quality参数控制返回的图像质量等级。当设置为'original'时，服务器会直接返回未经压缩的原始图像数据。这种设计在本地网络环境中特别有价值，因为：

1. 消除了图像压缩带来的质量损失
2. 避免了压缩/解压缩的计算开销
3. 确保了标注人员看到的是最真实的图像信息

扩展思考

虽然本文介绍了强制使用原始质量的方法，但在实际生产环境中，开发者可能需要考虑更多因素：

1. 对于超高分辨率图像，可能需要额外的内存管理
2. 在多用户协作场景下，网络带宽需求会显著增加
3. 可以考虑添加环境变量控制这一行为，而不是硬编码在源代码中

通过这种定制化修改，CVAT可以更好地适应专业场景下的高质量标注需求，为计算机视觉项目提供更精准的数据支持。