Function downloadFile

src/main/utils/download.ts:22–171

(
  url: string,
  filePath: string,
  options: DownloadFileOptions = {}
)

}

export async function downloadFile(
  url: string,
  filePath: string,
  options: DownloadFileOptions = {}
): Promise<void> {
  return new Promise<void>((resolve, reject) => {
    if (options.signal?.aborted) {
      reject(new DownloadCancelledError())
      return
    }

    let settled = false
    let writeStream: ReturnType<typeof createWriteStream> | null = null
    const request = net.request({
      url,
      session: session.defaultSession // 显式指定使用 defaultSession（确保代理配置生效）
    })

    const cleanup = (): void => {
      options.signal?.removeEventListener('abort', handleAbort)
    }

    const finish = (callback: () => void): void => {
      if (settled) return
      settled = true
      cleanup()
      callback()
    }

    const fail = (err: unknown): void => {
      finish(() => {
        try {
          request.abort()
        } catch {
          // 忽略失败清理时的请求状态差异
        }
        writeStream?.destroy()
        reject(err)
      })
    }

    function handleAbort(): void {
      try {
        request.abort()
      } catch {
        // 忽略 abort 期间的底层请求状态差异
      }
      fail(new DownloadCancelledError())
    }

    options.signal?.addEventListener('abort', handleAbort, { once: true })

    // 禁用缓存的请求头（确保每次都下载最新文件）
    request.setHeader('Cache-Control', 'no-cache, no-store, must-revalidate')
    request.setHeader('Pragma', 'no-cache')
    request.setHeader('Expires', '0')

    request.setHeader(