MCPcopy Index your code
hub / github.com/XimilalaXiang/DeLive

github.com/XimilalaXiang/DeLive @v2.2.4

Chat with this repo
repository ↗ · DeepWiki ↗ · release v2.2.4 ↗ · + Follow
1,420 symbols 3,204 edges 249 files 18 documented · 1%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

DeLive Banner


系統音訊擷取 | 多 Provider ASR | 本地優先的 AI 複盤工作台

English | 简体中文 | 繁體中文 | 日本語

版本 授權 Platform Platform Platform 下載量 Stars 文檔

🌐 官方網站 · 📖 專案文檔 · 📋 使用指南 · ⬇️ 立即下載

DeLive 是一個面向系統音訊的桌面轉錄工作台。它會擷取電腦正在播放的聲音,按所選 Provider 的能力選擇最合適的轉錄鏈路(共支援 12 種 ASR 後端),把會話保存在本機,並在錄製結束後提供完整的 AI 複盤工作台——支援 AI 糾錯、富文本 Markdown 對話、結構化 briefing、會話問答和思維導圖整理。同時支援上傳音訊/影片檔案進行離線轉錄,10 種雲端引擎均可用於檔案轉錄。

即時轉錄 字幕懸浮窗 MCP 整合
12 種 ASR 引擎即時轉錄 可拖曳的置頂字幕懸浮窗 外部 AI 工具透過 MCP 協定存取 DeLive
即時轉錄 字幕懸浮窗 MCP 整合
AI 概覽 AI 糾錯 AI 對話
摘要、行動項、關鍵詞與章節 直接糾錯 & 先檢測後糾錯,並排對比 多執行緒對話,帶引用片段
AI 概覽 AI 糾錯 AI 對話

🎯 核心功能

  • 系統音訊擷取 — 網頁影片、直播、會議、課程、Podcast,只要共享系統音訊即可接入
  • 12 種 ASR 後端 — Soniox、火山引擎、Groq、矽基流動、Mistral AI、Deepgram、AssemblyAI、ElevenLabs、Gladia、Cloudflare Workers AI、本地 OpenAI-compatible、本地 whisper.cpp
  • 檔案轉錄 — 上傳音訊/影片檔案,使用 10 種雲端引擎離線轉錄
  • AI 複盤工作台 — 糾錯(直接糾錯 / 先檢測後糾錯)、結構化 briefing、多執行緒對話、問答、思維導圖
  • 懸浮字幕窗 — 始終置頂視窗,支援原文 / 翻譯 / 雙語模式
  • Soniox 雙語與發言人辨識 — 即時翻譯、雙語字幕、speaker diarization
  • 主題功能 — 將會話歸類到專案容器中
  • 本地優先 — 會話、標籤、主題、設定保存在本機;可選 S3/WebDAV 雲端備份
  • 開放 API 與 MCP — 本地 REST API、即時 WebSocket、MCP 伺服器,供 AI Agent 使用
  • 跨平台 — Windows、macOS、Linux

📖 完整功能介紹:文檔

📥 下載安裝

Windows macOS Linux

平台 檔案
Windows .exe 安裝程式、免安裝版 .exe
macOS .dmg.zip(Intel x64 和 Apple Silicon arm64)
Linux .AppImage.deb

🔌 支援的 ASR Provider

Provider 類型 傳輸模式 檔案轉錄 亮點
Soniox V4 雲端 即時串流 支援 token 級即時轉錄、即時翻譯、雙語字幕、多發言人辨識
火山引擎 雲端 即時串流 支援 中文場景友善,內建代理
ElevenLabs 雲端 即時串流 支援 Scribe v2 Realtime,99 種語言
Mistral AI 雲端 即時串流 支援 Voxtral Realtime
Gladia 雲端 即時串流 支援 Solaria-1,100+ 種語言,<300ms 延遲
Deepgram 雲端 即時串流 支援 Nova-3 / Nova-2 串流
AssemblyAI 雲端 即時串流 支援 Universal-3 Pro 串流
Cloudflare Workers AI 雲端 視窗批次 支援 基於 Whisper,低成本含免費額度
矽基流動 雲端 視窗批次 支援 SenseVoice、TeleSpeech、Qwen Omni
Groq 雲端 視窗批次 支援 Whisper large-v3-turbo / large-v3
本地 OpenAI-compatible 本地 視窗批次 適配 Ollama 或相容閘道
本地 whisper.cpp 本地 Electron 管理 全本地運行,DeLive 管理 binary 和模型

