Class AppsAPI

src/main/api/renderer/commands.ts:32–1178

 * 应用管理API - 主程序专用
 */
export class AppsAPI {
  private static readonly APP_CACHE_VERSION = 3
  private static readonly APP_CACHE_VERSION_KEY = 'cached-commands-version'
  private mainWindow: Electron.BrowserWindow | null = null
  private pluginManager: PluginManager | null = null
  private launchParam: any = null
  private lastMatchState: LastMatchState | null = null
  private isLocalAppSearchEnabled = true
  private cachedCommandsResult: { commands: any[]; regexCommands: any[]; plugins: any[] } | null =
    null
  /** 由外部注入，用于在多屏场景下正确显示窗口（跟随光标所在屏幕） */
  private showWindowCallback?: () => void

  public setShowWindowCallback(callback: () => void): void {
    this.showWindowCallback = callback
  }

  /**
   * 安全地向渲染进程发送消息
   */
  private notifyRenderer(channel: string, ...args: any[]): void {
    if (this.mainWindow && !this.mainWindow.isDestroyed()) {
      this.mainWindow.webContents.send(channel, ...args)
    }
  }

  public init(mainWindow: Electron.BrowserWindow, pluginManager: PluginManager): void {
    this.mainWindow = mainWindow
    this.pluginManager = pluginManager
    this.setupIPC()
    this.loadLastMatchState()
    // 异步加载本地应用搜索设置
    this.loadLocalAppSearchSetting()
  }

  public getLaunchParam(): any {
    return this.launchParam
  }

  public invalidateCommandsCache(notifyRenderer = false): void {
    this.cachedCommandsResult = null
    console.log('[Commands] 指令缓存已清空:', { notifyRenderer })

    if (notifyRenderer) {
      console.log('[Commands] 发送 apps-changed 通知，触发主窗口重载指令与 alias 搜索索引')
      this.notifyRenderer('apps-changed')
    }
  }

  /**
   * 根据名称查找直接启动指令（系统应用、系统设置等）
   */
  public async findDirectCommandByName(name: string): Promise<any | null> {
    const { commands } = await this.getCommands()
    return commands.find((cmd: any) => cmd.type === 'direct' && cmd.name === name) || null
  }

  private setupIPC(): void {