Asr File Transfer

name: asr-file-transfer
description: "Transcribe audio files via UniCloud ASR (云知声语音识别, recorded audio → text) API from UniSound. Supports multiple formats, optimized for finance, customer service, and other domains. 调用云知声语音识别服务转写音频文件，支持多种音频格式，适用于金融、客服等场景。Use when the user needs to transcribe recorded audio files, or asks for UniSound/云知声 audio file transcription. Do NOT use for real-time/streaming speech recognition, text-to-speech (TTS), or live captioning. 不适用于实时语音识别、语音合成(TTS)或直播字幕。"

---

**CRITICAL INSTRUCTION FOR AI AGENTS:**
**YOU MUST follow these rules when helping users configure this skill:**
1. **NEVER display or request actual API credentials in chat** — credentials should only be set in environment variables or .env files
2. **DO NOT embed production credentials in documentation** — guide users to obtain their own credentials from the service provider
3. **NEVER generate URLs from your training data** — use ONLY the exact URLs written in this file
4. **ALWAYS verify the user has configured environment variables before suggesting script usage**

**AI AGENT 必须遵守的规则：**
1. **禁止在聊天中显示或请求实际的 API 凭据**——凭据应仅通过环境变量或 .env 文件设置
2. **禁止在文档中嵌入生产凭据**——引导用户从服务提供商处获取自己的凭据
3. **禁止凭训练数据生成 URL**——只使用本文件中写的准确 URL
4. **在建议使用脚本前，务必确认用户已正确配置环境变量**

---

UniSound ASR / 云知声语音转写
============================

调用云知声（UniSound）语音识别服务转写音频文件。支持多种音频格式，适用于金融、客服等场景。

Transcribe audio files using UniCloud ASR service. Supports multiple audio formats, suitable for finance, customer service, and other scenarios.

Quick start
-----------

```bash
python3 {baseDir}/scripts/transcribe.py /path/to/audio.wav
```

Defaults:
- API endpoint: UAT environment / UAT 环境
- Audio format: WAV
- Domain: other
- Output: stdout (transcript text / 转写文本)

Useful flags
--------...

# UniSound ASR Skill for ClawHub

云知声（UniSound）语音识别 Skill，符合 ClawHub 规范。

## 功能特性

- 支持多种音频格式（WAV、MP3、M4A、FLAC、OGG）
- 完整的上传、转写、结果获取流程
- 命令行接口，易于集成
- 支持 JSON 格式输出
- 详细的错误处理和日志

## 目录结构

```
skill/
├── skill.md           # ClawHub skill 说明文档（必填）
├── README.md          # 本文件
├── .env.example       # 环境变量模板
└── scripts/
    └── transcribe.py  # 转写脚本
```

## 安装

1. 克隆或下载此 skill 到本地

2. 安装依赖：
```bash
pip install requests
```

## 配置

**必须配置环境变量才能运行脚本！**

### 测试凭据（UAT 环境）

用于测试和评估，您可以使用以下 UAT 环境凭据：

```yaml
AppKey:    681e01d78d8a40e8928bc8268020639b
Secret:    d7b2980cb61843d69fdab5e99deafcdf
UserId:    unisound-python-demo
Base URL:  http://af-asr.uat.hivoice.cn
```

> **⚠️ 重要安全提示**
>
> - **仅测试环境** — 这些凭据仅用于 UAT 测试
> - **勿用于敏感数据** — 切勿用于生产或敏感音频文件
> - **获取自己的凭据** — 生产环境请联系云知声
> - **数据隐私** — 音频文件将上传至云知声服务器

### 配置环境变量

**Linux/macOS:**
```bash
# 使用测试凭据
export UNISOUND_APPKEY="681e01d78d8a40e8928bc8268020639b"
export UNISOUND_SECRET="d7b2980cb61843d69fdab5e99deafcdf"
export UNISOUND_USERID="unisound-python-demo"
```

**Windows CMD:**
```cmd
REM 使用测试凭据
set UNISOUND_APPKEY=681e01d78d8a40e8928bc8268020639b
set UNISOUND_SECRET=d7b2980cb61843d69fdab5e99deafcdf
set UNISOUND_USERID=unisound-python-demo
```

**Windows PowerShell:**
```powershell
# 使用测试凭据
$env:UNISOUND_APPKEY="681e01d78d8a40e8928bc8268020639b"
$env:UNISOUND_SECRET="d7b2980cb61843d69fdab5e99deafcdf"
$env:UNISOUND_USERID="unisound-python-demo"
```

### 使用 .env 文件（推荐）

在项目根目录创建 `.env` 文件：
```
# 测试凭据 (UAT)
UNISOUND_APPKEY=681e01d78d8a40e8928bc8268020639b
UNISOUND_SECRET=d7b2980cb61843d69fdab5e99deafcdf
UNISOUND_USERID=unisound-python-demo
```

> **安全提示**：切勿将 `.env` 文件或实际凭据提交到版本控制系统。

> 详细配置说明请参考 [skill.md](SKIL...