@lf_maple/koishi-plugin-phi-plugin-full 0.1.80

package/core/tests/themePageRouting.test.js

@@ -0,0 +1,431 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+import Config from '../components/Config.js'
+import { phihelp as ApiSettings } from '../apps/apiSetting.js'
+import { phihelp as UserSettings } from '../apps/setting.js'
+import { phimoney as Money } from '../apps/money.js'
+import { phiuser as UserInfo } from '../apps/user.js'
+import getInfo from '../model/game/getInfo.js'
+import fCompute from '../model/game/fCompute.js'
+import picmodle from '../model/render/picmodle.js'
+import send from '../model/render/send.js'
+import getBanGroup from '../model/user/getBanGroup.js'
+import getNotes from '../model/user/getNotes.js'
+import themeManager from '../model/theme/manager.js'
+import themeUseService from '../model/theme/useService.js'
+import { UserCredentials } from '../model/user/userCredentials.js'
+
+/** @param {string} msg */
+const event = msg => ({
+    msg,
+    user_id: 'test-user',
+    self_id: 'test-bot',
+    isGroup: false,
+    isPrivate: true,
+})
+
+const pluginData = () => ({
+    theme: 'milthm',
+    b30AvgKind: 'all',
+    b30AvgColor: 'red',
+    allowApiUsage: true,
+    showB30Analysis: true,
+})
+
+test('用户设置页把当前主题传给完整页面渲染目标', async () => {
+    const originals = {
+        getBan: getBanGroup.get,
+        getNotesData: getNotes.getNotesData,
+        getIll: getInfo.getill,
+        common: picmodle.common,
+        send: send.send_with_At,
+    }
+    /** @type {any[]} */ const renders = []
+    let currentTheme = 'milthm'
+
+    getBanGroup.get = async () => false
+    getNotes.getNotesData = async () => /** @type {any} */ ({ ...pluginData(), theme: currentTheme })
+    getInfo.getill = () => 'background.png'
+    picmodle.common = /** @type {any} */ (async (/** @type {any[]} */ ...args) => {
+        renders.push(args)
+        return 'image'
+    })
+    send.send_with_At = /** @type {any} */ (async () => undefined)
+
+    try {
+        const command = new UserSettings()
+        assert.equal(await command.showUserSetting(/** @type {any} */ (event('/phi myset'))), true)
+        assert.equal(renders.length, 1)
+        assert.equal(renders[0][1], 'setting')
+        assert.equal(renders[0][2].theme, 'milthm')
+        assert.equal(renders[0][3], 'userSetting')
+        const themedOptions = renders[0][2].items.find((/** @type {any} */ item) => item.key === 'theme').options
+        assert.deepEqual(themedOptions.slice(0, 4).map((/** @type {any} */ option) => option.value), ['default', 'snow', 'star', 'dss2'])
+        assert.equal(themedOptions.length, 5)
+        assert.equal(themedOptions[4].title, 'Milthm')
+        assert.equal(themedOptions[4].selected, true)
+        assert.equal(themedOptions[4].fullWidth, true)
+        assert.match(themedOptions[4].description, /\/phi market <slug>/)
+
+        currentTheme = 'default'
+        assert.equal(await command.showUserSetting(/** @type {any} */ (event('/phi myset'))), true)
+        const defaultOptions = renders[1][2].items.find((/** @type {any} */ item) => item.key === 'theme').options
+        assert.equal(defaultOptions[0].selected, true)
+        assert.equal(defaultOptions[4].title, '自定义')
+        assert.equal(defaultOptions[4].selected, false)
+        assert.equal(defaultOptions[4].fullWidth, true)
+    } finally {
+        getBanGroup.get = originals.getBan
+        getNotes.getNotesData = originals.getNotesData
+        getInfo.getill = originals.getIll
+        picmodle.common = originals.common
+        send.send_with_At = originals.send
+    }
+})
+
+test('用户按市场 slug 设置未下载主题时会自动下载并保存', async () => {
+    const originals = {
+        getUserCfg: Config.getUserCfg,
+        getBan: getBanGroup.get,
+        getNotesData: getNotes.getNotesData,
+        putNotesData: getNotes.putNotesData,
+        getThemeOptions: themeManager.getThemeOptions,
+        getTheme: themeManager.getTheme,
+        use: themeUseService.use,
+        getIll: getInfo.getill,
+        common: picmodle.common,
+        send: send.send_with_At,
+    }
+    let installed = false
+    const pluginData = /** @type {any} */ ({
+        theme: 'default', b30AvgKind: 'all', b30AvgColor: 'red',
+        allowApiUsage: true, showB30Analysis: true,
+    })
+    /** @type {string[]} */ const used = []
+    /** @type {any[]} */ const useOptions = []
+    /** @type {any[]} */ const saved = []
+    Config.getUserCfg = /** @type {any} */ ((_name = '', key = '') => key === 'cmdhead' ? 'phi' : key === 'openPhiPluginApi')
+    getBanGroup.get = async () => false
+    getNotes.getNotesData = async () => pluginData
+    getNotes.putNotesData = (userId, data) => { saved.push({ userId, data: { ...data } }); return true }
+    themeManager.getThemeOptions = () => ({
+        default: { title: '[0]默认', description: '' },
+        ...(installed ? { 'ocean-salt': { title: '[1]Ocean Salt', description: 'market' } } : {}),
+    })
+    themeManager.getTheme = () => null
+    themeUseService.use = async (slug, options) => {
+        used.push(slug)
+        useOptions.push(options)
+        installed = true
+        return /** @type {any} */ ({ cached: false, version: '1.0.0', theme: { id: slug, name: 'Ocean Salt' } })
+    }
+    getInfo.getill = () => 'background.png'
+    picmodle.common = /** @type {any} */ (async () => 'image')
+    send.send_with_At = async () => undefined
+
+    try {
+        const command = new UserSettings()
+        assert.equal(await command.showUserSetting(/** @type {any} */ (event('/phi myset 主题 ocean-salt'))), true)
+        assert.deepEqual(used, ['ocean-salt'])
+        assert.match(useOptions[0]?.requesterId || '', /test-user$/)
+        assert.equal(saved.length, 1)
+        assert.equal(saved[0].userId, 'test-user')
+        assert.equal(saved[0].data.theme, 'ocean-salt')
+    } finally {
+        Config.getUserCfg = originals.getUserCfg
+        getBanGroup.get = originals.getBan
+        getNotes.getNotesData = originals.getNotesData
+        getNotes.putNotesData = originals.putNotesData
+        themeManager.getThemeOptions = originals.getThemeOptions
+        themeManager.getTheme = originals.getTheme
+        themeUseService.use = originals.use
+        getInfo.getill = originals.getIll
+        picmodle.common = originals.common
+        send.send_with_At = originals.send
+    }
+})
+
+test('用户重新选择已安装市场主题时仍会在线校验并更新', async () => {
+    const originals = {
+        getBan: getBanGroup.get,
+        getNotesData: getNotes.getNotesData,
+        putNotesData: getNotes.putNotesData,
+        getThemeOptions: themeManager.getThemeOptions,
+        getTheme: themeManager.getTheme,
+        use: themeUseService.use,
+        getIll: getInfo.getill,
+        common: picmodle.common,
+        send: send.send_with_At,
+    }
+    const data = /** @type {any} */ ({ ...pluginData(), theme: 'default' })
+    /** @type {string[]} */ const used = []
+    /** @type {string[]} */ const messages = []
+    getBanGroup.get = async () => false
+    getNotes.getNotesData = async () => data
+    getNotes.putNotesData = () => true
+    themeManager.getThemeOptions = () => ({
+        default: { title: '[0]默认', description: '' },
+        'ocean-salt': { title: '[1]Ocean Salt', description: 'market' },
+    })
+    themeManager.getTheme = themeId => themeId === 'ocean-salt'
+        ? /** @type {any} */ ({ id: themeId, marketInstalled: true })
+        : null
+    themeUseService.use = async slug => {
+        used.push(slug)
+        return /** @type {any} */ ({ cached: false, version: '2.0.0' })
+    }
+    getInfo.getill = () => 'background.png'
+    picmodle.common = /** @type {any} */ (async () => 'image')
+    send.send_with_At = async (_event, message) => { messages.push(String(message)); return undefined }
+
+    try {
+        const command = new UserSettings()
+        assert.equal(await command.showUserSetting(/** @type {any} */ (event('/phi myset 主题 ocean-salt'))), true)
+        assert.deepEqual(used, ['ocean-salt'])
+        assert.equal(data.theme, 'ocean-salt')
+        assert.match(messages[0], /正在校验并准备主题/)
+        assert.ok(messages.some(message => /设置成功/.test(message)))
+    } finally {
+        getBanGroup.get = originals.getBan
+        getNotes.getNotesData = originals.getNotesData
+        getNotes.putNotesData = originals.putNotesData
+        themeManager.getThemeOptions = originals.getThemeOptions
+        themeManager.getTheme = originals.getTheme
+        themeUseService.use = originals.use
+        getInfo.getill = originals.getIll
+        picmodle.common = originals.common
+        send.send_with_At = originals.send
+    }
+})
+
+test('旧 theme 命令切换市场主题时也会校验更新', async () => {
+    const originals = {
+        getBan: getBanGroup.get,
+        getNotesData: getNotes.getNotesData,
+        putNotesData: getNotes.putNotesData,
+        getThemeList: themeManager.getThemeList,
+        getTheme: themeManager.getTheme,
+        use: themeUseService.use,
+        send: send.send_with_At,
+    }
+    const data = /** @type {any} */ ({ ...pluginData(), theme: 'default' })
+    /** @type {any[]} */ const useOptions = []
+    getBanGroup.get = async () => false
+    getNotes.getNotesData = async () => data
+    getNotes.putNotesData = () => true
+    themeManager.getThemeList = () => [
+        { id: 'default', src: '默认' },
+        { id: 'ocean-salt', src: 'Ocean Salt' },
+    ]
+    themeManager.getTheme = themeId => themeId === 'ocean-salt'
+        ? /** @type {any} */ ({ id: themeId, marketInstalled: true })
+        : null
+    themeUseService.use = async (slug, options) => {
+        useOptions.push({ slug, options })
+        return /** @type {any} */ ({ cached: false, version: '2.0.0' })
+    }
+    send.send_with_At = async () => undefined
+
+    try {
+        const command = new Money()
+        assert.equal(await command.theme(/** @type {any} */ (event('/phi theme 1'))), true)
+        assert.equal(useOptions[0]?.slug, 'ocean-salt')
+        assert.match(useOptions[0]?.options?.requesterId || '', /test-user$/)
+        assert.equal(data.theme, 'ocean-salt')
+    } finally {
+        getBanGroup.get = originals.getBan
+        getNotes.getNotesData = originals.getNotesData
+        getNotes.putNotesData = originals.putNotesData
+        themeManager.getThemeList = originals.getThemeList
+        themeManager.getTheme = originals.getTheme
+        themeUseService.use = originals.use
+        send.send_with_At = originals.send
+    }
+})
+
+test('主题功能被禁用时 myset 不能下载或保存主题', async () => {
+    const originals = {
+        getBan: getBanGroup.get,
+        getNotesData: getNotes.getNotesData,
+        putNotesData: getNotes.putNotesData,
+        use: themeUseService.use,
+        send: send.send_with_At,
+    }
+    let downloads = 0
+    let saves = 0
+    getBanGroup.get = async (_event, feature) => feature === 'theme'
+    getNotes.getNotesData = async () => /** @type {any} */ ({ ...pluginData(), theme: 'default' })
+    getNotes.putNotesData = () => { saves++; return true }
+    themeUseService.use = async () => { downloads++; return /** @type {any} */ ({}) }
+    send.send_with_At = async () => undefined
+
+    try {
+        const command = new UserSettings()
+        assert.equal(await command.showUserSetting(/** @type {any} */ (event('/phi myset 主题 ocean-salt'))), false)
+        assert.equal(downloads, 0)
+        assert.equal(saves, 0)
+    } finally {
+        getBanGroup.get = originals.getBan
+        getNotes.getNotesData = originals.getNotesData
+        getNotes.putNotesData = originals.putNotesData
+        themeUseService.use = originals.use
+        send.send_with_At = originals.send
+    }
+})
+
+test('仅禁用主题功能时 myset 仍可修改其他个人设置', async () => {
+    const originals = {
+        getBan: getBanGroup.get,
+        getNotesData: getNotes.getNotesData,
+        putNotesData: getNotes.putNotesData,
+        getIll: getInfo.getill,
+        common: picmodle.common,
+        send: send.send_with_At,
+    }
+    const data = /** @type {any} */ ({ ...pluginData(), b30AvgColor: 'red' })
+    let saves = 0
+    getBanGroup.get = async (_event, feature) => feature === 'theme'
+    getNotes.getNotesData = async () => data
+    getNotes.putNotesData = () => { saves++; return true }
+    getInfo.getill = () => 'background.png'
+    picmodle.common = /** @type {any} */ (async () => 'image')
+    send.send_with_At = async () => undefined
+
+    try {
+        const command = new UserSettings()
+        assert.equal(await command.showUserSetting(/** @type {any} */ (event('/phi myset 配色 gold'))), true)
+        assert.equal(data.b30AvgColor, 'gold')
+        assert.equal(saves, 1)
+    } finally {
+        getBanGroup.get = originals.getBan
+        getNotes.getNotesData = originals.getNotesData
+        getNotes.putNotesData = originals.putNotesData
+        getInfo.getill = originals.getIll
+        picmodle.common = originals.common
+        send.send_with_At = originals.send
+    }
+})
+
+test('API 用户设置页把当前主题传给完整页面渲染目标', async () => {
+    const originals = {
+        getNotesData: getNotes.getNotesData,
+        getIll: getInfo.getill,
+        common: picmodle.common,
+        send: send.send_with_At,
+    }
+    /** @type {any[]} */ const renders = []
+
+    getNotes.getNotesData = async () => /** @type {any} */ (pluginData())
+    getInfo.getill = () => 'background.png'
+    picmodle.common = /** @type {any} */ (async (/** @type {any[]} */ ...args) => {
+        renders.push(args)
+        return 'image'
+    })
+    send.send_with_At = /** @type {any} */ (async () => undefined)
+
+    try {
+        const command = new ApiSettings()
+        await command.renderApiUserSetting(/** @type {any} */ (event('/phi apiset')), {
+            allowDataCollection: true,
+            allowLeaderboard: true,
+            allowDataAggregation: true,
+            allowPlayerIdSearch: true,
+            allowUserIdSearch: true,
+        })
+        assert.equal(renders.length, 1)
+        assert.equal(renders[0][1], 'setting')
+        assert.equal(renders[0][2].theme, 'milthm')
+        assert.equal(renders[0][3], 'userSetting')
+    } finally {
+        getNotes.getNotesData = originals.getNotesData
+        getInfo.getill = originals.getIll
+        picmodle.common = originals.common
+        send.send_with_At = originals.send
+    }
+})
+
+test('info 命令传递用户主题并正确区分新版和旧版渲染', async () => {
+    const originals = {
+        getBan: getBanGroup.get,
+        getNotesData: getNotes.getNotesData,
+        getIll: getInfo.getill,
+        fuzzySongsNick: getInfo.fuzzysongsnick,
+        getAvatar: getInfo.idgetavatar,
+        getBackground: fCompute.getBackground,
+        getSave: send.getsave_result,
+        send: send.send_with_At,
+        userInfo: picmodle.user_info,
+        fromEvent: UserCredentials.fromEvent,
+    }
+    /** @type {any[]} */ const renders = []
+    const history = {
+        getRksAndDataLine: () => ({
+            rks_history: [],
+            data_history: [],
+            rks_range: [0, 0],
+            data_range: [0, 0],
+            rks_date: [new Date(0), new Date(0)],
+            data_date: [new Date(0), new Date(0)],
+        }),
+    }
+    const save = {
+        getStats: async () => [],
+        getRecord: () => [],
+        findAccRecord: () => [],
+        gameProgress: { money: [0, 0, 0, 0, 0] },
+        gameuser: { avatar: 'avatar-id', background: 'song-id', selfIntro: 'hello' },
+        saveInfo: {
+            PlayerId: 'TestPlayer',
+            summary: { challengeModeRank: 312, rankingScore: 15.1234 },
+        },
+    }
+
+    getBanGroup.get = async () => false
+    getNotes.getNotesData = async () => /** @type {any} */ ({ theme: 'milthm', allowApiUsage: false })
+    getInfo.getill = () => 'background.png'
+    getInfo.fuzzysongsnick = /** @type {any} */ (() => ['song-id'])
+    getInfo.idgetavatar = () => 'avatar1'
+    fCompute.getBackground = () => 'player-background.png'
+    send.getsave_result = /** @type {any} */ (async () => save)
+    send.send_with_At = /** @type {any} */ (async () => undefined)
+    picmodle.user_info = /** @type {any} */ (async (/** @type {any} */ e, /** @type {any} */ data, /** @type {any} */ kind) => {
+        renders.push({ e, data, kind })
+        return 'image'
+    })
+    UserCredentials.fromEvent = /** @type {any} */ (() => ({
+        getLocalHistory: async () => history,
+        getCloudHistory: async () => history,
+    }))
+
+    try {
+        const command = new UserInfo()
+        /** @type {Array<[string, number]>} */
+        const cases = [
+            ['/phi info', 0],
+            ['/phi info1', 1],
+            ['/phi info2', 2],
+            ['#phi info2', 2],
+            ['/phiinfo2', 2],
+            ['/phi info2 Test Song', 2],
+        ]
+        for (const [message, expectedKind] of cases) {
+            await command.info(/** @type {any} */ (event(message)))
+            const render = renders.at(-1)
+            assert.ok(render)
+            assert.equal(render.data.theme, 'milthm')
+            assert.equal(render.kind, expectedKind)
+        }
+        assert.equal(renders.length, cases.length)
+    } finally {
+        getBanGroup.get = originals.getBan
+        getNotes.getNotesData = originals.getNotesData
+        getInfo.getill = originals.getIll
+        getInfo.fuzzysongsnick = originals.fuzzySongsNick
+        getInfo.idgetavatar = originals.getAvatar
+        fCompute.getBackground = originals.getBackground
+        send.getsave_result = originals.getSave
+        send.send_with_At = originals.send
+        picmodle.user_info = originals.userInfo
+        UserCredentials.fromEvent = originals.fromEvent
+    }
+})

