audio-transcription
GitHub用于本地音频转录、生成字幕及会议纪要的技能,基于 FunASR 实现。
Trigger Scenarios
Install
npx skills add OpenBMB/PilotDeck --skill audio-transcription -g -y
SKILL.md
Frontmatter
{
"name": "audio-transcription",
"description": "Transcribe a project-local audio recording, generate subtitles, analyze a recording, or produce meeting notes from audio using local FunASR."
}
Audio Transcription
Use this Skill only when the user explicitly asks to transcribe audio, create subtitles, analyze a recording, or make meeting notes from a recording. Do not invoke ASR merely because an audio attachment is present.
PilotDeck provides this Skill itself; there is no Skill file to install. First check whether mcp__funasr__transcribe_audio is available. If its local runtime or models are missing, run the exact installation command shown by the attachment or MCP diagnostic. Source checkouts use npm:
npm --prefix "<PilotDeck directory>" run install:asr
Installed desktop apps invoke their bundled Node and scripts/install-asr.mjs directly. Use the displayed command through the Bash tool; do not substitute a system Node or npm installation.
The installer downloads the platform-specific official FunASR llama.cpp runtime and the local models. It does not require Docker, Python, or a cloud API. After it completes, retry mcp__funasr__transcribe_audio in the same session.
For platform, cache, download-source, and network troubleshooting details, read ../../docs/funasr-installation.md relative to this Skill directory.
Workflow
- Identify the registered audio attachment path in the session message.
- Pass that project-local host path directly as
audio_path; do not convert it to a container path. The tool rejects paths outside the current project, including symlinks that escape it. - Call
mcp__funasr__transcribe_audiowithlanguage: "auto". This is the only language value supported by the local SenseVoice CLI. - Preserve timestamped segments for subtitles, verbatim transcripts, or auditable meeting records.
- Only after transcription, summarize, translate, or extract action items as requested.
Constraints
- Do not use
read_fileto decode audio. - Do not send the audio to a cloud service or substitute a different ASR provider without the user's direction.
- The tool is intentionally limited to a real local file inside the active project.
Version History
-
52660d5
Current 2026-10-19 00:09
修复桌面端打包问题,使用捆绑的 Node 和 FunASR 安装器。
- ed8da90 2026-08-13 16:08


