34047007@qq.com
86126ea16f
- A1 业务层统一 async：gencode 表内省改 run_sync 异步（不再阻塞事件循环）、 check_db 改 async_engine、dict_util 启动预热异步载入；psycopg 降为 APScheduler SQLAlchemyJobStore 专用同步孤岛（注释标注） - A2 测试真 PG 化：conftest 弃 SQLite + mock Redis，改连真实 PG16(dpb_test)+ Redis（number_gen advisory lock 路径真被测）；新增 docker/test-compose.yaml 测试依赖栈(postgres:16:5433 + redis:7:6380)；run_ci 前置探测 + 容器兜底， pytest -m pg 10 套正式 tc 全过（真实 PG16 + Redis） - B1 Redis 启动不强依赖：redis_connect 失败降级启动，缓存类回源 DB、存储类 (会话/AI 配置/调度)经 require_redis 守卫返回 503；真机 3 阶段降级测试 PASS=11 FAIL=0（独立 Redis 6390 + 后端 8091，不动共享 dev 服务） - C 扶正 DPB：后端横幅/日志(dpb.log)/README/pyproject/ai_factory agent 名、 前端 package.json/署名注释/链接文案/deploy.sh/docker 注释全部去 fastapiadmin； grep backend/app + frontend/web/src 零残留 - 验证：全量回归 pass=72 fail=0
398 lines
12 KiB
TypeScript
398 lines
12 KiB
TypeScript
import { msg } from "@/utils/message";
|
||
/** System helpers (flattened). */
|
||
|
||
import type { App } from "vue";
|
||
import mitt, { type Emitter } from "mitt";
|
||
import VersionAPI from "@/api/module_system/version";
|
||
|
||
import { useUserStore } from "@stores";
|
||
import { Auth, StorageConfig } from "@utils";
|
||
import { BANNER } from "../../../build/banner";
|
||
|
||
// -----------------------------
|
||
// Console banner：ANSI 转义码生成网站 https://patorjk.com/software/taag/#p=testall&f=Fire+Font-k&t=dpb&x=none&v=4&h=4&w=80&we=false
|
||
// -----------------------------
|
||
|
||
export function printConsoleBanner(): void {
|
||
const asciiArt = `
|
||
\x1b[32m欢迎使用 ${StorageConfig.appName}-v${StorageConfig.CURRENT_VERSION}！
|
||
\x1b[0m
|
||
\x1b[32m${BANNER}
|
||
\x1b[0m
|
||
\x1b[36m你的支持就是我更新的超强动力！祝使用体验满分💯
|
||
\x1b[0m
|
||
\x1b[33m技术支持: 326030087（微信）
|
||
\x1b[0m
|
||
\x1b[31m广成科技: https://www.gonsun.com
|
||
\x1b[0m
|
||
`;
|
||
|
||
console.log(asciiArt);
|
||
}
|
||
|
||
// -----------------------------
|
||
// Mitt bus
|
||
// -----------------------------
|
||
|
||
type SysEvents = {
|
||
triggerFireworks: string | undefined;
|
||
openSetting: void;
|
||
openSearchDialog: void;
|
||
openChat: void;
|
||
openLockScreen: void;
|
||
};
|
||
|
||
export const mittBus: Emitter<SysEvents> = mitt<SysEvents>();
|
||
|
||
// -----------------------------
|
||
// Error handling
|
||
// -----------------------------
|
||
|
||
const IGNORABLE_SCRIPT_ERRORS = [
|
||
"ResizeObserver loop completed with undelivered notifications.",
|
||
"ResizeObserver loop limit exceeded",
|
||
];
|
||
|
||
function normalizeErrorMessage(message: Event | string): string {
|
||
if (typeof message === "string") return message;
|
||
if ("message" in message && typeof message.message === "string") return message.message;
|
||
return "";
|
||
}
|
||
|
||
function isIgnorableScriptError(message: Event | string, source?: string): boolean {
|
||
const normalizedMessage = normalizeErrorMessage(message);
|
||
if (!normalizedMessage) return false;
|
||
|
||
if (IGNORABLE_SCRIPT_ERRORS.some((item) => normalizedMessage.includes(item))) {
|
||
// 浏览器/扩展在布局抖动时常见的 ResizeObserver 噪声，不作为真实异常处理
|
||
return true;
|
||
}
|
||
|
||
// 浏览器扩展注入脚本偶发的跨域 Script error 也没有排查价值
|
||
if (normalizedMessage === "Script error." && source === "") return true;
|
||
return false;
|
||
}
|
||
|
||
export function vueErrorHandler(err: unknown, instance: any, info: string) {
|
||
console.error("[VueError]", err, info, instance);
|
||
}
|
||
|
||
export function scriptErrorHandler(
|
||
message: Event | string,
|
||
source?: string,
|
||
lineno?: number,
|
||
colno?: number,
|
||
error?: Error
|
||
): boolean {
|
||
if (isIgnorableScriptError(message, source)) return true;
|
||
console.error("[ScriptError]", { message, source, lineno, colno, error });
|
||
return true;
|
||
}
|
||
|
||
export function registerPromiseErrorHandler() {
|
||
window.addEventListener("unhandledrejection", (event) => {
|
||
console.error("[PromiseError]", event.reason);
|
||
});
|
||
}
|
||
|
||
export function registerResourceErrorHandler() {
|
||
window.addEventListener(
|
||
"error",
|
||
(event: Event) => {
|
||
const target = event.target as HTMLElement;
|
||
if (
|
||
target &&
|
||
(target.tagName === "IMG" || target.tagName === "SCRIPT" || target.tagName === "LINK")
|
||
) {
|
||
console.error("[ResourceError]", {
|
||
tagName: target.tagName,
|
||
src:
|
||
(target as HTMLImageElement).src ||
|
||
(target as HTMLScriptElement).src ||
|
||
(target as HTMLLinkElement).href,
|
||
});
|
||
}
|
||
},
|
||
true
|
||
);
|
||
}
|
||
|
||
export function initErrorHandle(app: App) {
|
||
app.config.errorHandler = vueErrorHandler;
|
||
window.onerror = scriptErrorHandler;
|
||
registerPromiseErrorHandler();
|
||
registerResourceErrorHandler();
|
||
}
|
||
|
||
// -----------------------------
|
||
// Upgrade
|
||
// -----------------------------
|
||
|
||
/**
|
||
* 版本升级管理器。
|
||
*
|
||
* ── 检测逻辑 ──
|
||
* 1. 跳过 1.0.0 版本（无需升级的基版本）
|
||
* 2. 首次访问 → 写入当前版本号，不升级
|
||
* 3. 版本相同 → 无需升级
|
||
* 4. 版本不同 + 存在旧数据 → 执行升级（展示通知、清理旧 key、按需登出）
|
||
* 5. 版本不同 + 无旧数据 → 仅更新版本号
|
||
*/
|
||
class VersionManager {
|
||
/** 轮询间隔（毫秒） */
|
||
private static readonly POLL_INTERVAL = 2 * 60 * 1000; // 2 分钟
|
||
|
||
/** localStorage key：上次检测到的构建 hash */
|
||
private static readonly DETECTED_HASH_KEY = "sys-detected-hash";
|
||
|
||
/** 当前页面的主脚本路径（Vite 构建时注入的 content hash） */
|
||
private readonly currentScriptSrc: string;
|
||
|
||
constructor() {
|
||
// 提取当前页面第一个 <script type="module" src="..."> 的 src
|
||
const scripts = document.querySelectorAll<HTMLScriptElement>("script[type=module]");
|
||
this.currentScriptSrc = scripts.length > 0 ? scripts[0]!.src : "";
|
||
}
|
||
|
||
private normalizeVersion(version: string): string {
|
||
return version.replace(/^v/, "");
|
||
}
|
||
|
||
private getStoredVersion(): string | null {
|
||
return localStorage.getItem(StorageConfig.VERSION_KEY);
|
||
}
|
||
|
||
private setStoredVersion(version: string): void {
|
||
localStorage.setItem(StorageConfig.VERSION_KEY, version);
|
||
}
|
||
|
||
private shouldSkipUpgrade(): boolean {
|
||
return StorageConfig.CURRENT_VERSION === StorageConfig.SKIP_UPGRADE_VERSION;
|
||
}
|
||
|
||
private isFirstVisit(storedVersion: string | null): boolean {
|
||
return !storedVersion;
|
||
}
|
||
|
||
private isSameVersion(storedVersion: string): boolean {
|
||
return storedVersion === StorageConfig.CURRENT_VERSION;
|
||
}
|
||
|
||
private findLegacyStorage(): { oldSysKey: string | null; oldVersionKeys: string[] } {
|
||
const storageKeys = Object.keys(localStorage);
|
||
const currentVersionPrefix = StorageConfig.generateStorageKey("").slice(0, -1);
|
||
|
||
const oldSysKey =
|
||
storageKeys.find(
|
||
(key) =>
|
||
StorageConfig.isVersionedKey(key) && key !== currentVersionPrefix && !key.includes("-")
|
||
) || null;
|
||
|
||
const oldVersionKeys = storageKeys.filter(
|
||
(key) =>
|
||
StorageConfig.isVersionedKey(key) &&
|
||
!StorageConfig.isCurrentVersionKey(key) &&
|
||
key.includes("-")
|
||
);
|
||
|
||
return { oldSysKey, oldVersionKeys };
|
||
}
|
||
|
||
private async fetchUpgradeVersions(): Promise<
|
||
{ version: string; title: string; requireReLogin: boolean }[]
|
||
> {
|
||
try {
|
||
const response = await VersionAPI.getPublishedVersions();
|
||
return (response.data.data ?? []).map((v) => ({
|
||
version: v.version ?? "",
|
||
title: v.title ?? "",
|
||
requireReLogin: v.require_re_login ?? false,
|
||
}));
|
||
} catch {
|
||
return [];
|
||
}
|
||
}
|
||
|
||
private shouldRequireReLogin(
|
||
storedVersion: string,
|
||
versions: { version: string; requireReLogin: boolean }[]
|
||
): boolean {
|
||
const normalizedCurrent = this.normalizeVersion(StorageConfig.CURRENT_VERSION);
|
||
const normalizedStored = this.normalizeVersion(storedVersion);
|
||
|
||
return versions.some((item) => {
|
||
const itemVersion = this.normalizeVersion(item.version);
|
||
return (
|
||
item.requireReLogin && itemVersion > normalizedStored && itemVersion <= normalizedCurrent
|
||
);
|
||
});
|
||
}
|
||
|
||
private buildUpgradeMessage(requireReLogin: boolean, latestTitle: string): string {
|
||
const messageParts = [
|
||
`<p style="color: var(--fa-gray-800) !important; padding-bottom: 5px;">`,
|
||
`系统已升级到 ${StorageConfig.CURRENT_VERSION} 版本，此次更新带来了以下改进：`,
|
||
`</p>`,
|
||
latestTitle,
|
||
];
|
||
|
||
if (requireReLogin) {
|
||
messageParts.push(
|
||
`<p style="color: var(--theme-color); padding-top: 5px;">升级完成，请重新登录后继续使用。</p>`
|
||
);
|
||
}
|
||
|
||
return messageParts.join("");
|
||
}
|
||
|
||
private showUpgradeNotification(message: string): void {
|
||
msg.notify({
|
||
title: "系统升级公告",
|
||
message,
|
||
duration: 0,
|
||
type: "success",
|
||
dangerouslyUseHTMLString: true,
|
||
});
|
||
}
|
||
|
||
private cleanupLegacyData(oldSysKey: string | null, oldVersionKeys: string[]): void {
|
||
if (oldSysKey) {
|
||
localStorage.removeItem(oldSysKey);
|
||
console.info(`[Upgrade] 已清理旧存储: ${oldSysKey}`);
|
||
}
|
||
|
||
oldVersionKeys.forEach((key) => {
|
||
localStorage.removeItem(key);
|
||
console.info(`[Upgrade] 已清理旧存储: ${key}`);
|
||
});
|
||
}
|
||
|
||
private performLogout(): void {
|
||
try {
|
||
useUserStore().logout();
|
||
console.info("[Upgrade] 已执行升级后登出");
|
||
} catch (error) {
|
||
console.error("[Upgrade] 升级后登出失败:", error);
|
||
}
|
||
}
|
||
|
||
private async executeUpgrade(
|
||
storedVersion: string,
|
||
legacyStorage: ReturnType<typeof this.findLegacyStorage>
|
||
): Promise<void> {
|
||
try {
|
||
const versions = await this.fetchUpgradeVersions();
|
||
if (!versions.length) {
|
||
console.warn("[Upgrade] 升级日志列表为空");
|
||
return;
|
||
}
|
||
|
||
const requireReLogin = this.shouldRequireReLogin(storedVersion, versions);
|
||
const message = this.buildUpgradeMessage(requireReLogin, versions[0]!.title);
|
||
|
||
this.showUpgradeNotification(message);
|
||
this.setStoredVersion(StorageConfig.CURRENT_VERSION);
|
||
this.cleanupLegacyData(legacyStorage.oldSysKey, legacyStorage.oldVersionKeys);
|
||
if (requireReLogin) this.performLogout();
|
||
|
||
console.info(`[Upgrade] 升级完成: ${storedVersion} → ${StorageConfig.CURRENT_VERSION}`);
|
||
} catch (error) {
|
||
console.error("[Upgrade] 系统升级处理失败:", error);
|
||
}
|
||
}
|
||
|
||
async processUpgrade(): Promise<void> {
|
||
if (this.shouldSkipUpgrade()) {
|
||
console.debug("[Upgrade] 跳过版本升级检查");
|
||
return;
|
||
}
|
||
|
||
const storedVersion = this.getStoredVersion();
|
||
if (this.isFirstVisit(storedVersion)) {
|
||
this.setStoredVersion(StorageConfig.CURRENT_VERSION);
|
||
console.info("[Upgrade] 首次访问，已设置当前版本");
|
||
return;
|
||
}
|
||
|
||
if (this.isSameVersion(storedVersion!)) {
|
||
console.debug("[Upgrade] 版本相同，无需升级");
|
||
return;
|
||
}
|
||
|
||
const legacyStorage = this.findLegacyStorage();
|
||
if (!legacyStorage.oldSysKey && legacyStorage.oldVersionKeys.length === 0) {
|
||
this.setStoredVersion(StorageConfig.CURRENT_VERSION);
|
||
console.info("[Upgrade] 无旧数据，已更新版本号");
|
||
return;
|
||
}
|
||
|
||
await this.executeUpgrade(storedVersion!, legacyStorage);
|
||
}
|
||
|
||
// ── 版本轮询（已打开页面的用户感知新版本部署） ──
|
||
|
||
/** 启动版本轮询：每隔 POLL_INTERVAL 检测 index.html 中的构建 hash 是否变化 */
|
||
startPolling(): void {
|
||
if (!this.currentScriptSrc) return;
|
||
|
||
const poll = async () => {
|
||
try {
|
||
const resp = await fetch(`/?_t=${Date.now()}`, { cache: "no-store" });
|
||
if (!resp.ok) return;
|
||
const html = await resp.text();
|
||
|
||
// 提取第一个 <script type="module" src="..."> 的 src
|
||
const match = html.match(/<script[^>]+type="module"[^>]+src="([^"]+)"/);
|
||
if (!match) return;
|
||
|
||
const remoteSrc = match[1]!;
|
||
if (remoteSrc === this.currentScriptSrc) return;
|
||
|
||
// 去重：同一 hash 不重复提示
|
||
const previousHash = localStorage.getItem(VersionManager.DETECTED_HASH_KEY);
|
||
if (previousHash === remoteSrc) return;
|
||
localStorage.setItem(VersionManager.DETECTED_HASH_KEY, remoteSrc);
|
||
|
||
// this.showUpdateNotification();
|
||
} catch {
|
||
// 网络失败静默跳过
|
||
}
|
||
};
|
||
|
||
poll(); // 首次立刻检测
|
||
setInterval(poll, VersionManager.POLL_INTERVAL);
|
||
}
|
||
|
||
private showUpdateNotification(): void {
|
||
msg.notify({
|
||
title: "新版本已发布",
|
||
message: "检测到新版本，请刷新页面以获取最新内容。",
|
||
duration: 0,
|
||
type: "warning",
|
||
dangerouslyUseHTMLString: false,
|
||
});
|
||
}
|
||
}
|
||
|
||
export async function processUpgrade(): Promise<void> {
|
||
const versionManager = new VersionManager();
|
||
await versionManager.processUpgrade();
|
||
}
|
||
|
||
export function systemUpgrade(): void {
|
||
setTimeout(() => {
|
||
void processUpgrade();
|
||
}, StorageConfig.UPGRADE_DELAY);
|
||
}
|
||
|
||
let _versionManager: VersionManager | null = null;
|
||
|
||
/** 启动版本轮询（检测已打开页面是否收到新部署） */
|
||
export function startVersionPolling(): void {
|
||
if (!Auth.isLoggedIn()) return;
|
||
if (!_versionManager) {
|
||
_versionManager = new VersionManager();
|
||
}
|
||
_versionManager.startPolling();
|
||
}
|