feat: 重构背景图处理体系，优化用户UX体验

- 重构背景图全链路处理：改用文件路径存储而非base64，新增`koring-res://`自定义协议流式加载本地壁纸，大幅降低内存占用
- 调整配置文件存储路径至userData目录，解决NSIS重装/升级时配置被清空的问题
- 新增路由调试页面，支持快速跳转所有已注册的应用页面
- 优化OOBE引导和更新完成页的「前往首页」按钮，添加4秒延迟渐入动画
- 自动迁移旧版配置：将安装目录的配置文件迁移至userData，同时将base64格式的背景配置自动转换为文件路径存储
- 重构预加载脚本、主进程IPC处理器与前端页面的背景图相关逻辑
- 更新AGENTS.md开发文档，修正路径与逻辑说明
- 更新应用背景图资源文件

AGENTS.md

@@ -27,8 +27,8 @@ pnpm dist:run           # production icon + Windows installer
 - **Preload script**: `electron/preload.ts` exposes `window.electronAPI` via context bridge.
 - **IPC handlers**: All handlers are in `electron/handlers/` directory.
 - **Mutable win ref**: `electron/main.ts` uses a mutable `win` object — handlers read `win.mainWindow` at runtime, not at registration time.
-- **Config**: YAML format (`Koring.yml`) stored next to executable. Sparse save (only non-default values).
-- **Auth**: JSON file (`koring-auth.json`) stored next to executable.
+- **Config**: YAML format (`Koring.yml`) stored in userData (packaged) / project root (dev). Sparse save (only non-default values). ⚠️ 不可放安装目录：NSIS 重装/升级会经旧卸载器删除整个安装目录。
+- **Auth**: JSON file (`koring-auth.json`) stored in userData (packaged) / project root (dev).
 - **Path alias**: `@/` maps to `src/` (configured in `vite.config.ts` and `tsconfig.json`).
 - **Dev mode**: Vite runs on port 1420, Electron loads from localhost.
 - **Asset paths**: Use `import.meta.env.BASE_URL` prefix for public assets. Absolute paths break in packaged app.
@@ -66,7 +66,8 @@ build/                   ← generated by switch-icon.js (gitignored)
 - `electron/config.ts`: YAML config management (sparse save)
 - `electron/auth.ts`: Auth data persistence (JSON file)
 - `electron/core/`: @xmcl/* integrations (auth, installer, launcher, modrinth, instance)
-- `electron/core/background-image.ts`: 背景图处理服务（自选背景降采样/重编码，程序本体资源管理）
+- `electron/core/background-image.ts`: 背景图处理服务 —— 自选壁纸复制到 userData 并按屏幕尺寸降采样/重编码**落盘**，配置文件只存**文件路径**（不使用 BASE64）
+- `electron/resource-protocol.ts`: `koring-res://` 特权自定义协议 —— 渲染进程以「资源引用」流式读取本地壁纸；仅服务 userData 内 `background-custom*` 白名单文件（realpath 二次校验，防目录穿越）
 - `electron/handlers/`: IPC handlers (config, auth, install, launch, mods, instance, background, task, system, window)
 
 ## Frontend notes
@@ -78,7 +79,7 @@ build/                   ← generated by switch-icon.js (gitignored)
   - `registry.ts` 资源注册表服务（acquire/release、引用计数、预算 + LRU 逐出、onRelease 释放回调）
   - `store.ts` 注册表 → zustand 镜像（调试面板消费）
   - `image.ts` 图片解码管线（按显示尺寸降采样）、`hooks.ts`/`ManagedImage.tsx` 复用组件（供列表缩略图）
-  - 当前接线点：`BackgroundLayer` 把当前背景登记为 `background` 类资源；主进程 `background:prepare` 在进渲染端前压小大图
+  - 当前接线点：`BackgroundLayer` 把当前背景（dataURL 或 koring-res 引用）登记为 `background` 类资源；自选壁纸经 `background:import` 落盘、配置存文件路径、渲染端经 `background:resolve` 拿 `koring-res://` 引用（全程无 base64）
   - 监控入口：debug 页「资源与内存」(`debug-resource`)
 - `src/hooks/useTheme.ts`: Dark mode sync with Electron theme
 - `src/components/system/WindowControls.tsx`: Custom window controls (min/max/close), uses `<button>` with `WebkitAppRegion: "no-drag"`