# Yichen Asr

逸尘自用的唯一音视频转写入口，统一管理 StepFun Step ASR、火山引擎豆包 ASR 与本地 Whisper 三个后端：纯文本转写按参数、已保存的引擎偏好、默认...

- Repository: https://github.com/mcncarl/yichen-skills (5140 stars)
- Category: Media
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add mcncarl/yichen-skills --skill yichen-asr -g -a claude-code -y`
Codex: `npx skills add mcncarl/yichen-skills --skill yichen-asr -g -a codex -y`
Cursor: `npx skills add mcncarl/yichen-skills --skill yichen-asr -g -a cursor -y`
Gemini CLI: `npx skills add mcncarl/yichen-skills --skill yichen-asr -g -a gemini-cli -y`

## Description

逸尘自用的唯一音视频转写入口，统一管理 StepFun Step ASR、火山引擎豆包 ASR 与本地 Whisper 三个后端：纯文本转写按参数、已保存的引擎偏好、默认 StepFun 的顺序选择引擎并处理首次选择提示；时间戳、SRT 字幕与口播粗剪转写在 Step 国内站与豆包之间按输出需求、安全边界和可用状态路由；另含转写前体检。适用于本地音频或视频，包括小宇宙、B 站等已下载的音视频、会议录音和长音频重新识别。用户说用 Step 转写、只用 step、stepaudio-2.5-asr、用豆包或火山转写、用本地 Whisper 免费转写、设置转写引擎，或点名 step-asr、volc-asr、yichen-asr 时使用；用户明确指定服务商时不得静默切换。Use when a local audio or video file needs transcription, timestamps or subtitles, or when the user names $yichen-asr, $step-asr or $volc-asr.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 逸尘统一 ASR

本 Skill 是转写的唯一入口：Step ASR 与豆包 ASR 的执行器路由、本地 Whisper 后端和引擎偏好都在这里。原 `step-asr`、`volc-asr` 已并入；豆包执行器随本 Skill 发布在 `scripts/backends/`，Step 执行器由用户自行配置。

| 用途 | 脚本（在 `~/.agents/skills/yichen-asr/scripts/` 下） |
|---|---|
| 纯文本转写（StepFun 或 Whisper，应用引擎偏好） | `transcribe.py` |
| 路由判断（时间戳、SRT、粗剪、豆包回退） | `route_asr.py` |
| 只读体检 | `asr_doctor.py` |
| 豆包执行器与口播粗剪 | `backends/volc_asr_transcribe.py` |
| Python 调用方共用的引擎库 | `asr_engine.py` |

公开版不内置 Step 执行器。纯文本执行器用 `YICHEN_STEP_ASR_SCRIPT`、逐字时间戳执行器用 `YICHEN_STEP_ASR_TIMESTAMPS_SCRIPT` 指向你已安装并审计过的兼容脚本；也可以把它们放在 `scripts/backends/step_asr_transcribe.py` 与 `scripts/backends/step_asr_timestamps.py`。豆包执行器可用 `YICHEN_DOUBAO_ASR_SCRIPT` 覆盖。接口约定见 `references/step-asr.md`。

## 纯文本转写与引擎偏好

```bash
python3 ~/.agents/skills/yichen-asr/scripts/transcribe.py \
  --input "/absolute/path/input.m4a" \
  --output-dir "/absolute/path/asr" \
  --title "标题" --hotwords "AI,Agent"
```

The rest: https://github.com/mcncarl/yichen-skills/blob/HEAD/yichen-asr/SKILL.md