📖 Provider 設定詳情:API Key 指南 · Provider 對比

🚀 快速開始

git clone https://github.com/XimilalaXiang/DeLive.git
cd DeLive
npm run install:all
npm run dev

📖 完整開發指南:環境搭建 · 建置打包 · 測試

🏗️ 系統架構

graph TB
    subgraph "桌面殼層"
        EM[Electron 主程序]
        WIN[主視窗]
        CAP[字幕懸浮窗]
        DESK[系統匣 / 快捷鍵 / 自啟動 / 更新]
        SEC[IPC 安全 / SafeStorage / Diagnostics]
    end

    subgraph "渲染層"
        UI[React App]
        STORES[Zustand Stores]
        CFG[Provider 與 Runtime 設定]
        PREV[歷史 / 預覽 / AI 工作台]
    end

    subgraph "編排層"
        ASR[useASR]
        CAPMGR[CaptureManager]
        PROVSESS[ProviderSessionManager]
        CAPBR[CaptionBridge]
    end

    subgraph "擷取管線"
        GDM[getDisplayMedia]
        MR[MediaRecorder

WebM / Opus]
        AP[AudioWorklet

PCM16 16kHz]
    end

    subgraph "Provider 層"
        REG[Provider Registry]
        SON[Soniox]
        VOL[Volcengine]
        ELB[ElevenLabs]
        MIS[Mistral AI]
        GLA[Gladia]
        DPG[Deepgram]
        AAI[AssemblyAI]
        CFL[Cloudflare Workers AI]
        SIL[SiliconFlow]
        GRQ[Groq]
        LOA[Local OpenAI-compatible]
        WCP[whisper.cpp Runtime]
    end

    subgraph "Electron 服務"
        PROXY[內建多 Provider 代理]
        RTM[本地 Runtime 控制器]
    end

    subgraph "持久化"
        REPO[Session Repository]
        IDB[IndexedDB]
        LS[localStorage]
        SAFE[safeStorage]
    end

    UI --> STORES
    UI --> CFG
    UI --> PREV
    UI --> ASR
    ASR --> CAPMGR
    ASR --> PROVSESS
    ASR --> CAPBR
    CAPMGR --> GDM
    GDM --> MR
    GDM --> AP
    PROVSESS --> REG
    REG --> SON & VOL & ELB & MIS & GLA & DPG & AAI & CFL & SIL & GRQ & LOA & WCP
    MR --> SON & LOA
    AP --> VOL & ELB & MIS & GLA & DPG & AAI & CFL & SIL & GRQ & WCP
    VOL & MIS & DPG & AAI & ELB & GLA --> PROXY
    WCP --> RTM
    STORES --> REPO
    REPO --> IDB & LS
    CFG --> SAFE
    UI --> EM
    EM --> WIN & CAP & DESK & SEC & PROXY & RTM
    CAPBR --> CAP

    style UI fill:#61dafb,color:#000
    style EM fill:#334155,color:#fff
    style CAP fill:#f472b6,color:#000
    style REG fill:#f59e0b,color:#000
    style PROXY fill:#10b981,color:#fff
    style RTM fill:#0f766e,color:#fff
    style SEC fill:#ef4444,color:#fff
    style SAFE fill:#a855f7,color:#fff
    style IDB fill:#3b82f6,color:#fff

📖 詳細架構:架構總覽 · Provider 架構 · Electron IPC · 資料流 · 安全

📁 專案結構

DeLive/
├── electron/          # Electron 主程序、視窗、系統匣、IPC、更新、runtime、Open API 伺服器
├── frontend/          # React 渲染層、Provider、Store、UI 元件、測試
├── shared/            # 共用 TypeScript 契約與代理 helper
├── server/            # 主要用於除錯的獨立代理伺服器
├── mcp/               # MCP 伺服器,供 AI Agent 使用(Claude、Cursor 等)
├── skills/            # Agent Skill 定義
├── scripts/           # 圖示生成、runtime 預置、release notes
├── docs/              # VitePress 文檔站原始碼
├── landing/           # Landing page 原始碼
└── package.json

