前言¶
DeepSeek Harness (DSH) 的核心哲学是「一切皆插件」。在构建需要处理语音交互的智能体时，如何低成本、高精度地识别不同地区的方言和口音是一个常见需求。xby-asr-f 插件正是为此设计，它提供了一套基于小笨羊服务的语音识别接口，支持普通话及20多种方言和口音。
插件概览¶
这是一个由 xby-skill 维护的模型推理类插件，采用 MIT 许可证。其核心价值在于将复杂的方言语音识别能力封装为 DSH 的标准接口，开发者无需关注底层识别逻辑，只需按照规范调用即可完成语音转文字。
安装¶
在安装之前，请确保你的 DeepSeek Harness 环境已正确配置。通过命令行安装该插件：
dsh plugin --profile web add github:xby_skill/xby-asr-f
安装完成后，插件会随 DSH 进程启动加载。
API 密钥配置¶
使用该插件前，必须配置有效的 API 密钥。你可以在聊天对话中直接调用 set_xby_apikey 命令来设置密钥。该命令支持自动持久化，设置后重启 DSH 依然有效。
语音识别用法¶
插件提供了三种识别方式，根据输入数据类型选择对应的方法：
asr_fire_red_asr_ctc：接收音频文件的 URL 链接。asr_fire_red_asr_ctc_for_data_base64：接收音频文件的 BASE64 编码。asr_fire_red_asr_ctc_for_data_file：接收音频文件的本地文件路径。
注意事项¶
需要注意的是，识别服务依赖于小笨羊官网。使用前需前往 小笨羊官网 注册并获取 API 密钥。此外，插件以当前 dsh 进程的权限运行，建议在安装前检查源码与许可证。
结语¶
总结来说，xby-asr-f 为 DSH 生态添加了方言语音识别的能力。如果你需要构建处理多地区语音输入的智能体，可以通过以下链接获取更多信息或提交反馈：
* GitHub 仓库
* DSH 插件目录
