Method ensurePluginToolReady

src/main/api/plugin/tools.ts:167–185

* 确保目标插件和目标工具已就绪。 * 插件未运行时会先后台预加载，然后等待 preload 完成 registerTool。

(
    pluginPath: string,
    toolName: string
  )

   * 插件未运行时会先后台预加载，然后等待 preload 完成 registerTool。
   */
  public async ensurePluginToolReady(
    pluginPath: string,
    toolName: string
  ): Promise<WebContents | null> {
    let webContents = this.pluginManager?.getPluginWebContentsByPath(pluginPath) ?? null
    if (!webContents) {
      await this.pluginManager?.preloadPlugin(pluginPath)
      webContents = this.pluginManager?.getPluginWebContentsByPath(pluginPath) ?? null
    }
    if (!webContents) return null

    if (this.isToolRegistered(webContents, toolName)) {
      return webContents
    }

    // 预加载后的 preload 注册是异步的，这里等待插件完成 registerTool。
    await this.waitForToolRegistration(webContents, toolName)
    return this.isToolRegistered(webContents, toolName) ? webContents : null
  }

  /**
   * 检查某个工具是否已在指定 WebContents 中注册。