前言¶
會議錄音、採訪素材、課堂回放，常見做法是本地跑 ASR 模型，或登錄訊飛聽見網頁端手動上傳、等結果再下載。前者要維護環境與模型；後者步驟多，和 IDE、對話式工作流也不在同一處。若你已經在 Cursor、Claude Code 等環境裏用 Skill 擴展 Agent，可以把「上傳—轉寫—取結果—紀要」交給一條對話鏈路，由 Skill 按官方流程調用訊飛聽見服務。下面介紹 SkillHub 上的 訊飛聽見語音轉文字（@user_294a7000/xftj-transcribe，v1.0.4）能做什麼、如何安裝，以及使用時要注意什麼。
這是什麼¶
訊飛聽見語音轉文字是社區發佈的辦公效率類 Skill（分類 office-efficiency，來源 community），SkillHub 座標爲 @user_294a7000/xftj-transcribe。頁面標註研發方爲聽見科技，實現爲純 Python 架構的訊飛聽見音頻轉寫服務封裝。
它面向 Agent：當用戶用自然語言描述轉寫或紀要需求時，Skill 引導完成與訊飛聽見相關的操作，而不是讓你在聊天裏手寫 HTTP 調用順序。
核心功能¶
以下能力均來自 Skill 官方簡介，可按三條主線理解。
新文件一鍵轉寫¶
完整鏈路爲：上傳 → 轉寫 → 輪詢 → 選權益 → 支付 → 下載結果。適合本地已有音頻文件、需要一次性拿到轉寫文本的場景。
歷史轉寫查詢與下載¶
支持查詢歷史轉寫文件列表，並對已有任務下載轉寫結果。適合「上次轉寫好了，把結果再拉一份」或覈對賬號下有哪些已完成任務。
AI 會議紀要¶
支持獲取或創建 AI 會議紀要，與轉寫任務銜接，減少從全文到結構化紀要的二次整理。
觸發用語（Agent 側）¶
Skill 說明中寫明，當用戶提出例如「轉寫音頻」「音頻轉文字」「轉寫錄音」「生成會議紀要」「查詢我的轉寫」「查看歷史轉寫」「查轉寫記錄」「獲取會議紀要」「幫我生成紀要」等表述時，應啓用本 Skill。具體話術不必背全，語義貼近上述即可。
安裝與啓用¶
SkillHub 頁面給出的安裝方式，是向你的 AI 助手發送安裝提示，並引用通用安裝文檔與技能座標：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_294a7000/xftj-transcribe`。
說明這一步在做什麼：讓 Agent 按 SkillHub 的 skillhub.md 流程拉取並註冊該 Skill，而不是手動 git clone 倉庫。
API Key：標籤爲 requires_api_key=true，使用前需具備訊飛聽見相關 API 憑證，並按 Skill 內說明（安裝後見於 SKILL.md 及附帶腳本）配置。憑證字段名與存放路徑以 Skill 包內文檔爲準；本文不臆造配置項名稱。
平臺差異：官方頁面僅給出上述統一安裝提示，未單獨列出 Cursor、Codex CLI、Claude Code 的不同命令。各客戶端只要支持 SkillHub 安裝協議，通常共用同一座標 @user_294a7000/xftj-transcribe；若某環境安裝失敗，應先對照 https://skillhub.cn/install/skillhub.md 是否可訪問，再檢查本機 Skill 目錄是否已出現該包。
典型用法¶
官方資料未提供獨立 CLI 示例命令，典型用法是在已啓用 Skill 的對話裏用自然語言驅動。可復現的表述方式如下。
新音頻轉寫（需準備好本地音頻路徑或按 Agent 提示上傳）：
幫我把這段錄音轉寫成文字，文件在 /path/to/meeting.m4a
查歷史並下載：
查詢我的轉寫記錄，把最近一條的結果下載下來
會議紀要：
根據這次轉寫幫我生成會議紀要
經過上面的步驟，Agent 應按 Skill 定義的 Python 流程處理上傳、輪詢、權益與支付環節（新轉寫時），並在完成後提供可下載的轉寫或紀要結果。若某步需要你在聽見側確認支付或選擇權益，以對話中的提示爲準。
適用場景與注意¶
適合誰：經常處理會議/採訪錄音、已使用訊飛聽見賬號與 API、希望轉寫和紀要與編碼環境同一窗口完成的開發者或辦公用戶。
服務與費用：新文件轉寫鏈路包含選權益與支付，實際扣費與額度以訊飛聽見平臺規則爲準，Skill 只自動化步驟，不替代賬號開通。
依賴與版本：當前 SkillHub 展示版本爲 v1.0.4；升級後以 SkillHub 頁面爲準。
社區指標（SkillHub 抓取數據）：評分 100000，下載 12133 次，分類爲 office-efficiency。可作爲選用參考，不代表個人賬號下的轉寫質量或 SLA。
限制：需網絡訪問訊飛聽見服務；requires_api_key=true 意味着未配置密鑰時 Skill 無法完成調用。純離線或不願使用雲端轉寫的場景不適用。
結尾¶
訊飛聽見語音轉文字把聽見側的「上傳—轉寫—取結果—紀要」收成 Agent 可執行的 Python Skill，適合用對話完成轉寫與歷史查詢，而不是反覆切換網頁。安裝與詳情見 SkillHub：
- 技能頁：https://www.skillhub.cn/skills/user_294a7000/xftj-transcribe
- API 入口：https://api.skillhub.cn/user_294a7000/xftj-transcribe
