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,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')
})
})