RELEASE_NOTES.md

# 🎬 B 站视频转录专家 v2.2.0 发布说明

**发布日期：** 2026-05-17
**版本类型：** 功能增强
**兼容性：** 向后兼容，无破坏性变更

---

## 🚀 新增功能

### 1️⃣ 输出目录优化

**之前**：目录名使用 BV 号（如 `BV1i4LG6TEBM`）
**现在**：目录名使用 `{UP主}_{标题}` 格式（如 `艾財说imoneytalk_美联储新主席上任缩表40%`）
- 自动清理特殊字符
- 自动截断超长名称（80 字符上限）
- 新增 `_sanitize_title()` 静态方法

### 2️⃣ Vosk 分块转写

**之前**：Vosk 一次性加载整个 WAV 文件 → 16分钟音频很容易 OOM
**现在**：自动按 180 秒分块处理
- 逐块读取识别
- 合并结果并输出准确的时间戳（不再是硬编码 0）
- 2 核 / 1.6GB 内存服务器实测 16分钟视频成功转写

### 3️⃣ 飞书文档自动创建

**新增 `create_lark_doc()` 方法**：
- 自动生成飞书友好格式的 markdown
- 使用 pipe 方式调用 `lark-cli`（避免 1.0.18 版本 bug）
- 支持指定知识空间
- 非关键步骤：失败不影响主流程
- 结果中返回 `feishu_doc_url` 字段

### 4️⃣ 多格式自动保存

**process() 现在自动保存三种格式**：
- `transcript.txt`：纯文本格式
- `transcript.json`：结构化 JSON（含评论）
- `summary.md`：Markdown 总结（含表格）

---

## 🔧 功能改进

- **内存检测阈值优化**：whisper tiny 阈值从 4GB 降到 2GB，更多机器可用
- **save_transcript() markdown 优化**：使用表格展示视频信息，结构化板块布局
- **cli.py**：新增飞书文档 URL 显示

---

## 🐛 已修复

- Vosk 时间戳从 0 硬编码改为基于帧偏移计算
- `--markdown ./file` 文件名陷阱已在文档和代码中避免（使用 pipe 方式）

---

## 📦 文件变更

| 文件 | 操作 | 说明 |
|------|------|------|
| `bilibili_transcriber.py` | 修改 | 新增 4 个改进 + 2 个新方法 |
| `cli.py` | 修改 | 新增飞书文档链接显示 |
| `SKILL.md` | 修改 | 新增飞书文档 + 低资源转写经验 |
| `package.json` | 修改 | 版本 2.2.0 |
| `.clawhub/release.json` | 修改 | v2.2.0 发布说明 |
| `.clawhub/origin.json` | 修改 | installedVersion → 2.2.0 |