前言¶

会议录音、采访素材、课堂回放，常见做法是本地跑 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