前言¶
整理播客、訪談或課程視頻時，常見流程是：先找下載方式，再換一款轉寫工具，最後把文本拷進筆記。若鏈接來自 YouTube、小宇宙或各類播客站，站點規則不一，雲端轉寫還要考慮費用與隱私。下面介紹的 Skill 把「按 URL 取音頻」和「語音轉文字」收進 Agent 工作流裏，轉寫依賴 Faster-Whisper，在本地完成，不需要配置雲端語音識別 API（requires_api_key=false）。
這是什麼¶
語音轉文字（座標 @user_03f2ab96/yuyinzhuanxie，版本 1.0.0）是 SkillHub 社區來源（community）的 Agent Skill，分類爲 design-media，由發佈者 user_03f2ab96 維護。
一句話定位：從任意可解析的 URL 下載音頻，用 Faster-Whisper 轉寫成文本；整條鏈路可在本機跑完，不依賴雲端轉寫 API。
官方頁面：SkillHub - 語音轉文字
API 入口：https://api.skillhub.cn/user_03f2ab96/yuyinzhuanxie
核心功能¶
以下能力均來自 SkillHub 上的官方簡介，未在資料中出現的實現細節不作展開。
- URL 音頻下載：支持從給定鏈接拉取音頻；明確提到 YouTube、小宇宙（Xiaoyuzhoufm），以及 yt-dlp 能提取音頻的任意站點（播客、視頻頁等）。
- 本地轉錄：使用 Faster-Whisper 將音頻轉爲文本，全程本地運行（
Runs entirely locally — no cloud API needed）。 - 自然語言觸發：當用戶提出與轉寫相關的需求時，Agent 應啓用該 Skill。官方列出的典型表述包括：
transcribe this audio、download and transcribe、speech to text、audio to text，以及中文 轉錄、語音轉文字、音頻轉文字；也適用於把 YouTube、小宇宙、播客等音視頻內容轉成文字的任務。
安裝與啓用¶
SkillHub 推薦兩種方式：用 CLI 安裝到當前 Agent 的 skills 目錄，或把安裝提示詞發給 AI 由其按官方文檔操作。
1. 檢查 SkillHub CLI¶
先確認本機是否已有 skillhub：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝與優先源配置 執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
若只需要 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安裝本 Skill¶
安裝時必須用 --dir 指向當前 Agent 實際使用的 skills 目錄，否則默認會裝到 ./skills/，Agent 可能識別不到。
skillhub install @user_03f2ab96/yuyinzhuanxie --dir <skills 目錄>
常用客戶端的 skills 路徑（摘自 SkillHub 安裝文檔）：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
在 Cursor 中示例：
skillhub install @user_03f2ab96/yuyinzhuanxie --dir ~/.cursor/skills/
3. 通過對話讓 AI 安裝¶
SkillHub 頁面提供的提示詞爲：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_03f2ab96/yuyinzhuanxie`。
將上述內容發給支持 Skill 的 Agent 即可；Agent 應按該文檔選擇正確的 --dir 並完成安裝。安裝後若 Agent 要求重啓或重新加載 skills，按其產品說明操作。
典型用法¶
公開資料未附帶獨立 CLI 手冊，用法以「安裝 Skill 後向 Agent 描述任務」爲主，與官方簡介中的觸發場景一致。
- 確認
@user_03f2ab96/yuyinzhuanxie已裝入當前 Agent 的 skills 目錄。 - 在對話中給出可訪問的音頻或視頻 URL，並說明需要轉寫，例如：
- 「請下載並轉錄這個鏈接的音頻：https://…」
- 「把這個小宇宙節目的語音轉成文字」
- 「speech to text，URL 是 …」 - Agent 按 Skill 指引完成下載（含 yt-dlp 支持的站點）與 Faster-Whisper 轉錄，將文本返回給你。
具體腳本路徑、模型尺寸、語言參數等以 Skill 包內 SKILL.md 爲準；若安裝後行爲與預期不符，可在 SkillHub 技能頁查看版本 1.0.0 是否有更新說明。
適用場景與注意¶
適合誰
- 需要把 YouTube、小宇宙、播客 等鏈接內容快速變成文字稿，且希望轉寫在 本機 完成、避免上傳音頻到第三方 API 的場景。
- 已在 Cursor、Claude Code、Codex 等環境使用 Skills，希望用自然語言驅動「下載 + 轉寫」流水線的人。
使用上需注意
- 站點與版權：能否下載取決於 URL 與 yt-dlp 對該站的支持情況；請遵守內容提供方服務條款與著作權規定。
- 本地資源：Faster-Whisper 在本地推理，會佔用 CPU/GPU 與磁盤；長音頻耗時與機器配置相關，公開頁面未給出性能指標，此處不臆測。
- 無需 API Key：標籤爲
requires_api_key=false，不依賴雲端語音識別密鑰；仍可能需要本機 Python 環境與 Skill 所聲明的依賴（以安裝後 Skill 文檔爲準）。 - 數據口徑：SkillHub 頁面顯示評分 100000、下載 9907、安裝 17（與部分聚合頁上的下載/評分數字可能不一致，以 官方技能頁 爲準）。
結尾¶
語音轉文字把「按 URL 取音頻」和 Faster-Whisper 本地轉寫封裝成 Agent Skill，適合播客、課程、訪談鏈接的一鍵轉稿需求，且不需要雲端轉寫 API。安裝時記住座標 @user_03f2ab96/yuyinzhuanxie 與正確的 --dir。
- 技能頁：https://www.skillhub.cn/skills/user_03f2ab96/yuyinzhuanxie
- API：https://api.skillhub.cn/user_03f2ab96/yuyinzhuanxie
- 安裝說明：https://skillhub.cn/install/skillhub.md