package/core/tests/themePolicy.test.js

@@ -0,0 +1,28 @@
+import assert from 'node:assert/strict'
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import test from 'node:test'
+import { ThemePolicyCache } from '../model/theme/policy.js'
+
+test('theme policy cache persists and applies blacklist and whitelist semantics', () => {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'phi-theme-policy-'))
+    const file = path.join(dir, 'policy.json')
+    try {
+        const cache = new ThemePolicyCache(file)
+        assert.deepEqual(cache.snapshot(), { mode: 'blacklist', entries: [] })
+        assert.equal(cache.isAllowed('ocean-salt'), true)
+        assert.equal(cache.apply({ mode: 'blacklist', entries: ['ocean-salt', '../bad'] }), true)
+        assert.equal(cache.isAllowed('ocean-salt'), false)
+        assert.equal(cache.isAllowed('another-theme'), true)
+
+        const reloaded = new ThemePolicyCache(file)
+        assert.deepEqual(reloaded.snapshot(), { mode: 'blacklist', entries: ['ocean-salt'] })
+        reloaded.apply({ mode: 'whitelist', entries: ['another-theme'] })
+        assert.equal(reloaded.isAllowed('ocean-salt'), false)
+        assert.equal(reloaded.isAllowed('another-theme'), true)
+        assert.equal(reloaded.apply({ mode: 'invalid', entries: [] }), false)
+    } finally {
+        fs.rmSync(dir, { recursive: true, force: true })
+    }
+})

