Course Transcribe

课堂录音转文字一键流程。用户提到课程/会议录音转写、录音转文字、转写蓝本前置处理、音频转 txt/seg 时触发。技术栈固定:飞书安可录音豆(采集)+ Gemini API(主转写)+ 阿里百炼 qwen-audio-3.0-asr-flash(备选/交叉校对)。所有参数与踩坑均经 2026-08 实测验证,不要自行更换模型或接口。

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add bleakbelladonnals/asr-transcription-skills --skill course-transcribe
Manual install
git clone --depth 1 https://github.com/bleakbelladonnals/asr-transcription-skills.git /tmp/asr-transcription-skills
mkdir -p ~/.claude/skills
cp -r /tmp/asr-transcription-skills/note-taking/course-transcribe ~/.claude/skills/course-transcribe

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# 课堂录音转文字(course-transcribe)

一条命令完成「课程录音 → 高质量中文转写文本」,术语准确优先,成本趋近 0(免费额度)。

## 触发条件

- 用户提到:课程录音转写 / 录音转文字 / 把录音转成文本 / 转写后做复习蓝本
- 输入一般是录音豆导出的 OGG/MP3(存于 `~/Documents/luyinwenjian/<日期>/`)

## 技术栈(2026-08 实测定案,勿改)

| 环节 | 工具 | 角色 |
|------|------|------|
| 采集 | 飞书安可录音豆(硬件) | 录音(0 断录已验证;弃用钉钉A1录音卡 102 次断录) |
| 主转写 | Gemini `gemini-3.6-flash` | 免费层主力,15 分钟/段,约 40-80 分钟转完 5 小时课 |
| 备选/校对 | 百炼 `qwen-audio-3.0-asr-flash` | 5 分钟/段(服务端上限 300s),5 小时课约 20-30 分钟 |
| 热词 | 百炼即时热词 / Gemini prompt 术语表 | 免费,生僻术语纠偏 |

> ⚠️ **模型选型实测结论(2026-08)**:百炼**不要用旧模型 qwen3-asr-flash**——它无热词(预编译被服务端拒绝 `preprocess service not found`、即时热词参数被静默忽略)、术语常错(Claude Code → Cloud Code)。`qwen-audio-3.0-asr-flash` 全面更优:模型更强 + 热词生效 + 响应自带句子级毫秒时间戳。gemini-2.5-flash 对 2026 年新用户已下线(404),勿用教程旧模型名。

## 快速开始

```bash
# 1. 前置:key 文件(一次性)
#    scripts/ 目录下放 gemini_key.txt(Google AI Studio 获取,需代理)和 bailian_key.txt(sk- 开头)
#    或用 --key-file / --gemini-key-file / --bailian-key-file 指定已有 key

# 2. 主转写(默认 Gemini,5 小时课约 1 小时)
python3 transcribe.py "~/Documents/转写评测/8.7/录音.ogg"

# 3. 备选/交叉校对
python3 transcribe.py 录音.ogg --engine bailian              # 百炼单独转
python3 transcribe.py 录音.ogg --engine compare              # 双引擎 + 锚点术语对比报告
```

## 完整工作流

### 第 1 步:录音采集(硬件,课前)
1. 录音豆放**讲台/离声源 1-2 米**(独立设备,不依赖手机位置)
2. 课后导出音频(OGG/MP3 均可,脚本自动处理)
3. 脚本内置**断录检测**(分帧 RMS:0.5s 帧,相邻帧骤降 >20dB 计数)——检测到疑似断录会警告,漏录内容转写救不回,宁可重录

### 第 2 步:音频预处理(脚本自动)
- ffmpeg 统一转 **16kHz 单声道 mp3 64kbps**(ASR 标准输入)
Read the full skill on GitHub

Details

Skill name
course-transcribe
Path
note-taking/course-transcribe/SKILL.md
License
MIT
Repo updated
17 August 2026

FAQ

What does the Course Transcribe skill do?

课堂录音转文字一键流程。用户提到课程/会议录音转写、录音转文字、转写蓝本前置处理、音频转 txt/seg 时触发。技术栈固定:飞书安可录音豆(采集)+ Gemini API(主转写)+ 阿里百炼 qwen-audio-3.0-asr-flash(备选/交叉校对)。所有参数与踩坑均经 2026-08 实测验证,不要自行更换模型或接口。

How do I install the Course Transcribe skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add bleakbelladonnals/asr-transcription-skills --skill course-transcribe. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Course Transcribe popular?

It lives in bleakbelladonnals/asr-transcription-skills, which has 9 GitHub stars and 0 forks.

Related skills

Asr Benchmarking

9

bleakbelladonnals/asr-transcription-skills

语音转写(ASR)服务与模型的评测和 API 集成:音频质量客观分析(ffmpeg)、转写质量对比(术语锚点/幻觉/结构)、AI 纪要核验、Gemini/阿里百炼/火山方舟/OpenAI 等平台批量转写调用。用于"录音转文字哪个最好"、录音硬件(录音豆/录音卡/录音笔)对比评测、公众号评测文章的数据准备。

Research & Science

Asr Transcription

9

bleakbelladonnals/asr-transcription-skills

语音转文字(ASR)方案评测与转写管线。多引擎对比(录音硬件/转写模型/纪要 AI)的完整方法论:双变量拆分、锚点对齐、幻觉检测、ffmpeg 音频质量指标;以及在线转写 API 接入(Gemini 脚本、OpenAI 兼容中转站)。用于"哪个转写方案好/要不要续会员/写转写产品评测文/批量转写录音"类任务。

Images, Video & Audio

Asr Transcription Evaluation

9

bleakbelladonnals/asr-transcription-skills

录音转写(ASR)引擎选型与评测:多平台 API 转写(Gemini/阿里百炼/火山方舟/OpenAI)、转写质量 Benchmark(CER/锚点/幻觉/信息丢失)、录音硬件质量评测(断录/漏录检测)。适用于选型对比、写评测文章、搭建转写管线、判断录音设备是否漏录。

Images, Video & Audio

Mxl Multimode

9

TaoELi/MaxwellLink

This skill should be used when users need the MaxwellLink multimode Fabry-Pérot cavity solver to study a spatial grid of molecules coupled to many photonic modes (mesoscale VSC), in either socket or embedded mode.

Images, Video & Audio

Speech to Text Apis

9

bleakbelladonnals/asr-transcription-skills

多平台录音转写(Gemini / 阿里百炼 / 火山方舟)API 调用与对比评测。触发场景:课程/会议录音转文字、多引擎转写质量对比、公众号文章数据采集。包含三家 API 的调用方式、已踩过的坑、现成脚本位置和锚点对比方法。

Images, Video & Audio

Transcription Quality Evaluation

9

bleakbelladonnals/asr-transcription-skills

对比评测录音转写产品/引擎(录音硬件端到端 vs 云转写模型):控制变量测试设计(2×2 音频×引擎)、ffmpeg 音频质量客观指标(响度/动态/底噪/削波/声道)、SRT 变体解析与统计、关键术语识别对照、内容锚点时间轴对齐、幻觉检测,输出对比矩阵。触发词:转写对比、转写质量、录音质量对比、ASR 评测、哪个转写好、录音笔对比、转写引擎对比。

Images, Video & Audio

Browse the most popular Claude skills, all images, video & audio skills, or write your own with the skills generator.