# WeChat 语音发送指南（给 Hermes Agent）

## 核心原则

**不要自己实现 SILK 编码，不要调 edge-tts，不要写 ffmpeg 命令。**
调一个 MCP 工具就完成全部工作。

---

## 发语音的正确姿势

### 最简单：文字直接发语音

```python
# Hermes 调用：
result = await mcp.call("send_wechat_voice_tts", {
    "to": "filehelper",          # 联系人 wxid，测试只用 filehelper
    "text": "你好，明天下午三点开会。",
    "voice": "zh-CN-XiaoxiaoNeural"  # 可选，默认女声
})
# result: {"status": "sent", "to": "filehelper", "duration_ms": 3240, ...}
```

**管线在工具内部自动完成**：
`text → edge-tts(MP3) → ffmpeg(16kHz PCM) → silk-wasm(SILK V3) → SEND_VOICE_INTERNAL 广播 → WeChat DB status=4`

### 换男声

```python
result = await mcp.call("send_wechat_voice_tts", {
    "to": "filehelper",
    "text": "今日摘要已生成，请查看。",
    "voice": "zh-CN-YunxiNeural"   # 男声
})
```

可用声音列表：
- `zh-CN-XiaoxiaoNeural` — 晓晓，女，自然
- `zh-CN-YunxiNeural`   — 云希，男，自然
- `zh-CN-YunyangNeural` — 云扬，男，新闻播报风

### 如果你已经有 SILK 文件

```python
result = await mcp.call("send_wechat_voice", {
    "to": "filehelper",
    "silk_path": "/data/local/tmp/my_voice.amr",
    "duration_ms": 4500
})
```

---

## 安全约束

**IMPORTANT**: 测试阶段只对 `filehelper`（文件传输助手）发送，不要对真实联系人发语音。

---

## 发文字消息

```python
result = await mcp.call("send_wechat_message", {
    "to": "filehelper",
    "content": "你好"
})
```

---

## 依赖（第一次使用前确认已安装）

在 Termux 里执行：
```bash
pip install edge-tts
pkg install ffmpeg nodejs
npm install -g silk-wasm
```

验证：
```bash
python3 -c "import edge_tts; print('OK')"
ffmpeg -version | head -1
node -e "require('silk-wasm'); console.log('OK')"
```

---

## 常见错误

| 错误信息 | 原因 | 解决 |
|---|---|---|
| `edge-tts not installed` | pip 未装 | `pip install edge-tts` |
| `ffmpeg not found` | 未装 ffmpeg | `pkg install ffmpeg` |
| `silk-wasm not found` | 未装 | `npm install -g silk-wasm` |
| `WeChat not running` | 微信进程未启动 | 工具会自动启动，等 10s 重试 |
| `failed to stage SILK` | 权限问题 | 确认 Magisk root 正常 |

---

## 技术背景（不需要懂，只需要调工具）

- WeChat 语音消息 = SILK V3 格式（Tencent 变体，`\x02#!SILK_V3` 前缀）
- 通过 LSPosed hook（wechathook 模块）注入 WeChat 内部 `w11.r0` 工厂
- DB INSERT 在 r0 构造器内完成，status=4（已送达），不触发 CDN 上传
- 不是 UI 模拟，不影响微信界面，不会被 WeChat 反自动化检测