2026-06-28 03:37:07 +08:00
|
|
|
import * as fs from 'fs';
|
|
|
|
|
import * as path from 'path';
|
|
|
|
|
import * as yaml from 'js-yaml';
|
|
|
|
|
import electron from 'electron';
|
|
|
|
|
const { app } = electron;
|
|
|
|
|
|
|
|
|
|
const CONFIG_FILE = 'Koring.yml';
|
|
|
|
|
const CURRENT_VERSION = 1;
|
|
|
|
|
|
2026-08-28 02:08:12 +08:00
|
|
|
/**
|
|
|
|
|
* 配置文件路径：
|
|
|
|
|
* - 打包后 → 系统用户数据目录（userData），避免安装到 Program Files 等只读目录时写入失败
|
|
|
|
|
* - 开发模式 → 项目根目录（与旧行为一致，方便调试）
|
|
|
|
|
*/
|
2026-07-12 01:24:31 +08:00
|
|
|
export function configPath(): string {
|
2026-06-28 03:37:07 +08:00
|
|
|
if (app.isPackaged) {
|
2026-08-28 02:08:12 +08:00
|
|
|
return path.join(app.getPath('userData'), CONFIG_FILE);
|
2026-06-28 03:37:07 +08:00
|
|
|
}
|
|
|
|
|
return path.join(__dirname, '..', CONFIG_FILE);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
export interface ThemeConfig {
|
|
|
|
|
darkMode: string;
|
|
|
|
|
parallax: boolean;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
export interface A11yConfig {
|
|
|
|
|
reduceMotion: boolean;
|
|
|
|
|
reduceTransparency: boolean;
|
|
|
|
|
highContrast: boolean;
|
|
|
|
|
contentBlurOpacity: number;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
export interface BackgroundConfig {
|
|
|
|
|
bgType: string;
|
|
|
|
|
image: string;
|
|
|
|
|
blur: number;
|
|
|
|
|
opacity: number;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
export interface GameConfig {
|
|
|
|
|
gameDir: string;
|
|
|
|
|
resourceDir: string;
|
|
|
|
|
savesDir: string;
|
|
|
|
|
instancesDir: string;
|
2026-08-28 02:08:12 +08:00
|
|
|
/** 已添加的游戏目录列表 */
|
|
|
|
|
gameDirs: string[];
|
2026-06-28 03:37:07 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
export interface JavaConfig {
|
|
|
|
|
javaPath: string;
|
|
|
|
|
memMode: string;
|
|
|
|
|
memGB: number;
|
|
|
|
|
gc: string;
|
|
|
|
|
jvmArgs: string;
|
|
|
|
|
}
|
|
|
|
|
|
2026-08-28 02:08:12 +08:00
|
|
|
export interface ServerConfig {
|
|
|
|
|
ip: string;
|
|
|
|
|
port: number;
|
|
|
|
|
}
|
|
|
|
|
|
2026-06-28 03:37:07 +08:00
|
|
|
export interface AdvancedConfig {
|
|
|
|
|
afterLaunch: string;
|
|
|
|
|
winMode: string;
|
|
|
|
|
customWidth: number;
|
|
|
|
|
customHeight: number;
|
|
|
|
|
gameArgs: string;
|
|
|
|
|
preLaunchCmd: string;
|
|
|
|
|
debugMode: boolean;
|
2026-08-28 02:08:12 +08:00
|
|
|
/** 快速进入服务器（启动后自动加入；ip 为空则不自动加入） */
|
|
|
|
|
server: ServerConfig;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
export interface AppInfoConfig {
|
|
|
|
|
/** 界面语言偏好（zh-CN | en-US）；语言包开发中，暂仅保存并设置 <html lang> */
|
|
|
|
|
language: string;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
export interface UiConfig {
|
|
|
|
|
/** 首页实例标题显示 */
|
|
|
|
|
showInstanceTitle: boolean;
|
|
|
|
|
/** 标题栏任务队列按钮显示 */
|
|
|
|
|
showTaskButton: boolean;
|
2026-06-28 03:37:07 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
export interface DownloadConfig {
|
|
|
|
|
fileSource: string;
|
|
|
|
|
versionSource: string;
|
|
|
|
|
threads: number;
|
|
|
|
|
speedLimit: number;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
export interface SecurityIdConfig {
|
|
|
|
|
enabled: boolean;
|
|
|
|
|
authUrl: string;
|
|
|
|
|
}
|
|
|
|
|
|
2026-07-31 04:03:18 +08:00
|
|
|
export interface InstanceMeta {
|
|
|
|
|
name: string;
|
|
|
|
|
displayName: string;
|
|
|
|
|
icon: string;
|
|
|
|
|
gameVersion: string;
|
|
|
|
|
loader: string;
|
|
|
|
|
loaderVersion: string;
|
|
|
|
|
createdAt: number;
|
|
|
|
|
lastPlayed: number;
|
|
|
|
|
playtime: number;
|
|
|
|
|
}
|
|
|
|
|
|
2026-06-28 03:37:07 +08:00
|
|
|
export interface NetworkConfig {
|
|
|
|
|
securityId: SecurityIdConfig;
|
|
|
|
|
}
|
|
|
|
|
|
2026-08-30 20:19:15 +08:00
|
|
|
/** 更新进度持久化（主进程 updater 写入；重启后可恢复/展示） */
|
|
|
|
|
export interface UpdateConfig {
|
|
|
|
|
/** 状态：idle/checking/available/not-available/downloading/paused/downloaded/installing/error */
|
|
|
|
|
state: string;
|
|
|
|
|
/** 目标版本号 */
|
|
|
|
|
version: string;
|
|
|
|
|
/** 下载进度百分比 0-100 */
|
|
|
|
|
percent: number;
|
|
|
|
|
transferred: number;
|
|
|
|
|
total: number;
|
|
|
|
|
/** 更新源：github / 加速源域名 */
|
|
|
|
|
source: string;
|
2026-08-31 02:20:25 +08:00
|
|
|
/** 更新通道：woker（慢走，仅正式版）/ runner（跑步，含预览版） */
|
|
|
|
|
channel: string;
|
2026-08-30 20:19:15 +08:00
|
|
|
error: string;
|
|
|
|
|
}
|
|
|
|
|
|
2026-06-28 03:37:07 +08:00
|
|
|
export interface AppConfig {
|
|
|
|
|
version: number;
|
2026-07-12 01:24:31 +08:00
|
|
|
oobe: boolean;
|
2026-08-28 02:08:12 +08:00
|
|
|
app: AppInfoConfig;
|
2026-06-28 03:37:07 +08:00
|
|
|
theme: ThemeConfig;
|
|
|
|
|
a11y: A11yConfig;
|
|
|
|
|
background: BackgroundConfig;
|
|
|
|
|
game: GameConfig;
|
|
|
|
|
java: JavaConfig;
|
|
|
|
|
advanced: AdvancedConfig;
|
|
|
|
|
download: DownloadConfig;
|
|
|
|
|
network: NetworkConfig;
|
2026-08-28 02:08:12 +08:00
|
|
|
ui: UiConfig;
|
2026-08-30 20:19:15 +08:00
|
|
|
update: UpdateConfig;
|
2026-07-31 04:03:18 +08:00
|
|
|
instances: InstanceMeta[];
|
2026-06-28 03:37:07 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
const DEFAULTS: AppConfig = {
|
|
|
|
|
version: CURRENT_VERSION,
|
2026-07-12 01:24:31 +08:00
|
|
|
oobe: true,
|
2026-08-28 02:08:12 +08:00
|
|
|
app: { language: 'zh-CN' },
|
2026-06-28 03:37:07 +08:00
|
|
|
theme: { darkMode: 'auto', parallax: true },
|
|
|
|
|
a11y: { reduceMotion: false, reduceTransparency: false, highContrast: false, contentBlurOpacity: 50 },
|
|
|
|
|
background: { bgType: 'image', image: '/background.png', blur: 0, opacity: 100 },
|
2026-08-28 02:08:12 +08:00
|
|
|
game: { gameDir: '.minecraft', resourceDir: '', savesDir: '', instancesDir: '.minecraft/instances', gameDirs: [] },
|
2026-06-28 03:37:07 +08:00
|
|
|
java: { javaPath: '', memMode: 'auto', memGB: 4, gc: 'auto', jvmArgs: '' },
|
2026-08-28 02:08:12 +08:00
|
|
|
advanced: { afterLaunch: 'close', winMode: 'default', customWidth: 854, customHeight: 480, gameArgs: '', preLaunchCmd: '', debugMode: false, server: { ip: '', port: 25565 } },
|
2026-06-28 03:37:07 +08:00
|
|
|
download: { fileSource: 'mirror', versionSource: 'mirror', threads: 16, speedLimit: 0 },
|
|
|
|
|
network: { securityId: { enabled: false, authUrl: '' } },
|
2026-08-28 02:08:12 +08:00
|
|
|
ui: { showInstanceTitle: true, showTaskButton: true },
|
2026-08-31 02:20:25 +08:00
|
|
|
update: { state: 'idle', version: '', percent: 0, transferred: 0, total: 0, source: 'github', channel: 'woker', error: '' },
|
2026-07-31 04:03:18 +08:00
|
|
|
instances: [],
|
2026-06-28 03:37:07 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
|
|
function migrate(config: AppConfig): AppConfig {
|
|
|
|
|
if (config.version < 1) {
|
|
|
|
|
config.version = 1;
|
|
|
|
|
}
|
|
|
|
|
return config;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
function diffValue(full: unknown, defaultVal: unknown): unknown {
|
|
|
|
|
if (full === null || full === undefined) return undefined;
|
|
|
|
|
if (typeof full !== 'object' || typeof defaultVal !== 'object') {
|
|
|
|
|
return full === defaultVal ? undefined : full;
|
|
|
|
|
}
|
|
|
|
|
if (Array.isArray(full) && Array.isArray(defaultVal)) {
|
|
|
|
|
return JSON.stringify(full) === JSON.stringify(defaultVal) ? undefined : full;
|
|
|
|
|
}
|
|
|
|
|
if (Array.isArray(full) !== Array.isArray(defaultVal)) return full;
|
|
|
|
|
|
|
|
|
|
const fullObj = full as Record<string, unknown>;
|
|
|
|
|
const defaultObj = defaultVal as Record<string, unknown>;
|
|
|
|
|
const result: Record<string, unknown> = {};
|
|
|
|
|
|
|
|
|
|
for (const key of Object.keys(fullObj)) {
|
|
|
|
|
const d = diffValue(fullObj[key], defaultObj[key]);
|
|
|
|
|
if (d !== undefined) {
|
|
|
|
|
result[key] = d;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return Object.keys(result).length === 0 ? undefined : result;
|
|
|
|
|
}
|
|
|
|
|
|
2026-07-12 01:24:31 +08:00
|
|
|
export function configExists(): boolean {
|
|
|
|
|
try {
|
|
|
|
|
return fs.existsSync(configPath());
|
|
|
|
|
} catch {
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2026-06-28 03:37:07 +08:00
|
|
|
export function loadConfig(): AppConfig {
|
|
|
|
|
const filePath = configPath();
|
|
|
|
|
if (!fs.existsSync(filePath)) {
|
|
|
|
|
return { ...DEFAULTS };
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
try {
|
|
|
|
|
const raw = fs.readFileSync(filePath, 'utf-8');
|
|
|
|
|
if (!raw.trim()) return { ...DEFAULTS };
|
|
|
|
|
const parsed = yaml.load(raw) as Partial<AppConfig>;
|
|
|
|
|
const config = migrate({ ...DEFAULTS, ...parsed } as AppConfig);
|
|
|
|
|
config.version = CURRENT_VERSION;
|
|
|
|
|
return config;
|
|
|
|
|
} catch {
|
|
|
|
|
return { ...DEFAULTS };
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
export function saveConfig(config: AppConfig): void {
|
|
|
|
|
const filePath = configPath();
|
|
|
|
|
const sparse = diffValue(config, DEFAULTS) as Record<string, unknown> | undefined;
|
|
|
|
|
|
|
|
|
|
if (!sparse || Object.keys(sparse).length === 0) {
|
|
|
|
|
try { fs.unlinkSync(filePath); } catch {}
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
const yamlStr = yaml.dump(sparse, { lineWidth: -1 });
|
|
|
|
|
fs.writeFileSync(filePath, yamlStr, 'utf-8');
|
|
|
|
|
}
|
2026-08-28 02:08:12 +08:00
|
|
|
|
|
|
|
|
// ==================== 主进程权威配置模型 ====================
|
|
|
|
|
// 主进程内存缓存是唯一权威（single source of truth）：
|
|
|
|
|
// 渲染进程通过 config:update 提交补丁 → updateConfig 合并 → debounce 稀疏写盘
|
|
|
|
|
// 启动游戏时直接读内存缓存，保证永远是最新配置（无磁盘竞争）。
|
|
|
|
|
|
|
|
|
|
let current: AppConfig | null = null;
|
|
|
|
|
|
|
|
|
|
function mergeDeep<T>(base: T, patch: unknown): T {
|
|
|
|
|
if (patch === null || patch === undefined) return base;
|
|
|
|
|
if (typeof base !== 'object' || typeof patch !== 'object' || Array.isArray(base) || Array.isArray(patch)) {
|
|
|
|
|
return patch as T;
|
|
|
|
|
}
|
|
|
|
|
const result: Record<string, unknown> = { ...(base as Record<string, unknown>) };
|
|
|
|
|
for (const key of Object.keys(patch as Record<string, unknown>)) {
|
|
|
|
|
result[key] = mergeDeep(result[key], (patch as Record<string, unknown>)[key]);
|
|
|
|
|
}
|
|
|
|
|
return result as T;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** 读取当前配置（内存优先，未加载则从磁盘读取） */
|
|
|
|
|
export function getConfig(): AppConfig {
|
|
|
|
|
if (!current) {
|
|
|
|
|
current = loadConfig();
|
|
|
|
|
}
|
|
|
|
|
return current;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
let saveTimer: ReturnType<typeof setTimeout> | null = null;
|
|
|
|
|
|
|
|
|
|
function scheduleSave(): void {
|
|
|
|
|
if (saveTimer) clearTimeout(saveTimer);
|
|
|
|
|
saveTimer = setTimeout(() => {
|
|
|
|
|
saveTimer = null;
|
|
|
|
|
flushConfig();
|
|
|
|
|
}, 300);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** 立即将内存配置写盘（应用退出前调用） */
|
|
|
|
|
export function flushConfig(): void {
|
|
|
|
|
if (saveTimer) {
|
|
|
|
|
clearTimeout(saveTimer);
|
|
|
|
|
saveTimer = null;
|
|
|
|
|
}
|
|
|
|
|
if (current) {
|
|
|
|
|
saveConfig(current);
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** 深度合并补丁到内存配置并返回合并结果（300ms debounce 写盘） */
|
|
|
|
|
export function updateConfig(patch: Record<string, unknown>): AppConfig {
|
|
|
|
|
const base = getConfig();
|
|
|
|
|
current = mergeDeep(base, patch) as AppConfig;
|
|
|
|
|
scheduleSave();
|
|
|
|
|
return current;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** 删除内存配置中的指定顶层键（如 koringUser），300ms debounce 写盘 */
|
|
|
|
|
export function deleteConfigKey(key: string): AppConfig {
|
|
|
|
|
const base = getConfig();
|
|
|
|
|
const next = { ...(base as unknown as Record<string, unknown>) };
|
|
|
|
|
delete next[key];
|
|
|
|
|
current = next as unknown as AppConfig;
|
|
|
|
|
scheduleSave();
|
|
|
|
|
return current;
|
|
|
|
|
}
|
