town asr

town asr 是内置 asr plugin 的短命令组。

这页保留为命令入口。更完整的 Plugin 结构说明见 Plugin 总览、当前有哪些内建 Plugin 和 Plugin Hooks 和 Resolve。

它负责什么

• 启用或关闭当前 agent 项目的 asr plugin
• 管理 asr 的转写配置
• 切换当前转写模型
• 转写本地音频文件

常用示例

# 启用 asr，并安装模型
town asr on SenseVoiceSmall

# 查看 plugin + transcriber 状态
town asr status

# 切换当前模型
town asr use whisper-large-v3-turbo

# 转写一个本地音频文件
town asr transcribe ./demo.ogg

说明

• town asr on 会在一步里更新当前 agent 项目的 ASR plugin 配置，并可选安装转写依赖。
• Console UI 的 Plugins -> asr 卡片里也提供了依赖修复台，可以直接读取状态、下载模型、切换当前模型，并填写 Python / models 目录等配置。
• asr plugin 会接入 chat runtime 的语音扩展点，Telegram / QQ 的语音消息会通过这些点完成转写与正文增强。
• agent 侧的 ASR 参数会持久化到项目 downcity.json 的 plugins.asr。

相关页面

• town plugin
• town tts
• Plugin 文档总览
• Agent Plugins Docs / asr
• Agent Plugins Docs / chat