Files
crawler-plugin/frontend-vue/src/shared/client-force-update.ts
T
huangzd1997 fa11db59ee feat(用户端): 低于 4.0.52 的桌面装机进强制升级遮罩——存量装机只有线上 Web 这一条覆盖通道
后端那个版本地板闸门只会把请求挡成 code 4012,客户端业务代码里没有任何 4012 分支:只拦、不推;
而桌面窗口直载 app-web(APP_URL = config.WEB_HOME_URL),做在页面上才吃得到已经装出去的机器。

判定落在 shared/client-force-update.ts(纯函数,17 例含"换地板结论就翻面"的反例):判不出来一律不拦
(浏览器形态、读不到本机版本、版本串解析不出数字、没有可下的包、线上包并不比本机新)。
遮罩挂 App.vue 根=登录页与首页一起覆盖,自动开始下载,失败只给"重试(断点续传)",不再等第二次确认。
2026-10-13 21:37:08 +08:00

75 lines
3.5 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* 强制升级判定(纯函数,无 DOM、可 node --test 直跑)。
*
* 动机:桌面窗口的页面是线上 Web(app_client/main.py 的 APP_URL = config.WEB_HOME_URL),
* 所以"要不要升、不升能不能继续用"这件事只有发一次 app-web 才能覆盖存量装机;
* 服务端那个版本地板闸门(ClientVersionGuardFilter)只会把请求挡成 code 4012,
* 而客户端业务代码里没有任何 4012 分支——它只拦、不推。这里补的就是"推"那一半。
*
* 判定刻意保守:**任何"判不出来"的情况一律不拦**(浏览器形态、读不到本机版本、
* 版本串解析不出数字、没有可下载的更新包、最新包并不比本机新)。
* 挡在门外是拿用户当天的任务换他们的下一次启动,误判一次的代价比漏判大。
*/
import { compareVersions, normVersion } from './utils/version-compare.ts'
/** 强升地板:低于这个版本的桌面装机必须更新后才能继续用。 */
export const FORCE_UPDATE_TARGET = '4.0.52'
/** 不拦的理由。每个值都必须能在界面上被解释,不许拿空串当"没必要说"。 */
export type ForceSkipReason =
| 'not-desktop'
| 'no-local-version'
| 'unparsable-local-version'
| 'invalid-target'
| 'at-or-above-target'
| 'no-newer-package'
export type ForceDecision =
| { force: true; localVersion: string; targetVersion: string }
| { force: false; reason: ForceSkipReason; localVersion: string; targetVersion: string }
/**
* 点分数字版本:至少三段、每段都是非负整数。
*
* 需要它是因为 compareVersions 把解析不出的段当 0('4.0.52-beta' 会等于 '4.0.0'),
* 于是"带后缀的版本"会被判成更旧而误锁人。地板只认能算干净的形状。
*/
export function isDottedNumericVersion(value: string): boolean {
const parts = normVersion(value).split('.')
if (parts.length < 3) return false
return parts.every((part) => /^\d+$/.test(part))
}
export function decideForceUpdate(input: {
/** 有没有真实的桌面桥(能下载并自启更新程序);Web 降级桥不算。 */
desktopBridge: boolean
/** 本机 exe 版本(桥读不到就传空串)。 */
localVersion: string
/** 线上最新包版本(/api/version/latest 的 version)。 */
latestVersion: string
/** 最新包有没有可用下载地址。 */
hasPackage: boolean
targetVersion?: string
}): ForceDecision {
const target = normVersion(input.targetVersion ?? FORCE_UPDATE_TARGET)
const local = normVersion(input.localVersion)
const notForced = (reason: ForceSkipReason): ForceDecision => ({
force: false,
reason,
localVersion: local,
targetVersion: target,
})
if (!input.desktopBridge) return notForced('not-desktop')
if (!isDottedNumericVersion(target)) return notForced('invalid-target')
if (!local) return notForced('no-local-version')
if (!isDottedNumericVersion(local)) return notForced('unparsable-local-version')
if (compareVersions(local, target) >= 0) return notForced('at-or-above-target')
// 到了这一步才看包:没有地址、或线上包并不比本机新,那就拿不出"升上去更好"的东西,
// 不能把人锁在门外(灰度回滚期 latest 低于地板是真实存在的状态)。
if (!input.hasPackage) return notForced('no-newer-package')
const latest = normVersion(input.latestVersion)
if (!latest || compareVersions(latest, local) <= 0) return notForced('no-newer-package')
return { force: true, localVersion: local, targetVersion: target }
}