bili2txt-agent

KO | EN

gitlite — search

#python #ai #llm #golang #go #linux #docker #macos #java #windows #cli #vue #openai #open-source

(★ 23)

将B站的视频用大模型做原文精转和关键纪要，通过飞书控制并收到结果

bili2txt-agent 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# bili2txt-agent

[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://raw.githubusercontent.com/phi0217/bili2txt-agent/master/LICENSE)
[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

**B站视频转飞书云文档智能机器人**

自动下载、语音识别、AI精转，一键生成结构化文档

[功能特性](#-功能特性) • [快速开始](#-快速开始) • [使用说明](#-使用说明) • [文档](#-文档)

</div>

## 📖 项目简介

**bili2txt-agent** 是一个基于飞书长连接的智能机器人，通过接收用户发送的B站视频链接，自动完成视频下载、语音识别、AI文本精转，并生成结构化的飞书云文档。

### 核心价值

- 🎯 **零学习成本**：发送视频链接，自动生成文档
- ⚡ **极致性能**：音频下载比视频快300倍
- 🤖 **AI增强**：DeepSeek API智能精转和摘要
- 💾 **智能缓存**：相同视频秒级处理
- 🌐 **多语言支持**：支持中英文双语模式

## ⚡ 性能优势

| 指标 | 传统方案 | bili2txt-agent | 提升 |
|------|---------|----------------|------|
| 音频下载 | 5-10分钟 | 1-2秒 | **300倍** |
| 文件大小 | ~500MB | ~1MB | **99.8%** |
| 总耗时 | 8-17分钟 | 3-7分钟 | **2-5倍** |
| 并发处理 | 串行 | 3线程 | **3倍** |

## ✨ 功能特性

### 📹 多格式链接解析
- **完整URL**：`https://www.bilibili.com/video/BV1ScfFBZE3y`（自动解析BV号）
- **短链接**：`https://b23.tv/abc123`（自动跳转并解析真实BV号）
- **直接ID**：`BV1ScfFBZE3y` 或 `av123456`（支持BV号和AV号）

### 🌐 双语处理模式
- **中文模式（默认）**：直接发送视频ID，如 `BV1ScfFBZE3y`
  - 使用中文Whisper模型识别语音
  - 生成纯中文的原文精转和关键纪要
  - 适合中文视频内容

- **英文/双语模式** ⭐：在ID后添加 `#en`，如 `BV1ScfFBZE3y#en`
  - 使用英文Whisper模型识别语音
  - 生成中英双语对照文档（每段采用"中文内容\n\nEnglish Content"格式）
  - 关键术语提供中英双语解释
  - 支持混合语言内容自动处理
  - 适合翻译、学习和国际场景

### ⚡ 核心特性
- **智能下载**：优先yt-dlp音频流（1-2秒），失败自动回退you-get，支持断点续传
- **Whisper识别**：Base模型，支持中英文识别及自动语言检测
- **DeepSeek增强**：原文精转（修正错别字、标点、表达）+ 关键纪要（结构化摘要），移除输出限制充分利用API能力
- **上下文理解**：视频标题注入提示词，提升专业术语处理准确性
- **飞书云文档**：自动创建Markdown文档，生成分享链接，支持原文精转和关键纪要两个文档
- **智能缓存**：按视频ID和语言分别缓存，支持快速重建，防重复下载，并发保护

## 🚀 快速开始

### 1. 系统要求

- Python 3.11+
- FFmpeg
- yt-dlp（推荐）或 you-get（备用）

### 2. 安装依赖

```bash
# 克隆项目
git clone https://github.com/yourusername/bili2txt-agent.git
cd bili2txt-agent

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# Linux/macOS:
source venv/bin/activate
# Windows:
venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt
```

### 3. 安装 FFmpeg

**Ubuntu/Debian:**
```bash
sudo apt-get update && sudo apt-get install -y ffmpeg
```

**macOS:**
```bash
brew install ffmpeg
```

**Windows:**
```bash
.\install-ffmpeg.ps1
```

验证安装：
```bash
ffmpeg -version
```

### 4. 配置环境变量

#### 4.1 创建配置文件

```bash
# 复制环境变量模板
cp .env.example .env

# 编辑 .env 文件
```

#### 4.2 必需配置

这些参数**必须配置**，程序才能正常运行：

| 参数名 | 说明 | 获取方式 | 示例值 |
|--------|------|----------|--------|
| `FEISHU_APP_ID` | 飞书应用ID | [飞书开放平台](https://open.feishu.cn/) → 创建应用 → 凭证管理 | `cli_xxxxxxxxx` |
| `FEISHU_APP_SECRET` | 飞书应用密钥 | [飞书开放平台](https://open.feishu.cn/) → 创建应用 → 凭证管理 → 凭证密钥 | `xxxxxxxxxxxxxxxx` |
| `DEEPSEEK_API_KEY` | DeepSeek API密钥 | [DeepSeek开放平台](https://platform.deepseek.com/) → API Keys | `sk-xxxxxxxxxxxxxxxx` |

> ⚠️ **重要提示**：
> - 飞书应用必须启用"机器人"能力
> - 飞书应用必须订阅 `im.message.receive_v1` 事件
> - 飞书应用必须授予相应权限
> - DeepSeek API需要充值才能使用

#### 4.3 可选配置

这些参数可以使用默认值，根据需要调整：

**飞书服务配置**

| 参数名 | 说明 | 默认值 | 使用场景 |
|--------|------|--------|----------|
| `FEISHU_DOMAIN` | 飞书API域名 | `https://open.feishu.cn` | 海外用户改为 `https://open.larksuite.com` |
| `FEISHU_DOC_DOMAIN` | 飞书文档域名 | `https://my.feishu.cn` | 控制返回给用户的文档链接格式 |
| | | | - 中国：`https://my.feishu.cn` |
| | | | - 海外：`https://my.feishu.com` 或 `https://docs.larksuite.com` |

**DeepSeek 服务配置**

| 参数名 | 说明 | 默认值 | 使用场景 |
|--------|------|--------|----------|
| `DEEPSEEK_BASE_URL` | API访问地址 | `https://api.deepseek.com/v1` | 一般无需修改 |
| | | | 使用代理或自定义端点时修改 |

**文件存储配置**

| 参数名 | 说明 | 默认值 | 使用场景 |
|--------|------|--------|----------|
| `TEMP_DIR` | 临时文件目录 | `./temp` | 指定其他存储位置 |

**网络代理配置**

| 参数名 | 说明 | 默认值 | 使用场景 |
|--------|------|--------|----------|
| `HTTP_PROXY` | HTTP代理地址 | 无 | 企业内网、需要代理访问外网 |
| `HTTPS_PROXY` | HTTPS代理地址 | 无 | 企业内网、需要代理访问外网 |
| | | | 示例：`http://127.0.0.1:7890` |

**高级配置**

| 参数名 | 说明 | 默认值 | 使用场景 |
|--------|------|--------|----------|
| `WHISPER_MODEL` | Whisper模型大小 | `base` | 可选：`tiny`, `small`, `medium`, `large` |
| | | | 更大模型精度更高但速度更慢 |
| `LOG_LEVEL` | 日志级别 | `INFO` | 调试时改为 `DEBUG` |
| | | | 可选：`DEBUG`, `WARNING`, `ERROR`, `CRITICAL` |

#### 4.4 配置示例

**最小配置（必需参数）：**
```bash
FEISHU_APP_ID=cli_xxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxxxxxxxx
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxx
```

**完整配置（包含可选参数）：**
```bash
# 必需配置
FEISHU_APP_ID=cli_xxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxxxxxxxx
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxx

# 飞书服务配置
FEISHU_DOMAIN=https://open.feishu.cn
FEISHU_DOC_DOMAIN=https://my.feishu.cn

# DeepSeek 服务配置
DEEPSEEK_BASE_URL=https://api.deepseek.com/v1

# 文件存储配置
TEMP_DIR=./temp

# 网络代理配置（如需要）
# HTTP_PROXY=http://127.0.0.1:7890
# HTTPS_PROXY=http://127.0.0.1:7890

# 高级配置
WHISPER_MODEL=base
LOG_LEVEL=INFO
```

#### 4.5 配置验证

启动前请确认：

- ✅ `.env` 文件已创建并填写必需参数
- ✅ `FEISHU_APP_ID` 和 `FEISHU_APP_SECRET` 已填写
- ✅ `DEEPSEEK_API_KEY` 已填写并充值
- ✅ FFmpeg 已安装（运行 `ffmpeg -version` 验证）
- ✅ Python 依赖已安装（运行 `pip list` 检查）
- ✅ 飞书应用已配置（详见[飞书应用配置](#-飞书应用配置)）
- ✅ 如使用代理，`HTTP_PROXY` 和 `HTTPS_PROXY` 已正确配置

详细配置说明请参考 [配置指南](docs/CONFIGURATION.md)

### 5. 启动服务

```bash
python main.py
```

看到以下输出表示启动成功：
```
============================================================
Feishu WebSocket Service Starting...
============================================================

App ID: cli_xxxxxxxxx
Temp Dir: ./temp

Using EventDispatcherHandler (Official Recommended)

Important: Please ensure:
  1. Event subscription is configured in Feishu Open Platform
  2. Subscribed to 'im.message.receive_v1' event
  3. Version is created and published
  4. 'Use long connection to receive events' is selected

Initializing WebSocket client...
```

## 🔧 飞书应用配置

### 步骤1：创建应用

1. 访问 [飞书开放平台](https://open.feishu.cn/)
2. 创建企业自建应用
3. 获取 **App ID** 和 **App Secret**

### 步骤2：开启能力

在应用管理页面，开启"机器人"能力

### 步骤3：配置事件订阅

1. 进入"事件与回调"配置
2. 选择 **"使用长连接接收事件"**（不要开启VPN，会造成长连接失败）
3. 订阅 `im.message.receive_v1` 事件
4. 创建并发布版本

### 步骤4：配置权限

授予应用以下权限：

- `im:message`（接收消息、发送消息）
- `im:message:send_as_bot`（以机器人身份发送消息）
- `docx:document`（创建文档）
- `drive:drive`（管理文档）
- `drive:drive:readonly`（读取文件）

### 步骤5：发布并使用

1. 将应用发布到企业或工作台
2. 添加机器人到群组或私聊
3. 发送视频链接开始使用

详细配置请参考 [飞书WebSocket配置](docs/WEBSOCKET_SETUP.md)

## 📖 使用说明

### 快速示例

> 🎯 **最简单的用法**：直接发送B站视频链接
> ```
> https://www.bilibili.com/video/BV1ScfFBZE3y
> ```

> 🌐 **双语模式用法**：在视频ID后添加 `#en`
> ```
> BV1ScfFBZE3y#en
> ```
> - 生成中英双语对照文档
> - 适合翻译和学习场景

### 基本使用

发送B站视频链接或ID：

```
https://www.bilibili.com/video/BV1ScfFBZE3y
```

或：

```
BV1ScfFBZE3y
```

### 多语言模式 🌐

**中文模式（默认）：**
```
BV1ScfFBZE3y
# 或
BV1ScfFBZE3y#zh
```
- ✅ 语音识别使用中文模型
- 📝 生成纯中文的原文精转
- 📋 生成纯中文的关键纪要

**英文/双语模式：**
```
BV1ScfFBZE3y#en
```
- ✅ 语音识别使用英文模型
- 📝 生成中英双语对照的原文精转
- 📋 生成中英双语的关键纪要

> 💡 **双语模式特点**：
> - 每个自然段采用中英对照格式
> - 关键术语提供中英双语解释
> - 适合学习和翻译场景

### 处理流程

```
接收视频链接
    ↓
检查缓存（秒级命中）
    ↓
下载音频（1-2秒）
    ↓
语音识别（30秒-1分钟）
    ↓
AI精转（2-5分钟）
    ↓
AI纪要（2-5分钟）
    ↓
创建文档（5-10秒）
    ↓
返回两个链接
```

### 输出示例

```
✅ [BV1ScfFBZE3y/zh] 处理完成！

📹 视频ID：BV1ScfFBZE3y
🌐 语言模式：中文
📹 视频标题：视频标题
📄 原文长度：12345 字符
📝 精转后长度：11234 字符

🔗 文档链接：原文精转-视频标题
https://my.feishu.cn/docx/xxxxx

🔗 文档链接：关键纪要-视频标题
https://my.feishu.cn/docx/yyyyy
```

## 📁 项目结构

```
bili2txt-agent/
├── main.py                      # 程序入口
│
├── src/                         # 源代码目录
│   ├── __init__.py
│   ├── config.py                # 配置管理
│   ├── utils.py                 # 通用工具
│   │
│   ├── bilibili_downloader.py  # yt-dlp 下载器（推荐）
│   ├── bilibili_utils.py        # you-get 下载器（备用）
│   ├── audio_utils.py           # 音频提取
│   ├── asr_utils.py             # Whisper 语音识别
│   ├── llm_utils.py             # DeepSeek 文本精转
│   ├── doc_utils.py             # 飞书文档创建
│   │
│   ├── feishu_handler.py        # 飞书消息处理
│   ├── feishu_ws_client.py      # 飞书 WebSocket 客户端
│   ├── cache_utils.py           # 缓存管理
│   ├── processing_tracker.py    # 处理状态追踪
│   │
│   └── task.py                  # 完整处理任务流程
│
├── docs/                        # 📚 文档目录
│   ├── README.md                # 文档索引
│   ├── PROJECT_STRUCTURE.md     # 项目结构详细说明
│   ├── CONFIGURATION.md         # 配置指南
│   ├── FAQ.md                   # 常见问题解答
│   ├── VIDEO_DOWNLOAD.md        # 视频下载方案
│   ├── FEISHU_DOCS.md           # 飞书文档创建
│   ├── SHORT_LINK_PARSING.md    # 短链接解析
│   ├── WEBSOCKET_SETUP.md       # WebSocket 配置
│   ├── PROXY_SETUP.md           # 代理设置
│   ├── VIDEO_TITLE_IN_PROMPT.md # 视频标题注入
│   ├── REMOVE_MAX_TOKENS_CONTROL.md # 移除max_tokens限制
│   └── MAX_TOKENS_UNLIMITED.md  # 无上限功能说明
│
├── tests/                       # 🧪 测试目录
│   ├── README.md                # 测试说明
│   ├── test_remove_max_tokens.py        # max_tokens测试
│   ├── test_video_title_simple.py      # 视频标题测试
│   ├── test_unlimited_tokens_simple.py  # 无上限测试
│   ├── test_max_tokens_unlimited.py     # 完整测试
│   ├── test_video_title_prompt.py       # 提示词测试
│   ├── test_integration.py      # 集成测试
│   ├── test_yt_dlp.py           # yt-dlp 测试
│   ├── test_document_api.py     # 文档 API 测试
│   └── test_short_link.py       # 短链接测试
│
├── temp/                        # 临时文件目录
│   ├── cache/                   # 缓存目录
│   └── results/                 # 处理结果缓存
│
├── requirements.txt             # Python 依赖
├── .env.example                 # 环境变量模板
└── README.md                    # 本文件
```

详细的项目结构说明请查看：[docs/PROJECT_STRUCTURE.md](docs/PROJECT_STRUCTURE.md)

## 📚 文档

### 🚀 快速开始

- [配置指南](docs/CONFIGURATION.md) - 环境变量配置详解
- [项目结构说明](docs/PROJECT_STRUCTURE.md) - 代码组织

### 🔧 核心功能

- [视频下载方案](docs/VIDEO_DOWNLOAD.md) - yt-dlp 音频下载（300倍速度提升）
- [飞书文档创建](docs/FEISHU_DOCS.md) - 文档创建和管理
- [视频标题注入](docs/VIDEO_TITLE_IN_PROMPT.md) - LLM上下文增强

### 🛠️ 技术实现

- [短链接解析](docs/SHORT_LINK_PARSING.md) - B站短链接支持
- [WebSocket 配置](docs/WEBSOCKET_SETUP.md) - 飞书长连接配置
- [代理设置](docs/PROXY_SETUP.md) - 网络代理配置
- [移除max_tokens限制](docs/REMOVE_MAX_TOKENS_CONTROL.md) - 充分利用API能力

### ❓ 帮助

- [常见问题解答](docs/FAQ.md) - 故障排除和常见问题
- [tests/README.md](tests/README.md) - 测试说明

## 🧪 测试

```bash
# 进入测试目录
cd tests

# 运行集成测试（推荐）
python test_integration.py

# 运行功能测试
python test_remove_max_tokens.py      # max_tokens测试
python test_video_title_simple.py     # 视频标题测试
python test_unlimited_tokens_simple.py # 无上限测试

# 运行组件测试
python test_yt_dlp.py          # 测试音频下载
python test_short_link.py      # 测试短链接
python test_document_api.py    # 测试文档API
```

详细测试说明请参考 [tests/README.md](tests/README.md)

## ⚠️ 注意事项

### 使用注意

1. **音频下载优先**：系统自动使用 yt-dlp 只下载音频（1-2秒），失败时回退到 you-get（5-10分钟）
2. **临时文件清理**：程序会自动清理下载的音频文件，处理结果保存到 `./temp/results/` 目录
3. **Whisper模型**：首次运行会自动下载 Whisper base 模型（约 150MB）
4. **DeepSeek API**：请注意 API 调用费用
5. **处理时间**：视频处理可能需要较长时间（主要是语音识别），请耐心等待
6. **长连接稳定性**：WebSocket 客户端会自动重连，无需额外处理

### 性能优化

1. **缓存利用**：相同视频再次处理只需3-5秒（重建文档）
2. **多语言缓存**：同一视频的不同语言版本分别缓存
3. **并发限制**：相同视频同时发送不会重复处理
4. **智能去重**：处理中状态追踪，避免资源浪费

## ❓ 常见问题

### Q: 如何提升下载速度？

**A**: 确保 yt-dlp 已安装（requirements.txt已包含），系统会自动优先使用，下载速度提升300倍。

### Q: 飞书连接失败？

**A**: 检查以下配置：
1. `FEISHU_APP_ID` 和 `FEISHU_APP_SECRET` 是否正确
2. 飞书应用是否已启用
3. 是否已订阅 `im.message.receive_v1` 事件
4. 是否已发布版本
5. 是否选择了"使用长连接接收事件"
6. 是否已关闭VPN，在正常的网络环境下

### Q: 文档链接打不开？

**A**: 检查 `FEISHU_DOC_DOMAIN` 配置：
- 国内飞书：`https://my.feishu.cn`
- 海外飞书：`https://docs.larksuite.com`

### Q: 语音识别失败？

**A**: 确保 FFmpeg 已正确安装：
```bash
ffmpeg -version
```

### Q: 如何使用英文模式？

**A**: 在视频ID后添加 `#en` 后缀：
```
BV1ScfFBZE3y#en
```

### Q: 相同视频再次处理为什么这么快？

**A**: 系统使用了智能缓存，第一次处理后保存结果，再次处理只需3-5秒重建文档。

更多问题请参考 [常见问题解答](docs/FAQ.md)

## 📊 性能对比

### 下载性能

| 方案 | 下载时间 | 文件大小 |
|------|---------|---------|
| you-get（视频） | 5-10分钟 | ~500MB |
| yt-dlp（音频）✨ | 1-2秒 | ~1MB |

### 总体性能

| 指标 | 旧方案 | 新方案 | 提升 |
|------|--------|--------|------|
| 总耗时 | 8-17分钟 | 3-7分钟 | **2-5倍** |
| 网络流量 | ~500MB | ~1MB | **500倍** |
| 磁盘占用 | ~510MB | ~1MB | **500倍** |
| 并发处理 | 不支持 | 3线程 | **3倍** |

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

### 开发新功能

1. 在 `src/` 对应模块中添加功能
2. 更新 `src/task.py` 中的处理流程
3. 在 `tests/` 中添加测试脚本
4. 在 `docs/` 中更新文档

### 代码规范

- 使用 black 格式化代码
- 遵循 PEP 8 规范
- 添加必要的文档字符串
- 编写单元测试

## 📄 许可证

本项目采用 Apache License 2.0 许可证 - 详见 [LICENSE](LICENSE) 文件

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```

## 🔗 相关链接

- [飞书开放平台](https://open.feishu.cn/)
- [DeepSeek 开放平台](https://platform.deepseek.com/)
- [yt-dlp GitHub](https://github.com/yt-dlp/yt-dlp)
- [Whisper GitHub](https://github.com/openai/whisper)
- [lark-oapi SDK](https://github.com/larksuite/oapi-sdk-python)

## 🌟 致谢

感谢以下开源项目：

- [lark-oapi](https://github.com/larksuite/oapi-sdk-python) - 飞书SDK
- [yt-dlp](https://github.com/yt-dlp/yt-dlp) - 视频下载
- [openai-whisper](https://github.com/openai/whisper) - 语音识别
- [you-get](https://github.com/soimort/you-get) - 备用下载器

---

**最后更新**: 2026-03-10 | **版本**: 2.0.0

Made with ❤️ by bili2txt-agent team

</div>

bili2txt-agent

bili2txt-agent 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

bili2txt-agent

bili2txt-agent 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README