feat(workbench-client): 新增数富AI工作台客户端包管理独立更新渠道

后台上传安装包,confirm 阶段由服务端从 MinIO 实物流式复算 sha256 后落库,
客户端经 /api/workbench-client/version/latest 自动检查更新;与 ShuFuAI 桌面端
的 nanri-image/versions/ 渠道隔离,包体落 client 桶 workbench-client/versions/。
This commit is contained in:
2026-10-24 12:49:51 +08:00
parent b94555f411
commit ba20f5ed42
22 changed files with 1789 additions and 53 deletions
@@ -0,0 +1,170 @@
package com.nanri.aiimage.modules.workbenchclient.service;
import com.baomidou.mybatisplus.core.MybatisConfiguration;
import com.baomidou.mybatisplus.core.metadata.TableInfoHelper;
import com.nanri.aiimage.common.exception.BusinessException;
import com.nanri.aiimage.modules.file.service.oss.OssStorageService;
import com.nanri.aiimage.modules.workbenchclient.mapper.WorkbenchClientPackageMapper;
import com.nanri.aiimage.modules.workbenchclient.model.entity.WorkbenchClientPackageEntity;
import org.apache.ibatis.builder.MapperBuilderAssistant;
import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.Test;
import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertNull;
import static org.junit.jupiter.api.Assertions.assertThrows;
import static org.junit.jupiter.api.Assertions.assertTrue;
import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.anyList;
import static org.mockito.ArgumentMatchers.anyString;
import static org.mockito.ArgumentMatchers.eq;
import static org.mockito.Mockito.mock;
import static org.mockito.Mockito.never;
import static org.mockito.Mockito.verify;
import static org.mockito.Mockito.verifyNoInteractions;
import static org.mockito.Mockito.when;
/**
* 工作台客户端包独立渠道:上传确认必须由服务端把 sha256 算出来并落库。
* 直传路径若留空摘要,客户端就只能退回「只验 zip 结构」,等于丢了完整性锚点。
*/
class WorkbenchClientPackageServiceTest {
private static final String PREFIX = WorkbenchClientPackageService.OBJECT_KEY_PREFIX;
private static final String SHA = "b".repeat(64);
private final WorkbenchClientPackageMapper packageMapper = mock(WorkbenchClientPackageMapper.class);
private final OssStorageService ossStorageService = mock(OssStorageService.class);
private WorkbenchClientPackageService service() {
return new WorkbenchClientPackageService(packageMapper, ossStorageService);
}
@BeforeAll
static void initializeMybatisMetadata() {
TableInfoHelper.initTableInfo(
new MapperBuilderAssistant(new MybatisConfiguration(), ""), WorkbenchClientPackageEntity.class);
}
private static WorkbenchClientPackageEntity row(long id, String version, String objectKey) {
WorkbenchClientPackageEntity entity = new WorkbenchClientPackageEntity();
entity.setId(id);
entity.setVersion(version);
entity.setFileName("ShuFuAI-Workbench-" + version + ".zip");
entity.setObjectKey(objectKey);
entity.setFileSize(1234L);
entity.setSha256(SHA);
entity.setCreatedAt(LocalDateTime.of(2026, 10, 24, 10, 0));
return entity;
}
@Test
void presignUsesIndependentPrefixAndReturnsUploadUrl() {
when(ossStorageService.presignWorkbenchClientUpload(anyString(), eq(180)))
.thenReturn("https://oss.aishufu.top/client/workbench-client/versions/put");
when(ossStorageService.getWorkbenchClientDownloadUrl(anyString()))
.thenReturn("https://download.aishufu.top/client/workbench-client/versions/1.2.3.zip");
Map<String, Object> result = service().presignPackage("ShuFuAI-Workbench-1.2.3.zip", "1.2.3");
String objectKey = (String) result.get("object_key");
assertTrue(objectKey.startsWith(PREFIX), "对象 key 必须落在独立前缀下: " + objectKey);
assertTrue(objectKey.endsWith("-1.2.3.zip"), "对象 key 必须以版本号收尾: " + objectKey);
assertEquals("1.2.3", result.get("version"));
assertEquals("ShuFuAI-Workbench-1.2.3.zip", result.get("file_name"));
assertEquals("https://oss.aishufu.top/client/workbench-client/versions/put", result.get("upload_url"));
}
@Test
void presignRejectsNonZipAndBlankVersion() {
assertThrows(BusinessException.class, () -> service().presignPackage("pkg.exe", "1.0.0"));
assertThrows(BusinessException.class, () -> service().presignPackage("pkg.zip", " "));
verifyNoInteractions(ossStorageService);
}
@Test
void confirmRecomputesSha256BeforeInsert() {
String objectKey = PREFIX + "20261024100000123-1.2.3.zip";
when(ossStorageService.workbenchClientObjectSize(objectKey)).thenReturn(1234L);
when(ossStorageService.workbenchClientObjectSha256(objectKey)).thenReturn(SHA);
when(ossStorageService.getWorkbenchClientDownloadUrl(objectKey))
.thenReturn("https://download.aishufu.top/client/" + objectKey);
when(packageMapper.selectCount(any())).thenReturn(0L);
when(packageMapper.insert(any(WorkbenchClientPackageEntity.class))).thenAnswer(invocation -> {
((WorkbenchClientPackageEntity) invocation.getArgument(0)).setId(99L);
return 1;
});
when(packageMapper.selectById(99L)).thenReturn(row(99, "1.2.3", objectKey));
Map<String, Object> result = service().confirmPackage(
objectKey, "ShuFuAI-Workbench-1.2.3.zip", "1.2.3");
assertEquals(SHA, result.get("sha256"), "返回行必须带服务端复算出的摘要");
verify(ossStorageService).workbenchClientObjectSha256(objectKey);
verify(packageMapper).insert(any(WorkbenchClientPackageEntity.class));
}
@Test
void confirmRejectsVersionThatDoesNotMatchObjectKey() {
String objectKey = PREFIX + "20261024100000123-1.2.3.zip";
assertThrows(BusinessException.class, () -> service().confirmPackage(
objectKey, "ShuFuAI-Workbench-1.2.4.zip", "1.2.4"));
verifyNoInteractions(ossStorageService);
verify(packageMapper, never()).insert(any(WorkbenchClientPackageEntity.class));
}
@Test
void confirmRemovesOversizeObjectWithoutHashing() {
String objectKey = PREFIX + "20261024100000123-1.2.3.zip";
when(ossStorageService.workbenchClientObjectSize(objectKey)).thenReturn(513L * 1024 * 1024);
assertThrows(BusinessException.class, () -> service().confirmPackage(
objectKey, "ShuFuAI-Workbench-1.2.3.zip", "1.2.3"));
verify(ossStorageService).removeWorkbenchClientObject(objectKey);
verify(ossStorageService, never()).workbenchClientObjectSha256(anyString());
verify(packageMapper, never()).insert(any(WorkbenchClientPackageEntity.class));
}
@Test
void latestReturnsNullFieldsWhenTableIsEmpty() {
when(packageMapper.selectOne(any())).thenReturn(null);
Map<String, Object> result = service().latestPackage();
assertNull(result.get("version"));
assertNull(result.get("file_url"));
assertNull(result.get("sha256"));
}
@Test
void deleteRemovesObjectOnlyWhenNoOtherRowReferencesIt() {
WorkbenchClientPackageEntity target = row(9, "1.2.3", PREFIX + "20261024100000123-1.2.3.zip");
when(packageMapper.selectBatchIds(anyList())).thenReturn(List.of(target));
when(packageMapper.deleteById(9L)).thenReturn(1);
when(packageMapper.selectCount(any())).thenReturn(0L);
int deleted = service().deletePackages(List.of(9L));
assertEquals(1, deleted);
verify(ossStorageService).removeWorkbenchClientObject(target.getObjectKey());
}
@Test
void deleteKeepsObjectWhenAnotherRowStillReferencesIt() {
WorkbenchClientPackageEntity target = row(9, "1.2.3", PREFIX + "20261024100000123-1.2.3.zip");
when(packageMapper.selectBatchIds(anyList())).thenReturn(List.of(target));
when(packageMapper.deleteById(9L)).thenReturn(1);
when(packageMapper.selectCount(any())).thenReturn(1L);
service().deletePackages(List.of(9L));
verify(ossStorageService, never()).removeWorkbenchClientObject(anyString());
}
}