2026-10-11 11:49:32 +08:00
|
|
|
|
import crypto from 'node:crypto';
|
2026-09-11 22:46:31 +08:00
|
|
|
|
import fs from 'node:fs';
|
|
|
|
|
|
import path from 'node:path';
|
|
|
|
|
|
import { app, safeStorage } from 'electron';
|
2026-09-27 14:59:12 +08:00
|
|
|
|
import {
|
|
|
|
|
|
CLASSISLAND_NOTIFICATION_CHANNELS,
|
|
|
|
|
|
DEFAULT_CLASSISLAND_NOTIFICATION_CHANNEL,
|
|
|
|
|
|
DEFAULT_ISLAND_APPEARANCE,
|
|
|
|
|
|
DEFAULT_SERVER_URL,
|
2026-09-27 16:34:01 +08:00
|
|
|
|
HOMEWORK_PHRASE_DEFAULTS,
|
|
|
|
|
|
HOMEWORK_PHRASE_MAX_COUNT,
|
|
|
|
|
|
HOMEWORK_PHRASE_MAX_LENGTH,
|
2026-09-27 14:59:12 +08:00
|
|
|
|
type ClassIslandNotificationChannel,
|
|
|
|
|
|
type IslandAppearance,
|
|
|
|
|
|
} from '@classhelper/shared';
|
2026-10-02 00:25:10 +08:00
|
|
|
|
import { logger } from './logger.js';
|
2026-09-12 23:48:59 +08:00
|
|
|
|
import type { DesktopStoredConfig, HomeworkBoardSettings } from '../types/desktop.js';
|
|
|
|
|
|
|
|
|
|
|
|
/** 作业页展示偏好默认值(看板 + 不显示时间 + 15px) */
|
|
|
|
|
|
const DEFAULT_HOMEWORK_BOARD: HomeworkBoardSettings = {
|
|
|
|
|
|
mode: 'board',
|
|
|
|
|
|
showTime: false,
|
|
|
|
|
|
fontSize: 15,
|
|
|
|
|
|
};
|
2026-09-11 22:46:31 +08:00
|
|
|
|
|
|
|
|
|
|
interface PersistedConfig {
|
|
|
|
|
|
serverUrl: string;
|
|
|
|
|
|
username: string;
|
|
|
|
|
|
/** 加密后的 token(base64)或明文(当系统不支持加密时) */
|
|
|
|
|
|
token: string | null;
|
|
|
|
|
|
tokenEncrypted: boolean;
|
2026-09-12 15:19:13 +08:00
|
|
|
|
/** 个性化设置:灵动岛外观(向后兼容:旧配置文件没有该字段时用默认值补齐) */
|
|
|
|
|
|
island?: Partial<IslandAppearance>;
|
2026-09-12 23:48:59 +08:00
|
|
|
|
/** 作业页展示偏好(向后兼容:旧配置文件没有该字段时用默认值补齐) */
|
|
|
|
|
|
homeworkBoard?: Partial<HomeworkBoardSettings>;
|
2026-09-27 14:59:12 +08:00
|
|
|
|
/** 通知显示位置(向后兼容:旧配置文件没有该字段时按默认 both 补齐) */
|
|
|
|
|
|
notificationChannel?: ClassIslandNotificationChannel;
|
2026-09-27 16:34:01 +08:00
|
|
|
|
/** 作业录入快捷短语(向后兼容:旧配置没有该字段时用默认那一组) */
|
|
|
|
|
|
homeworkPhrases?: string[];
|
2026-10-02 11:18:47 +08:00
|
|
|
|
/** 是否已看过初次启动引导(向后兼容:旧配置没有该字段视为没看过,首启弹一次) */
|
|
|
|
|
|
onboardingDone?: boolean;
|
|
|
|
|
|
/** 界面主题(向后兼容:旧配置没有该字段用浅色) */
|
|
|
|
|
|
theme?: 'light' | 'dark';
|
|
|
|
|
|
/** 主侧边栏是否折叠(向后兼容:旧配置没有该字段视为展开) */
|
|
|
|
|
|
sidebarCollapsed?: boolean;
|
2026-10-05 16:39:38 +08:00
|
|
|
|
/** 用户选择「忽略此版本」的版本号(向后兼容:旧配置没有该字段视为没忽略过任何版本) */
|
|
|
|
|
|
ignoredUpdateVersion?: string;
|
2026-10-11 11:49:32 +08:00
|
|
|
|
/** 本机设备标识(向后兼容:旧配置没有该字段时首次读取生成并落盘,之后永不变) */
|
|
|
|
|
|
deviceKey?: string;
|
|
|
|
|
|
/** 是否开机自启(向后兼容:旧配置没有该字段视为关闭 —— 由用户在设置页自己打开) */
|
|
|
|
|
|
autoLaunch?: boolean;
|
|
|
|
|
|
/** 是否接受服务端统一下发的自动更新(向后兼容:旧配置没有该字段视为开启) */
|
|
|
|
|
|
autoUpdate?: boolean;
|
|
|
|
|
|
/** 开发者模式:日志调到 debug 级 + 设置里多出「开发者」页(向后兼容:旧配置没有该字段视为关闭) */
|
|
|
|
|
|
developerMode?: boolean;
|
|
|
|
|
|
/** 关怀模式:整体放大正文与控件字号,供视力不佳的用户使用(向后兼容:旧配置没有该字段视为关闭) */
|
|
|
|
|
|
careMode?: boolean;
|
|
|
|
|
|
/** 已下载待安装的更新版本(空串 = 无;跨重启保留) */
|
|
|
|
|
|
pendingUpdateVersion?: string;
|
|
|
|
|
|
/** 已下载待安装的安装包绝对路径(空串 = 无;跨重启保留) */
|
|
|
|
|
|
pendingUpdateFile?: string;
|
2026-09-11 22:46:31 +08:00
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
const DEFAULT_CONFIG: PersistedConfig = {
|
|
|
|
|
|
serverUrl: DEFAULT_SERVER_URL,
|
|
|
|
|
|
username: '',
|
|
|
|
|
|
token: null,
|
|
|
|
|
|
tokenEncrypted: false,
|
2026-09-12 15:19:13 +08:00
|
|
|
|
island: { ...DEFAULT_ISLAND_APPEARANCE },
|
2026-09-12 23:48:59 +08:00
|
|
|
|
homeworkBoard: { ...DEFAULT_HOMEWORK_BOARD },
|
2026-09-27 14:59:12 +08:00
|
|
|
|
notificationChannel: DEFAULT_CLASSISLAND_NOTIFICATION_CHANNEL,
|
2026-09-27 16:34:01 +08:00
|
|
|
|
homeworkPhrases: [...HOMEWORK_PHRASE_DEFAULTS],
|
2026-10-02 11:18:47 +08:00
|
|
|
|
onboardingDone: false,
|
|
|
|
|
|
theme: 'light',
|
|
|
|
|
|
sidebarCollapsed: false,
|
2026-10-05 16:39:38 +08:00
|
|
|
|
ignoredUpdateVersion: '',
|
2026-10-11 11:49:32 +08:00
|
|
|
|
deviceKey: '',
|
|
|
|
|
|
autoLaunch: false,
|
|
|
|
|
|
autoUpdate: true,
|
|
|
|
|
|
developerMode: false,
|
|
|
|
|
|
careMode: false,
|
|
|
|
|
|
pendingUpdateVersion: '',
|
|
|
|
|
|
pendingUpdateFile: '',
|
2026-09-11 22:46:31 +08:00
|
|
|
|
};
|
|
|
|
|
|
|
2026-10-02 11:18:47 +08:00
|
|
|
|
/** 主题白名单:非法值一律回落浅色 */
|
|
|
|
|
|
function normalizeTheme(input?: 'light' | 'dark'): 'light' | 'dark' {
|
|
|
|
|
|
return input === 'dark' ? 'dark' : 'light';
|
|
|
|
|
|
}
|
|
|
|
|
|
|
2026-09-27 16:34:01 +08:00
|
|
|
|
/**
|
|
|
|
|
|
* 作业快捷短语的合法化:去空白、去重、限长限量。
|
|
|
|
|
|
* 空数组是**合法值**(老师把短语全删了 = 不想用快捷短语),因此不能拿默认值顶回去。
|
|
|
|
|
|
*/
|
|
|
|
|
|
function normalizeHomeworkPhrases(input?: string[]): string[] {
|
|
|
|
|
|
if (!Array.isArray(input)) return [...HOMEWORK_PHRASE_DEFAULTS];
|
|
|
|
|
|
const seen = new Set<string>();
|
|
|
|
|
|
const result: string[] = [];
|
|
|
|
|
|
for (const raw of input) {
|
|
|
|
|
|
if (typeof raw !== 'string') continue;
|
|
|
|
|
|
const value = raw.trim().slice(0, HOMEWORK_PHRASE_MAX_LENGTH);
|
|
|
|
|
|
if (!value || seen.has(value)) continue;
|
|
|
|
|
|
seen.add(value);
|
|
|
|
|
|
result.push(value);
|
|
|
|
|
|
if (result.length >= HOMEWORK_PHRASE_MAX_COUNT) break;
|
|
|
|
|
|
}
|
|
|
|
|
|
return result;
|
|
|
|
|
|
}
|
|
|
|
|
|
|
2026-09-27 14:59:12 +08:00
|
|
|
|
/** 通知显示位置的白名单校验:非法值一律回落到默认值,避免坏配置把提醒"静默吞掉" */
|
|
|
|
|
|
function normalizeNotificationChannel(
|
|
|
|
|
|
input?: ClassIslandNotificationChannel,
|
|
|
|
|
|
): ClassIslandNotificationChannel {
|
|
|
|
|
|
return CLASSISLAND_NOTIFICATION_CHANNELS.includes(input as ClassIslandNotificationChannel)
|
|
|
|
|
|
? (input as ClassIslandNotificationChannel)
|
|
|
|
|
|
: DEFAULT_CLASSISLAND_NOTIFICATION_CHANNEL;
|
|
|
|
|
|
}
|
|
|
|
|
|
|
2026-09-12 23:48:59 +08:00
|
|
|
|
/** 作业页偏好的合法化(模式白名单、字号夹紧) */
|
|
|
|
|
|
function normalizeHomeworkBoard(input?: Partial<HomeworkBoardSettings>): HomeworkBoardSettings {
|
|
|
|
|
|
const mode = input?.mode === 'list' ? 'list' : 'board';
|
|
|
|
|
|
const rawFont =
|
|
|
|
|
|
typeof input?.fontSize === 'number' && Number.isFinite(input.fontSize)
|
|
|
|
|
|
? input.fontSize
|
|
|
|
|
|
: DEFAULT_HOMEWORK_BOARD.fontSize;
|
|
|
|
|
|
return {
|
|
|
|
|
|
mode,
|
|
|
|
|
|
showTime: input?.showTime === true,
|
|
|
|
|
|
fontSize: Math.min(28, Math.max(11, Math.round(rawFont))),
|
|
|
|
|
|
};
|
|
|
|
|
|
}
|
|
|
|
|
|
|
2026-09-12 15:19:13 +08:00
|
|
|
|
/** 外观字段的合法区间校验(越界值直接夹紧,避免用户配置破坏灵动岛布局) */
|
|
|
|
|
|
function normalizeIslandAppearance(input?: Partial<IslandAppearance>): IslandAppearance {
|
|
|
|
|
|
const clamp = (value: unknown, min: number, max: number, fallback: number): number => {
|
|
|
|
|
|
const numeric = typeof value === 'number' && Number.isFinite(value) ? value : fallback;
|
|
|
|
|
|
return Math.min(max, Math.max(min, Math.round(numeric * 100) / 100));
|
|
|
|
|
|
};
|
2026-09-12 17:41:05 +08:00
|
|
|
|
const positions: IslandAppearance['position'][] = [
|
|
|
|
|
|
'top-center',
|
|
|
|
|
|
'top-left',
|
|
|
|
|
|
'top-right',
|
|
|
|
|
|
'bottom-center',
|
|
|
|
|
|
'bottom-left',
|
|
|
|
|
|
'bottom-right',
|
|
|
|
|
|
];
|
|
|
|
|
|
const styles: IslandAppearance['style'][] = ['black', 'glass', 'tinted'];
|
2026-09-12 15:19:13 +08:00
|
|
|
|
return {
|
|
|
|
|
|
height: clamp(input?.height, 36, 72, DEFAULT_ISLAND_APPEARANCE.height),
|
|
|
|
|
|
width: clamp(input?.width, 220, 420, DEFAULT_ISLAND_APPEARANCE.width),
|
|
|
|
|
|
radius: clamp(input?.radius, 8, 32, DEFAULT_ISLAND_APPEARANCE.radius),
|
|
|
|
|
|
opacity: clamp(input?.opacity, 0.4, 1, DEFAULT_ISLAND_APPEARANCE.opacity),
|
|
|
|
|
|
accent:
|
|
|
|
|
|
typeof input?.accent === 'string' && /^#[0-9a-fA-F]{6}$/.test(input.accent)
|
|
|
|
|
|
? input.accent
|
|
|
|
|
|
: DEFAULT_ISLAND_APPEARANCE.accent,
|
2026-09-12 17:41:05 +08:00
|
|
|
|
fontSize: clamp(input?.fontSize, 11, 20, DEFAULT_ISLAND_APPEARANCE.fontSize),
|
2026-09-12 15:19:13 +08:00
|
|
|
|
animations: input?.animations !== false,
|
|
|
|
|
|
speed: clamp(input?.speed, 0.5, 2, DEFAULT_ISLAND_APPEARANCE.speed),
|
|
|
|
|
|
position: positions.includes(input?.position as IslandAppearance['position'])
|
|
|
|
|
|
? (input?.position as IslandAppearance['position'])
|
|
|
|
|
|
: DEFAULT_ISLAND_APPEARANCE.position,
|
|
|
|
|
|
alwaysOnTop: input?.alwaysOnTop !== false,
|
2026-09-12 17:41:05 +08:00
|
|
|
|
style: styles.includes(input?.style as IslandAppearance['style'])
|
|
|
|
|
|
? (input?.style as IslandAppearance['style'])
|
|
|
|
|
|
: DEFAULT_ISLAND_APPEARANCE.style,
|
|
|
|
|
|
idleSliver: input?.idleSliver === true,
|
2026-09-27 16:34:01 +08:00
|
|
|
|
marginX: clamp(input?.marginX, 0, 200, DEFAULT_ISLAND_APPEARANCE.marginX),
|
|
|
|
|
|
marginY: clamp(input?.marginY, 0, 160, DEFAULT_ISLAND_APPEARANCE.marginY),
|
|
|
|
|
|
followCursorDisplay: input?.followCursorDisplay === true,
|
2026-09-12 15:19:13 +08:00
|
|
|
|
};
|
|
|
|
|
|
}
|
|
|
|
|
|
|
2026-09-11 22:46:31 +08:00
|
|
|
|
function configFilePath(): string {
|
|
|
|
|
|
return path.join(app.getPath('userData'), 'config.json');
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
function encryptToken(token: string | null): { token: string | null; tokenEncrypted: boolean } {
|
|
|
|
|
|
if (!token) return { token: null, tokenEncrypted: false };
|
|
|
|
|
|
try {
|
|
|
|
|
|
if (safeStorage.isEncryptionAvailable()) {
|
|
|
|
|
|
return { token: safeStorage.encryptString(token).toString('base64'), tokenEncrypted: true };
|
|
|
|
|
|
}
|
|
|
|
|
|
} catch {
|
2026-10-02 00:25:10 +08:00
|
|
|
|
// 见下方降级分支
|
2026-09-11 22:46:31 +08:00
|
|
|
|
}
|
2026-10-02 00:25:10 +08:00
|
|
|
|
// 降级为明文存储(DPAPI 不可用,一般只在本地开发环境出现)。
|
|
|
|
|
|
// 必须留下日志:明文 token 代表该班的全班身份,任何能读用户目录的进程/备份/同步盘都能拿到,
|
|
|
|
|
|
// 静默降级会让"为什么换个环境就得重新登录/凭据是怎么泄露的"无从查起。
|
|
|
|
|
|
logger.warn(
|
|
|
|
|
|
`系统加密存储不可用,登录令牌将以**明文**写入配置(${configFilePath()});` +
|
|
|
|
|
|
'如需加密请确认 Windows 凭据保护(DPAPI)可用',
|
|
|
|
|
|
);
|
2026-09-11 22:46:31 +08:00
|
|
|
|
return { token, tokenEncrypted: false };
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
function decryptToken(raw: PersistedConfig): string | null {
|
|
|
|
|
|
if (!raw.token) return null;
|
|
|
|
|
|
if (!raw.tokenEncrypted) return raw.token;
|
|
|
|
|
|
try {
|
|
|
|
|
|
return safeStorage.decryptString(Buffer.from(raw.token, 'base64'));
|
|
|
|
|
|
} catch {
|
|
|
|
|
|
return null;
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
|
2026-10-05 16:39:38 +08:00
|
|
|
|
function readPersistedFromDisk(): PersistedConfig {
|
2026-09-11 22:46:31 +08:00
|
|
|
|
try {
|
|
|
|
|
|
const content = fs.readFileSync(configFilePath(), 'utf8');
|
|
|
|
|
|
const parsed = JSON.parse(content) as Partial<PersistedConfig>;
|
|
|
|
|
|
return {
|
|
|
|
|
|
serverUrl:
|
|
|
|
|
|
typeof parsed.serverUrl === 'string' && parsed.serverUrl
|
2026-10-02 00:25:10 +08:00
|
|
|
|
? (normalizeServerUrl(parsed.serverUrl) ?? DEFAULT_CONFIG.serverUrl)
|
2026-09-11 22:46:31 +08:00
|
|
|
|
: DEFAULT_CONFIG.serverUrl,
|
|
|
|
|
|
username: typeof parsed.username === 'string' ? parsed.username : '',
|
|
|
|
|
|
token: typeof parsed.token === 'string' ? parsed.token : null,
|
|
|
|
|
|
tokenEncrypted: parsed.tokenEncrypted === true,
|
2026-09-12 15:19:13 +08:00
|
|
|
|
island: normalizeIslandAppearance(parsed.island),
|
2026-09-12 23:48:59 +08:00
|
|
|
|
homeworkBoard: normalizeHomeworkBoard(parsed.homeworkBoard),
|
2026-09-27 14:59:12 +08:00
|
|
|
|
notificationChannel: normalizeNotificationChannel(parsed.notificationChannel),
|
2026-09-27 16:34:01 +08:00
|
|
|
|
homeworkPhrases: normalizeHomeworkPhrases(parsed.homeworkPhrases),
|
2026-10-02 11:18:47 +08:00
|
|
|
|
onboardingDone: parsed.onboardingDone === true,
|
|
|
|
|
|
theme: normalizeTheme(parsed.theme),
|
|
|
|
|
|
sidebarCollapsed: parsed.sidebarCollapsed === true,
|
2026-10-05 16:39:38 +08:00
|
|
|
|
ignoredUpdateVersion:
|
|
|
|
|
|
typeof parsed.ignoredUpdateVersion === 'string' ? parsed.ignoredUpdateVersion : '',
|
2026-10-11 11:49:32 +08:00
|
|
|
|
deviceKey: typeof parsed.deviceKey === 'string' ? parsed.deviceKey : '',
|
|
|
|
|
|
autoLaunch: parsed.autoLaunch === true,
|
|
|
|
|
|
// 默认开启:老配置文件里没有这个字段时按"接受服务端统一下发的更新"处理
|
|
|
|
|
|
autoUpdate: parsed.autoUpdate !== false,
|
|
|
|
|
|
developerMode: parsed.developerMode === true,
|
|
|
|
|
|
careMode: parsed.careMode === true,
|
|
|
|
|
|
pendingUpdateVersion:
|
|
|
|
|
|
typeof parsed.pendingUpdateVersion === 'string' ? parsed.pendingUpdateVersion : '',
|
|
|
|
|
|
pendingUpdateFile: typeof parsed.pendingUpdateFile === 'string' ? parsed.pendingUpdateFile : '',
|
2026-09-11 22:46:31 +08:00
|
|
|
|
};
|
|
|
|
|
|
} catch {
|
|
|
|
|
|
return { ...DEFAULT_CONFIG };
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
|
2026-10-05 16:39:38 +08:00
|
|
|
|
/* ------------------------------------------------------------ 内存缓存 + 异步合并写
|
|
|
|
|
|
*
|
|
|
|
|
|
* 为什么不能每次 saveConfig 都同步读写盘(原来的写法):
|
|
|
|
|
|
* 侧栏折叠(`stores/ui.ts` 的 toggleSidebar)、主题切换、通知渠道、作业看板偏好、登录/登出
|
|
|
|
|
|
* 全都走 `saveConfig`,而它一次调用要做「readFileSync + JSON.parse + 8 个 normalize」**两遍**
|
|
|
|
|
|
* (开头读一遍、结尾 `getConfig()` 又读一遍)+ `writeFileSync` 一遍 + DPAPI 解密一遍,
|
|
|
|
|
|
* **全部同步跑在主进程主线程上**。主进程是 Electron 的消息泵进程,被它摁住的那一拍
|
|
|
|
|
|
* 渲染进程也跟着掉帧 —— 用户反馈的"点汉堡展开/收回侧栏时卡一下"就是这一拍。
|
|
|
|
|
|
*
|
|
|
|
|
|
* 现在:配置常驻内存(连已解密的 token 一起缓存),写盘改成**异步 + 合并** ——
|
|
|
|
|
|
* 同一拍内的多次改动只落最后一次,写入串行不会互相覆盖;退出前由 `flushConfigSync()` 兜底。
|
|
|
|
|
|
*
|
|
|
|
|
|
* **语义变化(有意为之)**:`saveConfig()` 返回时数据可能还没落盘(延迟 CONFIG_WRITE_DEBOUNCE_MS)。
|
|
|
|
|
|
* 正常退出(托盘 → 退出)会走 `flushConfigSync()`,不会丢最后一次改动;只有进程被强杀
|
|
|
|
|
|
* 才可能丢这最后 120ms 内的改动。
|
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
|
|
/** 写入合并窗口:拖动同类控件(滑块/连续点击)时的连续改动只落最后一次 */
|
|
|
|
|
|
const CONFIG_WRITE_DEBOUNCE_MS = 120;
|
|
|
|
|
|
|
|
|
|
|
|
interface ConfigCache {
|
|
|
|
|
|
config: PersistedConfig;
|
|
|
|
|
|
/** 已解密的登录令牌(null = 未登录 / 解密失败)。缓存它是为了不再每次都走一遍 DPAPI */
|
|
|
|
|
|
token: string | null;
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* 内存配置。**必须懒初始化**:`main/index.ts` 会先 `app.setPath('userData', smokeProfile)`
|
|
|
|
|
|
* 把配置目录指到冒烟专用 profile,之后才第一次读配置;在模块顶层立即读盘会读错文件。
|
|
|
|
|
|
*/
|
|
|
|
|
|
let cache: ConfigCache | null = null;
|
|
|
|
|
|
|
|
|
|
|
|
function loadCache(): ConfigCache {
|
|
|
|
|
|
if (cache) return cache;
|
|
|
|
|
|
const config = readPersistedFromDisk();
|
|
|
|
|
|
cache = { config, token: decryptToken(config) };
|
|
|
|
|
|
return cache;
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/** 待写入的配置快照(合并窗口内只保留最后一次) */
|
|
|
|
|
|
let pendingWrite: PersistedConfig | null = null;
|
|
|
|
|
|
let writeTimer: ReturnType<typeof setTimeout> | null = null;
|
|
|
|
|
|
/** 是否有一次异步写入正在进行(用它把写入串行化,避免两次写互相覆盖) */
|
|
|
|
|
|
let writing = false;
|
|
|
|
|
|
|
|
|
|
|
|
/** 排一次落盘。合并窗口内的多次调用只会写最后一次;`immediate` 用于不该被延迟的场景 */
|
|
|
|
|
|
function scheduleWrite(config: PersistedConfig, immediate = false): void {
|
|
|
|
|
|
pendingWrite = config;
|
|
|
|
|
|
if (immediate) {
|
|
|
|
|
|
if (writeTimer !== null) {
|
|
|
|
|
|
clearTimeout(writeTimer);
|
|
|
|
|
|
writeTimer = null;
|
|
|
|
|
|
}
|
|
|
|
|
|
void flushConfigAsync();
|
|
|
|
|
|
return;
|
|
|
|
|
|
}
|
|
|
|
|
|
// 已有待写任务(定时器在跑或正在写):内容已经记在 pendingWrite 里,等它自己收尾即可。
|
|
|
|
|
|
// 正在写的那次结束后会再检查一次 pendingWrite(见 flushConfigAsync 的 finally)。
|
|
|
|
|
|
if (writeTimer !== null || writing) return;
|
|
|
|
|
|
writeTimer = setTimeout(() => {
|
|
|
|
|
|
writeTimer = null;
|
|
|
|
|
|
void flushConfigAsync();
|
|
|
|
|
|
}, CONFIG_WRITE_DEBOUNCE_MS);
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/** 异步落盘(不阻塞主进程消息泵)。失败只记日志 —— 与 readPersistedFromDisk 的容错口径一致 */
|
|
|
|
|
|
async function flushConfigAsync(): Promise<void> {
|
|
|
|
|
|
if (writing) return;
|
|
|
|
|
|
const target = pendingWrite;
|
|
|
|
|
|
if (!target) return;
|
|
|
|
|
|
pendingWrite = null;
|
|
|
|
|
|
writing = true;
|
|
|
|
|
|
// 先把内容序列化下来:写入期间的后续改动由 pendingWrite 负责补一次,
|
|
|
|
|
|
// 不会出现"这一次写的是半新半旧的对象"
|
|
|
|
|
|
const payload = JSON.stringify(target, null, 2);
|
|
|
|
|
|
try {
|
|
|
|
|
|
const file = configFilePath();
|
|
|
|
|
|
await fs.promises.mkdir(path.dirname(file), { recursive: true });
|
|
|
|
|
|
await fs.promises.writeFile(file, payload, 'utf8');
|
|
|
|
|
|
} catch (error) {
|
|
|
|
|
|
logger.warn(`写入配置失败(${configFilePath()}):${error instanceof Error ? error.message : error}`);
|
|
|
|
|
|
} finally {
|
|
|
|
|
|
writing = false;
|
|
|
|
|
|
// 写入期间又有改动:再写一次(内容已被 pendingWrite 合并成最后一次)
|
|
|
|
|
|
if (pendingWrite) void flushConfigAsync();
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* 退出前同步落地一次(`main/index.ts` 的 shutdownResources 调用)。
|
|
|
|
|
|
*
|
|
|
|
|
|
* 即使没有待写内容也把内存里的配置重写一遍:那一时刻可能正有一次异步写在进行中,
|
|
|
|
|
|
* 它未必来得及完成;退出时多写一次的代价可以忽略。
|
|
|
|
|
|
*/
|
|
|
|
|
|
export function flushConfigSync(): void {
|
|
|
|
|
|
if (writeTimer !== null) {
|
|
|
|
|
|
clearTimeout(writeTimer);
|
|
|
|
|
|
writeTimer = null;
|
|
|
|
|
|
}
|
|
|
|
|
|
const target = pendingWrite ?? cache?.config ?? null;
|
|
|
|
|
|
if (!target) return;
|
|
|
|
|
|
pendingWrite = null;
|
|
|
|
|
|
try {
|
|
|
|
|
|
const file = configFilePath();
|
|
|
|
|
|
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
|
|
|
|
fs.writeFileSync(file, JSON.stringify(target, null, 2), 'utf8');
|
|
|
|
|
|
} catch (error) {
|
|
|
|
|
|
logger.warn(
|
|
|
|
|
|
`退出前写入配置失败(${configFilePath()}):${error instanceof Error ? error.message : error}`,
|
|
|
|
|
|
);
|
|
|
|
|
|
}
|
2026-09-11 22:46:31 +08:00
|
|
|
|
}
|
|
|
|
|
|
|
2026-10-02 00:25:10 +08:00
|
|
|
|
/**
|
|
|
|
|
|
* 服务器地址只接受 http/https 绝对地址。
|
|
|
|
|
|
*
|
|
|
|
|
|
* 渲染进程的输入框走 `normalizeServerUrl` 校验过,但 IPC(`saveConfig`)与手工改过的
|
|
|
|
|
|
* config.json 都会绕过它,而该值随后会作为 axios baseURL 与 Socket.IO 地址使用 ——
|
|
|
|
|
|
* 因此必须在**主进程这一侧也收口**,非法值一律丢弃(保留原值)。
|
|
|
|
|
|
*/
|
|
|
|
|
|
function normalizeServerUrl(input: string): string | null {
|
|
|
|
|
|
const trimmed = input.trim().replace(/\/+$/, '');
|
|
|
|
|
|
if (!trimmed) return null;
|
|
|
|
|
|
try {
|
|
|
|
|
|
const url = new URL(trimmed);
|
|
|
|
|
|
if (url.protocol !== 'http:' && url.protocol !== 'https:') return null;
|
|
|
|
|
|
return trimmed;
|
|
|
|
|
|
} catch {
|
|
|
|
|
|
return null;
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
|
2026-10-05 16:39:38 +08:00
|
|
|
|
/** 由内存缓存组装对渲染进程暴露的配置(不再读盘、不再解密) */
|
|
|
|
|
|
function toDesktopConfig(state: ConfigCache): DesktopStoredConfig {
|
|
|
|
|
|
const persisted = state.config;
|
2026-09-11 22:46:31 +08:00
|
|
|
|
return {
|
|
|
|
|
|
serverUrl: persisted.serverUrl,
|
|
|
|
|
|
username: persisted.username,
|
2026-10-05 16:39:38 +08:00
|
|
|
|
token: state.token,
|
2026-09-12 15:19:13 +08:00
|
|
|
|
island: normalizeIslandAppearance(persisted.island),
|
2026-09-12 23:48:59 +08:00
|
|
|
|
homeworkBoard: normalizeHomeworkBoard(persisted.homeworkBoard),
|
2026-09-27 14:59:12 +08:00
|
|
|
|
notificationChannel: normalizeNotificationChannel(persisted.notificationChannel),
|
2026-09-27 16:34:01 +08:00
|
|
|
|
homeworkPhrases: normalizeHomeworkPhrases(persisted.homeworkPhrases),
|
2026-10-02 11:18:47 +08:00
|
|
|
|
onboardingDone: persisted.onboardingDone === true,
|
|
|
|
|
|
theme: normalizeTheme(persisted.theme),
|
|
|
|
|
|
sidebarCollapsed: persisted.sidebarCollapsed === true,
|
2026-10-05 16:39:38 +08:00
|
|
|
|
ignoredUpdateVersion: persisted.ignoredUpdateVersion ?? '',
|
2026-10-11 11:49:32 +08:00
|
|
|
|
deviceKey: ensureDeviceKey(persisted),
|
|
|
|
|
|
autoLaunch: persisted.autoLaunch === true,
|
|
|
|
|
|
autoUpdate: persisted.autoUpdate !== false,
|
|
|
|
|
|
developerMode: persisted.developerMode === true,
|
|
|
|
|
|
careMode: persisted.careMode === true,
|
|
|
|
|
|
pendingUpdateVersion: persisted.pendingUpdateVersion ?? '',
|
|
|
|
|
|
pendingUpdateFile: persisted.pendingUpdateFile ?? '',
|
2026-09-11 22:46:31 +08:00
|
|
|
|
};
|
|
|
|
|
|
}
|
|
|
|
|
|
|
2026-10-11 11:49:32 +08:00
|
|
|
|
/**
|
|
|
|
|
|
* `crypto.randomUUID()`:Node 18+ / Chromium 里都有,但**不能假设它一定存在**
|
|
|
|
|
|
* (打包后的运行时或某些受限环境里 `crypto.randomUUID` 为 undefined,直接调用会抛)。
|
|
|
|
|
|
* 兜底用时间戳 + 随机字节拼一个同形状的 UUID v4。
|
|
|
|
|
|
*/
|
|
|
|
|
|
function generateDeviceKey(): string {
|
|
|
|
|
|
try {
|
|
|
|
|
|
if (typeof crypto.randomUUID === 'function') return crypto.randomUUID();
|
|
|
|
|
|
} catch {
|
|
|
|
|
|
// 落到下面的兜底
|
|
|
|
|
|
}
|
|
|
|
|
|
const hex = crypto.randomBytes(16).toString('hex');
|
|
|
|
|
|
return (
|
|
|
|
|
|
`${hex.slice(0, 8)}-${hex.slice(8, 12)}-4${hex.slice(12, 15)}` +
|
|
|
|
|
|
`-a${hex.slice(15, 18)}-${hex.slice(18, 30)}`
|
|
|
|
|
|
);
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* 设备标识:**首次读取时生成并落盘,之后永不变**(它是这台机器在服务端的身份,
|
|
|
|
|
|
* 服务端按 `deviceKey` upsert 设备记录,换了它就等于换了一台机器)。
|
|
|
|
|
|
*
|
|
|
|
|
|
* 为什么放在这里生成:`getConfig()` 是所有读取路径的唯一出口(主进程各处 + 渲染进程 IPC),
|
|
|
|
|
|
* 且此时必然已经过了 `app.setPath('userData', …)`(见 `loadCache()` 的懒初始化说明),
|
|
|
|
|
|
* 写的就是当前 profile 的 config.json。落盘走既有的 120ms 合并窗口,退出时 `flushConfigSync()` 兜底。
|
|
|
|
|
|
*/
|
|
|
|
|
|
function ensureDeviceKey(persisted: PersistedConfig): string {
|
|
|
|
|
|
const existing = typeof persisted.deviceKey === 'string' ? persisted.deviceKey.trim() : '';
|
|
|
|
|
|
if (existing) return existing;
|
|
|
|
|
|
const created = generateDeviceKey();
|
|
|
|
|
|
persisted.deviceKey = created;
|
|
|
|
|
|
scheduleWrite(persisted);
|
|
|
|
|
|
logger.info(`已为本机生成设备标识(服务端据此识别这台电脑):${created}`);
|
|
|
|
|
|
return created;
|
|
|
|
|
|
}
|
|
|
|
|
|
|
2026-10-05 16:39:38 +08:00
|
|
|
|
/** 读取配置(token 已解密),供渲染进程使用 */
|
|
|
|
|
|
export function getConfig(): DesktopStoredConfig {
|
|
|
|
|
|
return toDesktopConfig(loadCache());
|
|
|
|
|
|
}
|
|
|
|
|
|
|
2026-09-11 22:46:31 +08:00
|
|
|
|
/** 局部更新配置:只覆盖传入的字段 */
|
|
|
|
|
|
export function saveConfig(patch: Partial<DesktopStoredConfig>): DesktopStoredConfig {
|
2026-10-05 16:39:38 +08:00
|
|
|
|
const state = loadCache();
|
|
|
|
|
|
const persisted = state.config;
|
2026-09-11 22:46:31 +08:00
|
|
|
|
|
|
|
|
|
|
if (typeof patch.serverUrl === 'string' && patch.serverUrl.trim()) {
|
2026-10-02 00:25:10 +08:00
|
|
|
|
const normalized = normalizeServerUrl(patch.serverUrl);
|
|
|
|
|
|
if (normalized) persisted.serverUrl = normalized;
|
|
|
|
|
|
else logger.warn(`忽略非法的服务器地址(只接受 http/https):${patch.serverUrl}`);
|
2026-09-11 22:46:31 +08:00
|
|
|
|
}
|
|
|
|
|
|
if (typeof patch.username === 'string') {
|
|
|
|
|
|
persisted.username = patch.username;
|
|
|
|
|
|
}
|
2026-09-12 15:19:13 +08:00
|
|
|
|
if (patch.island !== undefined) {
|
|
|
|
|
|
persisted.island = normalizeIslandAppearance({ ...persisted.island, ...patch.island });
|
|
|
|
|
|
}
|
2026-09-12 23:48:59 +08:00
|
|
|
|
if (patch.homeworkBoard !== undefined) {
|
|
|
|
|
|
persisted.homeworkBoard = normalizeHomeworkBoard({
|
|
|
|
|
|
...persisted.homeworkBoard,
|
|
|
|
|
|
...patch.homeworkBoard,
|
|
|
|
|
|
});
|
|
|
|
|
|
}
|
2026-09-27 16:34:01 +08:00
|
|
|
|
if (patch.homeworkPhrases !== undefined) {
|
|
|
|
|
|
persisted.homeworkPhrases = normalizeHomeworkPhrases(patch.homeworkPhrases);
|
|
|
|
|
|
}
|
2026-09-27 14:59:12 +08:00
|
|
|
|
if (patch.notificationChannel !== undefined) {
|
|
|
|
|
|
persisted.notificationChannel = normalizeNotificationChannel(patch.notificationChannel);
|
|
|
|
|
|
}
|
2026-10-02 11:18:47 +08:00
|
|
|
|
// 引导只接受"已看过":重看入口不走这里(看过与否只有 true 与"没看过"两种状态,
|
|
|
|
|
|
// 想 re-arm 只能清配置 clearConfig)。传 false 一律忽略,避免任何调用点误把用户退回首启状态。
|
|
|
|
|
|
if (patch.onboardingDone === true) {
|
|
|
|
|
|
persisted.onboardingDone = true;
|
|
|
|
|
|
}
|
|
|
|
|
|
if (patch.theme !== undefined) {
|
|
|
|
|
|
persisted.theme = normalizeTheme(patch.theme);
|
|
|
|
|
|
}
|
|
|
|
|
|
if (patch.sidebarCollapsed !== undefined) {
|
|
|
|
|
|
persisted.sidebarCollapsed = patch.sidebarCollapsed === true;
|
|
|
|
|
|
}
|
2026-10-05 16:39:38 +08:00
|
|
|
|
// 空串是合法值(= 没有忽略任何版本),因此这里只判类型不判空
|
|
|
|
|
|
if (typeof patch.ignoredUpdateVersion === 'string') {
|
|
|
|
|
|
persisted.ignoredUpdateVersion = patch.ignoredUpdateVersion;
|
|
|
|
|
|
}
|
2026-10-11 11:49:32 +08:00
|
|
|
|
if (patch.autoLaunch !== undefined) {
|
|
|
|
|
|
persisted.autoLaunch = patch.autoLaunch === true;
|
|
|
|
|
|
}
|
|
|
|
|
|
if (patch.autoUpdate !== undefined) {
|
|
|
|
|
|
persisted.autoUpdate = patch.autoUpdate === true;
|
|
|
|
|
|
}
|
|
|
|
|
|
if (patch.developerMode !== undefined) {
|
|
|
|
|
|
persisted.developerMode = patch.developerMode === true;
|
|
|
|
|
|
}
|
|
|
|
|
|
if (patch.careMode !== undefined) {
|
|
|
|
|
|
persisted.careMode = patch.careMode === true;
|
|
|
|
|
|
}
|
|
|
|
|
|
// 待安装的更新只由主进程的 auto-update 模块写入;渲染进程传进来也照收(退出登录/重置走 clearConfig)
|
|
|
|
|
|
if (typeof patch.pendingUpdateVersion === 'string') {
|
|
|
|
|
|
persisted.pendingUpdateVersion = patch.pendingUpdateVersion;
|
|
|
|
|
|
}
|
|
|
|
|
|
if (typeof patch.pendingUpdateFile === 'string') {
|
|
|
|
|
|
persisted.pendingUpdateFile = patch.pendingUpdateFile;
|
|
|
|
|
|
}
|
|
|
|
|
|
// deviceKey **不接受外部改写**:它是这台机器在服务端的身份,改了服务端就会当成一台新机器
|
|
|
|
|
|
// (旧记录永远停在上一次心跳、新记录从零开始)。要重置身份只能手工删掉 config.json 里的该字段。
|
|
|
|
|
|
if (typeof patch.deviceKey === 'string' && patch.deviceKey && patch.deviceKey !== persisted.deviceKey) {
|
|
|
|
|
|
logger.warn('忽略对设备标识(deviceKey)的改写:它是这台机器在服务端的身份,不允许变更');
|
|
|
|
|
|
}
|
2026-09-11 22:46:31 +08:00
|
|
|
|
if (patch.token !== undefined) {
|
|
|
|
|
|
const encrypted = encryptToken(patch.token);
|
|
|
|
|
|
persisted.token = encrypted.token;
|
|
|
|
|
|
persisted.tokenEncrypted = encrypted.tokenEncrypted;
|
2026-10-05 16:39:38 +08:00
|
|
|
|
// 明文一并进缓存:既省掉一次 DPAPI 解密,也保证紧接着的 getConfig() 读到的就是刚存的令牌
|
|
|
|
|
|
state.token = patch.token;
|
2026-09-11 22:46:31 +08:00
|
|
|
|
}
|
|
|
|
|
|
|
2026-10-05 16:39:38 +08:00
|
|
|
|
scheduleWrite(persisted);
|
|
|
|
|
|
return toDesktopConfig(state);
|
2026-09-11 22:46:31 +08:00
|
|
|
|
}
|
|
|
|
|
|
|
2026-10-11 11:49:32 +08:00
|
|
|
|
/**
|
|
|
|
|
|
* 清空为默认配置(退出登录 / 重置)。立即落盘:它对应退出登录,不该被合并窗口延迟。
|
|
|
|
|
|
*
|
|
|
|
|
|
* **保留"这台机器"的身份与本地开关**:`deviceKey`(服务端按它识别设备,换了就等于换一台机器)、
|
|
|
|
|
|
* 开机自启 / 自动更新 / 开发者模式 / 关怀模式,以及已下载待安装的更新记录 —— 退出登录不该在服务端
|
|
|
|
|
|
* 多出一台陌生设备,也不该把用户刚打开的开关悄悄关回默认值。
|
|
|
|
|
|
*/
|
2026-09-11 22:46:31 +08:00
|
|
|
|
export function clearConfig(): DesktopStoredConfig {
|
2026-10-11 11:49:32 +08:00
|
|
|
|
const current = cache?.config ?? DEFAULT_CONFIG;
|
|
|
|
|
|
const kept: PersistedConfig = {
|
|
|
|
|
|
...DEFAULT_CONFIG,
|
|
|
|
|
|
deviceKey: current.deviceKey ?? '',
|
|
|
|
|
|
autoLaunch: current.autoLaunch === true,
|
|
|
|
|
|
autoUpdate: current.autoUpdate !== false,
|
|
|
|
|
|
developerMode: current.developerMode === true,
|
|
|
|
|
|
careMode: current.careMode === true,
|
|
|
|
|
|
pendingUpdateVersion: current.pendingUpdateVersion ?? '',
|
|
|
|
|
|
pendingUpdateFile: current.pendingUpdateFile ?? '',
|
|
|
|
|
|
};
|
|
|
|
|
|
ensureDeviceKey(kept);
|
|
|
|
|
|
const state: ConfigCache = { config: kept, token: null };
|
2026-10-05 16:39:38 +08:00
|
|
|
|
cache = state;
|
|
|
|
|
|
scheduleWrite(state.config, true);
|
|
|
|
|
|
return toDesktopConfig(state);
|
2026-09-11 22:46:31 +08:00
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
export function getConfigPath(): string {
|
|
|
|
|
|
return configFilePath();
|
|
|
|
|
|
}
|