metona-ai-desktop/electron/services/config.service.ts

/**
 * Config Service — 配置读写
 *
 * 管理 app_config 表的读写操作。
 * 所有配置值以 JSON 格式存储。
 *
 * v0.3.17: 引入全局配置层（GlobalConfigService）。
 *   - 全局 key（llm.* / agent.* / onboarding.completed 等）读取时优先工作空间 DB，
 *     miss 时回退到全局 JSON，确保切换工作空间后 LLM 凭据和引导状态不丢失。
 *   - 写入时同时写工作空间 DB（兼容）和全局 JSON（跨工作空间共享）。
 *
 * @see docs/MetonaAI-Desktop 架构与交互设计.html — 数据库配置
 */

import type Database from 'better-sqlite3';
import log from 'electron-log';
import { GlobalConfigService, isGlobalKey, isUnconfiguredGlobalKey } from './global-config.service';

export interface ConfigRow {
  key: string;
  value: string;
  category: string;
  updated_at: number;
}

export class ConfigService {
  private globalConfig: GlobalConfigService | null = null;

  constructor(private getDB: () => Database.Database) {}

  /**
   * 注入全局配置服务（可选，由 main.ts 在启动时调用）
   * 注入后，全局 key 的读取会回退到全局层，写入会双写。
   */
  setGlobalConfig(globalConfig: GlobalConfigService): void {
    this.globalConfig = globalConfig;
  }

  /**
   * 获取配置值
   * 读取顺序：工作空间 DB → 全局 JSON（仅全局 key）
   *
   * 特殊处理：对于"空值视为未配置"的全局 key（如 llm.apiKey=''、onboarding.completed=false），
   * 当工作空间 DB 的值为空/默认值时，回退到全局层读取真实值。
   * 这解决了新工作空间 DB 被 seedDefaults 灌入空值导致配置丢失的问题。
   */
  get<T = unknown>(key: string): T | null {
    const db = this.getDB();
    const row = db.prepare('SELECT value FROM app_config WHERE key = ?').get(key) as ConfigRow | undefined;

    if (row) {
      let parsed: unknown;
      try {
        parsed = JSON.parse(row.value);
      } catch {
        parsed = row.value;
      }

      // 全局 key 的空值回退：若工作空间 DB 存在该 key 但值为"未配置"（如 llm.apiKey=''），
      // 且全局层有真实值，则返回全局层的值。
      // 解决场景：新工作空间 DB 被 seedDefaults 灌入 llm.apiKey='' / onboarding.completed=false，
      // 但用户在全局层已配置过，应回退到全局层。
      if (this.globalConfig && isGlobalKey(key) && isUnconfiguredGlobalKey(key, parsed)) {
        const globalValue = this.globalConfig.get<T>(key);
        if (globalValue !== null && !isUnconfiguredGlobalKey(key, globalValue)) {
          return globalValue;
        }
      }

      return parsed as T;
    }

    // 工作空间 DB miss，若为全局 key 则回退到全局层
    if (this.globalConfig && isGlobalKey(key)) {
      return this.globalConfig.get<T>(key);
    }

    return null;
  }

  /**
   * 设置配置值（保留已有 category）
   * 全局 key 同时写入工作空间 DB 和全局 JSON
   */
  set(key: string, value: unknown): void {
    const db = this.getDB();
    const jsonValue = JSON.stringify(value);

    // 查询已有 category，避免 INSERT OR REPLACE 覆盖为默认值
    const existing = db.prepare('SELECT category FROM app_config WHERE key = ?').get(key) as ConfigRow | undefined;
    const category = existing?.category ?? 'general';

    db.prepare(`
      INSERT OR REPLACE INTO app_config (key, value, category, updated_at)
      VALUES (?, ?, ?, ?)
    `).run(key, jsonValue, category, Date.now());

    // 全局 key 同步写入全局层（跨工作空间共享）
    if (this.globalConfig && isGlobalKey(key)) {
      this.globalConfig.set(key, value);
    }

    log.debug(`Config set: ${key}`);
  }

  /**
   * 获取所有配置（工作空间 DB + 全局层合并）
   * 合并规则与 get() 一致：全局 key 在 DB 中为"未配置"时回退到全局层
   */
  getAll(): Record<string, unknown> {
    const db = this.getDB();
    const rows = db.prepare('SELECT key, value FROM app_config').all() as ConfigRow[];

    const config: Record<string, unknown> = {};
    for (const row of rows) {
      try {
        config[row.key] = JSON.parse(row.value);
      } catch {
        config[row.key] = row.value;
      }
    }

    // 全局层合并：与 get() 的回退逻辑保持一致
    if (this.globalConfig) {
      const globalAll = this.globalConfig.getAll();
      for (const [key, globalValue] of Object.entries(globalAll)) {
        if (!(key in config)) {
          // DB miss → 用全局层
          config[key] = globalValue;
        } else if (isGlobalKey(key) && isUnconfiguredGlobalKey(key, config[key])
                   && !isUnconfiguredGlobalKey(key, globalValue)) {
          // DB 有值但为"未配置"（seedDefaults 默认值/空值），全局层有真实值 → 用全局层
          config[key] = globalValue;
        }
      }
    }

    return config;
  }

  /**
   * 获取指定分类的所有配置
   */
  getByCategory(category: string): Record<string, unknown> {
    const db = this.getDB();
    const rows = db.prepare('SELECT key, value FROM app_config WHERE category = ?').all(category) as ConfigRow[];

    const config: Record<string, unknown> = {};
    for (const row of rows) {
      try {
        config[row.key] = JSON.parse(row.value);
      } catch {
        config[row.key] = row.value;
      }
    }

    return config;
  }

  /**
   * 删除配置
   */
  delete(key: string): boolean {
    const db = this.getDB();
    const result = db.prepare('DELETE FROM app_config WHERE key = ?').run(key);
    return result.changes > 0;
  }
}