# live-caption

**Repository Path**: PanvanCode/live-caption

## Basic Information

- **Project Name**: live-caption
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-09
- **Last Updated**: 2026-08-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎙️ 实时翻译字幕 — Live Caption

基于 **Tauri v2 + Vue 3 + Rust** 的 macOS 桌面实时语音识别与同声翻译应用。

## 功能

- 🎤 **麦克风采集** — Rust 后端通过 cpal + CoreAudio 采集音频，支持麦克风/混合模式
- 📝 **本地语音识别** — 基于 OpenAI Whisper (small model)，离线转写，数据不出本机
- 🌐 **LLM 翻译** — 支持 DeepSeek / OpenAI / Claude，原文转写后可自动翻译
- 🪟 **悬浮字幕窗** — 始终置顶，半透明毛玻璃，可拖动+调整大小+调节透明度
- 🎨 **自定义样式** — 背景色（深色/浅色）、字号、文字透明度、毛玻璃模糊度，5 个滑块实时调节
- 💡 **连接状态灯** — 左上角红/蓝/绿指示灯，3 秒无事件自动变红
- 📋 **历史记录** — 按语义段落合并原文+翻译，支持导出 Markdown
- 🤖 **AI 会议纪要** — 配置 API Key 后可一键生成结构化会议纪要
- ⚡ **VAD 断句** — 语音活动检测，支持极快/快/正常/慢 4 档语速

## 开发

```bash
pnpm install
pnpm tauri dev    # 开发模式（热重载）
bash build.sh     # 生产打包（自动签名+安装到 /Applications）
```

## 技术栈

| 层 | 技术 |
|---|------|
| 桌面框架 | Tauri v2 (Rust) |
| 前端 | Vue 3 + Vite |
| 音频采集 | cpal (CoreAudio) |
| 语音识别 | OpenAI Whisper (Python daemon) |
| 翻译 | DeepSeek / OpenAI / Claude API |
| 毛玻璃 | CSS backdrop-filter |
| 窗口管理 | Tauri window API |

## 目录结构

```
live-caption/
├── src/                    # Vue 前端
│   ├── App.vue             # 主布局
│   ├── components/         # 组件
│   │   ├── ControlPanel.vue
│   │   ├── SubtitleOverlay.vue
│   │   ├── HistoryView.vue
│   │   └── SettingsView.vue
│   └── composables/        # 状态管理
├── src-tauri/              # Rust 后端
│   ├── src/
│   │   ├── lib.rs          # 入口
│   │   ├── commands.rs     # Tauri 命令
│   │   ├── audio/          # 音频采集 + VAD
│   │   └── transcribe.rs   # 转写队列
│   └── whisper/            # Whisper daemon
├── overlay.html            # 悬浮字幕窗
├── build.sh                # 一键构建安装脚本
└── start.sh                # 开发启动脚本
```