package/core/tests/themeStorageRecovery.test.js

@@ -0,0 +1,192 @@
+import assert from 'node:assert/strict'
+import crypto from 'node:crypto'
+import fs from 'node:fs'
+import path from 'node:path'
+import test from 'node:test'
+import JSZip from 'jszip'
+import {
+    installMarketArchive,
+    marketWorkPath,
+    recoverAllMarketInstalls,
+    recoverMarketInstall,
+} from '../model/theme/installer.js'
+import { cleanStaleMarketWork } from '../model/theme/recovery.js'
+import { themesDir } from '../model/theme/paths.js'
+import { addThemesToBackup, restoreThemesFromBackup } from '../model/save/getBackup.js'
+
+const SHA256 = 'c'.repeat(64)
+
+test('force updates and Git ignore rules preserve installed theme directories', () => {
+    const gitignore = fs.readFileSync(new URL('../.gitignore', import.meta.url), 'utf8')
+    const updateCommand = fs.readFileSync(new URL('../apps/update.js', import.meta.url), 'utf8')
+    assert.match(gitignore, /^\/resources\/themes\/\*$/m)
+    assert.match(updateCommand, /clean -fd -e resources\/themes\//)
+})
+
+/** @param {string} directory @param {string} themeId @param {string} marker */
+async function writeMarketTheme(directory, themeId, marker) {
+    await fs.promises.mkdir(directory, { recursive: true })
+    await fs.promises.writeFile(path.join(directory, 'info.yaml'), `id: ${themeId}\nname: ${marker}\n`)
+    await fs.promises.writeFile(path.join(directory, 'marker.txt'), marker)
+    await fs.promises.writeFile(path.join(directory, '.phi-market.json'), `${JSON.stringify({
+        installedAt: new Date().toISOString(),
+        sha256: SHA256,
+        slug: themeId,
+        source: 'phi-theme-marketplace',
+        version: '1.0.0',
+    })}\n`)
+}
+
+/** @param {string} themeId */
+async function makeArchive(themeId) {
+    const zip = new JSZip()
+    zip.file('info.yaml', `id: ${themeId}\nname: Downloaded\n`)
+    zip.file('b19.css', 'body { color: white; }\n')
+    const archivePath = marketWorkPath(`storage-${themeId}-${crypto.randomUUID()}.zip`)
+    await fs.promises.mkdir(path.dirname(archivePath), { recursive: true })
+    await fs.promises.writeFile(archivePath, await zip.generateAsync({ type: 'nodebuffer' }))
+    return archivePath
+}
+
+test('market recovery matches the complete slug and keeps similarly prefixed backups', async () => {
+    const base = `exact${Date.now()}${crypto.randomBytes(2).toString('hex')}`
+    const other = `${base}-extra`
+    const target = path.join(themesDir, base)
+    const otherTarget = path.join(themesDir, other)
+    const ownBackup = path.join(themesDir, `.phi-market-backup-${base}-${crypto.randomUUID()}`)
+    const otherBackup = path.join(themesDir, `.phi-market-backup-${other}-${crypto.randomUUID()}`)
+    try {
+        await writeMarketTheme(target, base, 'current')
+        await fs.promises.mkdir(otherTarget, { recursive: true })
+        await fs.promises.writeFile(path.join(otherTarget, 'info.yaml'), `id: ${other}\nname: Local\n`)
+        await writeMarketTheme(ownBackup, base, 'old')
+        await writeMarketTheme(otherBackup, other, 'other')
+        await recoverMarketInstall(base)
+        assert.equal(fs.existsSync(ownBackup), false)
+        assert.equal(fs.existsSync(otherBackup), true)
+    } finally {
+        await Promise.all([target, otherTarget, ownBackup, otherBackup].map(item =>
+            fs.promises.rm(item, { recursive: true, force: true })))
+    }
+})
+
+test('market recovery replaces a damaged marketplace target with a healthy backup', async () => {
+    const themeId = `damaged${Date.now()}${crypto.randomBytes(2).toString('hex')}`
+    const target = path.join(themesDir, themeId)
+    const backup = path.join(themesDir, `.phi-market-backup-${themeId}-${crypto.randomUUID()}`)
+    try {
+        await fs.promises.mkdir(target, { recursive: true })
+        await fs.promises.writeFile(path.join(target, 'info.yaml'), `id: ${themeId}\nname: Broken\n`)
+        await fs.promises.writeFile(path.join(target, '.phi-market.json'), '{truncated')
+        await writeMarketTheme(backup, themeId, 'healthy-backup')
+
+        const result = await recoverMarketInstall(themeId)
+        assert.equal(result.healthy, true)
+        assert.equal(await fs.promises.readFile(path.join(target, 'marker.txt'), 'utf8'), 'healthy-backup')
+        assert.equal(fs.existsSync(backup), false)
+    } finally {
+        await Promise.all([target, backup].map(item =>
+            fs.promises.rm(item, { recursive: true, force: true })))
+    }
+})
+
+test('startup recovery discovers interrupted installs without another install request', async () => {
+    const themeId = `startup${Date.now()}${crypto.randomBytes(2).toString('hex')}`
+    const target = path.join(themesDir, themeId)
+    const backup = path.join(themesDir, `.phi-market-backup-${themeId}-${crypto.randomUUID()}`)
+    try {
+        await writeMarketTheme(backup, themeId, 'startup-backup')
+        const failures = await recoverAllMarketInstalls()
+        assert.equal(failures.some(item => item.themeId === themeId), false)
+        assert.equal(await fs.promises.readFile(path.join(target, 'marker.txt'), 'utf8'), 'startup-backup')
+    } finally {
+        await Promise.all([target, backup].map(item =>
+            fs.promises.rm(item, { recursive: true, force: true })))
+    }
+})
+
+test('startup work cleanup also handles installs that never created a backup', async () => {
+    const work = await fs.promises.mkdtemp(path.join(path.dirname(themesDir), '.phi-work-cleanup-'))
+    const orphan = path.join(work, 'download-orphan.zip')
+    try {
+        await fs.promises.writeFile(orphan, 'partial download')
+        await cleanStaleMarketWork(true, work)
+        assert.equal(fs.existsSync(orphan), false)
+    } finally {
+        await fs.promises.rm(work, { recursive: true, force: true })
+    }
+})
+
+test('a local theme conflict still removes the already downloaded archive', async () => {
+    const themeId = `conflict${Date.now()}${crypto.randomBytes(2).toString('hex')}`
+    const target = path.join(themesDir, themeId)
+    let archivePath = ''
+    try {
+        await fs.promises.mkdir(target, { recursive: true })
+        await fs.promises.writeFile(path.join(target, 'info.yaml'), `id: ${themeId}\nname: Local\n`)
+        archivePath = await makeArchive(themeId)
+        await assert.rejects(
+            installMarketArchive(themeId, { version: '1.0.0', sha256: SHA256 }, archivePath),
+            error => /** @type {any} */ (error)?.code === 'theme_conflicts_with_local_theme',
+        )
+        assert.equal(fs.existsSync(archivePath), false)
+    } finally {
+        await fs.promises.rm(target, { recursive: true, force: true })
+        if (archivePath) await fs.promises.rm(archivePath, { force: true })
+    }
+})
+
+test('theme backup includes installed themes and restore preserves an existing target', async () => {
+    const themeId = `stored${Date.now()}${crypto.randomBytes(2).toString('hex')}`
+    const target = path.join(themesDir, themeId)
+    try {
+        await fs.promises.mkdir(path.join(target, 'nested'), { recursive: true })
+        await fs.promises.writeFile(path.join(target, 'info.yaml'), `id: ${themeId}\nname: Stored\n`)
+        await fs.promises.writeFile(path.join(target, 'nested', 'asset.txt'), 'from-backup')
+
+        const backup = new JSZip()
+        const result = addThemesToBackup(backup)
+        assert.ok(result.themes >= 1)
+        assert.ok(backup.file(`themes/${themeId}/nested/asset.txt`))
+
+        const restoreZip = new JSZip()
+        restoreZip.file(`themes/${themeId}/info.yaml`, `id: ${themeId}\nname: Stored\n`)
+        restoreZip.file(`themes/${themeId}/nested/asset.txt`, 'from-backup')
+        await fs.promises.rm(target, { recursive: true, force: true })
+        assert.deepEqual(await restoreThemesFromBackup(restoreZip), { restored: 1, skipped: 0 })
+        assert.equal(await fs.promises.readFile(path.join(target, 'nested', 'asset.txt'), 'utf8'), 'from-backup')
+
+        await fs.promises.writeFile(path.join(target, 'nested', 'asset.txt'), 'keep-current')
+        assert.deepEqual(await restoreThemesFromBackup(restoreZip), { restored: 0, skipped: 1 })
+        assert.equal(await fs.promises.readFile(path.join(target, 'nested', 'asset.txt'), 'utf8'), 'keep-current')
+    } finally {
+        await fs.promises.rm(target, { recursive: true, force: true })
+    }
+})
+
+test('a POSIX theme backup streams and restores locally valid file names', {
+    skip: process.platform === 'win32',
+}, async () => {
+    const themeId = `portable${Date.now()}${crypto.randomBytes(2).toString('hex')}`
+    const target = path.join(themesDir, themeId)
+    try {
+        await fs.promises.mkdir(target, { recursive: true })
+        await fs.promises.writeFile(path.join(target, 'info.yaml'), `id: ${themeId}\nname: Portable\n`)
+        for (const fileName of ['palette:night.css', 'trailing.', 'CON.asset']) {
+            await fs.promises.writeFile(path.join(target, fileName), fileName)
+        }
+
+        const backup = new JSZip()
+        addThemesToBackup(backup)
+        const bytes = await backup.generateAsync({ type: 'nodebuffer', streamFiles: true })
+        await fs.promises.rm(target, { recursive: true, force: true })
+        const loaded = await JSZip.loadAsync(bytes)
+        const result = await restoreThemesFromBackup(loaded)
+        assert.ok(result.restored >= 1)
+        for (const fileName of ['palette:night.css', 'trailing.', 'CON.asset']) {
+            assert.equal(await fs.promises.readFile(path.join(target, fileName), 'utf8'), fileName)
+        }
+    } finally {
+        await fs.promises.rm(target, { recursive: true, force: true })
+    }
+})