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:
@@ -0,0 +1,63 @@
|
||||
import test from 'node:test'
|
||||
import assert from 'node:assert/strict'
|
||||
import { readSource } from './helpers.ts'
|
||||
import { adminPages } from '../src/router/routes.ts'
|
||||
import { OPERATION_GUIDES } from '../src/layout/operation-guides.ts'
|
||||
|
||||
/** 工作台客户端包管理页:独立渠道、上传直传、服务端 sha256、客户端自动更新契约。 */
|
||||
|
||||
test('align_workbench_client_page_registered', () => {
|
||||
const page = adminPages.find((p) => p.path === 'records/workbench-client-package')
|
||||
assert.ok(page, '路由注册表应包含 records/workbench-client-package')
|
||||
assert.equal(page.menuKey, 'admin_workbench_client_package')
|
||||
assert.equal(page.title, '数富AI工作台客户端包管理')
|
||||
assert.equal(page.companyScoped, false, '客户端包是全平台共享资源,不按公司隔离')
|
||||
})
|
||||
|
||||
test('align_workbench_client_page_wiring', () => {
|
||||
const page = readSource('src/pages/records/WorkbenchClientPackagePage.vue')
|
||||
// 上传:版本号必填 → zip → 直传(进度条)→ 成功提示留驻弹窗。
|
||||
assert.match(page, /上传客户端包/, '存在上传入口按钮')
|
||||
assert.match(page, /uploadWorkbenchClientPackage/, '上传走工作台客户端包直传链路')
|
||||
assert.match(page, /label="版本号" required/, '上传弹窗要求填写版本号')
|
||||
assert.match(page, /请填写版本号/, '未填版本号时提示')
|
||||
assert.match(page, /仅支持 \.zip 格式/, '格式校验提示')
|
||||
assert.match(page, /上传成功,客户端已可检测到新版本/, '成功提示说明客户端已能检测更新')
|
||||
// 列表:当前生效标记、sha256、下载、删除、空态。
|
||||
assert.match(page, /当前生效/, '最新上传的包标记当前生效')
|
||||
assert.match(page, /sha256/, '展示服务端复算的摘要')
|
||||
assert.match(page, /formatFileSize/, '展示包体大小')
|
||||
assert.match(page, /\/api\/workbench-client\/version\/latest/, '页面标明客户端更新检查接口')
|
||||
assert.match(page, /确认删除选中的/, '批量删除二次确认')
|
||||
assert.match(page, /暂无客户端包记录/, '空态文案')
|
||||
})
|
||||
|
||||
test('align_workbench_client_api_contract', () => {
|
||||
const api = readSource('src/pages/records/workbench-client-api.ts')
|
||||
assert.match(api, /\/api\/admin\/workbench-client\/packages/, '列表端点')
|
||||
assert.match(api, /WORKBENCH_CLIENT_PACKAGE_ENDPOINT = '\/api\/admin\/workbench-client\/package'/, '上传端点前缀')
|
||||
assert.match(api, /\$\{WORKBENCH_CLIENT_PACKAGE_ENDPOINT\}\/presign/, '直传预签名端点')
|
||||
assert.match(api, /\$\{WORKBENCH_CLIENT_PACKAGE_ENDPOINT\}\/confirm/, '确认端点')
|
||||
assert.match(api, /\$\{WORKBENCH_CLIENT_PACKAGE_ENDPOINT\}\/delete/, '删除端点')
|
||||
assert.match(api, /params: \{ file_name: fileName, version \}/, '预签名回传文件名与版本号')
|
||||
assert.match(api, /params: \{ object_key: objectKey, file_name: fileName, version \}/, '确认回传对象 key、文件名与版本号')
|
||||
assert.match(api, /withCredentials: false/, '直传实例不挂会话拦截器')
|
||||
assert.match(api, /\/api\/workbench-client\/version\/latest/, '公开更新契约路径固定')
|
||||
})
|
||||
|
||||
test('align_workbench_client_model_parsers', () => {
|
||||
const model = readSource('src/pages/records/workbench-client-model.ts')
|
||||
assert.match(model, /r\.file_name \?\? r\.fileName/, '兼容 snake/camel 文件名')
|
||||
assert.match(model, /r\.file_url \?\? r\.fileUrl/, '兼容 snake/camel 下载链接')
|
||||
assert.match(model, /r\.file_size \?\? r\.fileSize/, '兼容 snake/camel 文件大小')
|
||||
assert.match(model, /r\.object_key \?\? r\.objectKey/, '兼容 snake/camel 对象 key')
|
||||
assert.match(model, /r\.sha256/, '解析 sha256')
|
||||
assert.match(model, /isValidWorkbenchClientVersion/, '版本号必填校验')
|
||||
})
|
||||
|
||||
test('align_workbench_client_guide_registered', () => {
|
||||
const guide = OPERATION_GUIDES.admin_workbench_client_package
|
||||
assert.ok(guide, '每个菜单页都必须有操作提示')
|
||||
assert.match(guide.text, /sha256/, '提示说明服务端会复算摘要')
|
||||
assert.match(guide.text, /\/api\/workbench-client\/version\/latest/, '提示说明客户端更新检查接口')
|
||||
})
|
||||
@@ -1,10 +1,10 @@
|
||||
{
|
||||
"note": "readSource 钉子逐文件基线。两把尺子:pins=落在用例体内的读盘,reads=全文读点总数(含模块级夹具与 helper)。都只许减;pins 下降而 reads 没同步下降=把读盘挪出体内,不算改进。由 tests/source-pin-ratchet.test.ts 生成。",
|
||||
"totals": {
|
||||
"files": 244,
|
||||
"cases": 1728,
|
||||
"pins": 448,
|
||||
"reads": 639
|
||||
"files": 245,
|
||||
"cases": 1733,
|
||||
"pins": 451,
|
||||
"reads": 642
|
||||
},
|
||||
"files": {
|
||||
"admin-scaffold.test.ts": {
|
||||
@@ -182,6 +182,11 @@
|
||||
"pins": 1,
|
||||
"reads": 1
|
||||
},
|
||||
"align-workbench-client.test.ts": {
|
||||
"cases": 5,
|
||||
"pins": 3,
|
||||
"reads": 3
|
||||
},
|
||||
"company-config-entry-super-only.test.ts": {
|
||||
"cases": 4,
|
||||
"pins": 3,
|
||||
|
||||
@@ -0,0 +1,96 @@
|
||||
/**
|
||||
* 工作台客户端包管理页挂载测试:列表渲染、搜索、删除二次确认。
|
||||
* 直传与 Element Plus 弹窗在 mount 环境里用 stub 顶掉,只验页面自己的状态与 API 调用。
|
||||
*/
|
||||
import { beforeEach, describe, expect, it, vi } from 'vitest'
|
||||
import { flushPromises, mount } from '@vue/test-utils'
|
||||
|
||||
import WorkbenchClientPackagePage from '@/pages/records/WorkbenchClientPackagePage.vue'
|
||||
|
||||
const api = vi.hoisted(() => ({
|
||||
fetchWorkbenchClientPackages: vi.fn(),
|
||||
uploadWorkbenchClientPackage: vi.fn(),
|
||||
deleteWorkbenchClientPackages: vi.fn(),
|
||||
}))
|
||||
const confirmMock = vi.hoisted(() => vi.fn())
|
||||
const feedbackMock = vi.hoisted(() => vi.fn())
|
||||
const messageMock = vi.hoisted(() => ({ success: vi.fn() }))
|
||||
|
||||
vi.mock('@/pages/records/workbench-client-api.ts', () => api)
|
||||
vi.mock('@/components/admin-confirm', () => ({ openAdminConfirm: confirmMock }))
|
||||
vi.mock('@/components/admin-feedback-ui', () => ({ showAdminFeedback: feedbackMock }))
|
||||
vi.mock('element-plus', () => ({ ElMessage: messageMock }))
|
||||
|
||||
const SHA = 'c'.repeat(64)
|
||||
const row = {
|
||||
id: 7,
|
||||
version: '1.2.3',
|
||||
fileName: 'ShuFuAI-Workbench-1.2.3.zip',
|
||||
objectKey: 'workbench-client/versions/20261024100000123-1.2.3.zip',
|
||||
fileSize: 2048,
|
||||
sha256: SHA,
|
||||
fileUrl: 'https://download.aishufu.top/client/workbench-client/versions/1.2.3.zip',
|
||||
createdAt: '2026-10-24 10:00',
|
||||
}
|
||||
|
||||
const stubs = {
|
||||
'el-dialog': { template: '<div><slot /></div>' },
|
||||
'el-form': { template: '<form><slot /></form>' },
|
||||
'el-form-item': { template: '<div><slot /></div>' },
|
||||
'el-input': {
|
||||
props: ['modelValue'],
|
||||
emits: ['update:modelValue'],
|
||||
template: '<input :value="modelValue" @input="$emit(\'update:modelValue\', $event.target.value)" />',
|
||||
},
|
||||
'el-upload': { template: '<div><slot /></div>' },
|
||||
'el-button': { template: '<button><slot /></button>' },
|
||||
'el-progress': true,
|
||||
'el-alert': { props: ['title'], template: '<div>{{ title }}</div>' },
|
||||
}
|
||||
|
||||
function mountPage() {
|
||||
return mount(WorkbenchClientPackagePage, { global: { stubs } })
|
||||
}
|
||||
|
||||
describe('WorkbenchClientPackagePage', () => {
|
||||
beforeEach(() => {
|
||||
vi.clearAllMocks()
|
||||
api.fetchWorkbenchClientPackages.mockResolvedValue({ items: [row] })
|
||||
api.deleteWorkbenchClientPackages.mockResolvedValue(1)
|
||||
confirmMock.mockResolvedValue(true)
|
||||
})
|
||||
|
||||
it('渲染版本、文件名、sha256 与当前生效标记', async () => {
|
||||
const wrapper = mountPage()
|
||||
await flushPromises()
|
||||
|
||||
const text = wrapper.text()
|
||||
expect(text).toContain('1.2.3')
|
||||
expect(text).toContain('ShuFuAI-Workbench-1.2.3.zip')
|
||||
expect(text).toContain(SHA)
|
||||
expect(text).toContain('当前生效')
|
||||
expect(text).toContain('2.0 KB')
|
||||
})
|
||||
|
||||
it('搜索无命中时显示空态', async () => {
|
||||
const wrapper = mountPage()
|
||||
await flushPromises()
|
||||
|
||||
await wrapper.get('input.workbench-keyword').setValue('9.9.9')
|
||||
await flushPromises()
|
||||
|
||||
expect(wrapper.text()).toContain('暂无匹配客户端包')
|
||||
})
|
||||
|
||||
it('删除单条会二次确认并调用删除接口', async () => {
|
||||
const wrapper = mountPage()
|
||||
await flushPromises()
|
||||
|
||||
await wrapper.get('.ops-cell .btn-danger').trigger('click')
|
||||
await flushPromises()
|
||||
|
||||
expect(confirmMock).toHaveBeenCalledTimes(1)
|
||||
expect(api.deleteWorkbenchClientPackages).toHaveBeenCalledWith([7])
|
||||
expect(api.fetchWorkbenchClientPackages).toHaveBeenCalledTimes(2)
|
||||
})
|
||||
})
|
||||
@@ -40,6 +40,7 @@ const OPS_MIN_COL_PX: Record<string, number> = {
|
||||
'src/pages/records/RecordsDigitalHumanVersionPage.vue': 287,
|
||||
'src/pages/records/RecordsSoftwareVersionPage.vue': 77,
|
||||
'src/pages/records/RecordsTutorialPage.vue': 77,
|
||||
'src/pages/records/WorkbenchClientPackagePage.vue': 77,
|
||||
'src/pages/shop/ShopKeysPage.vue': 240,
|
||||
'src/pages/shop/ShopManagePage.vue': 199,
|
||||
}
|
||||
|
||||
@@ -0,0 +1,82 @@
|
||||
import { describe, expect, it } from 'vitest'
|
||||
import {
|
||||
formatFileSize,
|
||||
isValidWorkbenchClientVersion,
|
||||
parseWorkbenchClientPackageList,
|
||||
parseWorkbenchClientPackageUpload,
|
||||
WORKBENCH_CLIENT_VERSION_MAX_LENGTH,
|
||||
} from '@/pages/records/workbench-client-model.ts'
|
||||
|
||||
const SHA = 'a'.repeat(64)
|
||||
|
||||
describe('workbench-client model:列表解析', () => {
|
||||
it('解析 snake_case 行并丢弃缺 id 的坏行', () => {
|
||||
const list = parseWorkbenchClientPackageList({
|
||||
success: true,
|
||||
data: {
|
||||
items: [
|
||||
{
|
||||
id: 7,
|
||||
version: '1.2.3',
|
||||
file_name: 'ShuFuAI-Workbench-1.2.3.zip',
|
||||
object_key: 'workbench-client/versions/20261024100000123-1.2.3.zip',
|
||||
file_size: 2048,
|
||||
sha256: SHA,
|
||||
file_url: 'https://download.aishufu.top/client/workbench-client/versions/1.2.3.zip',
|
||||
created_at: '2026-10-24 10:00',
|
||||
},
|
||||
{ version: 'bad-no-id' },
|
||||
],
|
||||
},
|
||||
})
|
||||
|
||||
expect(list.items).toHaveLength(1)
|
||||
expect(list.items[0]).toMatchObject({
|
||||
id: 7,
|
||||
version: '1.2.3',
|
||||
fileName: 'ShuFuAI-Workbench-1.2.3.zip',
|
||||
objectKey: 'workbench-client/versions/20261024100000123-1.2.3.zip',
|
||||
fileSize: 2048,
|
||||
sha256: SHA,
|
||||
fileUrl: 'https://download.aishufu.top/client/workbench-client/versions/1.2.3.zip',
|
||||
createdAt: '2026-10-24 10:00',
|
||||
})
|
||||
})
|
||||
|
||||
it('兼容 camelCase 负载,缺省回空列表', () => {
|
||||
const camel = parseWorkbenchClientPackageList({
|
||||
success: true,
|
||||
data: { items: [{ id: 2, version: '2.0.0', fileName: 'a.zip', fileSize: 10, sha256: SHA, fileUrl: 'u', createdAt: 't' }] },
|
||||
})
|
||||
expect(camel.items[0].fileName).toBe('a.zip')
|
||||
expect(camel.items[0].fileUrl).toBe('u')
|
||||
|
||||
expect(parseWorkbenchClientPackageList({ success: true, data: {} }).items).toEqual([])
|
||||
})
|
||||
|
||||
it('上传返回行取 data.item,缺 item 回 null', () => {
|
||||
const item = parseWorkbenchClientPackageUpload({
|
||||
success: true,
|
||||
data: { item: { id: 3, version: '3.0.0', file_name: 'c.zip', sha256: SHA } },
|
||||
})
|
||||
expect(item?.version).toBe('3.0.0')
|
||||
expect(item?.sha256).toBe(SHA)
|
||||
expect(parseWorkbenchClientPackageUpload({ success: true, data: {} })).toBeNull()
|
||||
})
|
||||
})
|
||||
|
||||
describe('workbench-client model:版本号与大小', () => {
|
||||
it('版本号必填且不超过后端列宽', () => {
|
||||
expect(isValidWorkbenchClientVersion('')).toBe(false)
|
||||
expect(isValidWorkbenchClientVersion(' ')).toBe(false)
|
||||
expect(isValidWorkbenchClientVersion('1.0.0')).toBe(true)
|
||||
expect(isValidWorkbenchClientVersion('a'.repeat(WORKBENCH_CLIENT_VERSION_MAX_LENGTH))).toBe(true)
|
||||
expect(isValidWorkbenchClientVersion('a'.repeat(WORKBENCH_CLIENT_VERSION_MAX_LENGTH + 1))).toBe(false)
|
||||
})
|
||||
|
||||
it('大小展示与旧页面口径一致', () => {
|
||||
expect(formatFileSize(0)).toBe('—')
|
||||
expect(formatFileSize(2048)).toBe('2.0 KB')
|
||||
expect(formatFileSize(90 * 1024 * 1024)).toBe('90.0 MB')
|
||||
})
|
||||
})
|
||||
Reference in New Issue
Block a user