Interface ImportAdapter

src/services/import/types.ts:112–159

// ==================== 核心接口 ====================

export interface ImportAdapter {
  /**
   * 导入文件。Electron 接受 File 或文件路径，Web 只接受 File。
   */
  importFile(
    file: File | string,
    options?: ImportOptions,
    onProgress?: (p: ImportProgress) => void
  ): Promise<ImportResult>

  /** 检测文件格式 */
  detectFormat(file: File | string): Promise<FormatInfo | null>

  /** 扫描包含多个聊天的文件 */
  scanMultiChatFile(file: File | string): Promise<MultiChatEntry[]>

  /** 注册 ZIP 导入源。Web 上传一次，Electron 记录本地路径。 */
  prepareImportSource(file: File | string): Promise<PreparedImportSourceResult>

  /** 从已注册导入源中导入一个聊天。 */
  importPreparedChat(sourceId: string, chatId: string, onProgress?: (p: ImportProgress) => void): Promise<ImportResult>

  /** 释放导入源及其临时文件；重复调用应保持幂等。 */
  releaseImportSource(sourceId: string): Promise<void>

  /** 获取支持的导入格式列表 */
  getSupportedFormats(): Promise<FormatInfo[]>

  /** 导入 Demo 数据 */
  importDemo(locale: string, onProgress?: (p: DemoProgress) => void): Promise<DemoImportResult>

  /** 分析增量导入（预览去重后可新增多少消息） */
  analyzeIncrementalImport(sessionId: string, file: File | string): Promise<IncrementalAnalysis>

  /** 执行增量导入 */
  incrementalImport(
    sessionId: string,
    file: File | string,
    onProgress?: (p: ImportProgress) => void
  ): Promise<IncrementalImportResult>

  /** 导入目录（多文件格式如 chunked-jsonl）。Electron 传目录路径，Web 传 File[]（含 webkitRelativePath） */
  importDirectory(
    source: File[] | string,
    options?: ImportOptions,
    onProgress?: (p: ImportProgress) => void
  ): Promise<ImportResult>
}

export type { ImportProgress }