LiteLoaderQQNT-OneBotApi 图片类型上报问题分析与解决方案

问题背景

在LiteLoaderQQNT-OneBotApi项目中，存在一个关于图片类型上报的兼容性问题。由于QQNT客户端保存的图片几乎都以.jpg格式存储，导致系统在上报图片消息时，会将原本是GIF、PNG等格式的图片统一上报为JPG格式。这种处理方式对接入Onebot协议的应用(如Koishi)造成了困扰，特别是在跨平台文件传输时会出现格式不匹配的问题。

技术分析

问题根源

该问题的核心在于QQNT客户端的文件存储机制与Onebot协议之间的不兼容性。QQNT将所有接收到的图片文件统一保存为.jpg格式，而不管其原始格式如何。当LiteLoaderQQNT-OneBotApi从QQNT获取这些图片文件时，只能看到.jpg后缀，无法直接识别出原始格式。

影响范围

这种格式不匹配会导致以下问题：

1. 动态GIF图片被当作静态JPG处理，失去动画效果
2. 透明背景的PNG图片被当作不透明JPG处理，失去透明度信息
3. 其他需要精确识别图片格式的应用场景出现兼容性问题

解决方案探讨

初始方案评估

最直接的解决方案是在上报消息时检测文件的实际类型，而非依赖文件后缀名。项目组最初考虑了几种实现方式：

1. 修改文件后缀：直接修改QQNT存储的文件后缀名

   • 缺点：可能导致QQNT客户端无法识别图片，影响正常使用

2. 复制文件：创建格式正确的副本文件

   • 缺点：占用额外存储空间，特别是对于频繁发送的动图

3. 仅修改上报文件名：保持原文件不变，只在上报时修改文件名

   • 缺点：会导致文件名与实际文件不匹配，违反Onebot协议规范

最终采用的解决方案

经过讨论，项目组采用了"文件名标记法"的解决方案，其核心思想是：

1. 保持QQNT存储的原文件不变(仍为.jpg)
2. 在上报时，通过特殊的文件名后缀标记原始格式
3. 在接收文件请求时，解析特殊标记还原真实文件名

具体实现方式如下：

// 上报时添加格式标记
function modifyFilename(originalFilename: string, realType: string): string {
    const randomValue = generateRandomString();
    return `${originalFilename}.llonebot_${randomValue}.${realType}`;
}

// 接收时解析还原
function parseAndRestoreFilename(modifiedFilename: string): string {
    const pattern = /^(.+)\.llonebot_(\w+)\.(\w+)$/;
    const match = modifiedFilename.match(pattern);
    return match ? match[1] : modifiedFilename;
}

技术实现要点

1. 文件类型检测：通过读取文件头信息准确判断图片实际格式
2. 随机值生成：确保每个标记的唯一性，避免冲突
3. 协议兼容性：在保持Onebot协议规范的前提下解决格式问题
4. 性能考量：避免不必要的文件复制操作，减少IO开销

总结

该解决方案在v3.25.0版本中已得到实现，有效解决了QQNT图片格式上报不准确的问题。这种设计既保持了与QQNT客户端的兼容性，又满足了Onebot协议的要求，同时避免了额外的存储开销，是一个兼顾各方面需求的优雅解决方案。

对于开发者而言，这一改进使得基于Onebot协议开发的应用程序能够更准确地处理来自QQNT的各种图片格式，提升了跨平台消息传递的可靠性。