📖 完整專案結構:專案結構

🔧 技術棧

層級 技術
桌面應用 Electron 40
前端 React 18.3 + TypeScript 5.6 + Vite 6
樣式 Tailwind CSS 3.4
狀態管理 Zustand 4.5
測試 Vitest 4(314 測試 / 32 檔案)
持久化 IndexedDB、localStorage、Electron safeStorage
打包 electron-builder + GitHub Actions

🌐 開放 API 與 MCP

DeLive 透過本地 REST API、即時 WebSocket 和 MCP 伺服器對外開放轉錄資料——預設關閉,可選 Bearer Token 驗證。

📖 完整 API 參考:REST · WebSocket · MCP 伺服器 · 驗證 · Agent Skill

⚠️ 注意事項

  • 系統需求:Windows 10+、macOS 13+、或具備 PulseAudio loopback 的 Linux。
  • Provider 代理內建在 Electron 中,正常桌面使用無需單獨後端。
  • 系統匣行為:關閉主視窗預設隱藏到系統匣。
  • 自動更新:支援 Windows、macOS 和 Linux AppImage。

🛡️ Windows SmartScreen 提示

首次執行時 Windows 可能彈出 SmartScreen 警告。點選 更多資訊仍要執行

📄 授權

Apache License 2.0

🙏 致謝

  • BiBi-Keyboard — 多 Provider 架構靈感
  • 字節跳動 — 火山引擎語音辨識服務與飛書 AI 校園挑戰賽支持
  • LINUX.DO 社群 — 在這裡學到了很多,感謝社群一直以來的慷慨幫助與支持

Star History Chart

Made by XimilalaXiang

Extension points exported contracts — how you extend this code

CreateAppTrayOptions (Interface)
(no doc)
electron/tray.ts
DiagnosticData (Interface)
(no doc)
electron/diagnosticsIpc.ts
CaptionStyle (Interface)
(no doc)
electron/captionWindow.ts
CreateMainWindowOptions (Interface)
(no doc)
electron/mainWindow.ts
ApiServerOptions (Interface)
(no doc)
electron/apiServer.ts
RegisterCaptionIpcOptions (Interface)
(no doc)
electron/captionIpc.ts
RegisterApiIpcOptions (Interface)
(no doc)
electron/apiIpc.ts
LocalRuntimeDefinition (Interface)
(no doc)
electron/localRuntimeShared.ts

Core symbols most depended-on inside this repo

trim
called by 356
frontend/src/utils/rollingAudioBuffer.ts
on
called by 153
frontend/src/types/asr/provider.ts
getString
called by 51
frontend/src/utils/sessionSchema.ts
process
called by 49
frontend/src/utils/transcriptStabilizer.ts
flush
called by 29
frontend/src/utils/hypothesisBuffer.ts
validateBackupData
called by 26
frontend/src/utils/backupStorage.ts
debug
called by 23
electron/captionWindow.ts
assertTrustedSender
called by 23
electron/ipcSecurity.ts

Shape

Function 902
Interface 299
Method 170
Class 48
Enum 1

Languages

TypeScript100%

Modules by API surface

frontend/src/utils/localRuntimeManager.ts36 symbols
frontend/src/services/aiPostProcess.ts36 symbols
frontend/src/hooks/useFileTranscription.ts36 symbols
electron/captionWindow.ts35 symbols
frontend/src/services/captureManager.ts25 symbols
shared/electronApi.ts24 symbols
frontend/src/types/index.ts24 symbols
electron/localRuntime.ts23 symbols
frontend/src/providers/windowedBatch.ts22 symbols
frontend/src/types/asr/common.ts21 symbols
frontend/src/utils/sessionStorage.ts20 symbols
frontend/src/utils/sessionSchema.ts19 symbols

For agents

$ claude mcp add DeLive \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact