Function initConfigWatcher

src/config.ts:302–373

()

 * 环境变量覆盖始终保持最高优先级，不受热重载影响。
 */
export function initConfigWatcher(): void {
    if (watcher) return; // 避免重复初始化
    if (!existsSync('config.yaml')) {
        console.log('[Config] config.yaml 不存在，跳过热重载监听');
        return;
    }

    const DEBOUNCE_MS = 500;

    watcher = watch('config.yaml', (eventType) => {
        if (eventType !== 'change') return;

        // 防抖：多次快速写入只触发一次重载
        if (debounceTimer) clearTimeout(debounceTimer);
        debounceTimer = setTimeout(() => {
            try {
                if (!existsSync('config.yaml')) {
                    console.warn('[Config] ⚠️  config.yaml 已被删除，保持当前配置');
                    return;
                }

                const oldConfig = config;
                const oldPort = oldConfig.port;

                // 重新解析 YAML + 环境变量覆盖
                const defaults = defaultConfig();
                const { config: newConfig } = parseYamlConfig(defaults);
                applyEnvOverrides(newConfig);

                // 检测变更
                const changes = detectChanges(oldConfig, newConfig);
                if (changes.length === 0) return; // 无实质变更

                // ★ 端口变更特殊处理：仅警告，不生效
                if (newConfig.port !== oldPort) {
                    console.warn(`[Config] ⚠️  检测到 port 变更 (${oldPort} → ${newConfig.port})，端口变更需要重启服务才能生效`);
                    newConfig.port = oldPort; // 保持原端口
                }

                // 替换全局配置对象（下一次 getConfig() 调用即返回新配置）
                config = newConfig;

                console.log(`[Config] 🔄 config.yaml 已热重载，${changes.length} 项变更:`);
                changes.forEach(c => console.log(`  └─ ${c}`));

                // 触发回调
                for (const cb of reloadCallbacks) {
                    try {
                        cb(newConfig, changes);
                    } catch (e) {
                        console.warn('[Config] 热重载回调执行失败:', e);
                    }
                }
            } catch (e) {
                console.error('[Config] ❌ 热重载失败，保持当前配置:', e);
            }
        }, DEBOUNCE_MS);
    });